QuantOS 私有化部署

系统要求

项目	最小配置	推荐配置
CPU 架构	x86_64 (amd64) — 镜像仅支持此架构
操作系统	Linux x86_64 (Ubuntu 22.04+ / CentOS 8+)	同左
CPU	4 核	8 核
内存	16 GB	32 GB
磁盘	100 GB SSD	500 GB SSD
Docker	24.0+ (含 Compose V2)	同左

跨平台说明

Linux x86_64 服务器 — 推荐环境，原生运行，性能最佳。
Windows x86_64 — 通过 Docker Desktop (WSL2) 运行 Linux 容器，完全支持。
macOS Apple Silicon (M1/M2/M3/M4) — Docker Desktop 通过 Rosetta 2 模拟 amd64，可运行但性能有损耗，建议仅用于测试。
macOS Intel — Docker Desktop 原生支持 amd64，可正常运行。

首次部署需联网下载 Docker 镜像。部署完成后可在完全离线的内网环境中运行。

部署步骤

获取机器指纹您操作

在目标部署服务器上运行指纹脚本（约 1 分钟）

Linux / macOS

chmod +x fingerprint.sh
./fingerprint.sh

Windows

# 方式一：双击 fingerprint.bat
# 方式二：在 PowerShell 中运行
powershell -ExecutionPolicy Bypass -File fingerprint.ps1

将输出的 Fingerprint 值复制备用，下一步粘贴到控制台申请表单中。指纹与机器的 CPU、MAC 地址、主机名绑定。

提交许可证申请您操作

登录 QuantGPT 控制台，在首页 QuantOS 卡片中粘贴指纹并提交申请。管理员审批通过后您会收到通知，可在控制台直接下载 license.json。

# 审批通过后，也可通过 API 下载:
curl -fsSL "https://quant-gpt.com/api/v1/deploy/my-license/download" \
  -H "Authorization: Bearer YOUR_TOKEN" -o license.json

下载并加载镜像您操作

下载 QuantOS Docker 镜像并导入（约 10-30 分钟，取决于网络速度）

# 通过控制台下载（YOUR_TOKEN 为许可证下载 Token，可在控制台获取）
curl -fL "https://quant-gpt.com/api/v1/deploy/quantos-image/YOUR_TOKEN" \
  -o quantos-latest.tar.gz

# 导入镜像
docker load -i quantos-latest.tar.gz

# 验证镜像已加载
docker images | grep quantos

镜像约 6 GB，导入后可删除 tar.gz 文件释放磁盘空间。

Docker 部署您操作 AI 可协助

配置环境变量并启动服务（约 5 分钟）

4.1 配置密码

cat > .env << 'EOF'
POSTGRES_PASSWORD=请替换为安全密码
REDIS_PASSWORD=请替换为安全密码
EOF

4.2 启动服务

docker compose up -d
docker compose ps

预期看到 quantos-app、quantos-postgres、quantos-redis 三个容器均为 Up 状态。

初始化数据您操作

下载 A 股行情数据并初始化数据库（约 30-60 分钟）

docker exec quantos-app python -m tools.quantos_init \
    --data-dir /app/data \
    --universe hs300 \
    --years 3 \
    --database-url postgresql://postgres:你的密码@postgres:5432/quant_research

数据下载需要服务器能访问外网。初始化完成后，系统可在完全离线环境中运行。

验证部署您操作

确认服务正常运行（约 1 分钟）

# 健康检查
curl http://localhost:8000/health

# 验证许可证
docker exec quantos-app python3 -c \
  "from hf_engine.hf_engine_rs import verify_license; print(verify_license())"

全部通过后，浏览器访问 http://服务器IP:8200 即可使用。

服务端口说明

端口	服务	说明
8000	Research Kernel	因子研究 API 引擎
8100	Orchestration	AI 编排服务
8200	Interface (BFF)	前端 Web UI — 日常使用只需访问此端口
8300	Paper Trading	模拟盘引擎

日常运维

服务管理

docker compose ps          # 查看状态
docker compose logs -f     # 查看日志
docker compose restart     # 重启服务
docker compose down        # 停止全部
docker compose up -d       # 启动全部

更新版本

docker compose pull
docker compose up -d

数据备份

docker exec quantos-postgres \
  pg_dump -U postgres quant_research \
  > backup_$(date +%Y%m%d).sql

故障排查

Machine fingerprint mismatch

许可证的机器指纹与当前机器不匹配。在正确的机器上重新运行 fingerprint.sh，在控制台重新提交申请。

License expired

许可证已过期。在控制台重新提交申请，审批通过后下载新的 license.json 并重启服务。

Cannot read license file

确认 license.json 存在且已正确挂载到 Docker 容器。检查 docker-compose.yml 中的 volumes 配置。