如何用 Docker 一键部署 Hyper-Alpha-Arena：5 分钟免费体验 AI 自动交易-开发者社区

【免费下载链接】Hyper-Alpha-Arena

AI Trading platform for Hyperliquid & Binance Futures AI 自动交易平台，支持 Hyperliquid 和币安合约

项目地址：https://gitcode.com/gh_mirrors/hy/Hyper-Alpha-Arena

Hyper-Alpha-Arena是一款支持 Hyperliquid 与 Binance 合约的AI 自动交易平台，内置 86 个量化因子、多模型 LLM 交易决策和信号触发系统。借助 Docker，只需一条命令即可在本地完成一键部署，5 分钟内就能用 Hyperliquid Testnet 免费体验 AI 自动交易，全程无需写代码。

部署后你能得到什么？

启动成功后，打开浏览器就能看到三大核心界面：

AI 交易竞技场：多个 AI 交易员同屏竞技，实时监控 BTC、ETH 等合约资金流向
Hyper AI 助手：通过自然语言对话生成策略、管理交易员、诊断系统
信号检测系统：基于资金流、持仓量、资金费率等触发条件，自动开平仓

部署 Hyper-Alpha-Arena 前的准备工作

只需一样：Docker。

操作系统	安装方式
Windows / macOS	安装 Docker Desktop（官网免费个人版）
Linux	安装 Docker Engine + Compose 插件

💡 首次构建需要拉取依赖并编译前端，约需 3~10 分钟，取决于网络速度。

Docker 一键部署步骤（最快上手方法）

# 1. 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/hy/Hyper-Alpha-Arena cd Hyper-Alpha-Arena # 2. 一键构建并启动（二选一） docker compose up -d --build # 新版 Docker Desktop（推荐） # 或 docker-compose up -d --build # 旧版 docker-compose

完成！应用地址为http://127.0.0.1:8802（Windows 用户建议直接用127.0.0.1，避免localhost解析到 IPv6 导致加载失败）。

如何验证 AI 自动交易部署成功

# 查看容器状态：postgres 应为 healthy，app 应为 running docker compose ps # 跟踪应用日志，看到 uvicorn 启动信息即部署成功 docker compose logs -f

整个部署由 docker-compose.yml 编排：自动创建 PostgreSQL 14 数据库（init-db.sh 初始化数据），再由 Dockerfile 多阶段构建——先编译 React 前端，再打包 Python 后端，最终暴露 8802 端口。

免费体验：Hyperliquid Testnet 模拟交易

部署完成后，推荐先用Testnet零成本体验：

浏览器打开http://127.0.0.1:8802，在左侧边栏将Trading Mode切换为Testnet
配置 Hyperliquid 测试网钱包（免费测试资金，无需 KYC）
进入Hyper AI，用一句话描述你的交易策略（如"BTC 突破前高做多，止损 2%"），AI 会自动生成策略并接管交易
也可创建Program Trader，用 Python 规则策略 + 历史回测验证后再实盘

⚠️ 实盘（Mainnet）支持 1~50 倍杠杆，请先在 Testnet 验证策略表现，谨慎管理风险。

常用 Docker 管理命令速查

操作	命令
查看日志	`docker compose logs -f`
停止应用	`docker compose down`
重启应用	`docker compose restart`
更新到最新版	`git pull`后执行`docker compose up -d --build`

数据持久化提示：所有交易数据、配置都存储在 Docker volume 中，停止/重启容器不会丢失。除非执行docker compose down -v，否则数据都会保留——不要随意加-v参数，那会清空全部数据！

常见问题快速排查

端口 8802 被占用：docker compose down后重新docker compose up -d --build
Windows 下页面打不开 / WebSocket 报错：改用http://127.0.0.1:8802访问
报"Cannot connect to Docker daemon"：确认 Docker Desktop 已启动
数据库连接错误：等待 PostgreSQL 容器变为 healthy（docker compose ps查看）

部署配置文件在哪里？

文件	作用
docker-compose.yml	服务编排：数据库 + 应用、端口、环境变量、热加载挂载
Dockerfile	多阶段构建：Node 前端编译 + Python 3.12 后端
init-db.sh	首次启动自动创建`alpha_arena`与`alpha_snapshots`数据库
backend/main.py	FastAPI 后端入口

按照以上步骤，5 分钟即可从零部署一套完整的Hyper-Alpha-Arena AI 自动交易系统。先用 Testnet 免费跑通流程，熟悉 AI 助手和信号系统后，再考虑接入实盘，是新手最稳妥的上手路径 🚀