计算机网络 / 系统课时

整理协议排障检查表

整理协议排障检查表

本课把零散命令整理为一张可执行、可记录、可交接的协议排障检查表。完成后,值班人员可以按统一顺序采集证据,快速判断故障所在层级,并形成可复核的处理记录。

学习目标

  • 设计覆盖地址、路由、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 后赋予执行权限。

bash
#!/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"

预期结果

text
脚本依次输出本机地址、DNS 结果、目标路由、TCP 连接结果和 HTTP 状态。
当 TCP 或 curl 失败时,脚本返回非零状态,便于值班平台识别检查未通过。

执行示例

bash
chmod +x protocol-check.sh
./protocol-check.sh api.lab.example 8443

预期输出

text
== 基本信息 ==
<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、私钥和完整业务报文必须脱敏后再进入工单。

复盘时应把本次新发现的现象补回检查表,并删除无效或重复步骤。检查表需要版本号和维护人,否则随着环境变化,很快会退化为过时命令集合。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

整理协议排障检查表

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通