升级 RigeOS Client

Client 升级用于获得新功能、修复和兼容性更新。升级前应先了解版本说明，并从少量测试矿机开始。

升级前检查

• 阅读版本说明、适用架构和已知影响。
• 确认目标矿机在线，且没有正在进行的飞行表、网络或维护操作。
• 先选择一台可恢复的测试矿机。
• 确认有可用的远程或带外访问方式，以便出现异常时排障。

升级步骤

1. 在 Client 升级入口查看可用版本。
2. 选择适用于目标矿机的版本。
3. 勾选测试矿机，阅读确认信息后下发升级。
4. 在操作进度中查看每台矿机的状态。
5. 升级完成后，确认矿机重新在线、版本已更新、MINER 状态正常。

Client 会在 Server 提供的合规候选中选择传输量更小的升级方式：优先使用适配当前基线的差分包；没有可用差分、基线不匹配或校验失败时，自动回退到压缩完整包。还原后的目标二进制仍会经过大小、SHA-256 和签名校验，再原子切换。

升级后检查

• 工作台显示的 Client 版本符合预期。
• 矿机持续上报，最后上报时间正常更新。
• 飞行表、MINER 和硬件指标保持正常。
• 运行事件中没有持续失败或回退提示。

升级失败时

不要立即反复对同一台矿机下发升级。先查看页面和 Client 日志中的具体阶段；“网络异常”“磁盘空间不足”“基线不匹配”和“制品校验失败”需要不同处理。特别是系统盘已满时，curl 可以下载并不代表 Client 能写入和安装目标版本。

本机可先检查：

rigectl status
rigectl logs --warn --lines 300
rigectl cleanup
df -h /

继续阅读终端、升级与控制冲突。