从下载，到第一次启动。

01 / 使用前准备

2026.10.22.8 版本包含 Pro 参数编辑、手动/AI 参数来源、AI 每 30 分钟更新、AI 中线方向判断，以及默认保留旧轮止盈挂单等功能。

02 / Windows

1. 下载 Windows ZIP，解压到有写权限的文件夹。
2. 双击 TradingOS.exe。首次运行在控制台输入管理员用户名和密码，密码长度为 8～128 个字符。
3. 设置完成后会自动打开浏览器，默认地址为 http://127.0.0.1:9002/。运行期间保留控制台窗口。

也可以在解压后的 TradingOS 文件夹打开 PowerShell：

.\TradingOS.exe setup
.\TradingOS.exe serve

03 / Linux

下载并解压 Linux 包，然后执行以下命令。后续版本请替换为对应的安装包文件名。

tar -xzf TradingOS-2026.10.22.8-linux-x86_64.tar.gz
cd TradingOS
chmod +x tradingos.bin
./tradingos.bin setup
./tradingos.bin serve

按提示设置管理员用户名和密码。默认网页地址也是 http://127.0.0.1:9002/。

使用 systemd 托管网页

Linux 包附带 tradingos.service.example。编辑其中的用户、程序和数据路径后安装；使用前须以同一用户完成 setup。服务只启动网页，交易引擎仍需在网页中手动启动。

04 / 远程访问

在服务器运行时，可以在自己的电脑建立 SSH 隧道。请替换下方用户名和服务器地址：

ssh -L 19002:127.0.0.1:9002 user@your-server

保持隧道连接，在自己电脑上打开 http://127.0.0.1:19002/。程序监听地址和端口也可以通过 serve --host 地址 --port 端口 指定。

05 / 数据与更新

保持数据目录一致

默认数据目录为程序旁的 data。账户、API 加密文件、配置和交易状态均保存在这里。使用独立目录时，每次启动必须传入同一个 --data-dir 路径：

./tradingos.bin setup --data-dir /your/path/tradingos-data
./tradingos.bin serve --data-dir /your/path/tradingos-data

将 /your/path/tradingos-data 替换为自己的可写目录。Windows 对应使用 TradingOS.exe，参数相同。setup 拒绝覆盖已有数据库；已有数据直接使用 serve 启动。

更新步骤

1. 备份整个 data 目录。
2. 按计划在网页中停止交易引擎。
3. 退出网页程序，再替换可执行文件。
4. 保留原 data，或继续使用原 --data-dir 路径，通过 serve 启动。

可选运维界面

运行 operations 命令可使用运维界面，默认端口 5001。它和主控制台使用同一数据目录。

06 / 版本验证与自检

Linux 在程序目录中执行：

./tradingos.bin version
./tradingos.bin self-test

Windows 在 PowerShell 中执行：

.\TradingOS.exe version
.\TradingOS.exe self-test

自检使用临时空账户，不读取你的交易账户，不发送交易订单。包内 VALIDATION.json、SELFTEST.txt、SMOKE.txt 记录对应平台的实际检查结果，包括登录、页面资源、多账户、重启保留数据、凭据加密，以及缺少凭据时拒绝启动引擎。

校验下载文件

下载校验文件，与安装包的 SHA-256 摘要进行比对：

下载 SHA256SUMS.txt ↗

Get-FileHash .\TradingOS-2026.10.22.8-windows-x86_64.zip -Algorithm SHA256

sha256sum TradingOS-2026.10.22.8-linux-x86_64.tar.gz

请保留发行包内 THIRD-PARTY-NOTICES.json 和 licenses 目录中的依赖许可文件。可执行程序由 PyInstaller 打包，不是源码加密方案。

07 / 常见问题