buffer_platform/DEPLOY.md

期货智析平台 - Docker 部署指南

📋 部署前准备

1. 环境要求

• Docker Desktop for Windows（已安装并运行）
• Windows 10/11 专业版或家庭版（WSL2后端）
• 至少 2GB 可用内存
• 至少 5GB 磁盘空间

2. 检查Docker状态

docker --version
docker-compose --version

🚀 快速部署

方法一：使用部署脚本（推荐）

1. 双击运行 deploy.bat
2. 等待自动完成构建和部署
3. 访问 http://localhost:9600

方法二：手动部署

# 进入项目目录
cd e:\docker_workspace\cobot2.0_WorkHorse\app\working\workspaces\default\share_data\project\market_data_colector_platform\buffer_platform

# 停止旧容器
docker-compose down

# 构建镜像
docker-compose build --no-cache

# 启动服务
docker-compose up -d

🌐 访问地址

部署成功后，可访问以下地址：

服务	地址
主页	http://localhost:9600
品种分析	http://localhost:9600/futures-analysis
AI配置	http://localhost:9600/ai-config
API文档	http://localhost:9600/docs
健康检查	http://localhost:9600/api/v1/health

🛠️ 日常管理

使用管理脚本

双击运行 manage.bat，可选择：

1. 启动服务
2. 停止服务
3. 重启服务
4. 查看日志
5. 查看状态
6. 进入容器
7. 清理资源

常用Docker命令

# 查看容器状态
docker-compose ps

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

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

# 重启服务
docker-compose restart

# 停止服务
docker-compose stop

# 启动服务
docker-compose start

# 停止并删除容器（保留数据）
docker-compose down

# 完全清理（包括数据卷）
docker-compose down -v

# 进入容器bash
docker exec -it futures-buffer-platform /bin/bash

# 查看容器资源使用
docker stats futures-buffer-platform

📁 目录结构

buffer_platform/
├── data/              # SQLite数据库（自动创建）
├── logs/              # 日志文件（自动创建）
├── app/
│   └── static/        # 前端静态文件
├── docker-compose.yml # Docker编排配置
├── Dockerfile         # Docker镜像构建文件
├── deploy.bat         # 一键部署脚本
└── manage.bat         # 管理脚本

🔧 配置说明

环境变量

在 docker-compose.yml 中可配置：

变量	说明	默认值
BUFFER_DB_PATH	数据库路径	/app/data/buffer.db
BUFFER_HOST	服务监听地址	0.0.0.0
BUFFER_PORT	服务端口	8600
CACHE_TTL	缓存过期时间（秒）	300
BUFFER_LOG_LEVEL	日志级别	INFO
MAX_WORKERS	并发采集数	2
TZ	时区	Asia/Shanghai

端口映射

• 宿主机端口：9600
• 容器端口：8600

如需修改端口，编辑 docker-compose.yml 中的 ports 配置：

ports:
  - "你想要的端口:8600"

🔍 故障排查

1. 容器无法启动

# 查看详细日志
docker-compose logs

# 检查端口占用
netstat -ano | findstr "9600"

2. 数据库问题

# 进入容器检查数据库
docker exec -it futures-buffer-platform ls -la /app/data

3. 重新构建镜像

# 清理旧镜像
docker-compose down
docker system prune -a

# 重新构建
docker-compose build --no-cache
docker-compose up -d

4. 查看健康状态

# 查看容器健康检查状态
docker inspect --format='{{.State.Health.Status}}' futures-buffer-platform

🔄 更新部署

当代码有更新时：

# 方法一：使用部署脚本
deploy.bat

# 方法二：手动更新
docker-compose down
docker-compose build --no-cache
docker-compose up -d

📊 监控和日志

实时日志

docker-compose logs -f buffer-platform

容器资源监控

docker stats futures-buffer-platform

日志位置

• 容器内：/app/logs/
• 宿主机：./logs/

🗄️ 数据备份

备份数据库

docker cp futures-buffer-platform:/app/data/buffer.db ./backup_buffer.db

恢复数据库

docker cp ./backup_buffer.db futures-buffer-platform:/app/data/buffer.db
docker-compose restart

🎯 生产环境建议

1. 修改默认端口：避免端口冲突
2. 配置日志轮转：在docker-compose.yml中添加：

   logging:
     driver: "json-file"
     options:
       max-size: "10m"
       max-file: "3"
   

3. 数据卷备份：定期备份data目录
4. 监控资源：使用docker stats监控资源使用
5. 设置重启策略：已配置为 unless-stopped

📞 技术支持

如遇问题，请检查：

1. Docker Desktop是否正常运行
2. 端口9600是否被占用
3. 查看容器日志：docker-compose logs
4. 检查健康状态：docker-compose ps