TCMinerProxy 钱包与矿工名热替换

钱包与矿工名热替换

钱包与矿工名热替换用于在端口运行期间动态改写矿机提交的身份。新版规则把钱包和矿工名统一为 wallet.device 组合，不再分别创建钱包规则和矿工名规则。

规则命中后，服务端会强制断开对应矿机，并在矿机下次接入时应用新的钱包与矿工名。

与抽水热更新的区别

只调整费率钱包时使用抽水热更新；需要按矿机当前钱包和矿工名匹配并改写身份时，使用本功能。

打开入口

热替换规则依赖已经创建的端口 ID，因此不能在新建端口尚未保存时配置。可以从以下入口打开：

1. 仪表盘端口列表：端口操作菜单 -> 钱包 / 矿工名热替换。
2. 端口详情页：顶部操作区 -> 钱包 / 矿工名热替换。

端口详情按钮上的数字表示当前端口已有规则数量；规则数为 0 时不显示数字。

组合匹配规则

pattern 由 匹配钱包.匹配矿工名 组成。两侧均可填写单个值、逗号分隔的多个值或整侧 *。

普通值只允许英文字母、数字以及 _、@、-。规则按完整值匹配，不支持正则表达式、部分通配或在钱包、矿工名内部使用 .。

组合替换目标

target 由 目标钱包.目标矿工名 组成。每一侧只能填写一个固定值，或使用对应的保留原值占位符。

• 钱包侧只能使用 #{WALLET} 保留原钱包。
• 矿工名侧只能使用 #{DEVICE} 保留原矿工名。
• target 不支持 * 或逗号列表，占位符也不能放到错误的一侧。

可选矿池重定向

开启 同时重定向挖矿地址 后，还需要填写：

• 矿池地址：目标矿池的 host:port。
• 矿池协议：TCP 或 TLS/SSL，必须与目标矿池地址一致。

不开启时，规则只替换钱包和矿工名，矿机继续使用当前端口配置的矿池。

创建规则

1. 打开热替换弹窗，点击 添加规则。
2. 填写匹配钱包和匹配矿工名，也可以使用 所有钱包、所有矿工 快捷按钮。
3. 填写目标钱包和目标矿工名，也可以使用 保留原钱包、保留原矿工名 快捷按钮。
4. 按需开启矿池重定向并填写地址和协议。
5. 检查界面生成的 pattern 与 target 组合。
6. 点击 创建规则，在二次确认框中再次确认影响范围。
7. 请求期间确认按钮会进入 loading 并禁止重复点击；成功后弹窗展示新规则，失败时确认框保留并恢复按钮。

当前接口只支持组合类型 t=2。旧类型 t=0 和 t=1 已废弃，Web 后台会固定按 t=2 创建。

预览、删除与修改

已保存规则在左侧规则列表中展示。选择规则后可查看完整的匹配组合、目标组合和可选矿池重定向信息。

• 已保存规则为只读预览，不能直接编辑。
• 需要修改时，先删除旧规则，再创建新规则。
• 删除也需要二次确认；请求期间确认按钮会显示 loading 并禁止重复点击。
• 新增或删除成功后，页面会重新获取规则列表和端口矿工数据。

验证是否命中

规则命中并且矿机重新接入后，进入端口详情的设备列表检查钱包和矿工名。页面会分别展示：

「原值」已重定向为「目标值」

使用 #{WALLET} 或 #{DEVICE} 的一侧会解析为矿机当前值。若矿工已经重连但没有出现具体目标提示，可依次检查：

1. 设备返回的 wd 是否有值。
2. 当前端口的规则列表中是否存在相同 ID。
3. 对应规则是否为 t=2，且 target 是有效的 wallet.device 组合。

wd 对应 /api/ht/{server_id} 响应元组下标 0 的规则 ID。旧字段 hw、hd 已废弃。完整接口结构见代理端口与抽水钱包 API。

操作建议

• 先用少量测试矿机验证，再扩大匹配范围。
• 谨慎使用 *.*，它可能让当前端口的大量矿机同时掉线重连。
• 创建前再次核对钱包、矿工名、目标矿池和协议。
• 规则新增或删除后，回到端口详情确认设备身份和上游矿池数据。
• TP/NGINX 纯转发端口不解析真实钱包和矿工名，不适合使用身份热替换。