计算机网络 / 系统课时
整理协议排障检查表
整理协议排障检查表
本课把零散命令整理为一张可执行、可记录、可交接的协议排障检查表。完成后,值班人员可以按统一顺序采集证据,快速判断故障所在层级,并形成可复核的处理记录。
学习目标
- 设计覆盖地址、路由、DNS、端口、TLS 和应用层的检查项
- 为每个检查项定义命令、关键字段、通过条件和失败去向
- 使用采集脚本生成标准化的初始诊断信息
检查表应包含什么
工程化检查表不是命令清单,而是“检查对象、采集方法、判定标准、失败动作”的组合。每一项都应能回答两个问题:当前层是否通过;若不通过,下一步由谁处理。
建议固定记录故障时间、客户端地址、目标域名、目标端口、执行人和变更编号。动态值使用实际现场数据,避免只留下“已检查、无异常”这类不可复核结论。
分层检查表
| 层级 | 推荐命令或证据 | 关键字段 | 通过标准 | 常见失败现象 |
|---|---|---|---|---|
| 本机地址 | ip -brief address |
接口状态、IP、掩码 | 接口 UP,地址属于预期网段 | 无地址、掩码错误、接口 DOWN |
| 路由 | ip route get <IP> |
下一跳、出口、源地址 | 路径与设计一致 | unreachable、错误 VPN、错误源地址 |
| DNS | getent ahostsv4 <HOST> |
返回地址 | 与当前服务节点一致 | 旧地址、空结果、分裂解析 |
| TCP | nc -vz -w 3 <HOST> <PORT> |
成功、超时、拒绝 | 三次测试均成功 | 超时、refused、间歇失败 |
| TLS | openssl s_client |
SAN、有效期、验证码 | 主机名和证书链校验通过 | 过期、名称不符、链不完整 |
| HTTP | curl -v |
状态码、重定向、响应头 | 返回预期状态和内容 | 404、401、502、504、500 |
| 服务端 | ss -lntp、日志 |
监听地址、进程、异常 | 监听正确且无持续错误 | 仅监听本地、进程退出、上游失败 |
表格中的“通过标准”必须是可验证结果。比如“端口正常”应改写为“从故障客户端连续三次建立 TCP 连接成功”,这样才能避免偶发成功被误判为彻底恢复。
标准采集脚本
下面脚本在 Linux 客户端采集地址、路由、DNS、TCP 和 HTTP 结果。它不会自动修改系统,只负责生成第一轮证据。保存为 protocol-check.sh 后赋予执行权限。
#!/usr/bin/env bash
set -u
if [ "$#" -ne 2 ]; then
echo "用法: $0 <HOST> <PORT>"
exit 2
fi
HOST="$1"
PORT="$2"
echo "== 基本信息 =="
date -Is
ip -brief address
echo "== DNS =="
getent ahostsv4 "$HOST" || true
TARGET_IP="$(getent ahostsv4 "$HOST" | awk 'NR==1 {print $1}')"
if [ -n "${TARGET_IP:-}" ]; then
echo "== 路由 =="
ip route get "$TARGET_IP" || true
fi
echo "== TCP =="
nc -vz -w 3 "$HOST" "$PORT"
echo "== HTTP/HTTPS =="
curl --connect-timeout 3 --max-time 8 --silent --show-error \
--output /dev/null --write-out 'status=%{http_code} remote=%{remote_ip}\n' \
"https://${HOST}:${PORT}/health"预期结果
脚本依次输出本机地址、DNS 结果、目标路由、TCP 连接结果和 HTTP 状态。
当 TCP 或 curl 失败时,脚本返回非零状态,便于值班平台识别检查未通过。执行示例
chmod +x protocol-check.sh
./protocol-check.sh api.lab.example 8443预期输出
== 基本信息 ==
<TIME>
eth0 UP 192.168.10.25/24
== DNS ==
10.30.8.20 STREAM api.lab.example
== 路由 ==
10.30.8.20 via 192.168.10.1 dev eth0 src 192.168.10.25
== TCP ==
Connection to api.lab.example 8443 port [tcp/*] succeeded!
== HTTP/HTTPS ==
status=200 remote=10.30.8.20时间、接口名和地址会随环境变化。脚本输出只用于初筛;若 TLS 或 HTTP 异常,还需补充 openssl s_client、curl -v、抓包和服务端日志。
把现象映射到下一步
当 DNS 解析错误时,先核对权威记录、缓存和客户端 DNS,不要直接重启应用。TCP 超时优先检查路由、防火墙和回程路径;TCP 拒绝优先检查监听端口和进程状态。
TLS 校验失败时处理证书、SNI 和系统时间;HTTP 404 检查路径与代理规则;502 或 504 检查上游连接;500 检查应用日志和依赖服务。检查表的价值就在于让相同现象始终进入相同处理分支。
交付与复盘要求
一次完整记录至少应包含原始现象、检查时间、每层命令、关键输出、根因、变更内容和复测结果。敏感信息如令牌、Cookie、私钥和完整业务报文必须脱敏后再进入工单。
复盘时应把本次新发现的现象补回检查表,并删除无效或重复步骤。检查表需要版本号和维护人,否则随着环境变化,很快会退化为过时命令集合。