1. 课程导入
欢迎进入《Docker量化实盘服务部署实战》。在开始敲下第一条命令之前，我们需要先建立一张清晰的“作战地图”：量化实盘部署到底难在哪里？Docker 为什么能成为解决这些难题的关键工具？这 30 章课程将带你走过怎样的路径，最终又能交付什么？本章不写代码，但它的重要性不亚于任何一次实操——因为方向错了，跑得越快偏得越远。
一、量化实盘部署的真实挑战
很多量化研究者在回测阶段顺风顺水，一旦进入实盘就频频翻车。问题往往不在策略逻辑，而在“部署”这一层。实盘部署的本质，是把一个研究环境中的策略，变成一个 7×24 小时稳定运行、可监控、可恢复、可迭代的生产服务。这中间横亘着几类典型挑战：
- 环境不一致：研究机上是 Python 3.9 + pandas 1.5，服务器上是 Python 3.11 + pandas 2.0，同一个策略跑出完全不同的信号，甚至直接报错。
- 依赖冲突：量化栈常同时依赖 numpy、pandas、TA-Lib、ccxt、vnpy、tensorflow 等，版本互相打架，装一个坏一个。
- 部署流程手工化：靠 SSH 上传文件、手动 pip install、手动 nohup 启动，一次部署半小时，出错还难回滚。
- 运行状态不可见：进程是否活着、行情是否断连、订单是否成交、内存是否泄漏，全靠“盯屏幕”。
- 故障恢复困难：服务器重启、网络抖动、交易所 API 限流，服务挂了没人知道，错过行情就是真金白银的损失。
- 多策略隔离差：两个策略共用一套环境，一个升级依赖，另一个直接崩溃。
这些挑战的共同根源是：策略代码与运行环境、部署流程、运维手段没有被标准化地封装在一起。而 Docker 恰恰是为解决“标准化封装与交付”而生的。
二、Docker 为量化实盘带来的核心价值
Docker 通过镜像（Image）与容器（Container）机制，把“应用 + 依赖 + 运行时 + 配置”打包成一个不可变单元。对量化实盘而言，它带来四层价值：
| 挑战 | Docker 对应能力 | 实盘收益 |
|---|---|---|
| 环境不一致 | 镜像固化依赖版本 | 研究机与服务器行为一致 |
| 依赖冲突 | 容器级隔离 | 多策略互不干扰 |
| 部署手工化 | 镜像分发 + 一条命令启动 | 部署从半小时到一分钟 |
| 状态不可见 | 日志、健康检查、监控集成 | 运行状态可观测 |
| 故障恢复难 | 重启策略 + 编排 | 崩溃自动拉起 |
需要强调的是，Docker 不是“银弹”。它解决的是交付与运行环境问题，不解决策略本身的盈利性，也不替代风控与资金管理。把 Docker 当成“部署基础设施”，而不是“赚钱工具”，是学习本课程的正确心态。
三、从研究到实盘的部署链路
为了让你对整门课的技术地图有直观认识，下面这张图展示了量化策略从研究环境走向实盘容器的关键链路与隔离边界。请重点观察：策略代码、依赖环境、配置与密钥、运行编排这四类对象分别被放在哪一层。
四、课程学习路径与实战目标
本课程共 30 章，整体遵循“先建立认知，再打通单机，最后走向编排与运维”的递进路径。你可以把它理解为三个阶段：
- 基础与镜像阶段（第 1～10 章）：理解 Docker 核心概念，掌握 Dockerfile 编写、镜像构建与优化，能把一个量化策略脚本打包成可运行镜像。
- 运行与编排阶段（第 11～20 章）：掌握容器运行、数据卷、网络、环境变量与密钥管理，使用 Docker Compose 编排行情服务、策略服务与数据库。
- 实盘与运维阶段（第 21～30 章）：接入真实交易所、实现日志与监控、配置健康检查与自动重启、完成灰度发布与故障复盘。
学完本课程，你将能够独立完成下面这条命令所代表的交付能力：
# 目标：一条命令拉起完整量化实盘服务栈
docker compose -f quant-live.yml up -d
# 查看服务状态
docker compose ps
# 跟踪策略容器日志
docker logs -f quant-strategy --tail 100
# 预期日志片段
# [2025-01-15 09:30:01] market feed connected: binance
# [2025-01-15 09:30:02] strategy loaded: ma_cross_v3
# [2025-01-15 09:30:05] order placed: BUY BTCUSDT qty=0.01
五、新手常见误区与复盘提醒
在正式进入实操前，先避开几个高频误区，能帮你少走很多弯路：
- 误区一：把 Docker 当虚拟机用。在容器里装 systemd、开多个后台进程，违背“一容器一进程”原则，导致日志混乱、信号无法正确传递。
- 误区二：镜像里写死密钥。、私钥一旦进入镜像层，推送仓库即泄露。正确做法是通过环境变量或密钥文件挂载注入。
- 误区三：只用 latest 标签。实盘环境必须使用明确版本号，否则一次拉取就可能引入未验证的变更。
- 误区四：不做日志持久化。容器删除日志即丢失，实盘排障将无从下手，必须把日志输出到宿主机或日志系统。
- 误区五：忽视资源限制。策略容器不加内存与 CPU 限制，一旦行情暴动导致内存飙升，可能拖垮整台服务器。
现在，你已经对量化实盘部署的挑战、Docker 的价值以及本课程的整体路径有了全局认识。接下来，我们将从 Docker 的核心概念开始，一步步把这张地图变成你手中真实可运行的系统。