Files
H3ConuMS-v2/docs/现场ONU故障排查指南.md
v6ole d222978ae4 ```
feat(import): 添加区域字段支持和改进模板路径处理

- 在OLT设备导入功能中添加region字段支持,从Excel模板读取区域信息
- 修复模板文件路径问题,使用相对路径动态构建模板文件路径
- 更新导入服务中的验证错误格式,包含行号和MAC地址信息

feat(check): 增强设备检测服务的端口信息同步

- 在CheckService中添加端口和OLT归属信息的同步逻辑
- 改进设备状态检查时的端口信息更新策略,避免用None覆盖现有值
- 扩展返回数据结构,包含端口ID、槽位号、端口号和OLT位置信息

feat(frontend): 添加设备列表刷新冷却机制和端口验证

- 实现设备状态刷新的60秒冷却时间限制,防止频繁操作
- 改进业务下发按钮的启用条件,同时支持port_id或slot_number+port_number组合
- 优化导入结果显示,显示具体的MAC地址信息

feat(olt): 添加重复MAC记录批量清除功能

- 新增批量清除重复MAC记录的功能,支持按OLT分组处理
- 实现SSH端口清除和自动忽略的批量操作流程
- 添加批量操作的进度提示和错误处理机制
```
2026-04-09 11:33:04 +08:00

899 lines
19 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# H3ConuMS2 现场ONU故障排查指南
## 文档说明
**版本**: v1.0
**适用对象**: 新入职维护人员
**适用场景**: 用户报修处理、定期巡检发现问题
**关联系统**: H3ConuMS2 OLT设备监控管理系统
**最后更新**: 2026年4月8日
---
## 第一章:准备工作
### 1.1 工具准备清单
#### 必备工具
1. **笔记本电脑**
- 安装SSH客户端(如PuTTY、SecureCRT
- 安装H3C设备管理软件(如有)
- 确保能连接公司VPN或内网
2. **网络测试工具**
- 网线测试仪
- 网络抓包工具(Wireshark
- Ping工具
3. **光纤测试设备**
- 光功率计(带适配器)
- 红光笔(可视故障定位仪)
- 光纤清洁工具(清洁笔、酒精棉片)
- 备用光纤跳线(SC/LC接口)
4. **维修工具**
- 十字/一字螺丝刀套装
- 尖嘴钳、斜口钳
- 剥线钳
- 电工胶布、扎带
- 防静电手环
5. **备用设备**
- 同型号ONU设备(至少1台)
- 电源适配器(12V/1A
- 网线(Cat5e/Cat6,不同长度)
- 光纤跳线(SC/LC,不同长度)
#### 软件准备
1. **H3ConuMS2系统访问**
- 确保有系统登录权限
- 熟悉设备查询界面
- 了解历史状态查看功能
2. **文档资料**
- 本指南(打印版或电子版)
- ONU设备技术手册
- OLT设备配置手册
- 网络拓扑图
### 1.2 出发前检查
#### 信息收集
1. **从H3ConuMS2系统获取信息**
```bash
# 查询设备当前状态
设备名称: [从系统获取]
OLT位置: [从系统获取]
最后在线时间: [从系统获取]
历史故障记录: [从系统获取]
```
2. **联系用户了解情况**
- 故障现象描述
- 故障发生时间
- 受影响范围(单用户/多用户)
- 是否尝试过重启
3. **确认现场信息**
- 具体地址和联系人
- 设备安装位置
- 现场环境(机房/用户端)
- 预计到达时间
#### 安全准备
1. **个人防护**
- 穿戴工作服、安全鞋
- 携带手电筒
- 准备口罩、手套
2. **工作许可**
- 确认是否有进入权限
- 是否需要用户陪同
- 工作时间限制
### 1.3 故障预判
根据系统信息和用户描述,初步判断可能的问题:
| 故障现象 | 可能原因 | 优先级 |
|---------|---------|--------|
| 完全无信号 | 电源故障、光纤断裂 | 高 |
| 信号弱/不稳定 | 光纤衰减大、连接器脏污 | 中 |
| 有光信号但无法上网 | 配置错误、网线问题 | 中 |
| 间歇性断线 | 设备过热、干扰 | 低 |
---
## 第二章:现场排查流程
### 2.1 到达现场后的标准操作流程
#### 步骤1:现场环境评估
1. **安全确认**
- 检查现场是否有安全隐患
- 确认电源插座接地良好
- 注意防静电措施
2. **设备定位**
- 找到故障ONU设备
- 确认设备型号与系统记录一致
- 检查设备安装位置是否合适
3. **环境检查**
- 温度是否过高(>40°C)
- 湿度是否合适(30%-70%
- 通风是否良好
- 是否有灰尘堆积
#### 步骤2:初步外观检查
1. **电源检查**
- 电源指示灯状态
- 电源适配器是否发热
- 电源线连接是否牢固
- 用万用表测量输出电压(应为12V±5%)
2. **指示灯状态分析**
| 指示灯 | 正常状态 | 故障状态 | 可能原因 |
|-------|---------|---------|---------|
| PWR | 常亮 | 不亮/闪烁 | 电源故障 |
| PON | 常亮 | 闪烁/不亮 | 光路问题 |
| LOS | 不亮 | 常亮/闪烁 | 光信号丢失 |
| LAN | 常亮/闪烁 | 不亮 | 网线/配置问题 |
3. **物理连接检查**
- 光纤连接器是否插紧
- 网线连接是否牢固
- 所有接口是否有松动
- 检查线缆是否有破损
#### 步骤3:光路测试
1. **使用红光笔检查**
- 在OLT端发射红光
- 在ONU端观察是否有红光
- 确认光纤通路是否完整
2. **光功率测量**
- 连接光功率计到ONU接收端
- 记录接收光功率
- 参考标准值:-8dBm ~ -27dBm
**光功率判断标准:**
- 优于-8dBm:光功率过强,可能损坏设备
- -8dBm ~ -27dBm:正常范围
- -27dBm ~ -30dBm:临界值,可能不稳定
- 低于-30dBm:光功率不足
3. **光纤清洁**
- 使用专用清洁笔清洁光纤端面
- 检查连接器是否有划伤
- 重新插拔光纤连接器
#### 步骤4:网络连接测试
1. **本地连接测试**
- 笔记本电脑直连ONU LAN口
- 设置静态IP(如192.168.1.100
- Ping ONU管理地址(通常192.168.1.1
2. **上网测试**
- 如果能够Ping通ONU,尝试访问网页
- 测试DNS解析(nslookup www.baidu.com
- 测试下载速度
3. **抓包分析(如需要)**
- 使用Wireshark抓取网络包
- 分析DHCP、PPPoE等协议交互
- 查找异常流量
#### 步骤5:设备诊断
1. **登录ONU管理界面**
- 默认地址:192.168.1.1
- 用户名/密码:admin/admin 或 查看设备标签
- 检查设备状态信息
2. **查看关键信息**
- 光模块信息(发射/接收功率)
- 温度信息
- 运行时间
- 错误日志
3. **配置检查**
- VLAN配置是否正确
- 业务VLAN是否匹配
- MAC地址学习情况
#### 步骤6OLT端检查
1. **通过H3ConuMS2系统检查**
- 登录系统查看设备状态
- 检查OLT端口状态
- 查看ONU注册状态
2. **SSH登录OLT(如需要)**
```bash
# 连接OLT
ssh admin@olt_ip
# 查看ONU状态
display onu slot X/X
# 查看端口信息
display interface gigabitethernet X/X/X
# 查看告警信息
display alarm active
```
3. **OLT端诊断命令**
- `display ont info` - 查看ONU信息
- `display ont optical-info` - 查看光信息
- `display ont version` - 查看版本信息
- `display ont statistic` - 查看统计信息
### 2.2 故障决策树
```mermaid
graph TD
A[开始排查] --> B{电源指示灯亮?}
B -->|否| C[检查电源]
B -->|是| D{PON指示灯状态?}
D -->|不亮| E[检查光路]
D -->|闪烁| F[检查注册状态]
D -->|常亮| G{LAN指示灯状态?}
G -->|不亮| H[检查网线/配置]
G -->|正常| I[测试网络连接]
C --> J[更换电源适配器]
J --> K{问题解决?}
K -->|是| L[记录并结束]
K -->|否| M[更换ONU设备]
E --> N[测试光功率]
N --> O{光功率正常?}
O -->|否| P[检查光纤/清洁连接器]
O -->|是| Q[检查OLT配置]
F --> R[检查ONU注册]
R --> S{注册成功?}
S -->|否| T[检查SN/MAC绑定]
S -->|是| U[检查业务配置]
H --> V[更换网线]
V --> W{问题解决?}
W -->|是| X[记录并结束]
W -->|否| Y[检查交换机配置]
I --> Z[Ping测试]
Z --> AA{能Ping通?}
AA -->|否| BB[检查IP配置]
AA -->|是| CC[测试上网]
CC --> DD{能上网?}
DD -->|否| EE[检查PPPoE/DHCP]
DD -->|是| FF[故障排除完成]
```
---
## 第三章:常见故障处理
### 3.1 电源类故障
#### 故障现象
- 所有指示灯不亮
- 设备无任何反应
- 电源适配器发热异常
#### 处理步骤
1. **检查电源插座**
- 使用其他设备测试插座
- 检查插座电压(220V±10%)
2. **检查电源适配器**
- 测量输出电压(应为12V
- 检查输出电流(应≥1A
- 观察指示灯状态
3. **检查设备电源接口**
- 检查接口是否松动
- 检查内部保险丝
- 检查电源电路
#### 解决方案
1. **更换电源适配器**
2. **更换电源线**
3. **更换ONU设备**
### 3.2 光路类故障
#### 故障现象
- PON指示灯不亮或闪烁
- LOS指示灯亮
- 光功率异常
#### 处理步骤
1. **检查光纤连接**
- 确认光纤类型(单模/多模)
- 检查连接器类型(SC/LC)
- 清洁光纤端面
2. **测量光功率**
- 在ONU端测量接收功率
- 在分光器端测量输出功率
- 计算链路衰减
3. **检查光纤质量**
- 检查光纤是否有弯折
- 检查接头是否有损伤
- 检查光纤长度是否超限
#### 解决方案
1. **重新制作光纤接头**
2. **更换光纤跳线**
3. **调整光功率(增加衰减器)**
4. **重新熔接光纤**
### 3.3 注册类故障
#### 故障现象
- PON指示灯闪烁
- OLT无法发现ONU
- 注册超时
#### 处理步骤
1. **检查SN/MAC地址**
- 核对ONU标签上的SN
- 检查OLT端SN绑定
- 检查MAC地址过滤
2. **检查OLT配置**
- 检查端口使能状态
- 检查ONU模板
- 检查带宽配置
3. **检查距离限制**
- 确认光纤长度
- 检查光功率预算
- 确认分光比
#### 解决方案
1. **重新配置SN/MAC**
2. **重启ONU设备**
3. **重置ONU到出厂设置**
4. **修改OLT配置**
### 3.4 业务类故障
#### 故障现象
- PON灯常亮但无法上网
- 能获取IP但无法访问外网
- 网速慢或不稳定
#### 处理步骤
1. **检查VLAN配置**
- 检查业务VLAN ID
- 检查VLAN透传
- 检查优先级标记
2. **检查IP配置**
- 检查DHCP获取情况
- 检查PPPoE拨号
- 检查静态IP配置
3. **检查路由配置**
- 检查默认网关
- 检查DNS服务器
- 检查路由表
#### 解决方案
1. **重新配置VLAN**
2. **重启网络服务**
3. **更新设备固件**
4. **优化网络配置**
### 3.5 性能类故障
#### 故障现象
- 网速达不到标称值
- 延迟高、抖动大
- 频繁掉线
#### 处理步骤
1. **进行网络测试**
- 测试上下行带宽
- 测试网络延迟
- 测试丢包率
2. **检查设备负载**
- 检查CPU使用率
- 检查内存使用率
- 检查温度状态
3. **检查干扰因素**
- 检查同频干扰
- 检查电源干扰
- 检查环境干扰
#### 解决方案
1. **优化设备位置**
2. **更换更高性能设备**
3. **调整信道/频率**
4. **增加散热措施**
---
## 第四章:记录与报告
### 4.1 故障记录规范
#### 基本信息
```yaml
故障单号: [系统生成]
报告人: [维护人员姓名]
报告时间: [YYYY-MM-DD HH:MM]
故障地点: [详细地址]
联系人: [用户姓名电话]
```
#### 故障信息
```yaml
设备信息:
- 设备型号: [H3C XXX]
- 设备SN: [XXXXXXXX]
- MAC地址: [XX:XX:XX:XX:XX:XX]
- 安装日期: [YYYY-MM-DD]
故障现象:
- 用户描述: [用户原话]
- 实际现象: [现场观察]
- 影响范围: [单用户/多用户]
处理过程:
- 到达时间: [HH:MM]
- 开始处理: [HH:MM]
- 解决时间: [HH:MM]
- 总耗时: [X小时X分钟]
```
#### 技术数据
```yaml
测试数据:
- 光功率: [接收: -XX dBm, 发射: -XX dBm]
- 网络测试: [下载: XX Mbps, 上传: XX Mbps]
- 延迟测试: [平均: XX ms, 最大: XX ms]
- 丢包率: [X%]
更换部件:
- 部件名称: [如: 电源适配器]
- 部件型号: [如: H3C-12V-1A]
- 更换原因: [如: 输出电压不稳定]
- 旧件SN: [XXXXXXXX]
- 新件SN: [XXXXXXXX]
```
### 4.2 H3ConuMS2系统更新
#### 设备状态更新
1. **登录系统**
- 进入设备管理界面
- 找到故障设备
2. **更新信息**
- 更新设备状态(在线/离线)
- 更新最后检查时间
- 更新维护记录
3. **添加备注**
- 描述故障现象
- 记录处理过程
- 添加技术数据
#### 生成报告
1. **导出数据**
- 导出设备历史状态
- 导出故障处理记录
- 导出性能测试数据
2. **生成报告**
- 使用系统报告功能
- 选择报告模板
- 自定义报告内容
3. **提交报告**
- 提交给上级主管
- 发送给用户确认
- 归档到知识库
### 4.3 知识积累
#### 故障案例库
1. **记录典型案例**
- 罕见故障现象
- 复杂处理过程
- 创新解决方案
2. **分析故障原因**
- 根本原因分析
- 预防措施建议
- 改进方案设计
3. **分享经验**
- 团队内部分享
- 编写技术文档
- 培训新员工
#### 持续改进
1. **统计分析**
- 统计故障类型分布
- 分析故障发生频率
- 计算平均修复时间
2. **优化流程**
- 根据数据优化排查步骤
- 改进工具配置
- 更新技术标准
3. **预防维护**
- 制定定期检查计划
- 预测性维护
- 设备生命周期管理
---
## 第五章:预防措施
### 5.1 定期维护计划
#### 月度检查
1. **设备清洁**
- 清洁设备表面灰尘
- 清洁散热孔
- 检查风扇运转
2. **连接检查**
- 检查所有连接器
- 检查线缆状态
- 检查标签完整性
3. **性能测试**
- 测试网络速度
- 测试光功率
- 测试设备温度
#### 季度检查
1. **全面诊断**
- 完整的功能测试
- 详细的性能测试
- 安全漏洞扫描
2. **配置备份**
- 备份设备配置
- 备份系统数据
- 验证备份完整性
3. **固件更新**
- 检查固件版本
- 评估更新必要性
- 制定更新计划
#### 年度检查
1. **设备评估**
- 评估设备性能
- 预测剩余寿命
- 制定更换计划
2. **环境评估**
- 评估安装环境
- 检查配套设施
- 提出改进建议
3. **文档更新**
- 更新技术文档
- 更新操作手册
- 更新维护记录
### 5.2 设备安装规范
#### 环境要求
1. **温度控制**
- 工作温度:0°C ~ 40°C
- 存储温度:-40°C ~ 70°C
- 避免阳光直射
2. **湿度控制**
- 工作湿度:10% ~ 90% RH
- 避免冷凝
- 保持通风
3. **电源要求**
- 稳定电压:220V ±10%
- 可靠接地
- 防雷保护
#### 安装规范
1. **设备固定**
- 使用合适支架
- 保持水平安装
- 预留散热空间
2. **线缆管理**
- 分类绑扎线缆
- 预留适当余量
- 避免弯折过度
3. **标签标识**
- 清晰设备标签
- 完整线缆标签
- 准确位置标签
### 5.3 备件管理
#### 备件库存
1. **常用备件**
- ONU设备:按设备总数10%储备
- 电源适配器:按设备总数15%储备
- 光纤跳线:按设备总数20%储备
- 网线:按需储备
2. **关键备件**
- 光模块
- 分光器
- 交换机
3. **工具备件**
- 测试工具
- 维修工具
- 安全装备
#### 库存管理
1. **入库管理**
- 记录备件信息
- 测试备件功能
- 分类存放
2. **出库管理**
- 记录领用信息
- 跟踪使用情况
- 及时补充库存
3. **定期检查**
- 检查备件状态
- 测试备件功能
- 更新库存记录
### 5.4 培训计划
#### 新员工培训
1. **基础培训(第1周)**
- 公司制度介绍
- 安全规范培训
- 工具使用培训
2. **技术培训(第2-3周)**
- 网络基础知识
- 光纤通信原理
- 设备操作培训
3. **实操培训(第4周)**
- 跟随老员工现场学习
- 模拟故障处理
- 独立完成简单任务
#### 在职培训
1. **月度培训**
- 新技术介绍
- 案例分享
- 经验交流
2. **季度培训**
- 技能考核
- 应急演练
- 安全培训
3. **年度培训**
- 技术更新培训
- 认证考试
- 职业发展规划
---
## 第六章:应急处理
### 6.1 紧急情况处理
#### 重大故障
1. **大面积断网**
- 立即上报主管
- 启动应急预案
- 协调多方资源
2. **设备损坏**
- 评估影响范围
- 准备替代方案
- 紧急采购设备
3. **安全事故**
- 确保人员安全
- 保护现场证据
- 按规定报告
#### 沟通协调
1. **内部沟通**
- 建立应急联络群
- 定期更新进展
- 协调技术支持
2. **用户沟通**
- 及时通知用户
- 说明处理进展
- 提供临时方案
3. **供应商沟通**
- 联系技术支持
- 协调备件供应
- 请求现场支持
### 6.2 应急预案
#### 预案制定
1. **风险评估**
- 识别潜在风险
- 评估影响程度
- 制定应对措施
2. **资源准备**
- 准备应急设备
- 准备应急人员
- 准备应急资金
3. **流程设计**
- 设计处理流程
- 明确责任分工
- 设定时间要求
#### 预案演练
1. **桌面演练**
- 模拟故障场景
- 讨论处理方案
- 优化处理流程
2. **实战演练**
- 模拟真实故障
- 实际处理操作
- 评估处理效果
3. **演练总结**
- 分析演练过程
- 发现存在问题
- 提出改进建议
---
## 第七章:附录
### 7.1 常用命令参考
#### OLT常用命令
```bash
# 查看ONU状态
display onu slot X/X
# 查看光信息
display ont optical-info X/X/X X
# 查看版本信息
display ont version X/X/X X
# 查看统计信息
display ont statistic X/X/X X
# 重启ONU
ont reboot X/X/X X
# 查看告警
display alarm active
# 查看端口状态
display interface gigabitethernet X/X/X
```
#### ONU管理命令
```bash
# 登录ONUTelnet/SSH
telnet 192.168.1.1
# 查看系统信息
show system
# 查看接口状态
show interface
# 查看光模块信息
show optical-module
# 查看日志
show log
# 重启设备
reboot
# 恢复出厂设置
factory-reset
```
### 7.2 技术参数参考
#### 光功率标准
| 项目 | 标准值 | 警告值 | 危险值 |
|------|--------|--------|--------|
| 接收光功率 | -8 ~ -27 dBm | -27 ~ -30 dBm | < -30 dBm |
| 发射光功率 | 0 ~ +5 dBm | +5 ~ +7 dBm | > +7 dBm |
| 链路衰减 | < 25 dB | 25 ~ 28 dB | > 28 dB |
#### 温度标准
| 项目 | 正常范围 | 警告范围 | 危险范围 |
|------|----------|----------|----------|
| 工作温度 | 0°C ~ 40°C | 40°C ~ 50°C | > 50°C |
| 存储温度 | -40°C ~ 70°C | - | - |
| 表面温度 | < 60°C | 60°C ~ 70°C | > 70°C |
### 7.3 联系信息
#### 内部联系人
| 部门 | 联系人 | 电话 | 职责 |
|------|--------|------|------|
| 技术支持 | 张三 | 138XXXXXXX | 技术指导 |
| 备件管理 | 李四 | 139XXXXXXX | 备件供应 |
| 项目管理 | 王五 | 137XXXXXXX | 项目协调 |
#### 供应商联系人
| 供应商 | 产品 | 联系人 | 电话 | 支持时间 |
|--------|------|--------|------|----------|
| H3C | OLT设备 | 技术支持 | 400-XXXX | 7x24 |
| 华为 | ONU设备 | 技术支持 | 400-XXXX | 7x24 |
| 中兴 | 光模块 | 技术支持 | 400-XXXX | 工作日 |
### 7.4 模板下载
#### 故障报告模板
[下载链接:故障报告模板.docx]
#### 维护记录模板
[下载链接:维护记录模板.xlsx]
#### 备件清单模板
[下载链接:备件清单模板.xlsx]
---
## 第八章:更新记录
| 版本 | 更新日期 | 更新内容 | 更新人 |
|------|----------|----------|--------|
| v1.0 | 2026-04-08 | 初始版本创建 | 系统团队 |
| v1.1 | - | 计划更新:添加更多案例 | - |
| v1.2 | - | 计划更新:优化流程图 | - |
---
## 使用说明
1. **新员工必读**:入职后一周内完成学习
2. **现场携带**:建议打印关键章节随身携带
3. **定期复习**:每季度复习一次
4. **反馈建议**:发现不足及时反馈
5. **持续改进**:根据实际情况更新内容
## 版权声明
本指南版权归H3ConuMS2项目组所有,未经许可不得外传。
---
**祝您工作顺利,排查无忧!**
如有任何问题或建议,请联系:
- 邮箱:support@h3conums2.com
- 电话:400-XXX-XXXX
- 内部通讯:企业微信/钉钉群