配置 RPC 端点

最后更新：2026年9月7日

本应用没有后端服务器，而是直接向各条网络发起查询。 因此每条网络都需要一个数据源：要么是官方公开 API，要么是您提供的节点 RPC 地址。 本页说明如何配置数据源，以及当它无法响应时该怎么办。

填写端点

1. 设置（首页顶部的 ⚙）→ 网络。
2. 选择网络。副标题已经显示它当前使用的数据源，或提示尚未配置。
3. 点击 配置 RPC 节点 / 更改端点，输入地址。地址必须以 http:// 或 https:// 开头。
4. 若节点需要身份验证，请在同一对话框中填写用户名与密码。
5. 点击 测试连接：应用会获取当前区块高度，并显示"OK"或具体的错误信息。
6. 重置会恢复默认值：有官方地址的网络恢复该地址，其余网络恢复为空白。

凭据保存在哪里

RPC 用户名和密码写入 Android Keystore / iOS 钥匙串，每条网络一个条目。 它们绝不会出现在应用设置、备份文件、日志或应用安装包中。

• 密码不会再次显示。重新打开对话框并将该字段留空，会保留已保存的凭据。
• 清除凭据会将其从安全存储中删除。
• 导出的备份只包含 RPC 地址 —— 绝不包含密码，也不包含用户名。

运行自己的节点

这些网络都是 Bitcoin 或 Dash 的分叉：RPC 在守护进程的配置文件中设置， 各网络所需的配置项完全相同。

server=1
rpcuser=<用户名>
rpcpassword=<足够长的随机密码>
rpcbind=0.0.0.0                  # 监听网络地址，而不仅仅是 localhost
rpcallowip=<可信 IP>/32          # 限制谁可以调用 RPC
# rpcport=...                    # 除非确有需要，否则保留各网络的默认端口

各网络对应的守护进程、配置文件、默认端口以及应用调用的方法：

未出现在上表中的网络 —— Cosanta、Neoxa 和 Flux —— 是通过公开浏览器或 API 读取的，而非 RPC 节点。它们不需要开放任何 RPC 端口， 您要改的始终只是一个网址。

HTTPS 与反向代理

守护进程提供的是明文 HTTP，而应用在全部十四个网络上都接受它： 没有任何主节点守护进程提供 TLS，而被监控的节点往往只能在局域网内访问， 公共可信证书在那里毫无意义。不过走 HTTP 时，一切都会以明文传输 —— 守护进程的响应，尤其是 RPC 密码（如果有的话）。只要链路不可信， 就请在 RPC 前面加一层 TLS 反向代理（Caddy、Nginx 或 Traefik）， 然后把代理的地址填给应用。使用 Caddy 只需两行，证书还会自动签发：

rpc.example.com {
    reverse_proxy 127.0.0.1:9998
}

您也可以让代理而非守护进程来承担 Basic 认证。两种做法下， 应用都通过 TLS 传输凭据，绝不明文发送。

各网络的注意事项

开箱即用的网络

Beldex、Firo、Cosanta 和 Neoxa 自带官方公开数据源， 完全无需配置。不过有两点仍值得了解：

• Beldex 是唯一可以叠加多个端点的网络。它们会按顺序依次尝试， 因此第二个地址就是一次自动故障切换。
• Firo 提供两种模式。公开浏览器可立即使用，但不公开 PoSe 数值分， 因此被处罚的节点在被封禁前看起来仍然正常。您自己的 firod 会公开该分值 —— 并且在您的节点掉线时自动回退到公开浏览器。

必须使用自有节点的网络

PIVX、Dash、Syscoin、Divi、Raptoreum、SmartCash、SwiftCash、BitCore、Flux 和 Terracoin 初始状态为未配置。这是有意为之，而非疏漏，背后有两个不同的原因。 前八个网络都没有公开主节点列表的官方公共端点，与其把您的流量导向一个您从未选择过的商业网关， 我们宁愿把该字段留空。Flux 和 Terracoin 属于另一种情况：官方数据源确实存在且响应正常， 但其运营方不允许应用程序查询 —— 两者均已于 2026-08-25 从默认值中移除。

• 除 PIVX 外，其余网络都必须进行身份验证；PIVX 为可选 —— 公共节点可能不要求，而您自己的 pivxd 通常会要求。
• 需要 API 密钥的网关（NOWNodes、GetBlock 等）无法使用： 应用不会发送 api-key 请求头。无需密钥的公共网关可能可用， 前提是它开放主节点列表相关方法 —— 许多网关只提供区块查询。
• 这些网络的浏览器要么已停止服务，要么被有意关闭。如果您知道可信的公共端点， 直接粘贴即可。
• Flux 不需要凭据 —— 它的 API 公开且只读 —— 每个 FluxNode 都在端口 16127 上以明文 HTTP 提供同一个 API：请填写 http://您的IP:16127。相邻的两个端口都是死路 —— 16126 是网页界面， 16128 则是同一个 API，但使用手机拒绝信任的自签名证书。

一条需要特别提醒的网络

安全

• 切勿把未启用身份验证的 RPC 暴露在公网上。开放的 RPC 意味着您的节点 —— 有时还包括钱包 —— 任人摆布。请使用 rpcallowip、防火墙、VPN 或带认证的反向代理。
• 使用足够长的随机密码。RPC 是机器接口，没有人需要反复手动输入它。
• 在添加节点的输入框中绝不要输入私钥。监控只需要公开数据。 在部分网络上，应用仅凭格式就能在任何请求离开设备之前拒绝私钥。
• 凭据始终留在设备上，保存于系统安全存储中 —— 不在设置里，不在备份中，也不在日志里。

故障排查

仍未解决？请把网络名称、测试连接显示的确切错误以及守护进程版本发给我们 —— 详见支持页面。切勿发送任何凭据。