首页/网络/网络设备配置速查/调试命令安全使用:debug 与回退
设备排障72 条

调试命令安全使用:debug 与回退

debug 是双刃剑:高峰期能把 CPU 拉满导致协议中断。三厂都要先开终端显示开关,且必须准备好一键关闭的回退命令。

网络设备配置速查网络更新于 2026-10-13

调试是把双刃剑

不带过滤条件就开报文级调试,在流量大的设备上能把 CPU 拉满并导致协议中断。三厂都需要先开终端显示开关才看得到输出,而且必须提前准备好一键关闭的回退命令,最好再留一条独立的登录通道。

基本信息

适用平台华为 VRP / Cisco IOS / H3C Comware
上屏开关三厂都是 terminal monitor
调试开关华为与 H3C 用 debugging,思科用 debug
关闭命令undo debugging all(华为/H3C)/ undebug all(思科)
收窄手段条件过滤、ACL 过滤、限定接口与协议
使用窗口低峰期、限时使用

典型使用场景

  • 协议交互异常,需要看报文级细节
  • 排查特定主机的连接问题,用条件过滤只看目标流量
  • 验证 ACL 与策略是否按预期命中
  • 设备异常前的关键过程抓取
  • 常规诊断命令无法定位时的最后手段

华为 VRP / H3C Comware

华为 VRP / H3C Comware
terminal monitor                          # 把日志与调试输出送到当前终端
terminal debugging                       # 允许调试信息上屏
debugging ip packet                      # 必须配合条件过滤,不要裸开
undo debugging all                       # 一键关闭全部调试
display debugging                        # 核对是否还有残留调试项

思科 IOS

思科 IOS
terminal monitor
show debugging                           # 先看已经开了什么
debug ip packet acl 100                  # 用 ACL 收窄匹配范围
debug ip packet detail                   # 确认影响可控再开
undebug all                              # 全部关闭

三厂命令对照

环节华为 VRP思科 IOSH3C Comware
上屏开关terminal monitorterminal monitorterminal monitor
调试开关debugging 模块debug 模块debugging 模块
关闭命令undo debugging allundebug allundo debugging all
查看已开项display debuggingshow debuggingdisplay debugging
三厂的上屏开关同名,但开关词不同:华为与 H3C 用 debugging、思科用 debug。记混时会敲出无效命令,现场容易误认为设备不支持该功能,先确认厂商再下手。
永远不要在不带过滤条件的情况下开报文级调试。开启前先准备第二条登录通道与定时关闭手段,调试过程中会话被输出刷屏时还能从另一条通道关闭它。
收尾同样重要:关闭调试、确认查看已开项的命令输出为空、再把终端显示开关恢复。残留的调试项会在下一次业务高峰悄悄消耗 CPU,属于最难追查的隐性故障源。

易错点

  • 不带过滤条件开报文级调试,流量大的设备 CPU 拉满,协议中断并失去管理通道
  • 忘记关闭调试,残留项在业务高峰消耗 CPU,故障现象与首次排查时完全不同
  • 只开调试不确认上屏方式,输出进了控制台或日志缓冲区,终端上一片空白以为没生效
  • 依赖单一登录通道做调试,会话被输出刷屏无法输入关闭命令
  • 在生产设备上照抄实验环境教程直接开全量调试,把实验室做法搬到高流量设备上

数据来源与参考

  • 华为调试命令
  • Cisco debug 命令参考
  • H3C 调试命令

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌