aiagents-stock/docs/DOCKER_README.md

🐳 Docker 部署快速指南

本文档是Docker部署的快速参考指南。完整文档请查看 DOCKER_DEPLOYMENT.md。

🎯 为什么选择Docker部署？

• ✅ 零环境配置：无需安装Python、Node.js等环境
• ✅ 一键启动：简单命令即可运行
• ✅ 环境隔离：不影响系统其他软件
• ✅ 跨平台：Windows/macOS/Linux统一部署方式
• ✅ 稳定可靠：容器自动重启，故障自动恢复

⚡ 5分钟快速开始

1️⃣ 安装Docker

Windows/macOS:

• 下载 Docker Desktop
• 双击安装，启动Docker Desktop

Linux:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

2️⃣ 配置环境变量

# 复制配置模板
cp .env.template .env

# 编辑 .env 文件，填入你的 DeepSeek API Key
# DEEPSEEK_API_KEY=sk-your-actual-api-key-here

3️⃣ 启动服务

# 一键启动
docker-compose up -d

# 查看日志（可选）
docker-compose logs -f

4️⃣ 访问系统

打开浏览器访问：http://localhost:8503

🎮 常用命令

# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

# 重启服务
docker-compose restart

# 查看日志
docker-compose logs -f

# 查看运行状态
docker ps

# 进入容器（调试用）
docker exec -it agentsstock1 bash

📁 项目结构

agentsstock1/
├── Dockerfile              # Docker镜像构建文件
├── docker-compose.yml      # Docker编排配置
├── .dockerignore          # Docker构建忽略文件
├── .env.template          # 环境变量模板
├── .env                   # 环境变量配置（需自己创建）
├── DOCKER_DEPLOYMENT.md   # 详细部署文档
├── DOCKER_CHECKLIST.md    # 部署检查清单
└── README.md              # 项目主文档

🔑 关键特性

Node.js 环境集成

Docker镜像已内置Node.js 18.x环境，支持pywencai等需要Node.js的Python包。

数据持久化

以下数据会自动保存到宿主机：

• stock_analysis.db - 分析历史数据库
• stock_monitor.db - 监测数据库
• data/ - 临时数据目录

即使删除容器，数据也不会丢失。

健康检查

容器会自动监控应用健康状态，异常时自动重启。

🐛 快速故障排除

问题1: 容器启动失败

# 查看详细日志
docker-compose logs

# 检查 .env 文件是否存在并配置正确
cat .env

问题2: 无法访问网页

# 检查容器是否运行
docker ps

# 检查端口映射
docker port agentsstock1

# 尝试从容器内访问
docker exec agentsstock1 curl http://localhost:8501

问题3: 端口被占用

修改 docker-compose.yml 文件：

ports:
  - "8502:8501"  # 改用8502端口

问题4: 数据库权限错误（Linux/macOS）

chmod 666 *.db
chmod 777 data/

🔄 更新和维护

更新代码

# 停止服务
docker-compose down

# 拉取最新代码
git pull

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

清理和重置

# 完全清理（包括volumes）
docker-compose down -v

# 删除镜像
docker rmi agentsstock1:latest

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

备份数据

# 备份数据库文件
cp stock_analysis.db stock_analysis.db.backup
cp stock_monitor.db stock_monitor.db.backup

📊 性能监控

# 查看资源使用
docker stats agentsstock1

# 查看容器详情
docker inspect agentsstock1

# 查看日志大小
docker logs agentsstock1 2>&1 | wc -l

🔒 安全建议

1. 保护.env文件

   # Linux/macOS - 设置文件权限
   chmod 600 .env
   

2. 不要提交敏感信息

   • .env 文件已在 .gitignore 中
   • 不要将API Key提交到版本控制

3. 定期更新

   # 更新Docker镜像
   docker-compose pull
   docker-compose up -d
   

🌐 生产环境部署

对于生产环境，建议：

1. 使用反向代理（Nginx/Caddy）
2. 配置HTTPS证书
3. 设置防火墙规则
4. 配置日志轮转
5. 定期备份数据库
6. 监控容器状态

示例Nginx配置：

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:8501;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

📚 更多资源

• 完整部署文档: DOCKER_DEPLOYMENT.md
• 部署检查清单: DOCKER_CHECKLIST.md
• 项目主文档: README.md
• Docker官方文档: https://docs.docker.com/

🆘 获取帮助

遇到问题？

1. 查看日志：docker-compose logs -f
2. 查看完整文档：DOCKER_DEPLOYMENT.md
3. 检查部署清单：DOCKER_CHECKLIST.md
4. 联系支持：ws3101001@126.com

---

Docker让部署更简单！祝您使用愉快！ 🚀🐳