一、系统简介
TradingAgents-CN 是一个基于 多智能体架构 的 AI 股票分析系统，面向中文用户优化，支持多维度股票研究与智能分析。
系统核心能力包括：
- 15+ AI 模型支持：兼容多种大模型服务商。
- 多维度股票分析：覆盖 基本面分析、技术面分析、新闻分析、社交媒体分析。
- 实时数据接入：支持 AKShare、Tushare、BaoStock 等数据源。
- 现代化 Web 界面：前端采用 Vue 3 + Element Plus。
- 一键部署：通过 Docker Compose 快速启动完整服务。
对于普通用户来说，使用 Docker Compose 部署的最大优势是：不用手动安装复杂依赖，只需要配置好环境变量，就可以快速运行整套系统。
二、部署架构
本次部署采用 Nginx 统一入口 的架构。
整体服务由以下组件组成：
- Nginx：统一访问入口，默认监听 80 端口。
- Frontend：前端服务，基于 Vue 3 构建。
- Backend：后端服务，基于 FastAPI，内部端口为 8000。
- MongoDB：用于存储股票数据、系统配置、分析报告等。
- Redis：用于缓存、任务状态和性能优化。
访问路径设计：
/：访问前端页面。/api：通过 Nginx 转发到后端 FastAPI 服务。
这种架构可以让用户只访问一个地址，例如：
http://localhost即可使用完整系统。
三、部署流程总览
完整部署流程可以分为六个阶段：
- 环境准备：安装 Docker 和 Docker Compose。
- 下载部署文件：获取 Compose 文件、环境变量文件和 Nginx 配置。
- 配置系统参数：重点配置 API 密钥 和数据源 Token。
- 启动服务：使用 Docker Compose 拉取镜像并启动容器。
- 初始化数据：导入系统配置并创建默认管理员账号。
- 访问系统：登录后台，检查模型配置和数据源配置。
四、部署前准备
1. 硬件要求
建议配置如下：
- CPU：最低 2 核，推荐 4 核及以上。
- 内存：最低 4GB，推荐 8GB 及以上。
- 磁盘空间：最低 20GB，推荐 50GB 及以上。
如果需要长期同步大量历史行情数据，建议预留更大的磁盘空间。
2. 系统要求
支持的系统包括：
- Windows 10 / Windows 11
- Ubuntu 20.04+
- CentOS 7+
- macOS Intel
- macOS Apple Silicon
3. 软件要求
需要提前安装：
- Docker 20.10+
- Docker Compose 2.0+
可以通过以下命令检查：
docker --version
docker compose version部分旧环境可能使用：
docker-compose --version如果你的系统支持 docker compose，优先使用新版命令。
五、最容易遗漏的关键步骤
部署过程中，最容易出问题的地方主要有四个。
1. 忘记配置 API 密钥
如果没有配置 API 密钥，系统可以启动，但 AI 分析功能无法正常使用。
至少建议配置一个可用模型服务，例如：
- DASHSCOPE_API_KEY
- DEEPSEEK_API_KEY
- OPENAI_API_KEY
2. 忘记导入初始配置
服务启动后，还需要执行初始化脚本，导入系统配置并创建默认管理员账号。
如果跳过这一步，可能会出现：
- 无法登录后台。
- 没有默认管理员账号。
- LLM 服务商配置缺失。
3. macOS Apple Silicon 用错 Compose 文件
如果使用的是 M 系列芯片 Mac，需要使用 ARM 专用文件：
docker-compose.hub.nginx.arm.yml不要误用普通版本的 Compose 文件。
4. 没有验证 Docker 是否正常
部署前建议先确认 Docker 正常运行，否则后续启动服务时容易出现镜像拉取失败、容器无法启动等问题。
六、Windows 快速部署
Windows 用户建议使用 PowerShell 操作。
1. 创建部署目录
mkdir $env:USERPROFILE\tradingagents-demo
cd $env:USERPROFILE\tradingagents-demo2. 下载部署文件
需要准备以下文件：
- docker-compose.hub.nginx.yml
- .env
- nginx/nginx.conf
其中 .env 通常由 .env.docker 复制或下载后改名得到。
3. 配置环境变量
编辑 .env 文件，至少配置一个 AI 模型 API Key。
示例：
DASHSCOPE_API_KEY=your_dashscope_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key
DEEPSEEK_ENABLED=true如果需要使用 Tushare 数据源，可以继续配置：
TUSHARE_TOKEN=your_tushare_token
TUSHARE_ENABLED=true4. 启动服务
docker-compose -f docker-compose.hub.nginx.yml pull
docker-compose -f docker-compose.hub.nginx.yml up -d5. 查看服务状态
docker-compose -f docker-compose.hub.nginx.yml ps确认 frontend、backend、mongodb、redis、nginx 等服务均正常运行。
七、macOS Apple Silicon 部署
如果你使用的是 M1、M2、M3、M4 等 Apple Silicon 芯片，需要使用 ARM 版本部署文件。
核心文件为：
docker-compose.hub.nginx.arm.yml启动命令示例：
docker-compose -f docker-compose.hub.nginx.arm.yml pull
docker-compose -f docker-compose.hub.nginx.arm.yml up -d其他步骤与普通部署基本一致，包括：
- 配置
.env - 下载
nginx.conf - 启动服务
- 执行初始化脚本
- 访问系统
八、Linux / macOS Intel 部署
Linux 和 macOS Intel 用户可以使用普通 Compose 文件。
mkdir -p ~/tradingagents-demo
cd ~/tradingagents-demo启动服务：
docker-compose -f docker-compose.hub.nginx.yml pull
docker-compose -f docker-compose.hub.nginx.yml up -d查看状态：
docker-compose -f docker-compose.hub.nginx.yml ps九、配置 API 密钥
API 密钥配置 是整个部署中最关键的一步。
常用配置项如下：
DASHSCOPE_API_KEY=your_dashscope_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key
DEEPSEEK_ENABLED=true
OPENAI_API_KEY=your_openai_api_key
OPENAI_ENABLED=true
TUSHARE_TOKEN=your_tushare_token
TUSHARE_ENABLED=true推荐至少配置一个大模型服务商，否则系统无法执行 AI 分析任务。
常见密钥来源：
| 服务 | 用途 |
|---|---|
| 阿里百炼 / DashScope | 国内大模型调用 |
| DeepSeek | 中文分析和推理任务 |
| OpenAI | GPT 系列模型调用 |
| Tushare | 股票基础数据和行情数据 |
十、启动服务与初始化数据
服务启动后，需要进入后端容器执行初始化脚本。
docker exec -it tradingagents-backend python scripts/import_config_and_create_user.py初始化过程通常会完成：
- 导入 系统配置
- 导入 LLM 服务商配置
- 创建默认管理员用户
- 初始化基础参数
默认账号通常为：
用户名：admin
密码：admin123首次登录后，强烈建议立即修改默认密码。
十一、访问系统
部署完成后，在浏览器中访问：
http://localhost首次进入系统后，建议按以下顺序检查：
- 修改默认管理员密码。
- 检查 LLM 配置 是否生效。
- 检查 数据源配置 是否正常。
- 尝试运行一次股票分析任务。
- 查看日志确认后端服务无异常。
十二、端口说明
默认端口如下：
| 服务 | 端口 | 说明 |
|---|---|---|
| Nginx | 80 | 统一访问入口 |
| Backend / FastAPI | 8000 | 后端内部服务 |
| Frontend | 80 | 前端容器内部端口 |
| MongoDB | 27017 | 数据库服务 |
| Redis | 6379 | 缓存服务 |
如果本机 80 端口 被占用，可以将 Nginx 映射端口改为 8080，然后通过以下地址访问：
http://localhost:8080十三、数据持久化与备份
系统中的关键数据主要保存在 MongoDB 和 Redis 对应的数据卷中。
建议定期备份：
- MongoDB 数据
- 系统配置
- 分析报告
- 用户配置
- 日志文件
常见备份方式：
docker exec tradingagents-mongodb mongodump --out /backup恢复时可使用：
docker exec tradingagents-mongodb mongorestore /backup如果是生产环境部署，建议将备份目录挂载到宿主机或外部存储中。
十四、常见问题排查
1. 服务启动失败
先查看容器状态：
docker-compose -f docker-compose.hub.nginx.yml ps查看日志：
docker-compose -f docker-compose.hub.nginx.yml logs -f重点关注 backend、nginx、mongodb、redis 是否正常启动。
2. 无法访问页面
可能原因包括：
- 80 端口被占用
- Docker Desktop 未正常运行
- Nginx 容器启动失败
- 防火墙拦截
- Compose 文件端口配置错误
可以尝试将端口改为 8080 后重新启动。
3. API 请求失败
重点检查：
- 后端容器是否运行正常。
- Nginx 是否正确转发
/api。 .env配置是否正确。- 后端日志是否有异常。
4. MongoDB 连接失败
可以检查 MongoDB 容器状态：
docker-compose -f docker-compose.hub.nginx.yml logs mongodb如果数据库异常，可以尝试重启：
docker-compose -f docker-compose.hub.nginx.yml restart mongodb5. 内存不足
如果机器内存较小，可能出现容器退出或响应缓慢。
可以查看资源占用：
docker stats建议为 Docker Desktop 分配至少 4GB 内存，更推荐 8GB 及以上。
十五、进阶配置
1. 配置自定义域名
可以在 Nginx 中配置自己的域名，例如：
server_name your-domain.com;然后将域名解析到服务器 IP。
2. 配置 HTTPS
生产环境建议使用 HTTPS。
可以通过 Let’s Encrypt + Certbot 申请免费证书，并在 Nginx 中配置 SSL。
3. Redis 优化
可以为 Redis 配置：
- 持久化策略
- 最大内存限制
- 缓存淘汰策略
例如：
maxmemory-policy allkeys-lru4. MongoDB 优化
当数据量增加后，建议为常用字段建立索引，例如：
- 股票代码
- 日期
- 数据源
- 报告 ID
- 用户 ID
这样可以提升查询速度和筛选性能。
5. 日志轮转
生产环境建议配置 logrotate，避免日志文件持续增大占满磁盘。
十六、系统监控与维护
日常维护建议关注以下内容：
查看服务状态
docker-compose -f docker-compose.hub.nginx.yml ps查看资源占用
docker stats查看日志
docker-compose -f docker-compose.hub.nginx.yml logs -f backend更新镜像
docker-compose -f docker-compose.hub.nginx.yml pull
docker-compose -f docker-compose.hub.nginx.yml up -d停止服务
docker-compose -f docker-compose.hub.nginx.yml down清空数据并重置
谨慎使用：
docker-compose -f docker-compose.hub.nginx.yml down -v该操作会删除数据卷，可能导致数据库数据丢失。
十七、总结
通过 Docker Compose 部署 TradingAgents-CN v1.0.0-preview，可以快速搭建一套完整的 AI 股票分析系统。
本教程覆盖了从环境准备到系统启动的完整流程，包括：
- Docker 与 Docker Compose 安装检查
- Windows、Linux、macOS、Apple Silicon 部署差异
- API 密钥配置
- Nginx、FastAPI、MongoDB、Redis 架构说明
- 初始化配置与默认账号登录
- 常见问题排查
- 数据持久化、备份恢复与进阶维护
对于新用户来说，最关键的三步是：
- 正确选择对应平台的 Docker Compose 文件。
- 在
.env中配置可用的 API 密钥。 - 启动服务后执行 初始化脚本。
完成以上步骤后，即可通过浏览器访问系统，开始使用 TradingAgents-CN 进行智能股票分析。
✅ 官方唯一渠道：📦 GitHub 仓库：https://github.com/hsliuping/TradingAgents-CN
Aekor AI-API 中转站，让全球顶尖 AI 大模型“触手可及”！你是否曾为这些烦恼头疼？
🔹 人在国内，却总被海外官网 API 的高延迟、掉线、甚至无法访问困扰？
🔹 想用最强的 GPT、Claude 等模型，却卡在海外信用卡、支付审核等重重阻碍？
🔹 官方 API 太贵？Aekor 为你打通“网络-支付-成本”的任督二脉！
💡 Aekor 核心价值：好用、便宜、快 💡
🚀 高速稳定，告别掉线国内专线加速，API 响应低延迟，告别「转圈圈」的焦虑，开发效率瞬间拉满！
🧠 顶尖模型，随需而调涵盖 GPT 系列、Claude 系列等全球主流大厂模型，一次接入，轻松调用！
🎁 免费白嫖，诚意拉满！
注册即送 20 美元体验额度，够你狠狠测试一轮模型质量与线路稳定性了！
⚠️ 温馨提示：API 中转市场虽多但良莠不齐（甚至有些会偷工减料换小模型糊弄事儿）。Aekor 坚持提供正版稳定的服务，但还是建议：先用免费的 20 刀测试是否契合自身需求，满意了再小额充值上车，理性消费不盲目。
文章评论