使用 rigectl
rigectl 是 RigeOS Client 提供的本机命令行工具。它适合在已经登录矿机后查看状态、跟踪日志和收集诊断信息。不同 Client 版本的子命令可能略有差异，以本机 rigectl help 为准。
常用状态与日志
bash
# Client 与当前挖矿状态
rigectl status
rigectl version
# Client 日志
rigectl logs --lines 200
rigectl logs --warn --lines 300
# MINER 状态和最近日志
rigectl miner status
rigectl miner status --json
rigectl miner logs --lines 200
# 一次性或持续查看设备监控
rigectl monitor --once
rigectl monitorrigectl status 会分别显示 Client、飞行表配置和 MINER 进程状态；不要把“已配置”和“运行中”混为一件事。miner status --json 适合脚本读取错误阶段、重试次数、日志路径和目标版本。
MINER 依赖与镜像跟随
bash
# 查看兼容依赖；安装会修改系统软件包
rigectl miner deps
rigectl miner deps --install
# 查看或配置母镜像跟随行为
rigectl miner follow status
rigectl miner follow on
rigectl miner follow off安装依赖无法解决所有 ABI 不兼容。例如系统软件源不提供目标 libssl.so 版本时，应改用静态链接、自带兼容运行库的 MINER 包，或升级操作系统，而不是强行复制动态库。
磁盘清理
bash
# 预览可清理内容，不删除文件
rigectl cleanup
# 查看完整受管目录盘点
rigectl cleanup --verbose
# 供脚本读取
rigectl cleanup --json
# 确认后执行
rigectl cleanup --apply默认输出只展示可释放量、候选和保留策略。当前身份、状态、配置、正在使用的 MINER 实例、当前 Client 和最近回退版本不会作为普通清理候选。
LAN 拓扑
Root 或 Leader 可以查看 LAN 状态与拓扑：
bash
rigectl lan status
rigectl lan top
rigectl lan top -g
rigectl lan top -m-g 展开 Group，-m 展开成员。LAN 优化是否启用以及当前角色由 Server 策略决定。
服务与诊断
bash
systemctl status rigeos-client
journalctl -u rigeos-client -f
rigectl doctor
rigectl support-bundle在 Cell Linux OS 容器平台中，进程可能由容器编排器管理；此时以 rigectl status 显示的进程管理方式为准，不要假定一定存在 systemd。
使用边界
- 不要并发手动启动多个
rigectl daemon。 - 不要删除身份、状态或升级目录来“重新注册”。
- 不要把 Token、钱包信息或敏感参数复制到公开位置。
- 控制命令执行前，先确认不会与工作台任务或其他平台发生冲突。
- 需要持续排障时，优先生成支持诊断包，而不是修改不熟悉的文件。