首页/网络/VLAN 与高可用速查/Cisco UDLD 单向链路检测
二层排障78 条

Cisco UDLD 单向链路检测

UDLD 是 Cisco 的单向链路检测:normal 模式仅在确定单通时告警,aggressive 模式检测到异常会把端口置为 err-disable。

VLAN 与高可用速查网络更新于 2026-10-13

Cisco UDLD 是什么

UDLD 是 Cisco 的单向链路检测协议,用来发现光纤接错、单纤故障等导致的单向链路。它分两个档:normal 模式只在能够确定链路单向时告警;aggressive 模式还会在超时无法确认时把端口置为 err-disable,保护动作更激进,但能更快切断有问题的链路。

基本信息

适用平台Cisco IOS / IOS-XE 交换机
normal 模式确定性检测,判断为单向时告警
aggressive 模式配合超时判定,异常时直接 err-disable
典型场景光纤链路、设备之间成对连接
查看命令show udld interface
恢复方式按 err-disable 流程恢复端口

典型使用场景

  • 机房设备间光纤互联:防止单纤故障造成静默丢包
  • 跨机房链路:链路 up 但只单向可达时快速定位
  • 更换模块或跳线后验证双向正常
  • 与聚合配合:避免单向链路被算作可用成员
  • 对接第三方设备时由本侧承担单向检测职责

配置与查看

配置与查看
udld enable                              # 全局开启
interface GigabitEthernet1/0/1
 udld port aggressive                     # 或使用正常模式
show udld interface GigabitEthernet1/0/1   # 查看检测状态与邻居
show interfaces GigabitEthernet1/0/1        # 核对是否被置为 err-disable
show errdisable recovery                     # 查看恢复策略

两种模式对照

模式检测行为异常时的动作
normal仅在能确定单向时判定告警,端口保持转发
aggressive配合超时判定,不确定也处理直接 err-disable 端口
两端不一致判定结果不完整可能出现一侧关闭一侧仍在转发
未启用不检测单向链路被长期使用,静默丢包

部署注意

  • 成对链路两端统一模式,避免一侧保护一侧放任
  • aggressive 模式要同时配置 err-disable 恢复策略,明确自动还是手动
  • 检测周期与超时值按平台默认或文档建议设置,不要自行调到极端值
  • 启用后把邻居信息与端口状态纳入巡检,才能发现『单向但还没触发关闭』的中间状态
两端模式不同会造成误判,成对链路统一规划模式;一侧 aggressive 一侧 normal 时,保护动作只在一侧生效,现象会不对称。
aggressive 模式关闭端口后要按 err-disable 流程恢复:先查原因再恢复,直接恢复会在故障未排除时反复进入关闭状态。

易错点

  • 两端模式不同会造成误判,成对链路统一规划模式,尤其是一条链路两端由不同团队维护时更容易出现。
  • aggressive 模式关闭端口后要按 err-disable 流程恢复,先定位根因再恢复,否则也会反复触发。
  • 把 UDLD 当成链路质量检测会误解用途:它检测单向链路,不检测误码与丢包,CRC 类问题要看错包计数。
  • 只在一端启用 UDLD,另一端什么都不做时,本端判定异常后关闭端口,而另一端仍显示链路正常,故障现象会不对称。
  • 启用后不看邻居信息,只能等到端口被关闭才知道出过问题,巡检里加上状态查看才能提前发现劣化。

数据来源与参考

  • Cisco UDLD 配置指南
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌