Ubuntu 部署教程（/root + PM2 + 局域网 + socks5h）

本教程对应你的目标环境：

• 部署目录：/root/okx_alt_engine
• 仅局域网访问，不做外网暴露
• Python 虚拟环境
• PM2 守护进程
• 出网代理：socks5h://127.0.0.1:1080

1. 基础环境

apt update
apt install -y python3 python3-venv python3-pip nodejs npm
npm install -g pm2

2. 上传项目并准备目录

将项目上传到：

/root/okx_alt_engine

创建数据目录：

mkdir -p /root/okx_alt_engine/{data,logs,backup}

3. 配置 .env

cd /root/okx_alt_engine
cp .env.example .env
vim .env

至少填写：

• AGENT_SHARED_TOKEN
• OKX_API_KEY
• OKX_API_SECRET
• OKX_PASSPHRASE
• OKX_FLAG（建议先 1 模拟盘）
• DRY_RUN=true（建议第一阶段）
• WECHAT_WEBHOOK（可选）

权限收紧：

chmod 600 /root/okx_alt_engine/.env

4. 创建虚拟环境并安装后端依赖

cd /root/okx_alt_engine
python3 -m venv .venv
source .venv/bin/activate
pip install -r backend/requirements.txt

5. 首次手动启动验证

5.1 启动后端

cd /root/okx_alt_engine
source .venv/bin/activate
python backend/run_backend.py

新开一个终端检查：

curl http://127.0.0.1:8091/health

5.2 启动前端

cd /root/okx_alt_engine
python3 -m http.server 5174 --directory frontend

局域网访问：

http://<服务器内网IP>:5174

6. PM2 守护（推荐）

项目已提供 ecosystem.config.js（路径写的是 /root/okx_alt_engine）。

cd /root/okx_alt_engine
pm2 start ecosystem.config.js
pm2 status
pm2 logs okx-alt-backend
pm2 logs okx-alt-frontend

保存进程列表：

pm2 save
pm2 startup

7. 代理检查（socks5h）

已在 ecosystem.config.js 中给后端配置：

• ALL_PROXY=socks5h://127.0.0.1:1080
• HTTP_PROXY=socks5h://127.0.0.1:1080
• HTTPS_PROXY=socks5h://127.0.0.1:1080
• NO_PROXY=127.0.0.1,localhost

请先确认你本机代理端口可用：

ss -ltnp | rg 1080

8. 局域网安全建议

• 防火墙只允许内网网段访问 5174；
• 8091 建议只绑定 127.0.0.1；
• 保留 X-Agent-Token 校验；
• 不要把 .env、日志备份文件上传到公共仓库。

9. 常用运维命令

# 查看状态
pm2 status

# 重启后端
pm2 restart okx-alt-backend

# 重启前端
pm2 restart okx-alt-frontend

# 查看后端日志
pm2 logs okx-alt-backend --lines 200

# 导出/备份数据库
bash /root/okx_alt_engine/scripts/backup_db.sh

10. 上线顺序建议

1. OKX_FLAG=1 + DRY_RUN=true 跑 1~2 天；
2. OKX_FLAG=1 + DRY_RUN=false 小规模模拟单；
3. OKX_FLAG=0 + DRY_RUN=true 校验实盘连通；
4. 最后 OKX_FLAG=0 + DRY_RUN=false 小仓实盘。

不要跳步骤，先验证“稳定执行”再谈放大。