网络故障排查

SKILL运维和基础设施
运维和基础设施 未标注权限 许可证不明确
安装这个技能

网络故障排查与定位。当用户问「网络不通怎么查」「ping 不通」「丢包怎么排查」「traceroute 星号」「网络卡顿/时延高」「环路怎么查」「ARP 欺骗/冲突」「STP 收敛慢」「OSPF 邻居起不来」时使用。触发词:故障排查、排障、ping、traceroute、抓包、tcpdump、丢包、时延、环路、MTU、ARP、STP、OSPF、路由。

一句话选型结论

按资料字段整理

网络故障排查是运维和基础设施类的 Agent Skill,安装方式未标注,权限级别未标注,许可证不明确,有可直接复制的安装命令。技能本质是给模型读的说明书,效果取决于模型与客户端;装完先用一个小任务验证,再放进正式流程。

分类运维和基础设施 安装方式未标注 权限级别未标注权限 许可证许可证不明确
累计安装 未标注 本周 未标注
GitHub 星标 未标注 仓库 未标注
下载量 未标注 技能市场下载数
权限级别 未标注权限 安装前请确认风险范围
许可证 许可证不明确 未说明

安装

未标注
在支持 Skills 的客户端里执行,装完问一句「你有哪些技能」验证
skillhub install user_c1c65a3c/net-fault-troubleshooting
  1. 1
    确认客户端支持

    确认你的客户端支持 Skills(Claude、Codex、Cursor 等),并升级到较新的版本。

  2. 2
    拿到技能文件

    执行上面的命令安装;也可以把仓库里的 SKILL.md 手动放进客户端的 skills 目录。

  3. 3
    刷新技能列表

    重新打开客户端,或刷新技能列表,让新放进来的技能被加载。

  4. 4
    验证是否生效

    问一句「你有哪些技能」,确认列表里出现它,再拿一个小任务试跑。

技能档案

运维和基础设施
字段来自技能仓库与公开索引,中文说明由本站标注
作者 / 维护方user_c1c65a3c仓库 未标注 · 版本 未标注
宿主客户端未标注技能可被这些客户端加载
安装方式未标注安装包 community
权限级别未标注权限安装前请确认风险范围
许可证未说明许可证不明确,商用前请自行确认条款
仓库可用性available技能仓库当前是否可访问
最近核验2026-11-06上游最后核验时间 · 数据更新 2026-11-06
正文体量8.9 KBSKILL.md 原文大小,越大说明说明书写得越细

典型使用场景

3 类
按分类整理的常见用法,具体以 SKILL.md 为准
查服务与日志

按现象定位服务状态与日志线索。

写部署与巡检脚本

把重复的部署、巡检写成脚本。

故障排查

按步骤排查网络、依赖与配置。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有标注权限级别,实际能做什么要装好后确认。
  • 许可证不明确,商用或二次分发前先到仓库确认条款。
  • 没有做站内核验,内容以作者仓库为准。
  • 技能只是说明书,实际效果取决于模型与客户端,装完先用小任务试一遍。

更适合

  • 需要在运维和基础设施场景里给模型补一套做法的人。
  • 愿意先读一遍 SKILL.md、确认它会让模型做什么的人。

不太适合

  • 对许可证要求很严、必须明确可商用的人。
  • 只想装完就自动变强、不打算看说明书的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
技能权限级别安装方式累计安装宿主客户端安装命令
网络故障排查当前 未标注权限 未标注 未标注 未标注 有
Azure 部署 调用外部服务 GitHub 仓库 664.2 万 Codex、Claude、Cursor 有
Azure diagnostics 问题管理 调用外部服务 GitHub 仓库 657.6 万 Codex、Claude、Cursor 有
Azure aigateway 部署 调用外部服务 GitHub 仓库 655.3 万 Codex、Claude、Cursor 有
Azure AI 搜索 调用外部服务 GitHub 仓库 651.4 万 Codex、Claude、Cursor 有
Azure Cloud migrate 部署 调用外部服务 GitHub 仓库 650.7 万 Codex、Claude、Cursor 有

SKILL.md 全文

8.9 KB
模型实际读到的说明书原文,来自技能仓库

网络故障排查

把「网络不通 / 慢 / 断」这类模糊现象,收敛成可复现、可定位、可复盘的排查动作链。本技能给出从分层定位、三板斧命令、抓包分析到典型故障处置的完整可执行方法,并附诊断命令集与解析脚本。

一、核心原理:分层排查法

网络故障定位的核心是缩小故障域。按 OSI 七层自底向上逐层确认,或按「端到端路径」二分切割,任何一层没通过就锁定在该层往下钻。

flowchart TD
    S[故障现象:不通/慢/断] --> L1[L1 物理层<br/>链路 up? 光功率? 错误计数?]
    L1 -->|正常| L2[L2 数据链路层<br/>ARP? MAC? STP? VLAN?]
    L2 -->|正常| L3[L3 网络层<br/>IP/路由/MTU/ACL]
    L3 -->|正常| L4[L4 传输层<br/>端口/防火墙/NAT/MTU黑洞]
    L4 -->|正常| L7[L7 应用层<br/>DNS/证书/应用配置]
    L1 -->|异常| F1[修链路/换光模块/查线缆]
    L2 -->|异常| F2[查STP环路/ARP表/VLAN]
    L3 -->|异常| F3[查路由表/ACL/MTU]
    L4 -->|异常| F4[查防火墙策略/NAT/分片]
    L7 -->|异常| F5[查DNS/证书/应用]

三板斧分工:
- ping:验证三层连通性与 RTT,-s 指定包长探测 MTU 黑洞。
- traceroute:逐跳定位在哪一跳丢包或绕路,星号 * * * 不一定是故障(可能是中间设备不回 ICMP)。
- 抓包:tcpdump/wireshark 看真实报文,回答「到底发没发、发到哪、回没回」。

> 口诀:先看链路,再查邻居(ARP),后验路由,最后抓包。90% 的「网络不通」卡在前三步。

二、参考排查拓扑

flowchart LR
    PC1[PC-1<br/>10.10.1.10/24] --> SW1[Access-1<br/>VLAN10 网关]
    SW1 --> SW2[Core-1<br/>OSPF Area0]
    SW2 --> RT[出口路由器<br/>NAT/FW]
    RT --> INET[互联网/远端]
    SW1 --> SW3[Core-2]
    SW2 --> SW3

配套 ASCII 路径图(用于画故障路径、标故障点):

PC-1(10.10.1.10) ──► SW1(Access) ──► SW2(Core) ──► RT(出口) ──► Internet
        │                │               │              │
        L1/L2            L2              L3            L3/L4/NAT
      ping 网关        MAC/STP      OSPF/路由表    ACL/NAT/MTU

三、关键决策表(现象→排查层→首要命令)

现象 最可能故障层 首要诊断命令 依据/常见错误
链路 down,接口不亮 L1 物理层 show interface status / display interface 光模块收发反接、光衰过大(收光<-12dBm 告警)
本网段 ping 不通 L2 数据链路层 show arp / arp -a ARP 未学到,MAC 表错误或端口隔离
跨网段不通,同段通 L3 网络层 show ip route / display ip routing-table 缺路由、下一跳不可达、ACL 拦截
traceroute 某跳后全星号 L3/L4 抓包看 TTL 与 ICMP 中间设备不回 ICMP 超时,未必故障
大包丢、小包通 MTU 黑洞 ping -s 1473 -M do 路径 MTU 小于 1500,ICMP 需分片被丢弃
时延忽高、偶发丢包 L2 环路/拥塞 show spanning-tree / 抓包看广播风暴 环路导致广播风暴、CPU 打满
端口有 CRC/错包 L1 物理层 show interface counters errors 线缆、光模块脏污或速率双工不匹配

> 阈值速查:光模块收光功率建议 -3~-12dBm;CRC 错误应持续为 0(非零即查链路);RTT 跨一跳 LAN 应 <1ms,WAN 按距离估算(每 1000km 约 5ms 单向)。

四、分步 SOP

  1. 确认范围与时间线:记录故障影响哪些主机/网段、从何时开始、有无变更(变更关联是头号线索)。
  2. L1 查链路:show interface status 看 up/down、速率双工;display transceiver 看收发光功率。
  3. L2 查邻居与环路:show arp、show mac address-table、show spanning-tree,排查环路与 VLAN 不一致。
  4. L3 查路由与过滤:show ip route、traceroute、show access-lists,确认转发路径与 ACL。
  5. 抓包验证:在故障点两侧同时 tcpdump,比对「发送端发出、接收端是否收到、是否回包」。
  6. 修复与回归:单点改动、灰度验证、回写监控与文档。

五、真实配置/诊断命令示例

华为 CloudEngine / VRP 诊断命令

# 查接口与光模块状态
display interface brief
display interface 10GE1/0/1
display transceiver interface 10GE1/0/1 verbose

# 查 MAC / ARP / 路由
display mac-address vlan 10
display arp
display ip routing-table

# 查 STP 环路
display stp brief
display stp abnormal-interface

思科 IOS-XE 诊断命令

show interface status
show interface GigabitEthernet1/0/1
show interfaces transceiver detail
show mac address-table vlan 10
show ip arp
show ip route
show spanning-tree vlan 10
show interfaces counters errors

Linux 抓包三板斧

# 抓 ICMP 与 TCP 握手
tcpdump -i eth0 -nn icmp
tcpdump -i eth0 -nn &#x27;tcp[tcpflags] &amp; (tcp-syn|tcp-fin) != 0&#x27;
# 抓某主机、写文件
tcpdump -i eth0 -nn host 10.10.1.10 -w /tmp/cap.pcap -c 1000
# MTU 探测(不分片,逐包长测试)
ping -c 3 -M do -s 1472 10.10.1.1   # 1500 MTU 下最大 payload=1472

六、验证方法

检查项 达标阈值 命令
连通性 丢包率 0%,RTT 稳定 ping -c 100 &lt;target&gt;
路径正确 跳数/路径与设计一致 traceroute -n &lt;target&gt;
MTU 一致性 1472 通、1473 断(1500 MTU) ping -M do -s 1473 &lt;target&gt;
错包计数 CRC/错误 = 0 show interfaces counters errors
光功率 收光 -3~-12 dBm show interfaces transceiver detail
STP 状态 无 blocked 异常端口、无拓扑变更风暴 show spanning-tree vlan 10

七、常见故障排查表

现象 根因方向 首要动作
ping 网关不通,链路 up ARP 未学到 / 端口被隔离 show arp,查端口是否 port-isolate
跨网段不通 缺路由 / 下一跳不可达 / ACL show ip route,逐跳 traceroute
大包丢、小包通 MTU 黑洞(路径 MTU <1500) ping -M do -s 1473 定位,调整 MTU 或开 MSS clamp
广播风暴、CPU 高 二层环路 show spanning-tree,找环、开 BPDU guard
traceroute 全星号 中间设备不回 ICMP 抓包看 TTL 超时,星号≠故障
时延偶发尖峰 拥塞/微突发/环路 抓包 + 队列计数,查 show queue
OSPF 邻居 down 区域不一致/MTU 不匹配/认证 show ip ospf neighbor,比对 hello 参数

八、输出规范

交付时应产出:故障时间线与影响范围、逐层排查记录(L1→L7 结论)、抓包关键报文解读、根因与修复动作、回归验证结果、预防措施(监控/变更关联)。

九、边界与风险

  • 抓包涉及敏感数据,需合规授权,脱敏后归档。
  • traceroute 星号常被误判为故障,需抓包佐证。
  • 生产环境操作(清 MAC、重启端口、改 STP)需变更窗口,避免二次故障。
  • 诊断命令为量级参考,具体以设备型号/软件版本为准,不承诺跨厂商命令完全一致。

配套资源

  • 诊断命令集:references/diagnostic-commands.md
  • 故障案例库:references/troubleshooting-cases.md
  • 数据基线:assets/fault-symptom-command.csv
  • 诊断模板:assets/diagnostic-template.txt
  • 脚本:scripts/diag_output_parser.py(诊断命令输出解析)
  • 配套检查清单:《网络故障排查清单》

常见问题

5 问
答案由本站依据条目字段整理
网络故障排查怎么安装?

在支持 Skills 的客户端里执行:skillhub install user_c1c65a3c/net-fault-troubleshooting。安装方式为未标注。装完刷新技能列表或重开客户端。

网络故障排查支持哪些客户端?

资料没有标注宿主客户端,但只要客户端支持 Skills(Claude、Codex、Cursor 等),一般都能加载。

网络故障排查权限高吗,安全吗?

权限级别为未标注权限。安装前先看它会读取或写入哪些内容。

网络故障排查收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于技能本身和所用的模型或客户端,正式使用前按作者说明确认。

网络故障排查用什么许可证?

许可证标注为 未说明(许可证不明确)。商用或二次分发前请到仓库确认条款原文。

热门专题

按场景挑技能
全部专题 →

技能内容以作者仓库为准;分类、权限级别与许可证状态的中文说明为中文整理,最近核验 2026-11-06。