登录 ERPC CLI 并查看密钥的保存位置
让本机登录后,ERPC CLI 会将会话保存在您的钥匙串或 1Password 中。本页还介绍节点密钥保存在哪里,以及 erpc 保留哪些文件。
本页介绍 ERPC CLI
v0.1.0-rc.4,这是一个预发布版本。登录
bash
erpc login 通过 OAuth 设备授权许可获取会话。在没有浏览器的机器上,erpc login --no-browser 会打印 URL 和代码,而不是打开浏览器;erpc signup --no-browser 会打印注册 URL。erpc whoami 显示已保存的会话属于谁,erpc logout 会退出登录并删除已保存的会话。选择会话的保存位置
在终端中,
erpc login 会询问使用哪个保存位置:操作系统的钥匙串(默认),或 1Password(在其有响应时)。--store 和 --vault 可不经询问直接选择,所选结果会记录在 config.toml 中,其他命令会从那里读取。如果既没有指定也没有记录选择,erpc 会在设置了
OP_SERVICE_ACCOUNT_TOKEN 时使用 1Password 服务账户,否则在有操作系统钥匙串时使用钥匙串,再否则使用其状态目录中的文件。erpc doctor 会报告正在使用哪个保存位置及其原因。使用服务账户时,erpc 只将 OP_SERVICE_ACCOUNT_TOKEN 传给它自己启动的 op 进程,不会将该令牌写入任何地方。1Password 条目以机器名命名,因此两台机器绝不会共用同一个会话。
ERPC_HOST_LABEL 可覆盖该名称。在 Linux 上
在有 Secret Service 响应的环境中,钥匙串就是 Secret Service。否则它是内核为您的用户提供的持久密钥环,位于内存中,从不写入磁盘:会话一直有效,直到重启或连续几天未使用,之后会再次要求运行
erpc login。没有经过自身登录而启动的 shell(不带 - 的 su、sudo -E)无法使用该密钥环,erpc 会拒绝,并说明这一点。在 macOS 上
erpc 通过
/usr/bin/security 访问钥匙串。以您的身份运行的任何其他程序,同样可以通过运行 security 读取会话;不过钥匙串仍会在静态存储时加密会话,并使其不被其他用户访问。会话位于磁盘上时
erpc 会在三种情况下将会话写入其状态目录:使用
file 保存位置时;对于暂存的会话(无法到达保存位置的已轮换刷新令牌);以及写入被中断之后。只要这类文件存在,erpc doctor 就会逐一报告。在 Unix 上,这些文件以 0600 权限模式创建;在 Windows 上,erpc 不设置自己的权限。节点密钥的保存位置
节点清单,以及各链指南中指明的原始密钥备份,都保存在 1Password 中。并非所有密钥都在 1Password 中,节点可能持有其运行所需的密钥。请自行备份主机上的内容:在没有备份的情况下重装该主机,会丢失这些内容。此外,活跃的 Sui validator 或已当选的 TRON witness 会拒绝迁移到新主机。
其他 RPC 节点不持有 validator 的签名密钥,但它们的主机会保存客户端为自身生成的内容,例如引擎 JWT、对等节点身份或 RPC cookie。
仅有密钥备份并不能确保 validator 恢复的安全。在更换服务器或恢复其数据之前,请遵循该链的恢复流程;各链的指南说明了如何恢复其密钥(节点)。
只有一个命令会将节点密钥写入您本机的磁盘:
erpc validator vote-account 在 Solana CLI 运行期间,将身份密钥和投票密钥写入状态目录下权限为 0600 的文件中,并在之后将其擦除。如果进程意外终止,文件可能会一直留存,直到之后的某次运行将其清理。erpc worker 应用的交易密钥和 Secret 与这些密钥分开保存:密钥与 Secret。





