安装 RigeOS Client

RigeOS Client 安装在矿机上，用于向工作台提供状态，并执行你已授权的操作。安装后，矿机才会显示在对应矿场的列表中。

安装前检查

• 你在目标矿场中拥有安装矿机所需的权限。
• 目标矿机可以访问 RigeOS 登录和管理站点。
• 你可以使用系统管理员权限登录该矿机。
• 目标矿机没有正在进行的高风险维护操作，例如系统重装或网络改造。

安装步骤

1. 在目标矿场打开“添加矿机”，生成或复用当前有效的安装短码。
2. 阅读页面的适用架构和安全提示。
3. 复制页面生成的简短安装命令。命令通过 --enroll 携带短码，不会直接暴露矿场 UUID 和完整安装令牌。
4. 登录目标矿机，以系统管理员权限执行该命令。
5. 等待命令完成，再返回工作台刷新矿机列表。

安装短码具有有效期和使用次数限制。只要页面仍保留着当前有效的短码，再次打开“添加矿机”会复用原命令；无需每安装一台矿机就重新生成。刷新页面后，出于安全原因可能需要生成新的短码。

如何确认安装成功

安装完成后，在矿场工作台确认：

• 矿机出现在列表中。
• 在线状态和最后上报时间开始更新。
• 主机名称、操作系统或硬件信息显示合理。
• 矿机详情可以正常打开。

首次上报需要一点时间。请不要在安装完成后立即重复执行多次安装命令。

安装后的本机检查

以下命令只用于查看服务和状态：

sudo systemctl status rigeos-client
sudo journalctl -u rigeos-client -f
sudo rigectl monitor --once

不要手动重复启动 daemon

RigeOS Client 通常由系统服务管理。不要并发执行多个 rigectl daemon；如需排障，请优先查看服务状态和日志。

如果安装后矿机未出现

1. 确认安装命令来自正确的矿场。
2. 查看服务状态和最近日志。
3. 确认目标矿机的网络与 DNS 可用。
4. 等待短暂时间后刷新工作台。

继续排查请阅读Client 离线或不能上报。

共享镜像与无盘矿机

如果多台矿机从同一套母镜像启动，请不要把普通注册后的设备身份直接复制到其他矿机。 应使用影子注册，让每台实例在启动时恢复自己的身份；如果还希望母镜像复制当时的 MINER 运行或停止行为，请继续阅读影子模式与无盘母镜像。

Docker、Kubernetes 与其他容器

受支持的容器会显示为 Cell Linux OS 及对应的容器平台。每个实例必须具有唯一、稳定的 Cell 身份；自动识别失败时，Client 会暂停而不是与其他容器共用身份。Kubernetes 等编排环境应通过平台原生机制注入实例 ID。所需环境变量和身份规则见系统要求与兼容性。