文档维护的意义
工业网络文档通常包含物理拓扑图、逻辑拓扑图、IP 与 VLAN 地址规划表、端口与配线对照表、设备台账（型号、序列号、固件版本、供应商、投运日期）、变更记录与配置备份索引。这套资料的价值在故障与交接时刻集中体现：夜里产线断线时，有没有准确的端口与链路图，决定了排障是按图索骥还是逐根线试。文档的难点不是写出来，而是保持与现场一致，因为每次变更都会让它过期。
基本信息
| 核心文档 | 物理与逻辑拓扑图、地址与 VLAN 规划、端口与配线表、设备台账、变更记录 |
|---|---|
| 更新触发点 | 任何新增、下线、改线、改地址、改 VLAN、换设备之后 |
| 版本要求 | 每份文档有版本号、修订日期与责任人，历史版本可追溯 |
| 存放要求 | 受控在线副本加离线可读副本，避免依赖单一平台或单一账号 |
| 图纸要求 | 物理图标注实际端口与走线，逻辑图标注网段、区划与跨区通道 |
| 敏感信息 | 账号与口令不进图纸，另存于受控资料并由权限系统管理 |
典型使用场景
- 故障定位：从告警位置反查端口、配线与对端设备，缩短判断时间
- 变更评审：改造前先看现有区划与地址规划，避免与既有设计冲突
- 人员交接：新接手人员凭文档即可建立对现场的完整认知
- 审计与检查：说明网络分区、隔离措施与变更过程的依据
- 扩产与扩容：盘清剩余端口、网段与供电余量，规划新设备接入
- 备件替换：按台账核对型号与固件，保证替换件与在网设备一致
文档类型与常见失守点
| 文档类型 | 必须写清的内容 | 常见失守点 |
|---|---|---|
| 物理拓扑图 | 设备位置、端口编号、走线路径、机柜编号 | 只画设备关系不标端口，现场无法定位 |
| 逻辑拓扑图 | 网段、VLAN、区划边界、跨区通道与方向 | 区划调整后未同步，与实际访问关系不符 |
| 地址与 VLAN 规划 | 网段用途、网关、地址分配原则、保留范围 | 靠散落表格维护，容易分配冲突 |
| 设备台账 | 型号、序列号、固件版本、供应商、投运日期 | 只登记型号，替换与漏洞评估无法开展 |
| 变更记录 | 变更内容、时间、执行人、验证结果、回滚方式 | 只有口头交接，无记录可追溯 |
拓扑图要区分「应有状态」与「实际状态」。设计图表达的是规划意图，现场核对出来的才是事实，两者不一致时应以现场为准并立刻更新。建议把现场核对纳入季度巡检，逐柜逐端口比一次，成本可控、收益明确。