TradingAgents-CN v2.0 Docker 环境快速部署指南

2026-02-09 16212点热度 0人点赞 0条评论

本项目官网：https://www.tradingagentscn.com

这篇指南面向希望快速部署 TradingAgents-CN v2.0 的用户，覆盖从 Docker 环境准备、一键部署、自动初始化 到 常见问题排查、进阶配置 和 运维维护 的完整流程。

如果你想在 Windows、Linux、macOS 上快速搭建可用环境，并尽量减少手工配置成本，这份文档可以直接作为操作参考。

一、部署架构

TradingAgents-CN v2.0 采用容器化部署方案，核心组件包括：

Nginx：统一入口，监听 8082 端口
Frontend：基于 Vue 3 的前端静态资源
Backend：基于 FastAPI 的后端服务，内部端口 8000
MongoDB：用于数据持久化，默认端口 27017
Redis：用于缓存加速，默认端口 6379

用户只需要访问：

http://服务器IP:8082

即可使用完整系统。
其中，Nginx 会自动处理前端页面和 API 请求路由，前端访问和后端接口调用都通过统一入口完成。

二、部署流程总览

在开始前，建议先了解完整流程，避免遗漏关键步骤。

第一阶段：环境准备

安装 Docker / Docker Compose / wget
验证 Docker 是否可正常运行

第二阶段：一键部署

下载部署脚本 deploy.sh 或 deploy.ps1
运行脚本，自动完成配置下载、目录创建、端口配置、镜像拉取和服务启动

第三阶段：自动初始化

v2.0 首次启动后会自动导入配置并创建默认用户
无需手动执行初始化脚本

第四阶段：访问系统

通过浏览器访问系统并登录

三、前置要求

硬件要求

组件	最低配置	推荐配置
CPU	2 核	4 核及以上
内存	4 GB	8 GB 及以上
磁盘	20 GB	50 GB 及以上
网络	10 Mbps	100 Mbps 及以上

软件要求

Windows 10+，推荐 Windows 11
Linux：Ubuntu 20.04+、CentOS 7+
macOS：Intel 或 Apple Silicon（M1/M2/M3）
Docker：20.10+
Docker Compose：2.0+

验证安装

docker --version
docker compose version
docker ps

如果以上命令能正常执行，说明基础环境已准备完成。

四、快速开始

Windows 用户

# 1. 创建项目目录
New-Item -ItemType Directory -Path "$env:USERPROFILE\tradingagents-demo-v2" -Force
Set-Location "$env:USERPROFILE\tradingagents-demo-v2"

# 2. 下载一键部署脚本
Invoke-WebRequest -Uri "https://www.tradingagentscn.com/docker/deploy.ps1" -OutFile "deploy.ps1"

# 3. 允许脚本执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 4. 运行部署脚本
./deploy.ps1

Linux 用户

# 1. 创建项目目录
mkdir -p ~/tradingagents-v2
cd ~/tradingagents-v2

# 2. 下载一键部署脚本
curl -O https://www.tradingagentscn.com/docker/deploy.sh

# 3. 运行部署脚本
chmod +x deploy.sh
./deploy.sh

macOS 用户

# 1. 创建项目目录
mkdir -p ~/tradingagents-v2
cd ~/tradingagents-v2

# 2. 下载一键部署脚本
curl -O https://www.tradingagentscn.com/docker/deploy.sh

# 3. 运行部署脚本
chmod +x deploy.sh
./deploy.sh

默认访问方式

本地部署：http://localhost:8082
服务器部署：http://你的服务器IP:8082
默认账号：admin
默认密码：admin123

登录后请立即修改默认密码。

五、详细步骤

步骤 1：准备服务器

Linux 服务器

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装 Docker
curl -fsSL https://get.docker.com | bash -s docker

# 启动 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker

# 将当前用户加入 docker 组
sudo usermod -aG docker $USER

完成后建议重新登录终端会话。

Windows 服务器

下载并安装 Docker Desktop for Windows
启动 Docker Desktop
打开 PowerShell，建议使用管理员模式

macOS

下载并安装 Docker Desktop for Mac
Apple Silicon 请选择 Apple Chip 版本
Intel 芯片请选择 Intel Chip 版本
启动 Docker Desktop 后打开终端

步骤 2：运行一键部署脚本

Windows 用户

# 创建项目目录
New-Item -ItemType Directory -Path "$env:USERPROFILE\tradingagents-v2" -Force
Set-Location "$env:USERPROFILE\tradingagents-v2"

# 下载一键部署脚本
Invoke-WebRequest -Uri "https://www.tradingagentscn.com/docker/deploy.ps1" -OutFile "deploy.ps1"

# 允许脚本执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 运行部署脚本
./deploy.ps1

Linux / macOS 用户

# 创建项目目录
mkdir -p ~/tradingagents-demo-v2
cd ~/tradingagents-demo-v2

# 下载一键部署脚本
curl -O https://www.tradingagentscn.com/docker/deploy.sh

# 运行部署脚本
chmod +x deploy.sh
./deploy.sh

脚本会自动完成：

端口配置
配置文件下载
目录创建
镜像拉取
容器启动

步骤 3：检查服务状态

docker-compose -f docker-compose.compiled.yml ps

预期结果类似：

NAME	IMAGE	STATUS
tradingagents-backend-pro	hsliup/tradingagents-pro-backend:latest	Up (healthy)
tradingagents-frontend-pro	hsliup/tradingagents-pro-frontend:latest	Up (healthy)
tradingagents-mongodb-pro	mongo:4.4	Up (healthy)
tradingagents-nginx-pro	nginx:alpine	Up
tradingagents-redis-pro	redis:7-alpine	Up (healthy)

Windows 用户注意事项

如果提示 docker-compose: command not found，请使用 docker compose
确保 Docker Desktop 已启动
如果 8082 被占用，请检查是否有其他程序占用了该端口

步骤 4：验证自动初始化

v2.0 首次启动会自动执行初始化，无需手动执行脚本。

查看初始化日志

Windows PowerShell：

docker-compose -f docker-compose.compiled.yml logs backend | Select-String -Pattern "初始化|init|import|admin|首次启动"
docker-compose -f docker-compose.compiled.yml logs backend

Linux / macOS：

docker-compose -f docker-compose.compiled.yml logs backend | grep -i "初始化\|init\|import\|admin\|首次启动"
docker-compose -f docker-compose.compiled.yml logs backend

预期输出示例

🚀 首次启动检测到，开始初始化数据库...
✅ MongoDB 连接成功
✅ Redis 连接成功
📦 开始导入配置数据并创建默认用户...
✅ 数据库初始化完成！
📋 默认登录信息:
   用户名: admin
   密码: admin123

验证初始化是否成功

docker exec tradingagents-backend-pro ls -la /app/runtime/.config_imported

如果该文件存在，说明初始化成功。

如果自动初始化失败

docker exec -it tradingagents-backend-pro python scripts/import_config_and_create_user.py
docker exec -it tradingagents-backend-pro python scripts/import_config_and_create_user.py --overwrite

说明：

v2.0 会自动检测首次启动并执行初始化
如果标记文件 /app/runtime/.config_imported 存在，会跳过初始化
所有配置都已经内置在 Docker 镜像中，无需手动下载

步骤 5：访问系统

打开浏览器访问：

Windows 本地部署：http://localhost:8082
服务器部署：http://你的服务器IP:8082

默认登录信息：

用户名：admin
密码：admin123

首次登录后建议优先完成以下操作：

修改默认密码
检查 LLM 配置
运行一次简单分析任务
配置 数据源

六、配置说明

目录结构

Windows 用户

C:\Users\你的用户名\tradingagents-demo-v2\
├── docker-compose.compiled.yml
├── .env
├── nginx\
│   └── nginx-proxy.conf
├── logs\
├── data\
├── runtime\
└── config\

Linux / macOS 用户

~/tradingagents-demo-v2/
├── docker-compose.compiled.yml
├── .env
├── nginx/
│   └── nginx-proxy.conf
├── logs/
├── data/
├── runtime/
└── config/

说明：

初始配置数据已经内置在 Docker 镜像中
logs/、data/、runtime/、config/ 会在首次启动时自动创建
runtime/.config_imported 用于标记是否完成初始化

端口说明

服务	容器内端口	宿主机端口	说明
Nginx	8082	8082	统一入口，处理前端和 API
Backend	8000	-	内部端口，通过 Nginx 访问
Frontend	80	-	内部端口，通过 Nginx 访问
MongoDB	27017	27017	数据库，可选暴露
Redis	6379	6379	缓存，可选暴露

默认使用 8082 端口，尽量避免与系统服务冲突。

数据持久化

系统通过 Docker Volume 和目录挂载方式保存数据。

Windows 用户

docker volume ls | Select-String tradingagents

docker run --rm -v tradingagents_mongodb_data:/data -v ${PWD}:/backup alpine tar czf /backup/mongodb_backup.tar.gz /data

docker run --rm -v tradingagents_mongodb_data:/data -v ${PWD}:/backup alpine tar xzf /backup/mongodb_backup.tar.gz -C /

Linux / macOS 用户

docker volume ls | grep tradingagents

docker run --rm -v tradingagents_mongodb_data:/data -v $(pwd):/backup alpine tar czf /backup/mongodb_backup.tar.gz /data

docker run --rm -v tradingagents_mongodb_data:/data -v $(pwd):/backup alpine tar xzf /backup/mongodb_backup.tar.gz -C /

七、常见问题

1. 服务启动失败

如果 docker-compose up 报错，可以先查看日志：

docker-compose -f docker-compose.compiled.yml logs
docker-compose -f docker-compose.compiled.yml logs backend
docker-compose -f docker-compose.compiled.yml restart

2. 无法访问系统

如果浏览器无法打开 http://localhost:8082 或 http://服务器IP:8082，可以按平台排查。

Windows

docker-compose -f docker-compose.compiled.yml ps
netstat -ano | findstr :8082

同时确认 Docker Desktop 是否正在运行。

Linux

docker-compose -f docker-compose.compiled.yml ps
sudo netstat -tulpn | grep :8082
sudo ufw status
sudo firewall-cmd --list-all
sudo ufw allow 8082
sudo firewall-cmd --add-port=8082/tcp --permanent && sudo firewall-cmd --reload

macOS

docker-compose -f docker-compose.compiled.yml ps
lsof -i :8082

如果 8082 被占用，可以把 8082:8082 改成 8080:8082，然后访问 http://localhost:8080。

3. 自动初始化失败

如果日志显示初始化失败，无法登录系统，可以这样处理：

docker-compose -f docker-compose.compiled.yml logs backend | grep -i "初始化\|init\|import\|error"
docker-compose -f docker-compose.compiled.yml ps mongodb
docker exec -it tradingagents-backend-pro python scripts/import_config_and_create_user.py
docker exec tradingagents-backend-pro ls -la /app/runtime/.config_imported
docker exec tradingagents-backend-pro rm /app/runtime/.config_imported
docker-compose -f docker-compose.compiled.yml restart backend

4. API 请求失败

如果前端显示“网络错误”或“API 请求失败”，请检查后端和 Nginx 日志。

Windows

docker logs tradingagents-backend-pro
docker logs tradingagents-nginx-pro
Invoke-WebRequest -Uri "http://localhost:8000/api/health"
curl http://localhost:8000/api/health

Linux / macOS

docker logs tradingagents-backend-pro
docker logs tradingagents-nginx-pro
curl http://localhost:8000/api/health

5. 数据库连接失败

如果后端日志显示 MongoDB connection failed：

docker exec -it tradingagents-mongodb-pro mongo -u admin -p tradingagents123 --authenticationDatabase admin
docker-compose -f docker-compose.compiled.yml restart mongodb
docker volume inspect tradingagents_mongodb_data

6. 内存不足

如果系统运行缓慢或容器被杀死，可以检查资源占用并清理无用资源。

Windows

docker stats
docker system prune -a

然后在 Docker Desktop 中调整内存限制：

打开 Docker Desktop
点击 Settings → Resources → Advanced
将 Memory 调整到至少 4GB
点击 Apply & Restart

Linux / macOS

docker stats
docker system prune -a

必要时可以给容器限制内存：

services:
  backend:
    deploy:
      resources:
        limits:
          memory: 2G

八、进阶配置

1. 使用自定义域名

编辑 nginx/nginx-proxy.conf：

server {
    listen 8082;
    server_name your-domain.com;

    # 其他配置保持不变
}

配置 DNS 解析后，重启 Nginx：

docker-compose -f docker-compose.compiled.yml restart nginx

2. 启用 HTTPS

推荐使用 Let’s Encrypt：

sudo apt install certbot
sudo certbot certonly --standalone -d your-domain.com

然后修改 nginx/nginx-proxy.conf：

server {
    listen 443 ssl http2;
    server_name your-domain.com;

    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
}

再将 HTTP 重定向到 HTTPS：

server {
    listen 8082;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

并在 docker-compose.compiled.yml 中挂载证书目录。

3. 性能优化

启用 Redis 持久化

services:
  redis:
    command: redis-server --appendonly yes --requirepass tradingagents123 --maxmemory 2gb --maxmemory-policy allkeys-lru

MongoDB 索引优化

docker exec -it tradingagents-mongodb-pro mongo -u admin -p tradingagents123 --authenticationDatabase admin

use tradingagents
db.market_quotes.createIndex({code: 1, timestamp: -1})
db.stock_basic_info.createIndex({code: 1})
db.analysis_results.createIndex({user_id: 1, created_at: -1})

日志轮转

创建 logrotate 配置：

sudo nano /etc/logrotate.d/tradingagents

内容示例：

/path/to/tradingagents-demo-v2/logs/*.log {
    daily
    rotate 7
    compress
    delaycompress
    missingok
    notifempty
}

九、监控和维护

查看系统状态

docker-compose -f docker-compose.compiled.yml ps
docker stats
docker-compose -f docker-compose.compiled.yml logs -f --tail=100

备份数据

docker exec -it tradingagents-backend-pro python scripts/export_config.py
docker cp tradingagents-backend-pro:/app/data/export_*.json ./backup/

更新系统

docker-compose -f docker-compose.compiled.yml pull
docker-compose -f docker-compose.compiled.yml up -d

清理和重置

docker-compose -f docker-compose.compiled.yml down
docker-compose -f docker-compose.compiled.yml down -v
docker image prune -a

注意：down -v 会删除所有数据，请提前备份。

十、总结

通过这份 TradingAgents-CN v2.0 Docker 环境快速部署指南，你应该能够完成以下目标：

在约 5 分钟 内完成系统部署
理解 v2.0 自动初始化 的工作方式
正确配置 AI 模型 和 数据源
排查常见部署问题
完成基础监控、备份和维护

✅ 官方唯一渠道：📦 GitHub 仓库：https://github.com/hsliuping/TradingAgents-CN

Aekor AI-API 中转站，让全球顶尖 AI 大模型“触手可及”！你是否曾为这些烦恼头疼？

🔹 人在国内，却总被海外官网 API 的高延迟、掉线、甚至无法访问困扰？

🔹 想用最强的 GPT、Claude 等模型，却卡在海外信用卡、支付审核等重重阻碍？

🔹 官方 API 太贵？Aekor 为你打通“网络-支付-成本”的任督二脉！

💡 Aekor 核心价值：好用、便宜、快 💡

🚀 高速稳定，告别掉线国内专线加速，API 响应低延迟，告别「转圈圈」的焦虑，开发效率瞬间拉满！

🧠 顶尖模型，随需而调涵盖 GPT 系列、Claude 系列等全球主流大厂模型，一次接入，轻松调用！

🎁 免费白嫖，诚意拉满！

注册即送 20 美元体验额度，够你狠狠测试一轮模型质量与线路稳定性了！

🚪 入口：https://api.aekor.com

⚠️ 温馨提示：API 中转市场虽多但良莠不齐（甚至有些会偷工减料换小模型糊弄事儿）。Aekor 坚持提供正版稳定的服务，但还是建议：先用免费的 20 刀测试是否契合自身需求，满意了再小额充值上车，理性消费不盲目。

本作品采用知识共享署名 4.0 国际许可协议进行许可

TradingAgents-CN v2.0 Docker 环境快速部署指南

一、部署架构

二、部署流程总览

第一阶段：环境准备

第二阶段：一键部署

第三阶段：自动初始化

第四阶段：访问系统

三、前置要求

硬件要求

软件要求

验证安装

四、快速开始

Windows 用户

Linux 用户

macOS 用户

默认访问方式

五、详细步骤

步骤 1：准备服务器

Linux 服务器

Windows 服务器

macOS

步骤 2：运行一键部署脚本

Windows 用户

Linux / macOS 用户

步骤 3：检查服务状态

Windows 用户注意事项

步骤 4：验证自动初始化

查看初始化日志

预期输出示例

验证初始化是否成功

如果自动初始化失败

步骤 5：访问系统

六、配置说明

目录结构

Windows 用户

Linux / macOS 用户

端口说明

数据持久化

Windows 用户

Linux / macOS 用户

七、常见问题

1. 服务启动失败

2. 无法访问系统

Windows

Linux

macOS

3. 自动初始化失败

4. API 请求失败

Windows

Linux / macOS

5. 数据库连接失败

6. 内存不足

Windows

Linux / macOS

八、进阶配置

1. 使用自定义域名

2. 启用 HTTPS

3. 性能优化

启用 Redis 持久化

MongoDB 索引优化

日志轮转

九、监控和维护

查看系统状态

备份数据

更新系统

清理和重置

十、总结

文章评论

使用AI教程

分类