AI Market Maker生产环境部署完整指南：Docker Compose一键搭建AI交易Dashboard-育师

AI Market Maker生产环境部署完整指南：Docker Compose一键搭建AI交易Dashboard

【免费下载链接】ai-market-makerAgentic AI Hedge Fund OS (AIMM)项目地址: https://gitcode.com/gh_mirrors/ai/ai-market-maker

AI Market Maker（AIMM）是一个面向加密对冲基金的 Agentic AI 交易系统，通过 Docker Compose + Postgres + Dashboard 的组合，一条命令即可搭建完整的生产环境。本指南带你从环境准备到面板访问，快速跑起多智能体交易平台的 API、Worker、数据库与可视化控制台。

📌 上图展示了 AIMM 的核心工作流：从 Research Desks（研究台）→ Alpha Generation（信号合成）→ Portfolio Management（组合管理）→ Risk Guard（硬性风控）→ Execution（执行），这正是本部署指南要落地的完整生产栈。

🎯 部署前你需要了解的 4 个组件

在生产模式下，AIMM 由 4 个协同工作的容器组成，理解它们的职责能帮你更好地排错：

组件	作用	端口
Postgres	存储回测结果、信号、关注、收件箱、执行记录	5432（容器内）
API 服务	FastAPI 后端，提供全部业务接口	8001
Worker	后台任务分发 + 可选自动执行	—
Web Dashboard	Next.js 可视化控制台	3000

这套栈定义在 docker-compose.prod.yml，官方生产部署说明见 PRODUCTION.md。

📦 环境准备：一键安装依赖

1. 克隆仓库

git clone https://gitcode.com/gh_mirrors/ai/ai-market-maker cd ai-market-maker

2. 配置环境变量文件

在项目根目录（docker-compose.prod.yml同级）创建.env文件。你可以参考模板 .env.example，生产环境必须填入真实值：

# 数据库密码（务必替换默认值） POSTGRES_PASSWORD=change-me-to-a-strong-password DATABASE_URL=postgresql+psycopg://aimm:change-me-to-a-strong-password@db:5432/aimm # 鉴权密钥（生产环境必填，不要用开发默认值） AIMM_ENV=production AIMM_AUTH_SECRET=这里换成你的长随机字符串 # Web → API 内部通信地址 FLOW_API_BASE_URL=http://api:8001 # CORS：设置为你的面板真实来源 AIMM_CORS_ORIGINS=http://localhost:3000 # Worker 配置（默认不自动执行，最安全） PLATFORM_WORKER_AUTO_EXECUTE=0 PLATFORM_WORKER_INTERVAL_SEC=2.0

⚠️安全提示：AIMM_AUTH_SECRET和POSTGRES_PASSWORD是生产部署的两个关键安全项。官方文档明确要求生产环境不要使用开发回退值（见 PRODUCTION.md）。

🚀 一键启动：Docker Compose 完整搭建

启动整个生产栈

只需一条命令，Docker 会自动构建镜像并拉起全部 4 个服务：

docker compose -f docker-compose.prod.yml up -d --build

执行成功后，你会看到db、api、worker、web四个容器进入running状态。API 容器使用 Dockerfile.api 构建，Worker 使用 Dockerfile.worker 构建，Web 控制台基于 web/Dockerfile 构建。

首次运行数据库迁移

生产配置中禁用了数据库自动建表（AIMM_DB_AUTOCREATE=0），因此首次启动后必须手动执行迁移：

docker compose -f docker-compose.prod.yml run --rm api alembic upgrade head

这条命令会应用 alembic/versions/ 中的全部表结构变更，建议每次发版后再执行一次。

🖥️ 打开 Dashboard 可视化控制台

服务启动完成后，在浏览器访问：

http://localhost:3000/leaderboard— 回测结果 + 信号看板
http://localhost:3000/console— Nexus 交易控制台
http://localhost:3000/get-started— 本地配置引导
http://localhost:3000/tools— 工具浏览器

💡新手提示：首次启动时 Leaderboard / Signals 可能是空的，这是正常的。你只需在 Nexus → Research 中跑一次回测，或发布一次 provider 结果，看板就会自动填充数据。

🔌 生产环境运维与健康检查

部署后你可以用以下接口快速验证系统是否健康：

接口	说明
`GET /health`	API 健康检查
`GET /runs/latest/payload`	最新一次运行的完整负载
`GET /leadpage/leaderboard`	排行榜数据
`GET /signals/feed`	信号流

curl http://localhost:8001/health # → {"status": "ok", ...}

🔒 生产环境安全清单

公开部署前，请逐项核对这份来自 PRODUCTION.md 的安全清单：

✅ 设置强AIMM_AUTH_SECRET并妥善保密
✅ 将 API 置于带 TLS 的反向代理之后
✅ 将AIMM_CORS_ORIGINS设为真实面板来源，而非*
✅ 若对公网开放，设置AIMM_API_KEY并限制网络入站
✅ 保持PLATFORM_WORKER_AUTO_EXECUTE=0，除非你明确需要自动执行

🧩 可选：Leaderboard 公共服务栈

如果你只想对外提供一个轻量的排行榜/信号站点（让用户从本地提交结果），而不是跑完整交易栈，可以使用独立的 docker-compose.leaderboard.yml：

# 仅 API + 数据库（最轻量） docker compose -f docker-compose.leaderboard.yml up -d --build # 附带 web-v2 门户 UI docker compose -f docker-compose.leaderboard.yml --profile web up -d --build

详细配置说明与 provider key 格式见 docs/leaderboard-hosting.md。