HTTPS证书到期前预警:监测实际访问入口并验收通知

监测浏览器实际拿到的证书

本文适用于已部署 Uptime Kuma 2.5.11 的独立监控机,命令示例使用 Ubuntu 24.04 的 OpenSSL 3.0。目标是证书过期前收到可处理的通知。服务器里的证书文件已更新,不代表 Nginx、反向代理或其他 HTTPS 入口已经加载新证书。

先列出客户真正访问的域名、端口和入口。www 与不带 www 的域名、后台子域名、API 可能使用不同证书;一张证书覆盖多个名称,也不等于每个入口部署正确。证书到期与域名注册到期是两件事,本文只监测 TLS 证书。

开启到期提醒并绑定通知

  1. 新增 HTTP(s) 监控,URL 填该域名直接返回正常内容的 HTTPS 地址;避免跳转到另一个域名后检查错入口。可以将重定向次数设为 0,并使用最终的规范地址。
  2. 选择合理采样间隔,例如300秒,在“高级”区域勾选“证书到期时通知”。保持“忽略 HTTPS 站点的 TLS/SSL 错误”未勾选,不用关闭验证掩盖过期、名称不符或证书链问题。

    Uptime Kuma中文高级设置,证书到期时通知已勾选,域名到期和忽略TLS错误未勾选

    Uptime Kuma 2.5.11 官方临时演示:在“高级”区域开启“证书到期时通知”,保持“忽略 HTTPS 站点的 TLS/SSL 错误”未勾选。“域名到期通知”属于另一类提醒,不能代替证书预警。

  3. 到“设置→通知→TLS证书过期通知”检查提前提醒天数。此处是全局设置,改动前先检查其他监控的需求,再按续期流程和处理时间选择阈值。新增值需要填写天数、点击右侧加号加入列表,再点击保存。

    Uptime Kuma中文TLS证书过期通知阈值,列表为7天14天21天,输入框显示1天占位提示

    Uptime Kuma 2.5.11 官方临时演示:列表中的7、14、21天为演示实例的默认阈值示例,请按自己的续期流程调整。下方“1天”只是输入框的占位提示,未添加为阈值;通知渠道还必须分配给监控项。

  4. 为该监控勾选真正使用的通知渠道,发送测试并实际收件。通知存在于设置页但没有分配给监控时,不会自动替该监控发信。

保存后打开监控详情中的证书信息,核对名称、签发者、到期日与剩余天数。HTTPS 检测正常与到期预警是不同结果:证书还有几天有效时,页面可能仍显示正常,但已经应该通知续期。

用命令复核同一个入口

将 www.example.com 换成自己的域名,在监控机执行。命令检查证书链与主机名,设置超时,并将握手记录保存到新的临时目录,不读取或修改网站私钥。

(
BLY_DOMAIN=www.example.com
if ! BLY_TLS_DIR="$(mktemp -d)"; then
  echo "无法创建记录目录,已停止检查" >&2
  exit 1
fi
if timeout 15 openssl s_client \
  -connect "$BLY_DOMAIN:443" -servername "$BLY_DOMAIN" \
  -verify_hostname "$BLY_DOMAIN" -verify_return_error \
  -CApath /etc/ssl/certs -showcerts \
  </dev/null >"$BLY_TLS_DIR/handshake.txt" \
  2>"$BLY_TLS_DIR/verify.txt"; then
  awk '/-----BEGIN CERTIFICATE-----/{p=1}
       p{print}
       /-----END CERTIFICATE-----/{exit}' \
       "$BLY_TLS_DIR/handshake.txt" > "$BLY_TLS_DIR/leaf.pem"
  if openssl x509 -in "$BLY_TLS_DIR/leaf.pem" -noout \
       -subject -issuer -enddate -fingerprint -sha256; then
    if openssl x509 -in "$BLY_TLS_DIR/leaf.pem" \
         -noout -checkend 1209600; then
      echo "当前证书在未来14天内不会到期"
    else
      echo "当前证书将在14天内到期,请处理"
    fi
  else
    echo "未取得可解析的证书,不能判定正常"
  fi
else
  echo "连接或证书验证失败,请查看记录"
fi
printf '记录目录:%s\n' "$BLY_TLS_DIR"
)

1209600 是 14 天的秒数。checkend 只判断到期窗口,所以前面仍需要链和名称验证;DNS、连接超时、无证书等采集失败不能写成“还有足够有效期”。使用内部 CA 的站点应先给监控机配置正确的信任链,不要关闭验证。

验收到期通知,而不只测试发信

在尚未接入正式监控的验收实例中,先选自己的有效 HTTPS 域名,记录剩余天数。临时设置一个大于其剩余天数的预警阈值,再新建并启用该域名的测试监控、勾选证书预警及通知渠道。等待证书检测实际产生到期预警,确认收到的消息包含正确域名和到期信息。

验收后恢复计划采用的阈值并保存。已有正式监控的实例,应另用独立测试实例验收,避免修改全局阈值触发其他业务群发。不能通过替换正式站证书或修改系统时间制造故障。

续期后的闭环

收到预警后,处理证书申请、部署和对应服务加载,再从监控机重新检查实际入口。确认到期日期、指纹及监控信息已变化;若仍读到旧证书,按证书已续期但访问仍报错定位真实入口。自动续期本身按Nginx证书续期指南检查。

定期抽查最后一次成功检测时间和通知渠道。单个监控点不能覆盖所有分布式入口;多个节点、IPv4/IPv6或不同网络应分别安排观察。监控被暂停、监控机离线或通知失效,都可能让到期提醒缺席,因此还要独立检查监控机本身。