recommend/README_DOCKER.md

# Docker 部署指南

本文档说明如何使用Docker部署个性化饮食推荐助手Web应用。

## 📋 前置要求

- Docker Engine 20.10+
- Docker Compose 2.0+

## 🚀 快速开始

### 方式一：使用 Docker Compose（推荐）

#### 生产环境

```bash
# 构建并启动容器
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止容器
docker-compose down
```

#### 开发环境（支持代码热重载）

```bash
# 使用开发配置启动
docker-compose -f docker-compose.dev.yml up -d

# 查看日志
docker-compose -f docker-compose.dev.yml logs -f

# 停止容器
docker-compose -f docker-compose.dev.yml down
```

### 方式二：使用 Docker 命令

```bash
# 构建镜像
docker build -t diet-recommendation-app .

# 运行容器
docker run -d \
  --name diet_recommendation_app \
  -p 5000:5000 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  -v $(pwd)/models:/app/models \
  diet-recommendation-app

# 查看日志
docker logs -f diet_recommendation_app

# 停止容器
docker stop diet_recommendation_app
docker rm diet_recommendation_app
```

## 🌐 访问应用

容器启动后，访问：
- **主页**: http://localhost:5000
- **背诵排序**: http://localhost:5000/recitation
- **数据采集**: http://localhost:5000/data-collection
- **智能推荐**: http://localhost:5000/recommendation
- **营养分析**: http://localhost:5000/analysis
- **健康检查**: http://localhost:5000/health

## 📁 数据持久化

以下目录会自动挂载到容器中，确保数据不丢失：

- `./data` - 用户数据和数据库
- `./logs` - 日志文件
- `./models` - 训练好的模型文件

## 🔧 配置说明

### 环境变量

可以通过 `docker-compose.yml` 中的 `environment` 部分或 `.env` 文件配置：

```yaml
environment:
  - FLASK_ENV=production
  - QWEN_API_KEY=your_api_key_here
```

### 端口配置

默认端口为 `5000`，如需修改：

```yaml
ports:
  - "8080:5000"  # 将主机的8080端口映射到容器的5000端口
```

## 🐛 故障排除

### 查看容器日志

```bash
# Docker Compose
docker-compose logs -f web

# Docker
docker logs -f diet_recommendation_app
```

### 进入容器调试

```bash
# Docker Compose
docker-compose exec web bash

# Docker
docker exec -it diet_recommendation_app bash
```

### 重启容器

```bash
# Docker Compose
docker-compose restart

# Docker
docker restart diet_recommendation_app
```

### 重新构建镜像

```bash
# Docker Compose
docker-compose build --no-cache

# Docker
docker build --no-cache -t diet-recommendation-app .
```

## 📊 健康检查

容器包含健康检查功能，可以通过以下方式查看状态：

```bash
# Docker Compose
docker-compose ps

# Docker
docker ps
```

健康检查端点：`http://localhost:5000/health`

## 🔒 安全建议

1. **生产环境**：
   - 使用反向代理（Nginx/Traefik）
   - 配置HTTPS
   - 限制端口访问
   - 使用环境变量管理敏感信息

2. **数据备份**：
   - 定期备份 `data` 目录
   - 备份 `models` 目录中的模型文件

## 🚢 生产部署示例

### 使用 Nginx 作为反向代理

```nginx
server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

## 📝 注意事项

1. **OCR功能**：Docker镜像已包含Tesseract OCR支持
2. **内存限制**：建议至少分配1GB内存给容器
3. **文件权限**：确保挂载的目录有适当的读写权限
4. **时区设置**：如需修改时区，在Dockerfile中添加：
   ```dockerfile
   ENV TZ=Asia/Shanghai
   RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
   ```

## 🔄 更新应用

```bash
# 停止容器
docker-compose down

# 拉取最新代码
git pull

# 重新构建并启动
docker-compose build --no-cache
docker-compose up -d
```