SSL 证书到期提醒怎么做?openssl 排查、certbot 续期与 Prometheus 告警 4 种方案
SSL 证书到期提醒建议设 45/30/14/7/3/1 天多级阈值,30 天是底线,因为 Let's Encrypt 证书只有 90 天寿命。 一条命令即可查到期时间:echo | openssl s_client -connect 域名:443 -servername 域名 2>/dev/null | openssl x509 -noout -dates,必须带 -servername 触发 SNI。 自动化优先级:certbot/acme.sh 自动续期 > Prometheus + blackbox_exporter 批量监控 > Uptime Kuma 或 UptimeRobot,提醒只作兜底。 告警渠道至少两条:群组邮箱加企业微信/钉钉/飞书机器人,7 天内升级到短信,避免单点失效。 CA/Browser Forum 计划把公共 TLS 证书有效期从 398 天逐步压缩到 200 天、100 天、47 天,提醒窗口必须跟着前移。
先给结论:SSL 证书到期提醒该提前多少天、走哪些渠道?
直接回答:至少提前 30 天报警,推荐按 45/30/14/7/3/1 天六级阈值推送,且至少两条独立通道。据 Let’s Encrypt 官方文档,其证书有效期固定 90 天,官方建议在剩余约 1/3 寿命(即约 30 天)时完成续期——把 30 天设为警告线,正好给”续期失败→排查→重签”留出窗口。
为什么不能只写死一个数字?因为证书寿命正在变短。CA/Browser Forum 自 2020-09-01 起把公共 TLS 证书最长有效期压到 398 天;据其 Ballot SC-081(2025 年通过),2026-03-15 起降为 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。所以 ssl 证书到期提醒的阈值应按”实际寿命的约 1/3″动态设置。
先确认事实,再配告警。OpenSSL 1.1.1 与 3.x 均可:
$ echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
subject=CN = example.com
issuer=C = US, O = Let's Encrypt, CN = R11
notBefore=Feb 1 08:12:33 2025 GMT
notAfter=May 2 07:12:32 2025 GMT
notAfter 减当前时间就是剩余天数,这也是 Zabbix、Prometheus blackbox_exporter(probe_ssl_earliest_cert_expiry)和 certbot renew --dry-run 的判定依据。
- 渠道要冗余:邮件发到 ops@example.com 群组邮箱 + 企业微信/钉钉/飞书机器人 + 短信 + 工单,至少两条通道。
- 别只靠本机 sendmail:云主机出站 25 端口常被封,邮件会静默失败,告警形同虚设。
- 对象要分层:30 天通知运维值班群;7 天内同时 @ 业务负责人;1 天内升级到电话。
- 别忘了业务影响:据 Google Search Central 文档,HTTPS 是排名信号之一,证书过期导致站点不可访问会直接影响抓取与排名。
最后把资产盘清楚:域名、端口、CA、签发日、到期日、负责人、续期方式七列,用 YAML 或 CMDB 维护,每季度核对一次。这一张表,比任何事后救火都便宜。
第一步:用 openssl 一条命令查清域名证书的到期时间
查证书到期时间最直接的办法是用 OpenSSL 的 s_client 发起一次真实握手,再交给 x509 解析。单域名查询命令如下(适用于 OpenSSL 1.0.2 及以上,1.1.1 与 3.x 同样可用):
echo | openssl s_client -connect sslgood.com:443 -servername sslgood.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -fingerprint -sha256
典型输出形如:
subject=CN = sslgood.com
issuer=C = US, O = Let's Encrypt, CN = R11
notBefore=Mar 1 00:00:00 2025 GMT
notAfter=May 30 23:59:59 2025 GMT
SHA256 Fingerprint=3A:F1:...:9C
为什么必须带 -servername? 因为现代 TLS 依赖 SNI(Server Name Indication,RFC 6066)来选择证书。同一 IP 上常挂多个站点,如果不发 SNI,服务器只会返回默认证书,你读到的可能是别人的到期时间,ssl 证书到期提醒 自然就报错了。-servername 会把它写进 ClientHello 的 server_name 扩展,拿到真正的目标证书。非 443 端口只需替换端口号,例如 -connect sslgood.com:8443。
要批量巡检,把域名每行一个写进 domains.txt,然后跑:
for d in $(cat domains.txt); do
end=$(echo | openssl s_client -connect $d:443 -servername $d 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
echo "$d -> $end"
done
如果证书已经下载成本地文件,判断更快:
openssl x509 -in fullchain.pem -noout -checkend 2592000
2592000 秒正好是 30 天。退出码 0 表示 30 天内不会过期,1 表示即将过期——这个退出码可以直接写进监控脚本做 if 分支,比解析日期字符串可靠得多。需要看整条链是否完整,加 -showcerts;据 OpenSSL 官方文档,缺中间证书时 Java 8、Android 7 以下等老客户端会直接握手失败,这是另一类高频证书故障,与到期问题要分开排查。
最后提醒:负载均衡、CDN、WAF 上挂的证书未必等于服务器 /etc/letsencrypt/live/ 下的文件。certbot 续期成功后,用上面的 SHA256 指纹比对线上与本地,才能确认新证书真的生效,否则到期提醒会一直误报。
方案一:certbot 与 acme.sh 自带的续期和到期提醒
certbot 和 acme.sh 都自带续期调度与到期通知,是成本最低的 ssl 证书到期提醒 起点。先用一条命令确认链路可用:
# certbot 2.x / 3.x 通用,--dry-run 不会写入生产证书
certbot renew --dry-run
正式续期不靠手工,而由 systemd 定时器或 cron 触发。Debian/Ubuntu 官方包默认每天执行两次并叠加随机延迟,可用 systemctl list-timers | grep certbot 确认 certbot.timer 是否存在;旧系统则看 /etc/cron.d/certbot。成功输出形如:
Congratulations, all renewals succeeded:
/etc/letsencrypt/live/sslgood.com/fullchain.pem (success)
若看到 Cert not yet due for renewal,说明尚未进入到期前 30 天的续期窗口,属正常现象。据 Let’s Encrypt 文档,证书有效期为 90 天,官方建议在剩余 30 天时续期。
邮件提醒在 /etc/letsencrypt/cli.ini 里配置:
email = your-ops@example.com
续期失败时由本机 MTA 发信。但云主机普遍封禁 25 端口,邮件常发不出去,建议改用 --deploy-hook 把通知交给 IM 机器人。把逻辑写成独立脚本,便于复用和测试:
#!/bin/bash
# /usr/local/bin/notify.sh
curl -s -X POST "https://open.feishu.cn/open-apis/bot/v2/hook/xxxx"
-H "Content-Type: application/json"
-d '{"msg_type":"text","content":{"text":"SSL 证书已续期完成: '"$RENEWED_LINEAGE"'"}}'
certbot renew --deploy-hook /usr/local/bin/notify.sh
deploy-hook 仅在真正完成续期时触发,而 --dry-run 也会触发一次,正好用来验证通知通道是否通畅。
acme.sh 3.x 的思路一致:acme.sh --install-cronjob 安装每日检查任务,acme.sh --set-notify --notify-hook mail 开启邮件通知,也可换成 telegram、dingtalk 等社区 hook。--notify-level 1 表示仅在出错时通知,避免每天刷屏。
最后别忘了重载服务,否则续期成功也等于白续:
nginx -s reload # Nginx
systemctl reload haproxy # HAProxy
# Java 应用需重启或重新读取 keystore
版本提示:certbot 2.x 与 3.x 的
renew、--deploy-hook参数行为一致;acme.sh 的 notify 功能自 2.8.x 起提供,3.x 已稳定。
方案二:Prometheus + blackbox_exporter 批量监控证书到期
不想每台机器都装脚本,有没有集中式的 ssl 证书到期提醒?有,用 Prometheus 的 blackbox_exporter 做黑盒探针。据 blackbox_exporter 官方文档(0.25.x),http 探针成功后会暴露两个关键指标:probe_success(0/1,探测是否成功)和 probe_ssl_earliest_cert_expiry(Unix 时间戳,取整条证书链中最早的一个到期时间,包含中间证书)。0.25.0 起还新增了 probe_ssl_last_chain_expiry_timestamp_seconds,可按证书逐张查看,排查链上哪一张先过期更直观。
先配置探针模块(blackbox.yml,适用于 0.25 及以上版本):
modules:
https_2xx:
prober: http
timeout: 10s
http:
preferred_ip_protocol: ip4
tls_config:
insecure_skip_verify: false
insecure_skip_verify: false 很重要:保持校验,才能顺带发现证书链不完整、自签名等真实问题。
在 Prometheus 里加一个抓取任务,用 relabel 把目标地址转成 /probe?target= 参数:
scrape_configs:
- job_name: blackbox-ssl
metrics_path: /probe
params:
module: [https_2xx]
static_configs:
- targets:
- https://sslgood.com
- https://api.sslgood.com:8443
relabel_configs:
- source_labels: [__address__]
target_label: __param_target
- source_labels: [__param_target]
target_label: instance
- target_label: __address__
replacement: 127.0.0.1:9115
告警规则做成两级,30 天预警、7 天严重:
groups:
- name: ssl-cert
rules:
- alert: SSLCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 30
for: 1h
labels:
severity: warning
annotations:
summary: '{{ $labels.instance }} 证书 30 天内到期'
- alert: SSLCertExpiringCritical
expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 7
for: 1h
labels:
severity: critical
annotations:
summary: '{{ $labels.instance }} 证书 7 天内到期'
Grafana 面板用 (probe_ssl_earliest_cert_expiry - time()) / 86400 画剩余天数曲线,哪些域名在往下掉一眼可见;Alertmanager 按 severity 路由到邮件、钉钉或 PagerDuty 即可分级通知。
为什么说它比脚本单点提醒更好排查?因为指标是可回溯的时间序列。如果某域名连续几天剩余天数完全不变,通常说明探针命中了 CDN 缓存或抓到了错误的证书(比如 SNI 不匹配拿到默认站点证书),这时把 probe_success 单独做一条告警,就能把“证书快过期”和“站点探测失败”两类故障区分开。
方案三:Zabbix、Uptime Kuma 与商业监控服务怎么选
域名只有十几个,Zabbix 和 Uptime Kuma 到底选哪个?关键看你已经有什么基础设施。已经在跑 Zabbix 6.0/7.0 的团队没必要再引入新组件:Zabbix agent 2 自带 WebCertificate 插件,item key 形如 web.certificate.get[sslgood.com,443,,],返回 JSON 中含 expiry 字段。
# zabbix_agent2.conf(Zabbix 6.0 及以上,需加载 Web 插件)
Plugins.Web.Timeout=10
# 监控项 key
web.certificate.get[sslgood.com,443,,]
# 预处理步骤 1:JSONPath 提取
$.expiry
# 预处理步骤 2:JavaScript 转 Unix 时间戳(expiry 是 "Nov 10 12:00:00 2025 GMT" 这类字符串)
var d = new Date(value);
return Math.floor(d.getTime() / 1000);
# 触发器表达式(剩余不足 14 天告警)
last(/sslgood.com/web.certificate.get[sslgood.com,443,,,#expiry]) - now() < 14*86400
不想维护 agent 也可以只用内置 Web scenario,但拿到的是响应码而非证书到期时间,粒度差一截。
Uptime Kuma 1.23+ 怎么开证书到期提醒?新建 HTTP(s) 监控后勾选 Certificate Expiry Notification 即可,默认提前 14 天告警,可在通知设置里改天数。它支持邮件、Telegram、企业微信、飞书、Server 酱等 90 多种通知方式,自建免费:
docker run -d --restart=always -p 3001:3001
-v uptime-kuma:/app/data --name uptime-kuma
louislam/uptime-kuma:1
不想自建,SaaS 和云厂商自带提醒够用吗?
| 方案 | 提醒提前量 | 成本(2025 年官网) | 适合规模 |
|---|---|---|---|
| UptimeRobot | 内置 SSL 到期提醒 | 免费版 50 个监控 / 5 分钟间隔;付费约 7 美元/月起 | 10 个域名以内 |
| 阿里云 SSL 证书服务 | 到期前 30/15/7/1 天短信 + 邮件 + 站内信 | 随证书 | 已购商业证书 |
| AWS ACM | 自动续期(依赖 DNS 验证 CNAME 记录) | 公有证书免费 | 跑在 AWS 上的服务 |
| Pingdom / Datadog Synthetics | 可自定义 | 单价明显更高 | 已有 APM 体系 |
腾讯云证书控制台机制与阿里云类似。注意 AWS ACM 的自动续期有个坑:当初做 DNS 验证的 CNAME 记录一旦被删,就只剩提醒没有续期,据 AWS ACM 文档,证书会在到期后失效,必须重新签发。
选型建议。域名 10 个以内用 Uptime Kuma 或 UptimeRobot;50 个以上、需要历史指标和统一告警,自建 Prometheus + blackbox_exporter 更划算。商业证书价格参考:DV 单域名约 0–300 元/年,OV 约 800–3000 元/年,EV 约 3000–8000 元/年,以 CA 与代理商实时报价为准。实际生产中混合部署很常见:ACME 证书(据 Let’s Encrypt 文档有效期 90 天)走自动续期,商业证书走云厂商控制台提醒,再用一套 Prometheus 做统一兜底,两层互不依赖——这也是把 ssl 证书到期提醒做扎实的常见做法。
方案四:一条 crontab 兜底的自检脚本(含完整代码)
前面三套方案都依赖外部组件,这里给一个只靠 cron 和 openssl 的兜底方案:脚本每天跑一次,把剩余天数低于阈值的域名打日志,需要推送就把 echo 换成 webhook 调用。
先建目录和域名清单(一行一个 FQDN,不要带 https://):
mkdir -p /etc/ssl-monitor
cat > /etc/ssl-monitor/domains.txt <<'EOF'
www.example.com
api.example.com
EOF
cat > /usr/local/bin/check-ssl.sh <<'EOF'
#!/usr/bin/env bash
WARN=30
for host in $(cat /etc/ssl-monitor/domains.txt); do
end=$(echo | openssl s_client -connect "$host:443" -servername "$host" 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
end_ts=$(date -u -d "$end" +%s)
days=$(( (end_ts - $(date -u +%s)) / 86400 ))
if [ "$days" -lt "$WARN" ]; then echo "$host 剩余 $days 天"; fi
done
EOF
chmod +x /usr/local/bin/check-ssl.sh
crontab(每天 9 点跑,日志留存方便追溯哪天开始掉到阈值以下):
0 9 * * * /usr/local/bin/check-ssl.sh >> /var/log/ssl-check.log 2>&1
推送只需把 echo 那行换成企业微信机器人调用,注意 webhook key 必须放在仅 root 可读的文件里(如 /etc/ssl-monitor/webhook.key,权限 600),不要写进 crontab 明文,泄露后会被滥用刷消息:
curl -s "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=$(cat /etc/ssl-monitor/webhook.key)"
-H 'Content-Type: application/json'
-d "{"msgtype":"text","text":{"content":"$host 剩余 $days 天"}}"
两个常见坑:一是 macOS 自带的 BSD date 不支持 -d,可用 date -j -f "%b %d %T %Y %Z" "$end" +%s,或直接用 openssl x509 -checkend $((WARN*86400)) 看退出码,绕开日期解析差异;二是时区对齐,证书 notAfter 按 RFC 5280 是 GMT/UTC,计算时统一加 -u,否则东八区会算错一天,出现”明明还有 1 天却报已过期”。
它的定位是最后一道防线:即使 certbot 续期和 Prometheus 告警都正常,crontab 自检也能在 MTA、webhook 同时出问题时留下可回溯的日志证据。
最常见的 6 个坑:提醒没少配,证书照样过期
监控配了一堆,证书还是过期?下面 6 个坑最常见,每个都附可复制的排查命令。
坑 1:只监控主域名,www、api、静态域名和邮件端口全漏了?
网站证书只是入口。SMTP 587(STARTTLS)、IMAP 993、PostgreSQL 5432 的 TLS 一旦过期,业务中断往往比网站更早暴露。逐端口探测,端口号按实际环境替换:
# Web 与静态资源域名(OpenSSL 1.1.1 / 3.x 通用)
for h in example.com www.example.com api.example.com cdn.example.com; do
printf '%s: ' "$h"
openssl s_client -connect $h:443 -servername $h /dev/null
| openssl x509 -noout -enddate
done
# 邮件端口:587 走 STARTTLS,993 为隐式 TLS
openssl s_client -connect mail.example.com:587 -starttls smtp -servername mail.example.com /dev/null | openssl x509 -noout -enddate
openssl s_client -connect mail.example.com:993 -servername mail.example.com /dev/null | openssl x509 -noout -enddate
坑 2:用 IP 做检查,监控到的其实是”假证书”?
不带 SNI 时,服务端只会返回默认虚拟主机的证书,真正的域名证书过期反而没有告警。据 RFC 6066,SNI 由客户端在握手时声明,-servername 就是开关。对比即可确认:
openssl s_client -connect 203.0.113.10:443 /dev/null | openssl x509 -noout -subject
openssl s_client -connect 203.0.113.10:443 -servername api.example.com /dev/null | openssl x509 -noout -subject
两条输出的 subject 不一致,说明探针一直盯着别人的证书。
坑 3:certbot 续期成功,服务却没换上新证书?
文件更新不等于进程加载:nginx 需要 nginx -s reload,HAProxy 需要 reload,Java 应用要重启或重读 keystore。用 deploy-hook 自动化,比人工记得住(Certbot 1.x 及以上):
cat >/etc/letsencrypt/renewal-hooks/deploy/reload.sh </dev/null || true
EOF
chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload.sh
坑 4:叶子证书没过期,链上的根或中间证书先过期了?
2021-09-30 DST Root CA X3 到期曾造成大面积旧客户端报错;Let’s Encrypt 随后的交叉签名调整(含 2024-06-06 及 2025 年的变更)也多次引发批量告警。除了盯叶子证书,还要看整条链:
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl crl2pkcs7 -nocrl -certfile /dev/stdin | openssl pkcs7 -print_certs -noout
同时订阅 CA 公告,并定期对照 Mozilla Server Side TLS 指南核对协议与套件配置。
坑 5:提醒只发给个人邮箱,人一休假就断链?
统一发到 ops@ 群组邮箱,IM 机器人做第二通道,剩余 7 天内追加短信;阈值建议按 30/14/7/3/1 天分级。
坑 6:配完就没再演练,通知链路其实早就断了?
每季度跑一次 dry-run 加一次通知链路测试。据 Let’s Encrypt 文档,–dry-run 走 staging 环境、不消耗速率限制:
certbot renew --dry-run
certbot certificates # 列出各证书剩余有效期与文件路径
另外,RFC 8555(ACME 协议)与 RFC 5280(证书有效期语义)的更新值得定期扫一眼——Prometheus 的 probe_ssl_earliest_cert_expiry 指标正是基于后者的 notAfter 语义计算的。
可直接照抄的最佳实践清单
把下面五条直接抄进你的运维规范即可,每条都对应一个容易踩的坑。
- 告警阈值至少四级,别只留 7 天。45 天发信息(准备工单)、30 天发警告(确认 ACME 是否正常)、14 天升高危(人工介入)、7 天紧急(值班群 @all),1 天仍未恢复则电话升级。只设单一 7 天阈值,等于把排查、灰度、CDN 刷新全压进一周。注意 CA/Browser Forum Baseline Requirements 与 SC-081 已规定公开 TLS 证书有效期上限将从 398 天逐步收紧(2026-03-15 起 200 天,2027-03-15 起 100 天),阈值也应随有效期同步压缩。
- 通道分层,且必须落到值班群。常规走群组邮件 + IM 机器人(Slack、钉钉、企业微信),7 天内叠加短信,1 天内叠加电话。任何 ssl 证书到期提醒都发给值班群而非某个人,否则休假即失联。
- 能自动续期就先自动化,提醒只做兜底。Let’s Encrypt、ZeroSSL、Google Trust Services 都支持 ACME。据 Let’s Encrypt 文档,其证书有效期 90 天,建议在剩余 30 天前完成续期,因此每日跑一次 dry-run 是最低成本保险:
# certbot >= 2.0(--cert-name 自 0.20 起可用)
certbot renew --dry-run --cert-name www.example.com
# 生产建议 systemd timer 每日执行两次并加随机延迟:
# /etc/systemd/system/certbot-renew.timer
[Timer]
OnCalendar=*-*-* 00,12:00:00
RandomizedDelaySec=3600
Persistent=true
- 用 YAML 或 CMDB 维护七列资产清单:域名、端口、CA、签发日、到期日、负责人、续期方式。每季度核对一次,顺手确认域名是否仍归自己所有、DNS 是否已迁走。
- 续期后立刻验证线上指纹,而不是本地文件。本地 cert.pem 更新了、负载均衡仍用旧证书是最常见事故:
# OpenSSL 1.1.1 / 3.x
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null
| openssl x509 -noout -fingerprint -sha256 -dates -subject
openssl x509 -in /etc/letsencrypt/live/www.example.com/cert.pem -noout -fingerprint -sha256
两处 SHA-256 指纹不一致,说明 CDN、WAF 或四层负载均衡上还挂着旧证书,需手动同步。协议与套件配置可对照 Mozilla Server Side TLS 指南,参数含义见 OpenSSL 手册页的 s_client、x509 条目。
Let’s Encrypt 的 ACME 证书有效期是 90 天,官方建议在剩余约 1/3 寿命(30 天)时完成续期。是否自动续期取决于你有没有装 certbot.timer 或 acme.sh 的 cron 任务,装了才会自动跑;没装的话,90 天一到就真的过期。
先看 /var/log/letsencrypt/letsencrypt.log,常见原因是 80/443 端口被占用导致 HTTP-01 验证失败、DNS-01 的 TXT 记录被清理、或者续期成功但没有 reload nginx。可以用 certbot renew –dry-run –debug-challenges 查看验证细节。
一般建议 30 天开始警告,因为 Let’s Encrypt 只有 90 天寿命。如果是 1 年期的商业证书,45 天提醒更从容;考虑到 CA/Browser Forum 计划在 2029 年前把公共证书有效期压到 47 天,阈值最好按证书实际寿命的约 1/3 动态设置。
自建可以用 Uptime Kuma(MIT 协议,免费)或 Prometheus + blackbox_exporter;SaaS 里 UptimeRobot 免费版提供 50 个监控和 SSL 到期提醒。如果只有几个域名,一个 crontab 加 openssl -checkend 脚本也够用。
内网证书没有公网入口,只能从内部探测:用 blackbox_exporter 从集群内发起 https 探针,或用 Zabbix agent 2 的 WebCertificate 插件。K8s 可以写一个 CronJob 定时扫 Ingress 的 tls secret,用 kubectl get secret -o jsonpath 取证书并计算剩余天数。
大概率是中间链路没更新:CDN、负载均衡、WAF 上还挂着旧证书,或者 nginx 没 reload。用 openssl s_client -connect 域名:443 -servername 域名 | openssl x509 -noout -dates -fingerprint 看实际返回的指纹,再和本地文件逐一比对。