imgpro生产环境部署完整指南:用systemd让Polymarket跟单机器人7×24稳定运行
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 跟单机器人健康检查——数据库、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。
