7×24 小时稳定运行:polymarket-copy-bot-ts 生产环境部署与 systemd 运维指南
7×24 小时稳定运行:polymarket-copy-bot-ts 生产环境部署与 systemd 运维指南
polymarket-copy-bot-ts 是一个开源的 Polymarket 跟单交易机器人(Copy Trading Bot),可以 7×24 小时监控目标交易者的成交,并按比例自动在你自己的钱包中复制下单。想要让它长期可靠地跑在服务器上,而不是关终端就停止,关键在于生产环境部署 + systemd 服务化:开机自启、崩溃自动重启、日志可查可轮转。本文将带你从零完成这套稳定运行方案。
一、这个项目能做什么
在部署之前,先快速了解机器人的工作流程(详见 README.md):
- 选择交易者:在 Polymarket 排行榜中挑选高胜率、活跃的交易者;
- 实时监控:默认每秒轮询一次,检测目标交易者的新仓位;
- 按比例计算仓位:根据你的余额与交易者余额自动缩放仓位大小;
- 实时执行下单:通过你的钱包在 Polymarket 下单;
- 记录历史:全部交易与仓位持久化存储在 MongoDB 中。
💡 上图是机器人首次启动时的界面:完成 MongoDB 连接、钱包信息加载后,会自动执行一次健康检查(HEALTH CHECK),逐项确认数据库、RPC 节点、余额、API 是否正常。
二、部署前准备清单
按照 docs/DEPLOYMENT.md 的官方部署文档,生产环境需要满足以下前置条件:
| 准备项 | 要求 | 说明 |
|---|---|---|
| Node.js | v18 及以上 | 建议安装 LTS 版本 |
| MongoDB | 本地或 MongoDB Atlas 免费版 | 用于记录交易历史与仓位 |
| Polygon 钱包 | 余额含 USDC | 你的交易资金(建议用小资金先测试) |
| POL / MATIC | 约 $5–10 | 支付链上 Gas 费 |
| RPC 节点 | Infura、Alchemy 或自建 | 稳定连接 Polygon 主网 |
服务器本身是常规 Linux 环境即可,官方推荐资源占用很低:CPU 1–2 核、内存 512MB–1GB、磁盘约 10GB(主要是 MongoDB 数据)。
三、快速部署:从克隆到首次运行
1. 克隆仓库并安装依赖
git clone https://gitcode.com/gh_mirrors/da/polymarket-copy-bot-ts
cd polymarket-copy-bot-ts
npm install
生产环境建议使用 npm ci --production 安装依赖,可保证与 lock 文件完全一致、安装更快。
2. 配置环境变量
cp .env.example .env
编辑 .env,核心变量如下(完整说明见 docs/GETTING_STARTED.md):
# 要跟单的交易者地址(多个用逗号分隔)
USER_ADDRESSES = '0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee'
# 你的交易钱包与私钥(私钥不带 0x 前缀)
PROXY_WALLET = 'your_polygon_wallet_address'
PRIVATE_KEY = 'your_private_key_without_0x_prefix'
# MongoDB 连接串与 Polygon RPC 节点
MONGO_URI = 'mongodb+srv://username:password@cluster.mongodb.net/database'
RPC_URL = 'https://polygon-mainnet.infura.io/v3/YOUR_PROJECT_ID'
⚠️ 安全提示:.env 中存放着钱包私钥,务必收紧权限,绝不要提交到版本库:
chmod 600 .env
另外建议单独为机器人创建一个专用钱包,不要与主钱包混用,风险隔离。
3. 构建并执行健康检查
npm run build
npm run health-check
健康检查由 src/scripts/healthCheck.ts 实现,会逐项验证数据库、RPC、余额和 Polymarket API 状态,并给出具体修复建议。全部通过(All Systems Operational!)后再进入下一步。
4. 手动试跑
npm start
看到 Starting trade monitor... 且持续监控目标交易者,说明运行正常。确认无误后,就可以将其交给 systemd 托管了。
四、创建 systemd 服务:开机自启 + 崩溃自动重启
这是实现"7×24 小时稳定运行"的核心步骤。systemd 是主流 Linux 发行版的默认服务管理器,它能让机器人在服务器重启后自动拉起,并在进程异常退出后 10 秒自动重启。
1. 编写服务文件
创建 /etc/systemd/system/polymarket-bot.service:
[Unit]
Description=Polymarket Copy Trading Bot
After=network.target mongod.service
[Service]
Type=simple
User=your-user
WorkingDirectory=/path/to/polymarket-copy-bot-ts
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:崩溃后 10 秒自动重启,保证服务自愈;After=network.target mongod.service:确保网络和本地 MongoDB 先就绪;StandardOutput=journal:日志统一交给 journal,方便用journalctl查询;- 若内存偏紧,可在
ExecStart前加NODE_OPTIONS="--max-old-space-size=2048"调整 Node.js 内存上限。
2. 启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable polymarket-bot
sudo systemctl start polymarket-bot
sudo systemctl status polymarket-bot
enable 之后重启服务器也会自动恢复运行,这就是"挂机不关机"的底气。
💡 如果你更习惯在 VPS 上用 PM2 管理进程,也可以按 docs/DEPLOYMENT.md 中的 PM2 章节操作(
pm2 start dist/index.js --name polymarket-bot+pm2 startup),效果类似,二选一即可。
五、日志与监控:出了问题怎么办
1. 查看实时日志
sudo journalctl -u polymarket-bot -f
日常运维建议每天至少看一次日志,确认交易是否正常执行、有无报错。
2. 配置日志轮转
防止日志撑爆磁盘,创建 /etc/logrotate.d/polymarket-bot:
/path/to/polymarket-bot/logs/*.log {
daily
rotate 7
compress
missingok
notifempty
}
每天轮转、保留 7 份并压缩,是兼顾可追溯与磁盘空间的稳妥配置。
3. 自动化巡检
可配合 cron 定时运行 npm run health-check(实现见 src/utils/healthCheck.ts),发现进程不在或检查失败时推送告警:
if ! pgrep -f "node.*dist/index.js" > /dev/null; then
echo "Bot process not running!"
fi
npm run health-check || echo "Health check failed!"
六、日常运维手册
1. 版本更新三步走
git pull origin main
npm ci
npm run build
sudo systemctl restart polymarket-bot
2. MongoDB 备份与恢复
交易历史都存在数据库里,建议定期备份:
# 备份
mongodump --uri="mongodb://localhost:27017/polymarket_copytrading" --out=/backup/$(date +%Y%m%d)
# 恢复
mongorestore --uri="mongodb://localhost:27017/polymarket_copytrading" /backup/20240101
3. 常见故障速查
| 现象 | 排查方向 |
|---|---|
| 机器人启动失败 | 运行 npm run health-check 定位;检查 MONGO_URI 与 Atlas IP 白名单 |
| 检测不到交易 | 确认目标交易者近期活跃、USER_ADDRESSES 地址正确 |
| 下单失败(余额不足) | 补充 USDC;用 npm run check-allowance 检查授权与 POL Gas 费 |
| 内存偏高 | 调大 FETCH_INTERVAL(1–3 秒)、减少跟单人数、上调 Node 内存上限 |
更多细节可参考官方排障章节 docs/DEPLOYMENT.md 与 docs/QUICK_START.md。
七、上线前安全检查清单
✅ .env 权限已设为 600,私钥未出现在日志中
✅ MongoDB 未暴露到公网
✅ RPC 节点使用 HTTPS
✅ 已配置日志轮转与定期备份
✅ 监控告警(进程状态 + 健康检查)已启用
总结
把 polymarket-copy-bot-ts 跑成"7×24 小时不掉线"的长期服务,只需四步:部署构建 → 健康检查 → systemd 托管 → 日志与备份。其中 Restart=always 负责自愈,journalctl 负责可观测,mongodump 负责数据兜底,配合本文的安全清单,普通用户也能把跟单机器人稳定地运行在自己的服务器上。
⚠️ 风险提示:本项目仅供学习研究,交易存在亏损本金的可能,请只投入可承受损失的资金,建议先用小额资金验证策略。

