QuantDinger 实战：自托管 AI 交易操作系统 · 第 1 章 十分钟部署

QuantDinger 实战：自托管 AI 交易操作系统 · 第 1 章 十分钟部署

章节摘要：本章目标很直接：十分钟后，你拥有一套跑在自己机器上的完整 QuantDinger——数据库、队列、六个应用进程、可观测层全部就位。1.1 节走 Docker Compose 一键安装主路径：系统要求、启动步骤、首启验证，以及首次启动后十来个容器各自扮演的角色表。1.2 节给源码部署路径：什么时候值得放弃一键安装（要改代码、要学架构、要调试），以及克隆、依赖、配置、初始化的完整步骤。1.3 节是本章真正的分量所在：默认端口与端点清单（以官方文档为准）、首次登录改密、API key 最小权限、不向公网裸暴露端口、防火墙清单——部署十分钟，安全基线决定你之后睡不睡得着。

学习目标

• 用 Docker Compose 在本机完成一键部署并通过首启验证。
• 说出首次启动后每个容器的角色与依赖关系。
• 判断自己该走一键安装还是源码部署，并完成源码路径。
• 落地五条安全基线：改密、key 最小权限、不裸暴露、防火墙、测试网先行。
• 知道部署后的第一件事是观察，而不是交易。

核心概念速览

部署完成后的进程全景（角色详见 1.1 节）

  ┌─────────── 应用层（Docker Compose 编排）───────────┐
  │ backend      trading-worker   scheduler-worker     │
  │ celery-worker + celery-beat   migration（首启迁移）  │
  └───────┬──────────────┬──────────────┬─────────────┘
          ▼              ▼              ▼
    PostgreSQL 18     Redis 8      Prometheus + Grafana
    （事实源）        （队列/缓存）    （可观测层）
​

一句话金句：部署十分钟，安全基线十分钟之外——后者决定你睡不睡得着。

（文字流程图）装 Docker ──▶ 获取仓库与配置 ──▶ compose up ──▶ 等迁移完成 ──▶ 首登改密 ──▶ 端口收敛与防火墙。

子章节导航

• 第 1.1 节《一键安装》：主路径——系统要求、启动步骤、首启验证、容器角色表。
• 第 1.2 节《源码部署》：克隆、依赖、配置与初始化；何时值得走这条路。
• 第 1.3 节《端口端点与安全基线》：端点清单、改密、key 管理、公网暴露与防火墙。

三节按序读：1.1 让系统跑起来，1.2 给需要改代码的读者，1.3 是任何人都不该跳过的一节。

子章节之间的逻辑关系

┌────────────┐  需要改代码/学架构  ┌────────────┐   跑起来之后    ┌──────────────┐
│ 1.1 一键安装 │ ────────────────▶ │ 1.2 源码部署 │ ────────────▶ │ 1.3 端口端点与 │
│ 十分钟主路径  │                  │ 开发者路径    │                │ 安全基线       │
└─────┬──────┘                  └─────┬──────┘                └──────┬───────┘
      │ 都产出同一套拓扑                │                              │
      └──────────────────────────────┴──────────────────────────────┘
                                     ▼
                第 2 章 v5 架构总览（从「跑起来」到「看懂它」）
​

前置知识与后续延伸

• 前置：第 0.2 节的先修清单与环境自检（Docker、Python 3.12、磁盘余量）。
• 延伸阅读：《Harness 工程：从零打造智能体运行环境》第 05 章《权限与审批门》——1.3 节 key 管理与最小权限的原理对照。
• 后续：第 2 章《v5 架构总览》——部署只回答「有什么」，架构回答「为什么这样长」。

免责声明：本书仅供研究与教育用途，不构成任何投资建议；实盘交易风险自担，建议长期停留在 paper 模式。