ERPC CLI 命令
用一张表列出 ERPC CLI 的全部命令组,以及适用于每个命令的选项和脚本可以依赖的退出码。
本页介绍 ERPC CLI
v0.1.0-rc.4,这是一个预发布版本。命令组
运行任何不带子命令的命令组(例如
erpc validator 或 erpc worker)即可列出其子命令。全局选项
--json提供机器可读的输出:erpc --json <command>。ERPC_JSON=true的效果相同。在节点命令中,--json必须放在命令之前。--lang设置 erpc 使用的语言:en、ja、zh或ru。未指定时,erpc 使用locale设置,若没有该设置则使用系统语言。
错误与退出码
失败的输出在各处都相同:一行
error: 说明出了什么问题,如果有下一步可做,还会有一行 hint: 说明接下来该怎么做。使用 --json 时,失败是标准输出上的一个对象 {"error": {"code", "exit", "message", "hint"}}。有两种情况会改为打印 clap 自身的消息并以 2 退出:在终端中 clap 无法解析的命令行,以及节点命令树(erpc validator、rpc、node)的子命令不接受的参数,后者即使在 --json 下也是如此。只有当命令需要向脚本进一步说明它在失败前做了什么时,才会出现 details 字段,并且在终端中从不出现。被 Ctrl-C(或 SIGTERM、SIGHUP)停止时,erpc 会以该信号本身结束,因此脚本中的循环也会停止。已发布的代码会保留其名称和退出状态,且代码从不重复使用。
存储与备份
bash
erpc storage buy 购买 ERPC Global Storage 方案,费用从 ERPC Credit 中支付。方案和价格请见价格。erpc storage
erpc storage put会在发送文件的任何部分之前在本机上对其加密,除非指定了--no-encrypt。ERPC 只存储加密后的字节,从不持有密钥。erpc storage get会识别加密文件并将其解密。- 每个账户有一个存储密钥,保存在
erpc login选择的保存位置中。erpc 不会将其保存在 Linux 内核密钥环中(该密钥环在重启后会丢失):请使用--store 1password或--store file登录,或使用--no-encrypt。使用file保存位置时,密钥以未加密的形式存放在~/.erpc/storage-key(权限模式 0600)中。--no-encrypt会将您要发送的文件按原样上传,不加密。 - 丢失存储密钥会丢失所有用它加密的文件,且 ERPC 无法恢复。
erpc storage key export --show会打印密钥,以便在本机之外保存一份副本;erpc storage key import可在另一台机器上将其导入。 - 文件存储所用的路径及其大小对 ERPC 可见。
erpc storage keys list显示存储访问密钥,erpc storage keys revoke <n>撤销其中一个。
erpc backup
erpc backup 使用 restic 将机器备份到 ERPC Global Storage。文件在离开您的机器之前就已在本地加密,ERPC 从不持有能打开备份的密码。- 每台机器都会获得一个仅追加的密钥,该密钥无法删除自身的备份。运行过
erpc backup init的机器还持有能够删除备份的密钥,因此只有在既不保存 erpc 会话、也不保存账户备份 Secret 的机器上,这种保护才有效。 - 请在这些机器之外保存一份
erpc backup password --show的副本。同时丢失主密码和每台机器的backup.env会导致备份丢失。 - 备份会排除已知的密钥文件和系统 Secret,例如
.ssh/id_*、.config/solana/id.json、erpc 的会话和 SSH 主机密钥。以其他名称或在其他位置存放的密钥材料会像其他文件一样被备份:请使用--exclude将其排除。 - erpc 安装 restic 0.19.1,并根据编译进 erpc 的 SHA-256 摘要检查压缩包和程序。
- 计划任务:在 Linux 上,先运行
sudo erpc backup init,然后运行sudo erpc backup schedule daily。在 macOS 上,运行erpc backup schedule daily ~/Documents;该任务以您的身份、在您登录期间运行。 - 备份存放到账户的默认区域。
erpc backup在它所备份的机器上运行;worker 的服务器则改用erpc worker backup on进行设置(备份应用的状态数据)。






