期货量化策略从 Windows 迁到 Linux 服务器：环境注意点

前言

国内期货量化很多是在 Windows 笔记本上写出来的：装 Anaconda、pip install tqsdk、在 IDE 里跑通 TqSim。上线时希望放到 Linux 云服务器上 7×24 跑夜盘，路径、换行符、进程守护和时区都会和本机不同。天勤 TqSdk 本身跨平台，策略里 wait_update、get_kline_serial 等调用一般不用改，变的是运行环境和运维方式。

下面按 Python 环境、文件路径、进程守护、网络时区、直连 CTP 等块说明迁移时要注意什么，并解释文中出现的 systemd、venv、TqCtp 等名词指什么。

一、Python 环境与 tqsdk 版本

venv 是 Python 自带的虚拟环境目录，用来隔离项目依赖，避免和系统里别的项目抢包版本。Linux 上建议：

bash 复制代码

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

requirements.txt 应锁定 tqsdk 版本号，与 Windows 开发机一致。Python 大版本（如 3.10 与 3.11）不一致时，个别依赖可能装不上；迁移后第一件事用 TqSim 跑通最小脚本，打印 quote.datetime 是否推进。

二、路径：不要写死 C 盘

Windows 用反斜杠 C:\Users\...，Linux 用正斜杠 /home/...。状态 JSON、日志、配置应使用 Python 的 pathlib.Path，或相对项目根目录的路径，不要硬编码盘符。否则策略在 Linux 上找不到 data\state.json 这类文件，重启后以为空仓又开仓。

.env 文件放项目根，用 os.environ 读 TQ_USER、TQ_MODE 等，不要把实盘密码写进代码再传到服务器。

三、时区与 K 线 datetime

K 线表和 quote 上的 datetime 是行情业务时间，一般由北京时间规则写入。服务器系统时区建议设为 Asia/Shanghai，或在文档里约定日志时间戳用北京时间，避免排查夜盘问题时与交易员本地时间差八小时对不上。

四、systemd 与 supervisor：让进程在崩溃后拉起

systemd 是多数 Linux 发行版自带的初始化与服务管理框架，可写一个 unit 文件，例如 /etc/systemd/system/futures-strategy.service，指定工作目录、虚拟环境 Python 路径、环境变量文件，并设置 Restart=on-failure 表示异常退出后自动重启。

supervisor 是另一款进程管理工具，配置写在 supervisord.conf 里，适合一台机跑多个策略进程、每个进程独立日志。

共同原则：同一期货资金账户，同一时刻只应有一个策略进程在跑；守护进程配置成单实例，避免手误启动两次。

五、网络与期货公司限制

云服务器出网 IP 可能与家里不同。部分期货公司对程序化交易有 IP 报备要求，迁移后要确认柜台是否允许新 IP 登录。防火墙只需放行策略访问行情与交易网关所需端口，不要无故关断出站连接。

若用 TqCtp 直连期货公司前置，需额外安装 tqsdk_zq_otg 包，并确认该包在 Linux 上受支持（见官方说明）；与 Windows 下 CTP 动态库路径问题不是同一类，但都要在目标系统实测登录。

六、无图形界面时的注意点

服务器通常没有桌面，天勤若开了 web 绘图，确认不会阻塞主循环。生产环境多数只保留文件日志，图形在开发机回放。

七、迁移验证步骤（建议按顺序）

Linux 上 TqSim 或 TqKq 跑最小循环，确认 wait_update 与 datetime 正常。
跑一夜模拟，检查日志轮转与磁盘空间。
人为 kill 进程，看 systemd 是否拉起，且不会叠两个 TqApi。
再切 TqAccount 小仓位实盘。

总结

从 Windows 迁到 Linux，难点通常不在策略公式，而在运行环境是否被完整复制：依赖版本、路径规则、守护方式、时区和网络边界缺一不可。策略能否稳定跑 7×24，关键在于把 venv/requirements 锁死、把状态文件路径和日志落地规范化、用 systemd/supervisor 做单实例保活和失败重启，并在切换到目标时区后重新核对 datetime 相关逻辑。很多时候你以为"代码一样就行"，但环境差异会让等待与过滤条件表现不同。把这些基础设施提前标准化，并在最小可行脚本上完成验证，迁移就会从'能跑'升级为'能长期稳定跑'，从而与后续实盘风控衔接得更紧。

FAQ

1）WSL 算生产环境吗？

适合开发联调，7×24 夜盘建议用独立 Linux 服务器或云主机。

2）Docker 部署可以吗？

可以，注意一容器一策略、环境变量注入密码、日志挂载到宿主机。

3）多策略多服务？

每个策略独立 systemd unit，勿同账户双进程。

4）编码问题？

源码与日志统一 UTF-8，避免 Windows 记事本另存为 GBK 后上传乱码。

风险提示

以上内容用于部署参考，不构成投资建议。