Polymarket Copy Trading Bot 如何用 systemd 常驻运行:生产环境完整部署指南
Polymarket Copy Trading Bot 如何用 systemd 常驻运行:生产环境完整部署指南
将 Polymarket Copy Trading Bot(polymarket-copy-bot-ts)部署到生产环境时,最推荐的方式是用 systemd 让它常驻运行:进程崩溃自动重启、开机自启、日志统一收集。本文从构建、服务文件配置到日志监控,带你一步步完成 7 个关键步骤,让跟单机器人 7×24 小时稳定运行。
为什么选择 systemd 常驻运行?
在 Linux 服务器上跑交易机器人,直接在终端执行 npm start 是最不稳定的做法——终端一断开进程就没了。用 systemd 托管可以获得以下好处:
| 能力 | 说明 |
|---|---|
| 崩溃自动重启 | Restart=always 保证进程异常退出后 10 秒内拉起 |
| 开机自启 | systemctl enable 后服务器重启无需人工干预 |
| 统一日志 | 日志写入 journal,支持 journalctl 实时跟踪和按时间过滤 |
| 优雅停机 | 本项目已内置 SIGTERM/SIGINT 处理,停机时会等待交易服务收尾并关闭数据库连接 |
本项目的入口 src/index.ts 中已经实现了 gracefulShutdown:收到 SIGTERM 信号后,会先停止 tradeMonitor 和 tradeExecutor,等待 2 秒让正在进行的操作完成,再关闭 MongoDB 连接。这正是 systemd 管理的理想形态。
部署前准备:构建与依赖
环境要求(详见 docs/DEPLOYMENT.md):
- Node.js 18+
- MongoDB(本地实例或 MongoDB Atlas)
- Polygon 钱包(需备好 USDC 与 POL 作为 Gas 费)
- Polygon RPC 节点(Infura、Alchemy 或自建)
1. 获取代码并安装依赖
git clone https://gitcode.com/gh_mirrors/aware3/polymarket-copy-bot-ts
cd polymarket-copy-bot-ts
npm ci --production
npm run build
💡 使用
npm ci --production只安装生产依赖,构建产物会输出到dist/目录,最终由dist/index.js作为运行入口(见 package.json 中的start脚本)。
2. 配置 .env 并加固权限
项目启动时会校验 8 个必填环境变量(校验逻辑在 src/config/env.ts),缺一个都会直接报错退出:
USER_ADDRESSES # 要跟单的交易者地址(逗号分隔或 JSON 数组)
PROXY_WALLET # 你的交易钱包地址
PRIVATE_KEY # 钱包私钥
MONGO_URI # MongoDB 连接串
RPC_URL # Polygon RPC 节点
CLOB_HTTP_URL # Polymarket CLOB HTTP 端点
CLOB_WS_URL # Polymarket CLOB WebSocket 端点
USDC_CONTRACT_ADDRESS # Polygon 上的 USDC 合约地址
安全上请务必执行:
chmod 600 .env
并遵守两条铁律:永远不要把 .env 提交到 Git;不要把 MongoDB 暴露在公网。
创建 systemd 服务文件:完整配置
3. 编写服务单元文件
创建 /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
几个关键参数的含义:
After=network.target mongod.service:确保服务在网络就绪、MongoDB 启动之后才启动,避免连库失败WorkingDirectory:必须指向项目根目录,因为dist/index.js通过相对路径读取.envRestart=always+RestartSec=10:崩溃后 10 秒自动拉起,这是"常驻运行"的核心保障StandardOutput=journal:控制台输出全部交给 journal 管理,后续可用journalctl查看
如果内存吃紧,可在
ExecStart中给 Node.js 加内存上限:/usr/bin/node --max-old-space-size=2048 dist/index.js。
4. 启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable polymarket-bot
sudo systemctl start polymarket-bot
sudo systemctl status polymarket-bot
status 输出中 Active: active (running) 即表示常驻成功。首次启动时终端(journal)里会依次出现 MongoDB 连接、健康检查、CLOB 客户端初始化、Starting trade monitor... 等日志,看到类似下图的输出就说明跟单流程已经跑起来了。
日志查看与日常运维
5. 用 journalctl 跟踪实时日志
sudo journalctl -u polymarket-bot -f # 实时跟踪
sudo journalctl -u polymarket-bot --since today # 查看今日日志
6. 定期健康检查
项目自带一键健康检查脚本 src/scripts/healthCheck.ts,会依次验证数据库、RPC 节点、USDC 余额、Polymarket API 四项状态:
npm run health-check
建议在 crontab 中加一条定时任务,每天跑一次并把结果写入文件,作为最简监控方案。
7. 更新代码后的标准重启流程
git pull origin main
npm ci
npm run build
sudo systemctl restart polymarket-bot
由于机器人内置了优雅停机逻辑,systemctl restart 会先发送 SIGTERM 让正在进行的交易收尾,整个过程不会丢单。
常见问题排查清单
| 症状 | 排查方向 |
|---|---|
| 服务起不来 | 先跑 npm run health-check,确认 8 个必填环境变量齐全 |
| MongoDB 连接失败 | 检查 MONGO_URI;Atlas 用户记得在 IP 白名单中放行服务器 IP |
| RPC 无响应 | 用 curl 直接请求 RPC_URL 验证;可切换 Infura/Alchemy |
| 交易未执行 | 用 npm run check-allowance 检查 USDC 授权;确认钱包里有 POL 付 Gas |
| 内存偏高 | 调大 FETCH_INTERVAL(建议 1~3 秒)、减少跟单人数、设置 --max-old-space-size |
生产环境安全收尾
- [ ]
.env权限已设为 600 - [ ] 私钥不出现在任何日志中
- [ ] MongoDB 不对公网开放
- [ ] RPC 使用 HTTPS 端点
- [ ] 已配置
journalctl日志归档(可用 logrotate 定期压缩清理)
更多部署细节、PM2 替代方案与多实例注意事项,可参考官方文档:docs/DEPLOYMENT.md、快速上手指南 docs/QUICK_START.md 和多交易者配置说明 docs/MULTI_TRADER_GUIDE.md。
配置完成后,你的 Polymarket Copy Trading Bot 就已经由 systemd 托管,实现崩溃自愈、开机自启、日志可查——接下来要关注的,就是让它持续帮你跟单了。

