私钥安全保卫战:polymarket-copy-trading-bot密钥保护最佳实践与风险控制清单
私钥安全保卫战:polymarket-copy-trading-bot密钥保护最佳实践与风险控制清单
polymarket-copy-trading-bot 是一个 7×24 小时自动跟单 Polymarket 交易者的机器人,它在执行交易时必须持有你的钱包私钥。正因如此,私钥安全是整个项目的第一道生命线——私钥一旦泄露,钱包里的 USDC 将不保。本文面向新手,整理出 9 条开箱即用的密钥保护最佳实践,并附一份可直接勾选的风险控制清单,帮助你在开启自动跟单之前把安全做在前面。
一、私钥在机器人中扮演什么角色?
理解风险之前,先弄清私钥用在哪里:
- 签名交易:机器人通过私钥初始化钱包,对每笔跟单订单进行链上签名(见 src/services/createClobClient.ts)
- 生成 API Key:CLOB 客户端会用私钥派生 Polymarket 的 API 凭证
- 全部存放在
.env:PRIVATE_KEY是必填环境变量,由 src/config/env.ts 在启动时强制校验
一句话总结:谁拿到了你的 .env 文件,谁就拿到了你的钱。所有安全实践都围绕这一条展开。
二、9 条密钥保护最佳实践
1. 使用专用钱包,只放小额资金
官方配置模板 .env.example 末尾的 SECURITY NOTES 明确建议:Use a dedicated wallet with limited funds for the bot(使用只存放有限资金的专用钱包)。
建议做法:
- 新建一个独立的 Polygon 钱包,专门用于跟单
- 只充值你"亏得起"的 USDC(例如 100~500 美元)加少量 POL/MATIC 用于 gas
- 绝不要把日常主钱包的私钥交给机器人
2. 永远不要把 .env 提交到 Git
项目已在 .gitignore 中写入了 .env 规则,但请注意:
- 仓库提供的只是
.env.example模板,你需要自己cp .env.example .env后填写 - 如果你手动执行
git add -A并强制添加.env,它仍会被提交——提交前务必检查git status - 已在远端泄露的私钥,没有任何补救措施能替代"立即转移资产"
3. 用 chmod 600 .env 限制文件权限
部署指南 docs/DEPLOYMENT.md 的 Security Best Practices 给出了标准做法:
chmod 600 .env
这表示只有文件所有者可读写。在共享服务器或 VPS 上部署时,这是防止同机其他用户读取配置的关键一步。
4. 确保私钥不会出现在日志中
项目内置了地址打码机制:src/utils/logger.ts 中的 maskAddress 方法会把钱包地址显示为 0xd3f2******************************95d3 的形式(如上图启动界面所示),避免完整地址进入日志文件。
你还需要注意:
- 不要自己编写
console.log打印PRIVATE_KEY或完整PROXY_WALLET - 分享错误日志到社区求助时,先人工复查日志中是否包含密钥或数据库密码
5. 私钥不带 0x 前缀填写,且只放在 .env 里
按 .env.example 的说明,PRIVATE_KEY 要求不带 0x 前缀。请只在 .env 文件中填写,不要粘贴到聊天记录、截图、issue 或任何文档里。.env.example 模板中该字段旁边就有醒目的警告:
⚠️ NEVER share this key or commit it to git!
6. 用 PREVIEW_MODE = true 预览模式先行测试
.env.example 提供了 PREVIEW_MODE 开关:
PREVIEW_MODE = true # 只监控跟单信号,不实际执行交易
开启后机器人只"看"不"买",是验证配置是否正确、跟单策略是否合理的安全沙盒。确认无误后再切换为 false 投入实盘。
7. 保护 MONGO_URI:数据库密码与私钥同等重要
MONGO_URI 连接串中包含数据库用户名和密码,它存储了你所有的交易历史与持仓记录。docs/DEPLOYMENT.md 的安全清单要求:
- MongoDB 不要暴露到公网(不要使用
0.0.0.0/0的 IP 白名单,改为只放行你的服务器 IP) - 若连接串曾泄露,立即在 MongoDB 控制台修改密码
8. 定期运行健康检查
npm run health-check
健康检查会验证数据库连接、RPC 端点、Polymarket API 可用性及钱包余额(如上图界面中的 HEALTH CHECK 区块)。配置错误(例如地址格式不对)会被 src/config/env.ts 的校验逻辑直接拦截并给出修复提示,避免机器人带着错误配置盲目运行。
9. 制定"泄露应急预案"
万一怀疑私钥泄露,按以下顺序操作:
- 立即用新钱包生成新私钥,停止机器人
- 将旧钱包中剩余 USDC 转移到新钱包
- 更新
.env中的PRIVATE_KEY与PROXY_WALLET - 检查 MongoDB 是否已被异常访问
- 复盘泄露途径(截图?日志?共享服务器?)
三、风险控制清单(上线前逐项勾选)
| # | 检查项 | 说明 |
|---|---|---|
| 1 | ☐ 使用专用小资金钱包 | 主钱包私钥绝不外借 |
| 2 | ☐ .env 未提交到 Git |
已列入 .gitignore |
| 3 | ☐ .env 权限为 600 |
chmod 600 .env |
| 4 | ☐ 日志无明文私钥 | 依赖 logger 打码机制 |
| 5 | ☐ MONGO_URI 未暴露公网 |
IP 白名单限制到本机 |
| 6 | ☐ 已用 PREVIEW_MODE 测试 |
确认策略后再实盘 |
| 7 | ☐ 已设置安全上限 | MAX_ORDER_SIZE_USD / MAX_DAILY_VOLUME_USD 防止异常大额跟单 |
| 8 | ☐ health-check 定期运行 |
快速发现配置异常 |
| 9 | ☐ 泄露预案就位 | 资产转移流程明确 |
其中第 7 项是"资金风险控制":.env.example 提供了 MAX_ORDER_SIZE_USD(单笔上限,默认 $100)、MAX_POSITION_SIZE_USD(单市场持仓上限)、MAX_DAILY_VOLUME_USD(单日交易量上限)三道闸口,即使被跟的大户突然下单 10 万美元,你的钱包也最多只买入上限金额。
四、相关文件索引
- 配置模板与安全说明:.env.example
- 环境变量校验逻辑:src/config/env.ts
- 交易客户端初始化:src/services/createClobClient.ts
- 日志打码实现:src/utils/logger.ts
- 部署与安全最佳实践:docs/DEPLOYMENT.md
- 快速上手指南:docs/QUICK_START.md
⚠️ 免责声明:本软件仅供教育用途,交易存在亏损风险。请务必先阅读 docs/GETTING_STARTED.md 并理解跟单策略后再投入资金。
