主机管理
登记网络里的设备(按 MAC 识别),给每台机器分配独立的引导行为,并跟踪其在线状态。
相关文档: 引导菜单配置 | 访问控制 | WOL 网络唤醒 | BMC 带外管理
什么时候用
- 某台机器要固定装某个系统 → 登记主机 + 绑定 Profile
- 机房批量上线 → 通过 自动化 API 循环创建
- 想远程唤醒 / 带外开关机 → 登记主机后操作
- 想看到哪些机器最近引导过 → 在线状态与引导次数
入口:管理 → 主机管理(/hosts),详情页 /hosts/:id。
任务 1:新建主机
点击「新建主机」:
| 字段 | 说明 |
|---|---|
| 名称 | 必填,如 server-01 |
| MAC 地址 | 必填,小写十六进制,冒号或短横线分隔(如 aa:bb:cc:dd:ee:01) |
| IP | 可选(已知 IP 可填) |
| 关联配置(Profile) | 绑定引导菜单,决定该机器如何引导 |
MAC 与名称均唯一:重复创建会报冲突。
批量登记多台主机没有内置 CSV 导入;可通过 自动化与 CI 集成 的 REST API 循环创建。
任务 2:绑定引导行为
两种方式:
- 详情页绑定:打开主机 → 关联 Profile → 保存。之后该机器引导时直接走该 Profile
- 批量场景可配合 自动化与 CI 集成 用 API 完成
任务 3:远程控制
主机详情页可发起:
- WOL 网络唤醒:向该 MAC 发送魔术包,唤醒关机状态的机器(支持定时调度)
- BMC/IPMI 电源控制:登记带外信息(BMC 地址/账号)后,可远程开机、关机、重启、查电源状态,支持批量操作
在线状态
有引导记录的主机在详情页显示「在线」。仪表盘的「在线主机」统计则取最近 10 分钟内有引导记录的机器。列表还显示引导次数与最近在线时间,用于确认装机/引导是否成功。
API
主机 CRUD、唤醒、BMC 操作均有对应 REST API,端点清单见 REST API 参考。