Agent Skills
返回列表
HTTPS 证书排障助手

HTTPS 证书排障助手

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b4da0893/https-cert-troubleshoot-cn。

技能介绍

为什么“证书错误”不能只看本地文件

浏览器弹红叉只是表象。在复杂的分布式架构中,证书已经更新、磁盘文件正确,流量却可能依然命中旧的边缘节点或反向代理。这种故障通常跨越 DNS 解析、负载均衡、SNI 匹配、证书链完整性、协议协商以及自动续期发布等多个环节。本文将分享如何系统化地排查这类问题。

如何工作:从链路还原到最小变更

排查的核心原则是只读取证与最小变更,禁止仅凭配置文件判断线上状态。其诊断工作流分为三个关键步骤:

  • 绘制真实的 TLS 终止路径:不依赖单一客户端截图,而是记录域名、端口、网络与错误原文。梳理流量经过的边缘节点、代理与网关,明确 TLS 在哪一跳终止,避免在错误节点替换证书。
  • 采集实际握手证据:使用正确的 SNI 连接每个可疑入口,提取线上返回的证书指纹、主机名、有效期与中间证书。将实际指纹与预期状态进行对比,识别“文件已换、进程未换”的情况。
  • 验证完整续期闭环:将续期视为从签发、分发、重载到线上探测的完整链路。核对密钥配对时不导出私钥,通过公钥派生比对确认部署一致性。

边界与注意点

排查的目的是精准修复根因,而不是掩盖问题:

  • 任何修改建议都需附带影响面评估、验证步骤与明确回滚方案。
  • 严禁建议关闭证书校验作为“临时”修复手段,这会导致中间人风险扩大。
  • 不能用单点测试代表全网可用性,必须在多网络、多客户端环境下进行多点验收。

使用场景

  • 线上证书已替换,浏览器却依旧提示证书过期,需要定位流量命中的旧节点
  • 接口客户端报证书链错误而浏览器正常,需要排查服务端中间证书与客户端信任库差异
  • 部分海外用户访问失败而国内正常,需要核对不同地区的DNS解析与边缘节点配置
  • 自动续期任务显示成功,第二天部分节点仍报过期,需要检查分发与重载闭环

适合人员

  • 后端运维工程师,每周负责批量替换证书,需要快速排查证书更新未生效的节点
  • 网站可靠性工程师(SRE),需要在多地区部署中定位证书链与握手失败的根因
  • API 集成开发者,要修复第三方客户端因信任库差异导致的证书报错
  • 云平台运维工程师,需设计并验证证书自动续期的发布与回滚流程