Polymarket Copy Trading Bot 如何用 systemd 常驻运行:生产环境完整部署指南

原创2026-10-24 12:49:081,923 阅读

Polymarket Copy Trading Bot 如何用 systemd 常驻运行:生产环境完整部署指南

将 Polymarket Copy Trading Bot(polymarket-copy-bot-ts)部署到生产环境时,最推荐的方式是用 systemd 让它常驻运行:进程崩溃自动重启、开机自启、日志统一收集。本文从构建、服务文件配置到日志监控,带你一步步完成 7 个关键步骤,让跟单机器人 7×24 小时稳定运行。

Polymarket 品牌主视觉

为什么选择 systemd 常驻运行?

在 Linux 服务器上跑交易机器人,直接在终端执行 npm start 是最不稳定的做法——终端一断开进程就没了。用 systemd 托管可以获得以下好处:

能力 说明
崩溃自动重启 Restart=always 保证进程异常退出后 10 秒内拉起
开机自启 systemctl enable 后服务器重启无需人工干预
统一日志 日志写入 journal,支持 journalctl 实时跟踪和按时间过滤
优雅停机 本项目已内置 SIGTERM/SIGINT 处理,停机时会等待交易服务收尾并关闭数据库连接

本项目的入口 src/index.ts 中已经实现了 gracefulShutdown:收到 SIGTERM 信号后,会先停止 tradeMonitor 和 tradeExecutor,等待 2 秒让正在进行的操作完成,再关闭 MongoDB 连接。这正是 systemd 管理的理想形态。

Polymarket Copy Trading Bot 启动时的终端界面,显示 MongoDB 连接、健康检查与跟单钱包信息

部署前准备:构建与依赖

环境要求(详见 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 通过相对路径读取 .env
  • Restart=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 托管,实现崩溃自愈、开机自启、日志可查——接下来要关注的,就是让它持续帮你跟单了。

登录后查看全文
polymarket-copy-bot-ts