Docker 一键部署开源投研 Agent(以 TradingAgents-CN 为例)

系列·Agent 篇 02 — 装好 Docker、拉起一个多 Agent 研报团队,浏览器里就能让它分析股票

📖 本篇是《AI 投研 Agent 部署》第 2 篇,前置:云服务器开通与远程连接(还没机器先看它)。

01 · 这一步做完你会得到什么

一个跑在你自己服务器上的开源投研 Agent:它内部是一支"虚拟分析师团队"——基本面、新闻情绪、技术面各司其职,互相辩论,最后汇总成一份研报。你只需要在网页里输入股票代码,等几分钟收报告。

本篇以 TradingAgents-CN(对中文用户与 A 股数据源做了适配的多 Agent 项目)为例演示通用流程。开源项目迭代快, 细节以项目 README 为准——但"装 Docker → 克隆 → 配 key → 起服务"这四步骨架对所有同类项目通用。

02 · 装 Docker:两条命令

SSH 登录服务器后执行(官方一键脚本):

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER   # 让当前用户免 sudo 用 docker
# 退出重新登录一次,让用户组生效
docker --version                # 能打印版本号即成功
docker compose version          # compose 插件一般已自带

03 · 克隆项目并配置

git clone https://github.com/hsliuping/TradingAgents-CN.git
cd TradingAgents-CN
cp .env.example .env            # 项目都会给一个环境变量模板
nano .env                       # 编辑配置(不会用 nano 就直接粘贴下面的最小集)

.env 里最少要填两类东西:LLM API Key(没有的话下一篇专门讲怎么申请)和数据源 Token(如 tushare,项目 README 会写清支持哪些)。填完保存,然后:

docker compose up -d            # 后台启动,第一次会拉镜像,耐心等几分钟
docker compose ps               # STATUS 是 Up/running 即成功
docker compose logs -f          # 看实时日志,Ctrl+C 退出(不影响运行)

04 · 打开网页,跑第一次分析

在安全组里放行项目对外端口(README 会写,常见如 8501 或 3000),然后本机浏览器访问http://你的IP:端口。输入一只你熟悉的股票代码点运行——第一次运行顺便校验数据源:它引用的价格、市值,和你行情软件里的对一下,对得上才说明数据接对了。

05 · 日常管理三件套

docker compose restart          # 改了 .env 之后重启生效
docker compose down             # 停止
git pull && docker compose up -d   # 项目更新(更新前看一眼 release notes)

06 · 避坑清单(每条都疼过)

2G 内存起容器卡死 — 部分项目吃内存。加 2G swap 兜底:sudo fallocate -l 2G /swapfile 一套操作(search "ubuntu add swap"),或直接升配 4G。
网页打不开 — 安全组没放行对应端口,是它,九成是它。
镜像拉取慢/超时 — 配一个国内镜像加速器(Docker 官方文档或云厂商都有现成配置),或换个时段重试。
.env 别外泄 — 里面是你的 API Key。chmod 600 .env 收紧权限; 不要把带 key 的 .env 提交到任何公开仓库。
项目停更/接口变了 — 开源项目的宿命。选星数活跃、issue 有人回的项目;部署前看最近提交时间。

🧠 Agent 只是壳,让它真的"懂 A 股"靠数据源和 LLM Key——下一篇专门讲:

下一篇:接入行情数据源与 LLM API →

教程不构成任何投资建议;Agent 产出是研究参考,不是买卖依据。