RustMinerSystem

文档

Web 安全、防火墙与日志 API

RustMinerSystem 安全路径、Web 端口、HTTPS、证书、IP/钱包防火墙和日志查询接口。

Web 安全、防火墙与日志 API

本章包含可能导致后台地址变化、服务重启或访问被阻断的接口。调用前必须确认新地址可访问，并避免把当前管理端 IP 加入黑名单。

Web 访问设置

方法 路径 请求/用途
GET /api/route 获取安全访问路径。
POST /api/route 保存安全路径，主体为 { "k": "new-route" }。
POST /api/web/port/restart 修改 Web 端口，主体为 { "port": 8080 }。
GET /api/web/tls 获取后台 HTTPS 状态。
POST /api/web/tls/{flag} 设置 HTTPS；flag 为 0 或 1。

修改安全路径、Web 端口或 HTTPS 可能使当前请求在服务重启时断开。调用端应根据新地址重新连接，而不是把断开直接判断为保存失败。

挖矿端口证书

方法 路径 用途
GET /api/cert 获取全局挖矿端口证书状态。
POST /api/cert/upload 上传 PEM 证书和私钥。
GET /api/cert/reset 恢复内置证书。

上传请求：

{
  "pem": "<证书文本先执行 URI 编码，再执行 Base64>",
  "key": "<私钥文本先执行 URI 编码，再执行 Base64>"
}

私钥属于敏感数据，不要记录请求体。恢复证书接口虽然会修改状态，但当前前端使用 GET 调用。

IP 黑名单

方法 路径 用途
GET /api/ip/blacklist 获取 IP 黑名单。
POST /api/ip/blacklist/add 添加一个或多个 IP。
POST /api/ip/blacklist/delete 删除一个或多个 IP。
GET /api/ip/coming 获取所有端口 IP 访问记录。
GET /api/ipblacklist/all/log 获取 IP 拦截记录。

添加和删除请求：

{
  "ips": ["192.0.2.10"]
}

钱包黑名单和白名单

方法 路径 用途
GET /api/wallet/blacklist 获取钱包黑名单。
POST /api/wallet/blacklist/add 添加钱包黑名单。
POST /api/wallet/blacklist/delete 删除钱包黑名单。
GET /api/wallet/whitelist 获取钱包白名单。
POST /api/wallet/whitelist/add 添加钱包白名单。
POST /api/wallet/whitelist/delete 删除钱包白名单。
GET /api/bwlist/log 获取钱包黑/白名单命中日志。

钱包添加和删除请求同样使用历史字段名：

{
  "ips": ["<钱包地址或子账号>"]
}

程序和操作日志

方法 路径 用途
GET /api/request/log 获取后台操作日志。
GET /api/running/log 获取程序运行日志。
GET /api/error/log 获取程序错误日志。
GET /api/d/tl 获取矿工连接故障记录。

日志响应可能包含钱包、IP、矿池地址和内部错误信息。对外系统展示前应脱敏，并限制日志 API 的访问权限。