# 情绪博物馆容器部署指南

## 📋 概述

本文档提供了情绪博物馆项目的完整容器化部署方案，支持开发环境和生产环境的快速部署。

## 🏗️ 架构说明

### 服务组件
- **前端应用** (Vue3 + Ant Design) - 端口: 80/3000
- **API网关** (Spring Cloud Gateway) - 端口: 9000
- **AI服务** (Spring Boot + Coze API) - 端口: 9002
- **用户服务** (Spring Boot) - 端口: 9001
- **MySQL数据库** - 端口: 3306
- **Redis缓存** - 端口: 6379
- **Nacos注册中心** - 端口: 8848
- **Nginx反向代理** - 端口: 80/443

### 网络架构
```
Internet → Nginx → Frontend/Gateway → Microservices → Database
```

## 🚀 快速开始

### 1. 系统要求
- **操作系统**: Linux/macOS/Windows
- **Docker**: 20.10+
- **Docker Compose**: 1.29+
- **内存**: 最少4GB，推荐8GB+
- **磁盘**: 最少10GB可用空间

### 2. 一键部署
```bash
# 克隆项目
git clone <repository-url>
cd EmotionMuseum

# 快速部署（自动安装依赖）
chmod +x quick-deploy.sh
./quick-deploy.sh

# 或者手动部署
chmod +x deploy.sh
./deploy.sh
```

### 3. 访问应用
- **前端应用**: http://localhost
- **API文档**: http://localhost:9000/doc.html
- **Nacos控制台**: http://localhost:8848/nacos (nacos/nacos)

## 📁 文件结构

```
EmotionMuseum/
├── docker-compose.yml          # 开发环境配置
├── docker-compose.prod.yml     # 生产环境配置
├── deploy.sh                   # 部署脚本
├── quick-deploy.sh             # 快速部署脚本
├── manage.sh                   # 管理脚本
├── .env                        # 环境变量
├── deploy/                     # 部署配置
│   ├── nginx/                  # Nginx配置
│   │   ├── nginx.conf
│   │   ├── conf.d/
│   │   └── ssl/
│   ├── mysql/                  # MySQL配置
│   └── redis/                  # Redis配置
├── backend/                    # 后端服务
│   ├── emotion-gateway/
│   │   └── Dockerfile
│   ├── emotion-ai/
│   │   └── Dockerfile
│   └── emotion-user/
│       └── Dockerfile
└── web/                        # 前端应用
    ├── Dockerfile
    └── nginx.conf
```

## ⚙️ 配置说明

### 环境变量配置
编辑 `.env` 文件：
```bash
# 数据库配置
MYSQL_ROOT_PASSWORD=123456
MYSQL_DATABASE=emotion_museum
MYSQL_USER=emotion
MYSQL_PASSWORD=emotion123

# Coze API配置
COZE_API_TOKEN=your-coze-api-token

# 时区设置
TZ=Asia/Shanghai
```

### Nginx配置
- **主配置**: `deploy/nginx/nginx.conf`
- **站点配置**: `deploy/nginx/conf.d/emotion-museum.conf`
- **SSL证书**: `deploy/nginx/ssl/`

### 数据库配置
- **MySQL配置**: `deploy/mysql/conf.d/my.cnf`
- **初始化脚本**: `backend/mysql_emotion_museum_final.sql`

## 🛠️ 管理命令

### 基础操作
```bash
# 启动所有服务
./manage.sh start

# 停止所有服务
./manage.sh stop

# 重启所有服务
./manage.sh restart

# 查看服务状态
./manage.sh status
```

### 日志管理
```bash
# 查看所有服务日志
./manage.sh logs

# 跟踪日志输出
./manage.sh logs -f

# 查看特定服务日志
./manage.sh logs -s gateway
./manage.sh logs -s ai-service
```

### 服务管理
```bash
# 重启特定服务
./manage.sh restart gateway
./manage.sh restart ai-service

# 健康检查
./manage.sh health

# 监控面板
./manage.sh monitor
```

### 数据管理
```bash
# 备份数据
./manage.sh backup

# 恢复数据
./manage.sh restore backup_file.tar.gz

# 更新服务
./manage.sh update

# 清理资源
./manage.sh clean
```

## 🔧 生产环境部署

### 1. 使用生产配置
```bash
# 使用生产环境配置文件
docker-compose -f docker-compose.prod.yml up -d
```

### 2. SSL证书配置
```bash
# 放置SSL证书
cp your-domain.crt deploy/nginx/ssl/emotion-museum.crt
cp your-domain.key deploy/nginx/ssl/emotion-museum.key

# 修改Nginx配置启用HTTPS
vim deploy/nginx/conf.d/emotion-museum.conf
```

### 3. 域名配置
修改 `deploy/nginx/conf.d/emotion-museum.conf`：
```nginx
server_name your-domain.com www.your-domain.com;
```

### 4. 防火墙配置
```bash
# Ubuntu/Debian
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# CentOS/RHEL
sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --permanent --add-port=443/tcp
sudo firewall-cmd --reload
```

## 📊 监控和维护

### 服务监控
```bash
# 实时监控
./manage.sh monitor

# 资源使用情况
docker stats

# 服务状态
docker-compose ps
```

### 日志查看
```bash
# 应用日志
./manage.sh logs -f

# 系统日志
tail -f logs/nginx/access.log
tail -f logs/mysql/error.log
```

### 性能优化
1. **数据库优化**: 调整 `deploy/mysql/conf.d/my.cnf`
2. **Redis优化**: 调整 `deploy/redis/redis.conf`
3. **Nginx优化**: 调整 `deploy/nginx/nginx.conf`
4. **JVM优化**: 修改Dockerfile中的JVM参数

## 🔒 安全配置

### 1. 数据库安全
- 修改默认密码
- 限制访问IP
- 启用SSL连接

### 2. Redis安全
- 设置密码认证
- 绑定特定IP
- 禁用危险命令

### 3. Nginx安全
- 启用HTTPS
- 配置安全头
- 限制请求频率

### 4. 应用安全
- 配置JWT密钥
- 启用CORS限制
- 设置API限流

## 🚨 故障排除

### 常见问题

#### 1. 服务启动失败
```bash
# 查看服务日志
./manage.sh logs -s service-name

# 检查端口占用
netstat -tlnp | grep :port

# 重启服务
./manage.sh restart service-name
```

#### 2. 数据库连接失败
```bash
# 检查MySQL状态
docker-compose exec mysql mysqladmin ping -u root -p

# 查看数据库日志
./manage.sh logs -s mysql
```

#### 3. 前端访问异常
```bash
# 检查Nginx配置
nginx -t

# 查看Nginx日志
./manage.sh logs -s nginx
```

#### 4. API调用失败
```bash
# 检查网关状态
curl http://localhost:9000/actuator/health

# 查看网关日志
./manage.sh logs -s gateway
```

### 性能问题
1. **内存不足**: 增加服务器内存或调整JVM参数
2. **磁盘空间**: 清理日志文件和Docker镜像
3. **网络延迟**: 检查服务间网络连接

## 📞 技术支持

如遇到问题，请：
1. 查看相关服务日志
2. 检查配置文件
3. 参考故障排除指南
4. 联系技术支持团队

---

**部署完成后，请及时修改默认密码和配置文件中的敏感信息！**