系统要求与兼容性
RigeOS Client 需要运行在受支持的 Linux 环境和硬件架构上。安装页面会显示与当前发布版本相关的适用信息。
安装前确认
- 目标主机具有受支持的 CPU 架构。
- 可以使用系统管理员权限执行安装。
- 网络可以访问 RigeOS 站点。
- 系统具备稳定的存储空间和网络连接。
Linux OS 与 Cell Linux OS
| 运行环境 | 当前支持 | 身份来源 |
|---|---|---|
| Linux OS | 普通有盘、无盘、WSL 等受支持 Linux 环境 | 使用稳定硬件摘要或影子注册规则。 |
| Cell Linux OS（Docker） | Docker 容器 | 稳定且唯一的容器实例 ID。 |
| Cell Linux OS（Kubernetes） | Kubernetes Pod | 通过 Downward API 注入的 Pod UID。 |
| Cell Linux OS（其他容器） | 能满足身份和运行要求的 Linux 容器 | 平台提供的稳定唯一实例 ID。 |
Cell Linux OS 必须能取得每个实例唯一且稳定的身份。自动识别不足时，需要同时设置：
text
RIGEOS_CELL_PLATFORM=docker|kubernetes
RIGEOS_CELL_INSTANCE_ID=每个实例唯一且稳定的值Kubernetes 推荐使用 Downward API 直接注入 Pod UID：
yaml
env:
- name: RIGEOS_CELL_PLATFORM
value: kubernetes
- name: RIGEOS_CELL_INSTANCE_ID
valueFrom:
fieldRef:
fieldPath: metadata.uidClient 不使用 MAC、宿主机 UUID 或 GPU 数量猜测 Cell 身份。无法确认时会暂停接入，避免多个容器被合并成同一台矿机。Pod 被替换并取得新的 UID 时，会作为新设备接入；若业务要求实例重建后沿用同一身份，编排层必须提供比 Pod 生命周期更长、同时又不会被多个副本共享的稳定槽位 ID。
容器内不要求存在 systemd 或 hostnamectl。Server 分配的名称首先保存为 RigeOS 逻辑矿机名；容器不会因为无法修改运行时 hostname 而注册失败。
Cell 内只能看到分配给当前容器的设备。若页面显示的 GPU 数量与实际配额不符，请先检查容器设备映射和 Client 版本，不要按宿主机 GPU 总数判断。
GPU 能力提示
不同厂商、驱动版本和硬件型号可提供的监控或控制能力可能不同。页面未显示某项功能时，不应通过不受支持的命令强行启用。
当前超频和自动风扇等高级功能应优先在受支持的 NVIDIA 环境中使用。AMD/Intel 的具体能力与支持范围应以对应发行说明和页面提示为准。
与其他控制平台共存
如果主机还使用其他矿机管理平台或调优工具，请先检查是否存在控制冲突。不要让多个工具同时修改同一项超频、风扇、网络或 MINER 配置。