214 lines
4.0 KiB
Markdown
214 lines
4.0 KiB
Markdown
# 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
|
||
```
|
||
|