rtsp-video-analysis-system/DOCKER-QUICK-START.md

# 🚀 Docker快速启动指南

## 一键部署

### Windows
```bash
deploy.bat
```

### Linux/Mac
```bash
chmod +x deploy.sh
./deploy.sh
```

## 手动部署

```bash
# 1. 启动所有服务
docker-compose up -d

# 2. 查看服务状态
docker-compose ps

# 3. 查看日志
docker-compose logs -f
```

## 常用命令

### 服务管理
```bash
# 启动服务
docker-compose up -d

# 停止服务
docker-compose stop

# 重启服务
docker-compose restart

# 停止并删除容器
docker-compose down

# 停止并删除容器和数据卷
docker-compose down -v
```

### 日志查看
```bash
# 查看所有日志
docker-compose logs

# 查看特定服务日志
docker-compose logs backend
docker-compose logs frontend
docker-compose logs python-service

# 实时查看日志
docker-compose logs -f

# 查看最近100行日志
docker-compose logs --tail=100
```

### 服务重建
```bash
# 重新构建所有镜像
docker-compose build

# 重新构建特定服务
docker-compose build backend

# 强制重建并启动
docker-compose up -d --build --force-recreate
```

### 进入容器
```bash
# 进入后端容器
docker exec -it rtsp-backend sh

# 进入前端容器
docker exec -it rtsp-frontend sh

# 进入Python服务容器
docker exec -it rtsp-python-service bash

# 进入MySQL容器
docker exec -it rtsp-mysql bash

# 进入Redis容器
docker exec -it rtsp-redis sh
```

## 端口配置

| 服务 | 默认端口 | 对外暴露 | 说明 |
|------|---------|---------|------|
| 前端 | 10080 | ✅ | 唯一对外暴露的端口 |
| 后端 | 8080 | ❌ | 仅容器内部访问 |
| Python服务 | 8000 | ❌ | 仅容器内部访问（CPU模式） |
| MySQL | 3306 | ❌ | 仅容器内部访问 |
| Redis | 6379 | ❌ | 仅容器内部访问 |
| MinIO | 外部服务 | - | 使用已部署的外部服务 |

要修改前端端口，编辑 `.env` 文件中的 `FRONTEND_PORT` 变量。

## 环境变量配置

所有配置都在 `.env` 文件中：

```bash
# 修改前端端口
FRONTEND_PORT=8080

# 修改数据库密码
MYSQL_ROOT_PASSWORD=your_secure_password
MYSQL_PASSWORD=your_secure_password

# 修改MinIO密码
MINIO_ROOT_PASSWORD=your_secure_password
```

修改后需要重新启动服务：
```bash
docker-compose down
docker-compose up -d
```

## 数据备份

### 备份MySQL数据
```bash
docker exec rtsp-mysql mysqldump -u root -pruoyi123 ry-vue > backup.sql
```

### 备份MinIO数据
```bash
docker cp rtsp-minio:/data ./minio-backup
```

### 恢复MySQL数据
```bash
docker exec -i rtsp-mysql mysql -u root -pruoyi123 ry-vue < backup.sql
```

## 故障排查

### 查看服务健康状态
```bash
docker-compose ps
```

### 服务启动失败
```bash
# 查看详细日志
docker-compose logs [服务名]

# 常见问题：
# 1. 端口被占用 -> 修改.env中的端口配置
# 2. 数据库连接失败 -> 等待MySQL完全启动（约30秒）
# 3. 内存不足 -> 增加Docker内存限制或减少服务
```

### 清理并重新开始
```bash
# 完全清理（会删除所有数据）
docker-compose down -v
docker system prune -a

# 重新部署
docker-compose up -d
```

## 访问地址

部署成功后：

- **前端界面**: http://localhost:10080
- **后端API**: 通过前端代理 `/prod-api/`
- **Python API**: 通过前端代理 `/python-api/`
- **API文档**: http://localhost:10080/prod-api/swagger-ui.html

## 首次使用

1. **准备YOLOv8模型**：将训练好的`best.pt`文件放到`python-inference-service/models/`目录
2. 访问 http://localhost:10080
3. 默认账号密码请参考主文档
4. 首次启动可能需要等待1-2分钟让所有服务完全启动

## YOLOv8模型说明

本系统使用**YOLOv8**（Ultralytics）进行目标检测：

- 将训练好的YOLOv8模型（`best.pt`）放到`python-inference-service/models/`目录
- （可选）创建`classes.txt`文件，每行一个类别名称
- 模型会自动加载并提供推理服务

## 更多帮助

详细文档请查看：`README-DOCKER.md`