批量修改矿机名称
批量改名使用命名模板为所选矿机生成新名称。系统会先展示逐台预览，只有校验通过的矿机才会进入名称同步队列。
快速开始
- 在矿机列表中勾选需要修改的矿机。
- 点击顶部操作栏中的“批量改名”。
- 输入命名模板并点击“预览”。
- 检查每台矿机的新名称和跳过原因。
- 确认后等待 Client 同步系统主机名。
最常用的模板是按顺序编号：
text
worker-${seq:03}预览结果类似 worker-001、worker-002。${seq:03} 表示把序号补足为三位。
可用变量
| 变量 | 含义 | 示例 |
|---|---|---|
${seq} | 本次所选矿机中的顺序，从 1 开始 | 1 |
${id} | 矿机 ID | 01K... |
${uuid} | 矿机 UUID | 83a5... |
${mac} | 首个可用网卡的 MAC 地址 | 00:11:22:AA:BB:CC |
${name} | 当前矿机名称 | rack-a-01 |
${hardware} | 当前矿机的硬件标识 | 用于生成区分名称 |
模板至少需要包含一个变量。固定文本可以直接写在变量前后，例如 sh-${seq:02}。
常用转换
转换写在变量后面，并使用 | 连接：
| 转换 | 作用 | 示例 |
|---|---|---|
upper | 转为大写 | `${name |
lower | 转为小写 | `${name |
compact | 移除冒号、连字符、点、下划线和空格 | `${mac |
take(n) | 保留前 n 个字符 | `${id |
takeLast(n) | 保留后 n 个字符 | `${mac |
prefix(text) | 在值前添加文本 | `${seq |
suffix(text) | 在值后添加文本 | `${seq |
replace(from,to) | 替换指定文本 | `${name |
slice(start,end) | 截取指定范围，允许负数位置 | `${uuid |
多个转换可以连续使用：
text
gpu-${mac|compact|takeLast(6)|lower}结果类似 gpu-a1b2c3。
名称规则
- 结果长度必须为 1～63 个字符。
- 必须以英文字母开头。
- 只能包含英文字母、数字和连字符
-。 - 不能与同一矿场中的其他矿机名称重复。
- 预览不会修改矿机；重复、格式错误或缺少所需数据的条目会被跳过。
先小范围验证
建议先选择少量矿机预览，确认排序和变量结果符合预期后，再扩大选择范围。
Client 版本要求
批量改名会同时更新 RigeOS 中的矿机名称和主机系统 hostname。矿机必须运行支持名称同步的 RigeOS Client；如果页面提示客户端不支持，请先完成 Client 升级后重试。
离线矿机可以保留名称同步目标，并在重新上线后执行。最终是否完成，以页面显示的名称同步状态为准。