1. 10-运营管理端
DCIM
  • 默认模块
    • whmcs回调
  • DCIM Backend API
    • 用户入口
      • 工单
        • 工单列表
        • 创建工单
    • 认证
      • 用户登录
      • 管理员登录
      • API认证
    • 系统
      • 系统更新
        • 检查系统更新
        • 获取更新日志
      • 系统API管理
        • 获取系统API列表
        • 创建系统API
        • 修改系统API
        • 删除系统API
      • 获取公共系统配置
    • 服务器
      • 服务器管理
        • 自定义字段
          • 获取服务器自定义字段
          • 创建服务器自定义字段
          • 修改服务器自定义字段
          • 删除服务器自定义字段
        • 添加服务器
        • 获取服务器详情
        • 编辑服务器
        • 删除服务器
        • 空闲服务器IP段
        • 自动分配MAC地址
        • 控制服务器电源
        • 修改服务器备注
        • 获取服务器日志
        • 获取服务器电源状态
        • 获取服务器监控信息详情
        • 获取服务器交付信息
        • 开启服务器DHCP
        • 服务器列表Excel导出
        • 服务器列表Excel导出下载
      • 服务器IP地址
        • IPv6
          • 自动批量分配IPv6段
          • 生成指定数量的IPv6地址
          • 空闲ipv6
          • 批量分配IPV6段
          • 获取服务器IPv6地址列表
        • IPv4
          • 空闲ip
          • 设置主ip
          • 分配IPV4段
          • 获取服务器IPv4地址列表
          • 分配ip
          • 获取服务器IP地址块
          • 获取IP段列表
          • 获取IP地址列表
      • 服务器硬件
        • 服务器硬件管理
          • 发送真实硬件获取脚本
          • 获取服务器真实硬件历史
          • 获取服务器真实硬件历史详情
        • 获取服务器硬件列表
        • 分配服务器硬件
        • 移除服务器硬件
        • 返修服务器硬件
        • 获取批次类型
        • 获取硬件类型
        • 获取批次采购时间
        • 获取批次硬件
        • 获取机柜服务器列表
      • 服务器分配
        • 取消分配api
        • 取消分配服务器给用户
        • 获取服务器分配列表
        • 获取服务器分配列表
        • 获取用户服务器下拉列表
        • 分配服务器给用户
      • 服务器规格
        • 分配规格
        • 取消规格
      • 服务器交换机端口
        • 修改交换机端口
        • 修改交换机端口 - QoS
        • 修改交换机端口 - VLAN
        • 获取交换机端口
      • 服务器重装
        • 镜像列表
        • 服务器重装系统
        • 获取重装系统镜像列表
        • 获取镜像预设分区
        • 重置服务器操作系统管理员密码
      • 服务器故障
        • 服务器故障
      • 服务器网卡管理
        • 获取服务器网卡列表
        • 服务器网卡添加
        • 服务器网卡修改
        • 服务器网卡删除
      • 服务器杂项接口
        • 获取服务器可用的IP地址列表
        • 获取可用的网关设备
        • 获取服务器网关设备绑定的自定义脚本
        • 执行服务器网关设备绑定的自定义脚本
        • 绑定服务器网卡
        • 获取服务器网卡获取端口vlan
        • 统计服务器电源功耗数据
        • 获取服务器被攻击事件
      • 服务器IPMI
        • 检测服务器KVM类型
        • 获取服务器mac地址
        • 获取服务器IPMI控制台
        • 关闭服务器IPMI控制台
        • 检查vnc连接
        • 获取服务器在线的会话
        • 发送键盘操作到IPMI控制台
        • 服务器电源控制
        • 重置服务器BMC
        • 启动救援模式
        • 修改服务器hostname
        • 取消服务器下所有关联
        • 设置服务器主端口开关
        • 设置服务器下一次启动顺序
        • 设置服务器从在线ISO启动
        • 获取服务器KVM文件
        • 获取IPMI用户列表
        • 添加IPMI用户
        • 修改IPMI用户状态
        • 修改IPMI用户密码
        • IPMI在线检测
        • 删除IPMI用户
      • 服务器简单锁定
        • 修改简单锁定
        • 删除简单锁定
        • 增加简单锁定
        • 获取简单锁定状态
      • 服务器流量计费
        • 获取流量计费列表
        • 添加流量计费
        • 修改流量计费
        • 删除流量计费中的服务器
        • 关联添加流量计费
        • 关联修改流量计费
        • 指定流量包列表
        • 添加流量包
        • 删除流量包
        • 获取流量池列表
        • 删除流量池
      • 服务器预下架
        • 创建服务器预下架请求
        • 删除服务器预下架请求
        • 获取服务器预下架请求
      • 服务器任务
        • 获取服务器任务进度
        • 取消服务器任务
      • 服务器分组管理
        • 添加服务器分组
        • 获取服务器分组列表
        • 编辑服务器分组
        • 获取单条服务器分组详情
        • 删除服务器分组
      • 通过序列号获取服务器信息
      • 获取服务器列表
      • 获取交付服务器通知内容
      • 服务器交付通知
      • 获取服务器端口
    • 数据源
      • 数据源回调处理
    • 管理员
      • 管理员
        • 获取管理员列表
        • 获取管理员详情
        • 修改管理员信息
        • 添加管理员
        • 删除管理员
        • 获取管理员列表(简化版)
        • 上传管理员头像
      • 获取当前会话权限
      • 获取当前管理员信息
      • 修改当前管理员信息
      • 获取当前管理员OTP二维码
      • 绑定当前管理员OTP
      • 解除绑定当前管理员OTP
      • 获取指定管理员OTP二维码
      • 绑定指定管理员OTP
      • 解除绑定指定管理员OTP
    • 授权
      • 获取授权模块信息
      • 获取机器码
      • 检查授权证书更新
      • 更改授权证书
      • 获取本地授权信息
      • 更新授权证书
      • 使用文件上传更新授权证书
      • 使用序列号更新授权证书
    • 数据中心
      • 数据中心
        • 添加数据中心
        • 获取数据中心列表
        • 修改数据中心
        • 获取数据中心详情
        • 删除数据中心
      • 获取仪表板数据中心列表
      • 获取数据中心机柜列表
      • 获取数据中心能耗带宽图表
      • 获取数据中心下的交换机
      • 获取数据中心选项
    • 机柜
      • 机柜
        • 添加机柜
        • 获取机柜列表
        • 编辑机柜
        • 获取机柜详情
        • 删除机柜
      • 获取机柜空间
      • 获取机柜中的交换机
      • 统计机柜电源功耗数据
      • 解除锁定
      • 获取指定数据中心的机柜列表
      • 获取机柜图片列表
      • 上传机柜图片
      • 获取机柜图片
    • 会话
      • 删除会话
      • 查看会话
    • 用户
      • 用户管理 - OTP
        • 获取二维码信息
        • 绑定otp
        • 解除绑定otp
        • 获取二维码信息
        • 绑定otp
        • 解除绑定otp
      • 用户管理 - API
        • 用户 API 列表
        • 创建用户 API
        • 修改用户 API
        • 删除用户 API
      • 用户管理
        • 用户列表
        • 添加用户
        • 获取用户详情
        • 编辑用户
        • 删除用户
        • 关键字搜索用户
        • 用户下拉列表
        • 用户服务器列表
        • 用户IP地址列表
        • 用户IP地址列表
        • 用户IP地址列表
      • 用户组管理
        • 创建用户组
        • 用户组列表
        • 创建管理员组
        • 管理员列表
        • User用户组列表
        • 编辑用户组
        • 删除用户组
        • 编辑管理员组
        • 删除管理员组
        • 用户组详情
        • 管理员用户组列表
        • 获取组通知权限内容
        • 修改组通知权限内容
        • 获取个人通知权限内容
        • 修改个人通知权限内容
      • 获取SSH Key
      • 添加SSH Key
    • 文件
      • 获取文件哈希
      • 下载文件
    • 网络安全
      • 获取可用数据源模块
      • 获取数据源远程数据
      • 数据源列表
      • 创建数据源
      • 获取安全事件列表
      • 创建安全事件
      • 标记安全事件完成
      • 删除安全事件
      • 获取安全概览信息
      • 获取按IP地址排名
      • 获取按IP段排名
      • 获取轮询数据源类型
      • 测试轮询数据源连接
      • 获取轮询数据源列表
      • 创建轮询数据源
      • 更新轮询数据源
      • 删除轮询数据源
      • 获取轮询数据源下的MO列表
      • 迁移MO IP
      • 获取轮询数据源下的访问列表
      • 获取轮询数据源下的告警列表
    • 日志管理
      • 获取操作日志列表
      • 获取登录日志列表
      • 获取特定模型操作日志
      • 记录操作日志
    • 控制台
      • 获取会话命令日志
      • 获取会话连接日志
    • 被控管理
      • 被控管理
        • 获取被控设备列表
        • 添加被控设备
        • 编辑被控设备
        • 删除被控设备
        • 获取单个被控设备
      • 检查被控设备版本
      • 请求被控设备下载新版本
      • 请求被控设备应用新版本
      • 获取被控设备当前负载
      • 获取被控设备历史负载
      • 获取被控设备选择列表
      • 检查主机是否在线
      • 获取VNC令牌
      • 清理镜像缓存
    • 工单
      • 工单状态管理
        • 获取工单状态列表
        • 添加工单状态
        • 编辑工单状态
        • 删除工单状态
      • 工单管理
        • 获取工单详情
        • 删除工单
        • 获取工单列表
        • 创建工单
        • 快速编辑工单状态
      • 工单回复管理
        • 获取工单部门列表
        • 获取工单部门下的管理员
        • 查看工单回复信息
        • 增加工单回复
        • 修改工单回复
      • 消息分类管理
        • 获取消息分类列表
        • 创建消息分类
        • 编辑消息分类
        • 删除消息分类
      • 分类信息管理
        • 获取分类信息列表
        • 创建分类信息
        • 编辑分类信息
        • 删除分类信息
      • 工单部门管理
        • 工单部门
          • 添加工单部门
          • 获取工单部门列表
          • 编辑工单部门
          • 删除工单部门
        • 自定义字段
          • 获取自定义字段
          • 创建自定义字段
          • 修改自定义字段
          • 删除自定义字段
        • 获取类型列表
        • 获取类型参数
    • 镜像
      • 镜像管理
        • 镜像列表
        • 添加镜像
        • 远程下载镜像
        • 镜像详情
        • 修改镜像
        • 删除镜像
        • 获取存储镜像文件名列表
        • 上传镜像
        • 获取镜像选项
        • 删除被控上缓存的镜像源文件
        • 获取公开镜像列表
        • 同步文件
        • 获取下载进度
      • 镜像分区方案
        • 获取镜像分区方案列表
        • 添加镜像分区方案
        • 获取镜像分区方案详情
        • 修改镜像分区方案
        • 删除镜像分区方案
        • 根据镜像获取分区方案
      • 镜像分组
        • 获取镜像分组列表
        • 添加镜像分组
        • 获取镜像分组详情
        • 编辑镜像分组
        • 删除镜像分组
        • 获取服务器分组列表
    • 规格管理
      • 添加规格
      • 获取规格列表
      • 获取规格信息
      • 修改规格
      • 删除规格
      • 获取规格详情
      • 规格分配服务器
      • 获取规格中可用的服务器
      • 获取规格列表
      • 规格服务器列表
    • 通知模板管理
      • 通知模板列表
      • 添加通知模板
      • 通知模板修改
      • 通知模板删除
      • 获取语言列表
      • 获取通知类型
      • 获取供应商列表
      • 获取供应商字段
      • 获取供应商配置字段
      • 添加或编辑供应商配置字段
    • 驱动管理
      • 获取驱动列表
      • 添加驱动
      • 获取驱动详情
      • 编辑驱动
      • 删除驱动
      • 获取驱动下拉列表
    • SSH Keys
      • 获取 SSH Key 列表
      • 添加 SSH Key
      • 修改 SSH Key
      • 删除 SSH Key
    • 首页
      • 首页统计
    • 返修
      • 返修列表
    • 任务
      • 任务列表
      • 取消任务
      • 任务详情
    • 全局搜索
      • 全局搜索
    • 交换机管理
      • 交换机端口关联关系管理
        • 获取所有交换机端口的关联关系
        • 刷新所有交换机端口的关联关系
        • 更新交换机拓扑图多点位置信息
        • 删除交换机拓扑图单点位置信息
      • 交换机脚本管理
        • 获取交换机控制脚本内置变量
        • 获取交换机控制脚本列表
        • 创建交换机控制脚本
        • 获取交换机控制脚本详情
        • 修改交换机控制脚本
        • 删除交换机控制脚本
        • 交换机关联控制脚本
      • 交换机管理
        • 预览交换机控制脚本
        • 执行交换机控制脚本
        • 获取端口详情
        • 获取交换机 Chassis Mac
        • Web 远程连接
        • 创建交换机上下联
        • 删除交换机上下联
        • 获取交换机详情
        • 修改交换机
        • 删除交换机
        • 获取交换机端口列表
        • 获取交换机端口列表V2
        • 获取端口差异列表
        • 更新端口差异
        • 修改交换机备注
        • 抓取交换机SNMP连接状态
        • 获取交换机自定义字段
        • 创建交换机自定义字段
        • 修改交换机自定义字段
        • 删除交换机自定义字段
        • 获取网关地址IP
        • 获取交换机IP段
        • 执行交换机端口开关脚本
        • 执行交换机端口限速脚本
        • 执行交换机端口vlan脚本
        • 获取端口流量
        • 修改端口备注
        • 端口流量排行
        • 更新端口mac
        • 解锁交换机mac地址绑定
        • 加锁交换机mac地址绑定
        • 交换机端口状态获取
        • 交换机端口名备注修改
        • 交换机端口自动获取mac
        • 交换机端口自动获取物理mac
        • 交换机端口自动获取链路速率
        • 交换机端口自动获取mtu
        • 获取交换机端口上的所有mac地址
      • 交换机高级功能
        • 添加交换机ARP绑定
        • 删除交换机ARP绑定
        • 添加交换机ACL绑定
        • 删除交换机ACL绑定
        • 执行交换机批量动作
        • 交换机故障申报
        • 开启交换机Netconf功能
        • 获取交换机关联网关
        • 增加交换机网关关联
        • 解除交换机网关关联
      • 交换机流量与会话管理
        • 获取指定交换机端口的流量
        • 获取指定端口的流量
        • 获取交换机信息
        • 获取交换机在线的会话
        • 修改交换机账号密码
      • 获取交换机扩展支持
      • 获取交换机列表
      • 添加交换机
      • 修改简单锁定
      • 通过 SNMP 获取交换机型号
    • 硬件管理
    • 数据模型
      • ImagePartitionBrief
      • Server
      • ImagePartitionDetail
      • ServerCreate
      • ImagePartitionCreate
      • ServerUpdate
      • ImagePartitionUpdate
      • IpBlock
      • VirtualDisk
      • Part
      • Partition
      • IpmiUser
      • ErrorResponse
  • DCIM手册
    • docs-manual
      • 90-附录
        • 如何把本手册导入 Apifox(含图片处理说明)
        • 常见问题 FAQ
        • 截图待补充清单
      • 30-单机服务器端
        • 《单机服务器访问端(server 角色)》
      • 20-客户自助端
        • 《客户自助端:开始使用》
        • 客户端:管理我的服务器(详情/电源/重装/救援/控制台)
        • 客户端:我的网络(IP / 流量 / 带宽)
        • 《客户端:提交与跟进工单》
        • 《客户端:账户设置、SSH 密钥与 API》
      • 10-运营管理端
        • 《运营管理端总览》
        • 《首页(数据概览)》
        • 《机柜与数据中心管理》
        • 服务器管理(核心)
        • 《交换机管理》
        • 《硬件型号与 PDU 电源管理》
        • 《设备故障与维护记录(issues)》
        • 《IPv4 地址资源管理》
        • 《IPv6 地址资源管理》
        • 网络安全:源地址校验、ARP 绑定与攻击防护
        • 《Cloudflare 与攻击防护数据源》
        • 《内网设备与流量/带宽计费》
        • 《部件与批次管理(备件库)》
        • 《工单管理》
        • 用户与规格(套餐)管理
        • 《统计报表》
        • 系统设置:基础参数 / 邮件 / 短信 / 公告 / 证书 / 文件
        • 系统设置:操作系统镜像与分区方案
        • 系统设置:备份 / 远程存储 / 从节点 / Webhook / 序列号规则
        • 带宽限速(流量计费与自动限速)
        • 《远程控制台(VNC/KVM)与会话录像》
        • 任务队列
        • 运维审计与日志
        • 《管理员账号与权限分组》
        • 《检测工具》
      • 00-入门指南
        • 欢迎使用 ServerOS / DCIM 用户手册
        • 产品简介:这套系统是做什么的(DCIM 是什么)
        • 《IDC / 数据中心术语速查表》
        • 《登录与首次使用》
        • 《界面布局与导航总览》
        • 《账号角色与权限说明》
  1. 10-运营管理端

《部件与批次管理(备件库)》

适用角色:运营管理端(admin)
菜单位置:左侧导航栏 部件管理,包含 批次管理 / 部件列表 / 批次类型 / 返修列表 四个子菜单。

本节带你认识数据中心的「备件库」——也就是机房里那些 CPU、内存、硬盘、网卡等硬件零件的进货、登记、装机、维修和报废全过程。即使你完全不懂机房业务,跟着本节也能学会日常管理。


1. 先搞懂几个概念(小白必读)

数据中心里有成千上万台服务器,每台服务器都是由一堆硬件「零件」拼起来的。系统用一套「备件库」来记账,管理这些零件从买进来到用坏报废的全过程。涉及四个核心名词:

名词通俗解释生活类比
部件(Part)一个具体的、单独的硬件零件,比如「这一条具体的内存」。每个部件在系统里是独一无二的一条记录。超市货架上那一瓶矿泉水(有自己的瓶身编号)
批次(Batch)一次性买进来的一批同样的零件。比如「2024 年 3 月从某供应商买的 100 条同型号内存」就是一个批次。一个批次里会包含很多个部件。超市一次进货的一整箱矿泉水(同品牌、同规格、同进货日)
批次类型 / 部件类型(PartType)给零件分大类,比如 CPU、内存、硬盘、PCI 设备。决定了登记这个零件时需要填哪些专业参数。超市把商品分成「饮料区」「零食区」
返修(Rework)零件用坏了,送去维修或退给供应商换货的处理流程及其登记记录。矿泉水过期了登记报损、或者退回厂家

为什么要按「批次」管理?
同一批买进来的零件,往往采购时间、单价、供应商、保修期都一样。按批次记账,财务对账、保修索赔、统计库存都更清楚。你只需要建一次批次并填好「数量」,系统就会自动按数量生成对应数量的部件单件。

下面几个零件专业词,第一次见到时这样理解即可(详见《IDC 术语速查表》):

  • CPU:中央处理器,服务器的「大脑」。
  • 内存(RAM):临时数据存放区,决定服务器能同时处理多少活,断电就清空。
  • 硬盘(HD/SSD):长期存数据的仓库,断电不丢。
  • PCI 设备:插在主板插槽上的扩展卡,常见的有网卡(连网线/光纤)、RAID 卡(管多块硬盘)、显卡等。
  • 序列号 / 资产序列号:序列号(serialno)是厂商贴在零件上的出厂编号;资产序列号(system_serial_number)是本系统按规则自动生成的内部编号,用来给本公司资产唯一打标签、贴条码。

parts-menu-overview.png

2. 批次类型(部件类型)

菜单位置:部件管理 > 批次类型

这里管理零件的「大类」。系统内置了 4 种不可修改、不可删除的基础类型,并允许你自行添加其他类型。

2.1 内置类型与自定义类型

类型编号名称能否修改/删除说明
1CPU否(系统内置)登记时会出现 CPU 专属参数(核心数、线程数、品牌)
2内存否(系统内置)登记时出现内存专属参数(容量、类型、电压、高度、品牌)
3硬盘否(系统内置)登记时出现硬盘专属参数(容量、类型、接口、品牌)
4PCI设备否(系统内置)登记时出现 PCI 专属参数(PCI 类型、端口数量、品牌)
5 及以后由你自定义是例如「电源」「散热风扇」「主板」等,使用通用自定义参数

注意: 上述 4 个内置类型(CPU、内存、硬盘、PCI设备)在列表里不显示「修改」「删除」按钮,系统后台也会直接拒绝改名或删除编号为 1~4 的类型,这是为了保证这些标准类型的专属参数表单始终可用。

2.2 列表与字段

页面顶部有筛选栏,可按名称搜索。列表每行显示:

  • 类型编号:系统自动分配的序号(type_code)。
  • 名称:类型的中文名,支持按名称排序。

2.3 添加 / 修改 / 删除类型

  1. 点击右上角 添 加 按钮,列表末尾会出现一行可编辑的输入框。
  2. 输入类型名称,按回车或点击 确认 即保存。名称不能为空(空白会提示「名称不能为空」),且不能与已有类型重名(系统会校验唯一性)。
  3. 对自定义类型,点击该行的 修改 可改名(改完同样点 确认 保存),点 取消 放弃;点击 删除 可删除。
  4. 删除前系统会弹出「确认删除此类型?」提示,确认后才执行。

删除限制: 只有「名下没有任何批次」的类型才能删除。如果已经有批次使用了这个类型,删除会失败——你需要先清空相关批次。

二次验证(视部署配置而定): 若系统开启了「危险操作需两步验证」,删除类型时会要求输入双因素验证码(即手机验证器 App 上每 30 秒刷新一次的 6 位动态码)。未开启该配置时直接删除。

📷 (界面截图待补充:批次类型列表页,显示内置的 CPU/内存/硬盘/PCI设备 以及自定义类型,并展示右上角"添 加"按钮)


3. 批次管理(进货登记)

菜单位置:部件管理 > 批次管理

这是备件库的主入口。每当采购了一批新硬件,就在这里登记成一个「批次」。

3.1 列表页

页面顶部是筛选栏(可按硬件名称、硬件类型、机房、品牌、采购时间等条件过滤),右上角有两个按钮:快速出库 和 添 加。列表每行展示以下字段:

列名含义
硬件名称该批次的官方型号名(officalmodel)。点击可进入该批次的部件列表。
硬件类型CPU / 内存 / 硬盘 / PCI设备 / 自定义类型
机房这批零件存放/归属的机房(数据中心)
品牌零件品牌
硬件参数该类型的专属参数汇总(如内存的「容量 / 类型 / 电压 / 高度」)
空闲数量这批零件中状态为「闲置」、尚未装机的数量
库存数量这批零件的总数量
采购时间采购日期
操作修改、删除图标

空闲数量 vs 库存数量:库存数量是这批进了多少个;空闲数量是其中还没被装进任何服务器、可随时领用的个数。两者的差,就是已经装机或已出库/维修中的数量。

parts-batch-list.png

3.2 新增批次(核心操作)

点击右上角 添 加,弹出「批次 添加」表单。表单分为通用字段和按硬件类型动态变化的专属字段两部分。

通用字段(所有类型都要填):

字段是否必填说明
硬件类型必填下拉选择 CPU/内存/硬盘/PCI设备或自定义类型。选择后,下方会自动切换出对应的专属参数。
机房必填下拉选择这批零件归属的数据中心
硬件名称必填输入官方型号;输入时会自动联想同类型已登记过的型号,方便沿用
数量必填,≥1这批进了多少个零件。系统会按此数量自动生成对应数量的部件单件。新增后数量不可再改(修改批次时该字段为只读)
采购时间必填选择采购日期
价格必填,≥0单价/采购价(数字,最大约 99 亿,即 9999999999.99)
供应商必填供货商名称
备注选填补充说明

专属字段(随「硬件类型」自动切换):

  • CPU 类型:CPU核心(1–100 的数字)、CPU线程(1–100 的数字)、CPU品牌(INTEL / AMD / 其他,必填)。
  • 内存类型:内存容量(必填)、内存类型(DDR2 / DDR3 / DDR4 / DDR5,以及对应的 ECC 版本 DDR2-ECC / DDR3-ECC / DDR4-ECC / DDR5-ECC)、内存电压(低电压 / 正常电压)、内存高度(正常 / 半高)、内存品牌(必填)。
    • 「ECC」是一种能自动纠正内存错误的服务器级内存,比普通内存更可靠。
  • 硬盘类型:硬盘容量(GB,必填)、硬盘类型(SSD 固态 / HD 机械)、硬盘接口(SATA / SAS / NVMe)、硬盘品牌(必填)。
  • PCI设备类型:PCI类型(RAID卡 / 网卡电 / 网卡光 / 直通卡 / 显卡,必填)。当选「网卡电」或「网卡光」时,会额外出现 PCI端口数量 输入框(必填,填数字);最后填 PCI品牌(必填)。
    • 「网卡电」指用网线(电口)的网卡,「网卡光」指用光纤(光口)的网卡。
  • 自定义类型:提供 4 个通用「自定义参数」输入框 + 品牌(品牌必填)。

关于「资产序列号生成规则」(必填):无论哪种硬件类型,专属字段区域顶部都有一个 资产序列号生成规则 下拉框,且为必填项——新增批次时必须选择一条规则(规则来源于「设置」里配置的序列号规则)。选定规则后,系统在生成部件时会按该规则自动给每个部件分配一个唯一的「资产序列号」,并在编号末尾补足 8 位流水号;有了资产序列号,部件才能生成条码、做扫码出库。

填完后点击 立即添加 保存(修改已有批次时按钮显示为 立即修改),点 取消 放弃。

parts-batch-add-form.png

3.3 修改 / 删除批次

  • 在列表「操作」列点击编辑图标即可修改批次信息(数量不可改)。
  • 点击删除图标,或勾选多行后用底部 删除 按钮批量删除。删除前会确认「确认删除 N 个批次 ?」。

删除限制: 如果该批次里还有部件被装在某台设备上(即部件有所属位置),删除会被拒绝。必须先把这些零件从设备上拆下、状态回到闲置后才能删除整个批次。删除批次会连带删除其下所有部件记录。

二次验证(视部署配置而定): 若系统开启了「危险操作需两步验证」,删除批次时会要求输入双因素验证码(手机验证器 App 上的动态码)。未开启该配置时直接删除。


4. 部件列表(批次内的单件管理)

进入方式:在 批次管理 列表点击某一行的「硬件名称」链接,进入该批次的部件列表。
注:左侧菜单里的 部件列表 子菜单同样进入这一类列表界面。

这里列出某个批次下的每一个具体零件单件。页面顶部是面包屑返回头(点标题可刷新当前页),右侧有三个按钮:生成资产序列号、出/入库、保存。

4.1 列表字段

列名含义
ID部件的系统内部编号
序列号厂商出厂序列号,可在此直接编辑录入(见 4.2)
资产序列号系统按批次规则生成的内部编号
机房所属机房
关联设备这个零件目前装在哪台设备上。若已装机,显示「设备名 (#ID)」并可点击跳转到该服务器详情
状态闲置 / 使用 / 维修 / 出库(见下方状态表)
硬件类型 / 硬件参数 / 品牌 / 硬件名称继承自所属批次
采购时间继承自所属批次
操作生成条码、详情、删除

部件状态一览:

状态(系统值)中文显示含义
Idle闲置在库、未装机,可领用
Using使用已装在某台服务器/设备上正在使用
Malfunction维修出故障,处于返修流程中
Export出库已出库(领走/退货/报废)

parts-part-list.png

4.2 录入厂商序列号

「序列号」列里每行都是可编辑输入框:

  1. 在某个部件的「序列号」框里输入厂商序列号。
  2. 按回车可单独保存该行;或修改多行后点右上角 保存 一次性提交。(保存 按钮默认是灰色不可点,只有你改动过序列号后才会亮起。)
  3. 同一批次内序列号不能重复,系统会校验,重复会报错「序列号已被占用」。

4.3 生成资产序列号(追加生成空白单件)

右上角 生成资产序列号 按钮用于在该批次下追加生成新的空白部件(只有批次绑定了资产序列号规则时才可点击;由于新增批次时规则为必填,正常情况下都可用)。

  1. 点击 生成资产序列号,弹窗显示当前批次绑定的规则名称。
  2. 在 资产序列号数量 中填入要追加生成的部件个数。
  3. 点 确定,系统会在该批次下追加生成相应数量的新部件,并自动分配资产序列号;批次的库存数量会随之增加。

这相当于「这批又到货了 N 个,按同样规则补登记进来」。

4.4 生成条码(打印资产标签)

  1. 勾选列表中已有资产序列号的部件(无资产序列号的勾不动),点击底部 生成条码;或在某行「操作」列点 生成条码 单独打印一个。
  2. 弹出条码预览与打印设置:可设置纸张大小(A4-210mm297mm / A3-297mm420mm / 自定义;选自定义时手动填尺寸的宽、高 mm)、条码间隔(上下、左右间距 mm,默认上下 3mm、左右 5mm)、布局(纵向 / 横向)、出血(mm,印刷术语,指内容超出裁切线的安全留边)。
  3. 点 打印 调起浏览器打印,把条码贴到对应零件上,便于日后扫码出入库。

📷 (界面截图待补充:条码生成/打印弹窗,展示条码预览与纸张大小/尺寸/条码间隔/布局/出血 等打印设置)

4.5 部件详情与生命周期

在某行「操作」列点击 详情,进入「部件详情」页,可看到:

  • 部件基础信息(表格):硬件名称、硬件类型、品牌、机房、序列号、资产序列号。
  • 标题旁一个状态下拉框,可手动变更该部件状态(闲置 / 使用 / 维修 / 出库)。变更时会弹出「变更设备状态」输入框要求填写「原因」,原因必填,不填会提示「请输入原因」并取消变更;变更成功后记入生命周期。
  • 部件生命周期:以时间轴形式按时间倒序记录该零件经历的所有关键事件(入库、装机、状态变更、返修等),便于追溯。

📷 (界面截图待补充:部件详情页,上方状态下拉框+基础信息表格,下方"部件生命周期"时间轴)

4.6 删除部件

在「操作」列点 删除,或勾选多行后用底部 删除 按钮。删除前确认「确认删除 N 个部件 ?」。

删除限制: 只有状态为「闲置」的部件才能删除(系统会拒绝删除非闲置部件,提示部件未处于闲置状态)。删除后系统会自动重新统计该批次的库存数量。

二次验证(视部署配置而定): 若系统开启了「危险操作需两步验证」,删除部件时同样会要求输入双因素验证码。


5. 扫码出入库

「出入库」用来批量记录零件的进出,强烈建议配合条码扫码枪使用,手动输入也可以。有两个入口:

  • 批次内出入库:在某批次的「部件列表」页点右上角 出/入库,弹窗含「扫码入库」「扫码出库」两个标签页。
  • 快速出库:在「批次管理」列表页点右上角 快速出库,直接进入出库流程(不针对特定批次)。

5.1 扫码入库

「入库」用于把带厂商序列号的实物零件录入到当前批次:

  1. 把光标停在输入框(弹窗打开时会自动聚焦),用扫码枪扫零件上的条形码,或手动输入序列号后回车(也可点 确定 提交一行)。
  2. 每扫一个,序列号就被加进下方列表(自动去重,重复的不会再加)。每行显示序列号、硬件类型、硬件参数,可点 删除 移除。
  3. 全部扫完后点 确定 提交。系统会为这些序列号在当前批次下创建部件,并按批次规则同时分配资产序列号。若某序列号在本批次内已存在,会提示「序列号已被占用」。

提示: 输入框要求英文输入法。如果检测到中文字符,会提示「请切换输入法至英文」并清空输入。

5.2 扫码出库

「出库」用于把零件标记为已出库(领走、退货、报废等):

  1. 同样用扫码枪扫码或手动输入——但出库扫的是 资产序列号(系统编号)。
  2. 每扫一个,系统会根据资产序列号查出该部件信息并加入列表(显示序列号、资产序列号、硬件类型、硬件参数),可点 删除 移除。
  3. 点 确定 提交,这些部件状态会被置为 出库(Export)。

📷 (界面截图待补充:出入库弹窗,展示"扫码入库""扫码出库"两个标签页与扫码输入框、已扫列表)


6. 把部件绑定到服务器

部件登记入库后,真正「装机」是在服务器那边完成的,而不是在本菜单里。流程概览:

  1. 进入 服务器管理 > 某台服务器详情 > 硬件列表。
  2. 把库里闲置的零件挑出来装到这台服务器上。绑定后,该部件状态变为 使用(Using),「关联设备」会显示这台服务器,可从部件列表直接点链接跳回服务器详情。
  3. 若要把零件从服务器上拆下,在服务器的硬件列表里移除,部件状态会回到 闲置(Idle),所属位置清空。

也就是说:本节(部件管理)负责进货、登记、出入库、维修台账;装机/拆机的实际动作在「服务器管理」里完成。 两边数据是联动的——这里的「空闲数量」「关联设备」「状态」会随着服务器侧的装拆自动变化。


7. 返修流程与返修列表

零件用着用着坏了,就要走「返修」:标记故障 → 送修/退换 → 修好后归位。

7.1 发起返修(在服务器侧)

返修的发起点同样在 服务器管理 > 某服务器 > 硬件列表 > 返修。发起返修时需要填写:

字段是否必填说明
状态必填选择 维修(Malfunction) 或 出库(Export)
返修时间必填送修日期
联系人必填对接人姓名
电话必填联系电话(系统按中国号码格式校验,格式不对会提示「电话无效」)
负责人必填内部负责人
标签 / 备注 / 方式选填标签、备注说明、返修方式(如寄修、上门等)

提交后,该部件状态变为所选状态(维修 / 出库),并在「返修列表」里生成一条未完成的返修记录。

7.2 返修列表

菜单位置:部件管理 > 返修列表

集中查看所有待处理 / 已处理的返修记录。顶部可按各列筛选。列表字段:

列名含义
标签返修登记时填的标签
型号零件官方型号
品牌零件品牌
方式返修方式
类型零件所属硬件类型
联系人 / 电话返修对接人及电话
备注备注说明
操作对未完成的记录显示「完成」按钮

parts-rework-list.png

7.3 标记返修完成

  1. 在返修列表某条未完成记录的「操作」列点击 完成。
  2. 弹出「确认完成?」,确认后该返修记录被标记为已完成。
  3. 系统会自动判断该部件接下来的状态:
    • 如果这个部件仍关联在某台设备上(位置不为 0),状态恢复为 使用(Using);
    • 否则状态回到 闲置(Idle),重新可领用。

已经标记「完成」的返修记录不能重复完成,再次点击会被拒绝。


8. 典型操作流程串讲

把前面的功能串成一条完整的「零件一生」,方便理解:

  1. 建类型(一次性):如需「电源」等新类别,在 批次类型 里添加。CPU / 内存 / 硬盘 / PCI 已内置,无需新建。
  2. 进货登记:采购到一批零件 → 批次管理 > 添 加 → 填类型、机房、型号、数量、价格、供应商等 → 必选一条资产序列号规则 → 立即添加。系统按数量自动生成 N 个部件并分配资产序列号。
  3. 录入实物序列号 / 入库:进入批次的 部件列表,逐行录入厂商序列号并保存;或用 出/入库 > 扫码入库 批量扫码录入。
  4. 贴标签:勾选有资产序列号的部件 → 生成条码 → 打印贴到实物上。
  5. 装机:到 服务器管理 把闲置零件分配给服务器,部件状态变「使用」。
  6. 维修/报废:零件坏了 → 在服务器侧发起 返修(维修或出库)→ 在 返修列表 跟踪 → 修好点 完成,部件回到使用 / 闲置。
  7. 出库/退货:用 快速出库 / 扫码出库 扫资产序列号,把零件标记为出库。
  8. 报废清理:闲置不再用的部件可在部件列表删除;整批不要了,可删除整个批次(前提是没有部件还装在设备上)。

常见错误提示对照:

  • 「序列号已被占用」——同批次内厂商序列号重复,请换一个。
  • 「请切换输入法至英文」——扫码/输入框检测到中文字符。
  • 删除批次失败——批次下仍有部件装在设备上,请先把在用零件拆机、状态恢复闲置。
  • 删除部件失败——只有闲置部件可删,请先把该部件拆机或撤回出库。
  • 删除类型失败——该类型下仍有批次,请先清空;内置的 CPU/内存/硬盘/PCI设备 4 类不可删。
  • 「电话无效」——返修联系电话不符合(中国)号码格式。
  • 提示需要「双因素验证码」——系统开启了危险操作两步验证,删除批次/部件/类型时需输入手机验证器上的动态码。
修改于 2026-06-25 08:28:02
上一页
《内网设备与流量/带宽计费》
下一页
《工单管理》
Built with