imgpro生产环境部署完整指南:用systemd让Polymarket跟单机器人7×24稳定运行

原创2026-10-25 15:52:221,908 阅读

imgpro生产环境部署完整指南:用systemd让Polymarket跟单机器人7×24稳定运行

imgpro(Polymarket Copy Trading Bot)是一款自动跟单机器人:它 24 小时监控 Polymarket 上高胜率交易者的开仓动作,按你的资金比例自动计算仓位并实时下单。要让跟单机会持续捕获每一个交易信号,生产环境部署是绕不开的一步。本文带你用 Linux 自带的 systemd 服务管理器完成 imgpro 的完整部署,实现崩溃自动重启、开机自启和日志集中管理,让机器人 7×24 稳定运行。

一、为什么用 systemd 部署跟单机器人?

手动执行 npm start 运行机器人有三个致命问题:终端一关进程就死、崩溃后不会自动恢复、重启服务器后需要手动再启动。systemd 全部帮你解决:

能力 说明
🔁 自动重启 进程崩溃或抛出未捕获异常后,10 秒内自动拉起
🚀 开机自启 服务器重启后机器人自动上线,不漏掉任何跟单信号
📋 日志集中 所有输出进入 journal,随时用一条命令查看
⚡ 优雅停机 停止服务时发送 SIGTERM,imgpro 会先停止交易监控和下单,再关闭 MongoDB 连接(见 src/index.ts)

imgpro Polymarket跟单机器人启动时的健康检查输出界面

上图:imgpro 启动后自动执行的 Polymarket 跟单机器人健康检查——数据库、RPC 节点、钱包余额、Polymarket API 四项全部通过后才会开始监控交易

二、部署前置条件

开始之前,请确认以下条件(详见 docs/DEPLOYMENT.md 和 docs/GETTING_STARTED.md):

  • Linux 服务器(Ubuntu 20.04+ / CentOS 7+ 均可)
  • Node.js 18+
  • MongoDB(本地或 MongoDB Atlas 免费版)
  • Polygon 钱包:已存入 USDC 用于交易,并有少量 POL/MATIC 支付 gas
  • Polygon RPC 节点(Infura、Alchemy 或自建)

三、systemd 部署完整步骤

1. 克隆仓库并安装依赖

git clone https://gitcode.com/gh_mirrors/im/imgpro
cd imgpro

npm ci --production   # 生产环境只安装运行所需依赖
npm run build         # 编译 TypeScript 到 dist/

配置文件放在项目根目录的 .env,核心变量有:USER_ADDRESSES(要跟单的交易者地址,逗号分隔)、PROXY_WALLET(你的钱包地址)、PRIVATE_KEY(私钥,不带 0x 前缀)、MONGO_URI、RPC_URL 等。imgpro 启动时会通过 src/config/env.ts 自动校验全部必填项,格式错误会直接报错并给出修复提示,建议把 FETCH_INTERVAL 保持 1~3 秒,兼顾跟单速度与 API 负载。

⚠️ 安全提醒:.env 里包含私钥,务必收紧权限,且不要提交到任何代码仓库:

chmod 600 .env

2. 部署前先跑健康检查

imgpro 内置了体检脚本,一键检测数据库、RPC、余额和 Polymarket API(源码见 src/scripts/healthCheck.ts):

npm run health-check

看到 "All Systems Operational!" 再往下走,能省掉部署后排查环境问题的时间。

3. 创建 systemd 服务文件

创建 /etc/systemd/system/polymarket-bot.service,按实际路径和用户名修改 User 和 WorkingDirectory:

[Unit]
Description=Polymarket Copy Trading Bot
After=network.target mongod.service

[Service]
Type=simple
User=your-user
WorkingDirectory=/path/to/imgpro
Environment="NODE_ENV=production"
ExecStart=/usr/bin/node dist/index.js
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

两个关键参数解释一下:

  • Restart=always + RestartSec=10:无论进程为何退出,systemd 都会在 10 秒后重新拉起它
  • After=network.target mongod.service:确保网络和 MongoDB 先就绪,机器人再启动

4. 启用开机自启并启动

sudo systemctl daemon-reload   # 加载新服务定义
sudo systemctl enable polymarket-bot   # 开机自启
sudo systemctl start polymarket-bot    # 立即启动
sudo systemctl status polymarket-bot  # 查看运行状态

status 显示 active (running) 且日志中出现健康检查全部通过的输出,部署就完成了 🎉

四、日常运维速查表

# 实时查看跟单机器人日志(Ctrl+C 退出)
sudo journalctl -u polymarket-bot -f

# 最近 100 行日志
sudo journalctl -u polymarket-bot -n 100

# 停止 / 重启 / 查看内存占用
sudo systemctl stop polymarket-bot
sudo systemctl restart polymarket-bot
sudo systemctl status polymarket-bot

更新代码后只需三步:git pull → npm ci && npm run build → sudo systemctl restart polymarket-bot。

五、常见问题排查

现象 排查方法
服务起不来 sudo journalctl -u polymarket-bot -n 50 看报错;多为 .env 缺变量或格式错误,先跑 npm run health-check
连不上 MongoDB 检查 MONGO_URI 是否以 mongodb:// 开头、Atlas 是否放行了服务器 IP
不下单 用 npm run check-allowance 检查 USDC 授权;确认钱包有 USDC 和 POL gas 费
内存偏高 调大 FETCH_INTERVAL 或减少跟单人数;必要时在 systemd 中加 Environment="NODE_OPTIONS=--max-old-space-size=2048"

资源需求参考:1~2 核 CPU、512MB~1GB 内存、10GB 磁盘即可稳定支撑单实例运行。

六、安全与运维清单 ✅

  • [ ] .env 权限已设为 600,私钥未出现在任何日志中
  • [ ] MongoDB 不暴露公网,RPC 节点使用 HTTPS
  • [ ] 已配置日志轮转或定期归档(详见 docs/DEPLOYMENT.md 的 Logging 章节)
  • [ ] 定期执行 mongodump 备份跟单历史数据
  • [ ] 防火墙仅开放必要端口

总结

跟着本文走完「安装依赖 → 健康检查 → 创建 systemd 服务 → 开机自启」四步,imgpro 就完成了一次标准的生产部署:崩溃自动拉起、重启自动上线、日志随查随看。配合 npm run health-check 的定期体检,你的 Polymarket 跟单机器人从此可以安心 7×24 值守。更多策略参数(如分层倍率 TIERED_MULTIPLIERS)和交易者筛选技巧,可以继续阅读 docs/TIERED_MULTIPLIERS.md 与 docs/TRADER_SELECTION_GUIDE.md。

登录后查看全文
imgpro