了解产品 预约演示
首页/产品使用文档/裸金属管理系统文档/功能清单

裸金属系统功能清单 · 整体大纲

完整功能范围 · 依据系统功能清单整理

范围：运维管理端 + OpenAPI + 边缘组件（Agent / LogicNode / PXE） 结构：业务域 → 功能组 → 功能点 说明：大纲级；整体详单见 docs-metal-system-feature-list.md

章节目录

  1. 仪表盘与工作台
  2. 机房与基础设施
  3. 服务器与机器生命周期
  4. 硬件资产与库存
  5. IP 地址管理
  6. 镜像、驱动与模板
  7. 系统装机与 PXE 编排
  8. 带外电源与远程控制
  9. 端口转发
  10. 逻辑器与节点监控
  11. 开放 API 与外部鉴权
  12. 系统管理与权限
  13. 监控审计与边缘运行时

1. 仪表盘与工作台

运维首页总览：资源占用、电源分布、公告与近期操作。详单见 docs-metal-system-feature-list.md

1.1 工作台

  • 在线用户摘要：当前会话用户一览
  • 系统状态卡片：主机/服务概览
  • 通知入口：公告与站内消息
  • 电源状态图表：机器电源分布
  • 资源占用概览：租用/托管/机柜汇总
  • 近期操作摘要：底部操作日志片段

1.2 分析页（弱化）

  • 访问分析演示：时段/浏览器/地域等 ContiNew 演示组件，非裸金属核心

2. 机房与基础设施

地区、机房、机柜与主控/被控连通探测。

2.1 地区管理

  • 地区列表：名称、编码、状态、备注
  • 条件查询：关键词搜索
  • 新增 / 编辑地区：名称、编码、备注
  • 启用 / 禁用：控制地区可用性

2.2 机房管理

  • 机房卡片列表：按机房浏览并进入详情
  • 新增机房：名称/别名、内外网 IP、网关、掩码、DNS、区域、坐标、临时 VLAN、备注
  • 被控连接配置：被控账号密码、SSH 端口、被控 KEY、被控端口（默认 9443）
  • 端口转发池配置：外网端口区间；独立同步服务 IP/端口（默认 9450）
  • 机房状态探测：并发探测被控 health → 正常/异常/未配置

2.3 机房详情

  • 机房摘要编辑：网络与被控摘要
  • 部署与网络信息：部署信息、静态路由、备注
  • 统计信息：机柜数等汇总
  • 基础状态探测：SSH 探针 — HTTP/SMB/FTP/DHCP/TFTP/DNS 监听；CPU/内存/磁盘/网卡吞吐
  • 机柜 Tab：在机房内添加与维护机柜

2.4 机柜管理

  • 机柜列表：归属机房、容量、单位、备注
  • 新增 / 编辑机柜：容量、联系人、电力单位、价格、计费与启用日期等
  • 删除机柜：移除空闲或废弃机柜

3. 服务器与机器生命周期

机器检索、电源批量、装机重装、回收站、详情、型号分组与装机任务。

3.1 机器检索

  • 多维筛选：机器编码/MAC/IPMI IP、机房、机柜、分组、状态、机型
  • 机器列表：编号、机房机柜、配置摘要、IPMI/开机卡、电源/逻辑器/业务状态
  • 新增机器：建档；可同步型号配置与配件数量
  • 编辑机器：型号、配件数量、网卡、IP、状态等
  • 单机电源：开机/关机/重启（IPMI 或开机卡）
  • 批量电源：异步批量开机/关机/重启
  • 批量查电源状态：刷新多机电源态
  • 单机重装：弹窗选择镜像与装机参数
  • 批量装机：多机并行创建装机任务
  • 装机任务条：顶部进度/步骤轮询
  • 停止装机：清理任务；可选关机并填原因
  • 故障登记：登记故障与解决描述/时间
  • 移入回收站：软删除
  • 回收站还原：按配件型号重绑后恢复
  • 彻底删除：解绑硬件、释放 IP、去分组

3.2 设备概要（机器详情）

  • 概要总览：示意图、配置、业务/装机状态
  • 硬件信息编辑：配置字段维护
  • 重装进度控制：暂停/取消暂停/停止（Windows 可暂停）
  • 电源操作：开机/关机/重启
  • 修改引导设备：PXE/Disk/BIOS/CDROM（IPMI）
  • 救援系统：开启/关闭救援
  • 远程连接信息：系统账号密码、远程端口；ToDesk/向日葵
  • IP 地址 Tab：查看绑定 IP
  • 硬件 Tab：查看已绑硬件明细
  • 订单 Tab：关联 productId/orderNo
  • 日志 Tab：机器相关日志

3.3 机器分组

  • 分组列表：供应商名称、备注
  • 新增 / 编辑分组：名称、备注
  • 分配机器：按机房/机柜/编码/CPU/GPU 勾选关联
  • 分组明细：查看已分配机器

3.4 服务器型号

  • 型号列表：名称与配件模板摘要
  • 新增 / 编辑型号：CPU/GPU/内存/主板/系统盘/数据盘数量、网卡
  • 删除型号：移除不用的模板
  • 同步到机器：建档或编辑时套用型号配置

3.5 机器配件

  • 配件关联：配件名与机器绑定
  • 按配件过滤：列表按配件名筛选

3.6 装机任务与变更

  • 装机任务页：系统安装/改密/救援/取硬件/开关机重启；进度与镜像
  • 机器变更日志：字段前后值、来源、调用链路 ID
  • 硬件变更历史：类型/名称、变更数量、库存与资产编号前后值

3.7 常用命令库

  • 命令列表：名称、内容、分类、适用 OS、启停
  • 新增 / 编辑命令：维护可下发脚本
  • 启用 / 禁用命令：控制是否可选

4. 硬件资产与库存

CPU/GPU/磁盘/内存/主板型号与 SN 明细、编号规则与出入库。

4.1 配件型号库

  • CPU 型号：机房、名称、规格、备注；CRUD
  • GPU 型号：机房、名称、显存等、备注；CRUD
  • 内存型号：机房、名称、容量、备注；CRUD
  • 磁盘型号：机房、名称、容量、备注；CRUD
  • 主板型号：机房、名称、备注；CRUD

4.2 硬件明细（SN）

  • 明细列表：序列号、状态（在库/已使用/故障/报废）、绑机
  • 新增明细：录入 SN 与初始状态
  • 状态变更：在库/使用/故障/报废流转
  • 解绑 / 换绑：调整与机器关系

4.3 出入库与编号

  • 出入库记录：按硬件类型记录库存变动
  • 资产编号规则：机房别名 + 日期格式 + 硬件类型 + 位数
  • 库存突破开关：绑机时是否允许超出在库明细（机房级）

5. IP 地址管理

IP 分组、网段与单地址分配释放。

5.1 IP 分组

  • 分组列表：名称、备注、占用比例
  • 新增 / 编辑分组：名称、备注
  • 删除分组：移除空分组
  • 进入地址：查看分组下地址

5.2 网段管理

  • 网段列表：CIDR、占用比例、自动分配开关、VLAN、类型
  • 添加网段：分组、机房、起止 IP、CIDR（/8~/28）、VLAN、类型、自动分配、备注
  • 修改网段：调整参数或自动分配
  • 删除网段：释放未占用网段

5.3 IP 地址明细

  • 地址列表：单 IP、绑定机器、MAC、状态
  • 分配 / 占用：装机 DHCP 按 MAC/可用 IP 占用
  • 释放地址：解绑后回收可分配

6. 镜像、驱动与模板

镜像导入与详情、驱动、分组、脚本库、Linux 装机模板。

6.1 镜像管理

  • 镜像列表：机房、分组、系统名、类型、源文件、使用次数、启用、对外、远程辅助、排序
  • 条件查询：按机房/分组/类型/启停筛选
  • 导入镜像：选机房 → 扫描被控镜像目录（多机房取交集）→ ISO/GHO
  • 复制镜像：基于已有镜像复制
  • 修改镜像：基本信息与开关项
  • 启用 / 禁用：控制是否可被选用
  • 注入进度：解压/驱动注入状态轮询

6.2 镜像详情

  • 基本信息：ISO/GHO、官方标记、对外/远程辅助、账号、结束步骤标记、简介
  • 关联驱动：Windows 驱动打包；关联/移除
  • 分区设置：ext4/xfs/btrfs/swap 或 NTFS；系统盘/数据盘尺寸
  • 镜像脚本：上传被控、在线编辑、依赖脚本、变更日志、按名下载

6.3 驱动与分组

  • 驱动库：驱动包维护，供镜像打包
  • 镜像分组：名称、编码、排序、状态、对外使用、备注

6.4 脚本与模板

  • 脚本库：可复用装机/运维脚本资产
  • Linux 装机模板：provision linux-install-template 维护
  • FTP（未启用）：历史入口，已由脚本库等替代

7. 系统装机与 PXE 编排

装机任务、PE 步骤模板、DHCP/iPXE、救援与硬件采集。

7.1 装机任务编排

  • 创建装机任务：镜像、账号密码、固定 IP、keepData、引导模式、装机盘、自定义步骤/脚本、callbackToken
  • 批量创建任务：多机并行装机
  • 自动准备：校验 → 渲染目录 → DHCP → iPXE → IPMI 上电
  • 暂停 / 恢复：暂停请求、取消暂停、恢复
  • 停止并清理：结束任务；可选关机
  • 任务查询：列表、明细日志、自定义配置回读
  • 步骤快照：任务维度固定快照，不受后续模板改动影响

7.2 PE 环境步骤模板

  • 步骤树：拖拽排序、启用
  • 结束标记：装机流程结束步骤；镜像结束步骤开关

7.3 DHCP / iPXE 发布

  • DHCP 发布：机房 SSH 下发 isc-dhcp；MAC 优先机器 mac
  • iPXE 发布：写被控 /opt/wuyou/images/{image}/ipxe/ 脚本

7.4 装机回调与里程碑

  • 里程碑事件：IPXE_BOOT_OK / PE_BOOT_OK / OS_INSTALL_* / POST_INSTALL / CLEANUP
  • 回调鉴权：X-Provision-Callback-Token 或 query token

7.5 救援、引导与采集

  • 救援模式：进入/退出救援系统
  • 引导设备切换：PXE/磁盘等（与电源章协同）
  • 初始化密码：装机或改密任务设置初始口令
  • 硬件信息采集：PE 阶段采集并回写

7.6 PXE 边缘素材

  • Windows PE 脚本链：分区、挂 SMB、apply、改密/IP/主机名、重启
  • Linux 发行版模板：ubuntu20/22/24；passwd / rescue
  • TFTP/iPXE 引导文件：undionly.kpxe、ipxe.linux 等
  • 被控安装包：nginx/smb/dhcp/tftp 与安装脚本

8. 带外电源与远程控制

IPMI/开机卡电源、SOL、KVM、远程桌面辅助。

8.1 电源控制

  • 单机电源：开机/关机/重启；按 machine_type 分流 IPMI/开机卡
  • 批量电源：异步入队执行
  • 电源状态查询：单机或批量刷新

8.2 SOL 与 KVM

  • SOL 串口控制台：WebSocket 路径 + 登录 token
  • BMC KVM：返回 BMC Web/iKVM 地址
  • 嵌入控制台页：bmcKvmEmbed、machineConsole

8.3 远程桌面辅助

  • 向日葵 / ToDesk：脚本取连接信息；callback 回写
  • OpenAPI 远程桌面：按 deviceCode 取/刷新 ticket

9. 端口转发

机房端口池规则、同步状态与跨机房迁移。

9.1 转发规则

  • 规则列表：机房、机器编码、内外网 IP/端口、启用、同步状态
  • 新增 / 编辑规则：内部 IP/端口、外部 IP/端口
  • 删除规则：移除转发
  • 启用 / 停用：控制是否生效

9.2 同步与迁移

  • 同步状态：PENDING_SYNC / 已同步 / STOPPED
  • 导出同步规则：JSON 对齐被控 port-forward sync
  • 跨机房迁移：预览目标外网端口；迁移后可删源规则
  • 机房端口池联动：min/max 与独立 sync host/port

10. 逻辑器与节点监控

心跳指标、命令下发、运行配置推送。

10.1 逻辑器心跳

  • 逻辑器列表：机器编号、在线、数据来源、最后心跳、监听端口
  • 指标展示：CPU/内存/硬盘/GPU、磁盘 IO、网卡 IO
  • 条件查询：按机器/在线状态筛选

10.2 命令下发

  • 下发记录：脚本类型、状态、耗时、结果刷新
  • 选用常用命令：从命令库选取下发
  • 结果回传：签名执行后回传主控

10.3 运行配置

  • 批量推送配置：enabled、心跳间隔、命令监听开关
  • 补齐上下游地址：主控写入 agent/master 地址

11. 开放 API 与外部鉴权

External API Key、OpenAPI 与业务 /busi-metal 能力面。

11.1 API 鉴权配置

  • 密钥列表：调用方密钥一览
  • 生成密钥：创建并展示 API Key
  • 启用 / 禁用密钥：控制访问
  • 调用人 / 链路 ID：Header 或 Query 必填审计字段

11.2 目录与机器查询 API

  • 健康与鉴权探活：/health、/auth/verify
  • 目录数据：机型/地区/镜像分组/镜像/机器分组/供应商/机房
  • 机器查询：列表、空闲、空闲计数、按型号、搜索、批量获取、详情

11.3 生命周期动作 API

  • 首次装机：POST 创建机器并装机（可带 orderNo/productId）
  • 装机任务查询：任务进度与明细
  • 电源动作：开机/关机/重启
  • 重装 / 救援 / 停装：对应 actions
  • 状态回写：update-status（租用/空闲等）
  • 电源状态批量查询：power-status

11.4 控制台与端口转发 API

  • 控制台：SOL/KVM 相关入口
  • 远程桌面 ticket：获取与刷新
  • 端口转发 CRUD：含批量删除

11.5 业务回调

  • 异步 callbackUrl：装机/电源等完成后 HTTP 回调业务
  • correlation / operationNo：关联业务单据

12. 系统管理与权限

人员角色菜单、文件公告、站点/登录/安全与 API 鉴权；弱化支付实名。

12.1 组织与权限

  • 用户管理：增删改查、导入导出、重置密码、分配角色
  • 角色管理：菜单与接口权限；分配/取消用户
  • 菜单管理：目录/菜单/按钮；清缓存
  • 部门管理：组织树与归属
  • 字典管理：字典与字典项

12.2 文件与公告

  • 文件管理：上传下载、文件夹、回收站
  • 通知公告：发布、查看、置顶
  • 消息中心：站内消息

12.3 系统配置

  • 网站配置：名称、LOGO、版权、备案
  • 安全配置：密码策略与锁定
  • 登录配置：验证码等
  • 存储配置：对象存储启停与默认
  • 客户端配置：多端客户端
  • API 鉴权配置：见第 11 章入口

12.4 常规运营设置

  • 站点常规：语言、域名、站名、维护模式等
  • SSL / 通知 / 自动化：运维偏好表单
  • IP / 安全 / 其他偏好：弱耦合运营项

12.5 登录准入

  • 账号密码登录：运维人员登录
  • 密码过期处理：引导更新密码
  • 个人中心：资料与密码修改

13. 监控审计与边缘运行时

操作/登录日志、在线用户；Agent / LogicNode / PXE 运行时。

13.1 日志与在线

  • 操作日志：请求 ID、链路 ID、模块、内容、耗时、字段变更；导出
  • 登录日志：登录成功/失败记录
  • 业务登录日志：业务侧相关登录审计
  • 在线用户：会话列表、强制下线
  • 短信日志：若启用短信时的发送记录

13.2 任务调度

  • 定时任务：snail-job 任务维护
  • 任务日志：执行历史
  • 调度系统日志：组件级日志

13.3 metal_agent（机房被控）

  • 健康探测：/metal-agent/health
  • framedmux 中继：握手后多路转发 BMC/开机卡/内网服务
  • HTTP 反代：逻辑器 upstream、端口转发同步
  • 端口转发服务：入站监听与 pfsync（默认 9450）

13.4 metal_logic_node

  • 心跳上报：metrics → Redis
  • 命令监听执行：默认端口 19527；签名校验
  • 配置热更新：config.json

13.5 PXE 素材运行时

  • 边缘装机资产：与第 7.6 节对应的落地文件与服务

附录 A：运维管理端菜单对照

  1. 仪表盘：工作台
  2. 机房管理：地区 / 机房 / 机柜
  3. 服务器：机器检索、分组、型号、硬件库、出入库、编号规则、端口转发、装机步骤、任务、命令、逻辑器、变更历史
  4. IP 管理：分组 / 网段 / 地址
  5. 镜像与驱动：镜像、驱动、分组、脚本库、Linux 模板
  6. 系统管理：用户/角色/菜单/部门/字典/文件/公告/配置
  7. 系统监控：在线用户、操作/登录日志
  8. 任务调度：定时任务与日志

未启用 / 脚手架（简述）

  • 镜像子页 partition/tasks/bootScript、旧 groups/ftp：空壳或已替代
  • 分析页、代码生成、租户插件：ContiNew 脚手架
  • 支付/实名配置：UI 已注释

附录 B：业务系统触点（简短）

  • 用户端：我的裸金属（电源/重装/救援/控制台/端口转发等，经 OpenAPI）
  • 管理端：选机开通、空闲计数、镜像/机型目录同步
  • 回调：装机与电源等异步结果回写业务单

v1 · 裸金属系统大纲