QuantDinger 安装与部署总览¶

这篇文档用于先选对安装方式，再进入对应的逐步教程。QuantDinger 的服务端、Web 页面和手机客户端是不同层次：Windows、Linux 或云服务器负责运行服务；H5、Android 和 iOS 是访问同一服务的客户端。

先选择你的目标¶

推荐安装方式¶

普通用户优先使用 GHCR 预构建镜像。安装程序会下载 Compose 配置、生成必要密钥、创建管理员并启动服务，不需要在本机编译 Python 或 Vue。

Linux 或 macOS：

curl -fsSL https://raw.githubusercontent.com/OpenByteInc/QuantDinger/main/install.sh | bash

Windows PowerShell：

irm https://raw.githubusercontent.com/OpenByteInc/QuantDinger/main/install.ps1 | iex

默认安装目录分别是 ~/quantdinger 和 %USERPROFILE%\quantdinger。安装程序可以重复执行用于升级；已有 .env 值和数据卷会被保留。

安装完成后的地址¶

如果页面打不开，不要反复删除容器或数据卷。先执行 docker compose ps，再进入安装故障排查。

安装后的正确顺序¶

1. 按部署后首次设置修改密码、站点地址、注册策略和数据源。
2. 需要公网访问时配置域名、HTTPS、备份和监控。
3. 完成第一次运行，先研究和回测，再使用模拟盘。
4. 准备真实资金前完成实盘安全清单。

源码部署适合谁¶

只有需要修改后端或本地构建镜像的开发者才应使用源码部署。普通使用和生产服务器应优先使用固定版本的 GHCR 镜像，减少编译环境差异。源码部署步骤见云服务器部署。

安全边界¶

• 不要把 5000、5432、6379 或 29092 直接开放到公网。
• 不要提交 .env、交易凭据、模型密钥或支付密钥。
• 不要为了重新安装而删除 PostgreSQL 数据卷；先备份并确认数据恢复方案。
• 手机 App 不是独立后端，必须连接一个可访问的 QuantDinger 服务端。