HTTPS证书到期前预警:监测实际访问入口并验收通知
监测浏览器实际拿到的证书
本文适用于已部署 Uptime Kuma 2.5.11 的独立监控机,命令示例使用 Ubuntu 24.04 的 OpenSSL 3.0。目标是证书过期前收到可处理的通知。服务器里的证书文件已更新,不代表 Nginx、反向代理或其他 HTTPS 入口已经加载新证书。
先列出客户真正访问的域名、端口和入口。www 与不带 www 的域名、后台子域名、API 可能使用不同证书;一张证书覆盖多个名称,也不等于每个入口部署正确。证书到期与域名注册到期是两件事,本文只监测 TLS 证书。
开启到期提醒并绑定通知
- 新增 HTTP(s) 监控,URL 填该域名直接返回正常内容的 HTTPS 地址;避免跳转到另一个域名后检查错入口。可以将重定向次数设为 0,并使用最终的规范地址。
- 选择合理采样间隔,例如300秒,在“高级”区域勾选“证书到期时通知”。保持“忽略 HTTPS 站点的 TLS/SSL 错误”未勾选,不用关闭验证掩盖过期、名称不符或证书链问题。
Uptime Kuma 2.5.11 官方临时演示:在“高级”区域开启“证书到期时通知”,保持“忽略 HTTPS 站点的 TLS/SSL 错误”未勾选。“域名到期通知”属于另一类提醒,不能代替证书预警。
- 到“设置→通知→TLS证书过期通知”检查提前提醒天数。此处是全局设置,改动前先检查其他监控的需求,再按续期流程和处理时间选择阈值。新增值需要填写天数、点击右侧加号加入列表,再点击保存。
Uptime Kuma 2.5.11 官方临时演示:列表中的7、14、21天为演示实例的默认阈值示例,请按自己的续期流程调整。下方“1天”只是输入框的占位提示,未添加为阈值;通知渠道还必须分配给监控项。
- 为该监控勾选真正使用的通知渠道,发送测试并实际收件。通知存在于设置页但没有分配给监控时,不会自动替该监控发信。
保存后打开监控详情中的证书信息,核对名称、签发者、到期日与剩余天数。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或不同网络应分别安排观察。监控被暂停、监控机离线或通知失效,都可能让到期提醒缺席,因此还要独立检查监控机本身。