快速开始

本指南将帮助您在几分钟内完成 QuantMind 的部署并登录体验。推荐基于 Docker 单容器一键部署，无需在本地安装 Python 依赖。

环境要求

项目 最低配置 推荐配置
系统 Ubuntu 22.04+ Ubuntu 24.04 LTS
CPU / 内存 4 核 / 8 GB 8 核 / 16 GB 以上
磁盘 100 GB 200 GB 以上
网络 可访问 Gitee 可访问 Docker Hub（脚本内置镜像加速）
说明

仅做回测 / 推理 / 投研分析无需 GPU；如需在本地训练量化模型，建议 8 核 / 64 GB 内存 + NVIDIA 显卡（CUDA）。整体采用 Docker 容器化编排，无需在服务器上手动安装 Python 环境。

部署步骤

第一步：一键部署（推荐 · 生产就绪）

在全新的 Ubuntu 服务器上执行，将从 CDN 下载完整业务数据 + 预训练模型 + 镜像包，下载校验后一次性恢复，部署完即可登录：

bash
curl -fsSL https://gitee.com/qusong0627/QuantMind/raw/master/deploy/full-deploy.sh | sudo bash

备选：在线一键部署（快速体验 · 不含业务数据）

适用于有外网、需快速体验的场景；不带业务数据，完成后需按第二步准备 QuantDB 数据：

bash
curl -fsSL https://gitee.com/qusong0627/QuantMind/raw/master/deploy/deploy.sh | sudo bash

第二步：数据准备（使用在线源码部署时必需）

推荐方式：QuantDB 在线下载及日常增量更新。登录桌面客户端后，在【个人中心】→【数据平台】填入 QuantDB API Key 一键绑定同步；或在服务器终端执行：

bash
docker exec quantmind python backend/scripts/quantdb_daily_sync.py

备选：离线数据包（全量离线导入，约 56GB）下载解压到 /opt/quantmind/data/quantdb/，详见 数据下载。

第三步：登录验证

部署完成后访问以下入口：

  • Web 控制台：http://<服务器IP>:3000
  • API 网关：http://<服务器IP>:8000
  • Swagger 文档：http://<服务器IP>:8000/docs
默认账号

默认管理员为 admin / admin123，生产环境请立即修改密码。

第四步：桌面客户端连接

下载 桌面客户端（Windows 已上线，macOS 尚未上线），登录时在「服务器地址」填写部署服务器 IP/域名与端口（默认 8000）即可直连使用。

第五步：日常更新

在项目目录下执行一键更新（拉取最新代码、重建/重启后端并应用数据库补丁，保留数据库与模型资产）：

bash
cd /opt/quantmind && sudo bash deploy/update.sh

服务架构

OSS 采用单容器统一编排，一个容器内运行全部后端微服务：

服务 端口 职责
api 8000 用户认证、策略管理、数据平台、新闻代理
engine 8001 Qlib 回测、AI 策略生成、模型训练/推理、因子挖掘
trade 8002 订单管理、持仓、风控、模拟撮合
stream 8003 实时行情接收、WebSocket 推送

常用运维命令：docker compose ps（查看状态）、docker compose logs -f quantmind（主服务日志）、docker compose restart quantmind（重启主服务）。

下一步