域名证书到期查询怎么做?openssl、certbot 与监控告警的 6 种实操方法
查询域名证书到期时间最快的一条命令是:openssl s_client -connect 域名:443 -servername 域名 /dev/null | openssl x509 -noout -enddate,输出的 notAfter 即为 UTC 到期时间。 用 openssl x509 -checkend 2592000 -noout 做阈值判断,退出码 0 表示 30 天内不会过期,退出码 1 表示即将过期,可直接接入 shell 或告警脚本。 本机 ACME 证书用 certbot certificates --cert-name 域名 或 acme.sh --list 查询,注意这两者只反映本机台账,不代表 CDN 或负载均衡上实际下发的证书。 持续监控建议用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标,配合 Prometheus 规则 probe_ssl_earliest_cert_expiry - time() < 86400 * 21 触发告警。 Let's Encrypt 90 天证书的续签阈值建议设在剩余 30 天,CA/Browser Forum SC-081v3 要求 2026-03-15 起公网证书最长 200 天、2027-03-15 起 100 天,告警阈值需按证书寿命的 1/3 动态调整。
为什么域名证书总是悄无声息地过期?
因为”证书过期”从来不是一次性事件,而是三个环节同时失守的结果:证书本身变短、部署面变宽、告警链路变哑。先看寿命:据 Let’s Encrypt 官方文档,其证书默认有效期 90 天,并建议在剩余 30 天时续签;商业 DV 证书常见上限 397 天。更关键的是 CA/Browser Forum 已通过的 SC-081v3 规定——2026-03-15 起公网 TLS 证书最长有效期压缩到 200 天,2027-03-15 起进一步压缩到 100 天。当续签频率从”一年一次”变成”一年四次以上”,靠 Excel 台账记到期日的方式在证书数量超过十几个之后必然失守,这就是为什么”域名证书到期查询”必须从人工查表变成可执行的探测。
第二种失效最隐蔽:多节点不一致。同一张证书通常同时部署在 Nginx 源站、CDN 边缘节点和云负载均衡上,而续签脚本往往只 reload 了源站。此时源站证书是新的,CDN 仍在向下发旧证书,用户侧看到的就是过期证书——你在办公网用浏览器打开一切正常,因为 DNS 把你解析到了另一个边缘 IP。所以探测必须打到具体 IP,而不是”打开网页看看”:
# 指定 IP + SNI 探测真实下发的证书,-servername 不能省,否则可能拿到默认站点证书
openssl s_client -connect 203.0.113.10:443 -servername www.example.com /dev/null
| openssl x509 -noout -subject -issuer -dates
# 输出示例:notAfter=Mar 15 12:00:00 2026 GMT
# 用 curl 把域名强制解析到该 IP,并打印证书有效期
curl -svI https://www.example.com --resolve www.example.com:443:203.0.113.10
-o /dev/null 2>&1 | grep -E 'start date|expire date|subject:'
第三种失效最安静:自动续签失败没人知道。certbot 通过 systemd timer 触发,默认每天运行两次(带随机延迟),只在剩余有效期低于 30 天(配置项 renew_before_expiry,默认 30 days)时才真正续签。它失败的原因高度集中在三类:cron/timer 环境 PATH 缺失导致找不到 webroot 插件、80 端口被占用导致 HTTP-01 校验失败、DNS-01 的 API Token 过期返回 403。这些都不会弹窗,只会写进 /var/log/letsencrypt/letsencrypt.log。定期跑一次演练并看退出码,比看日志更省事:
# 演练续签,不真正签发;退出码 0 才代表整条链路可用(适用于 certbot 1.x/2.x+)
certbot renew --dry-run --cert-name example.com
echo $? # 非 0 即为续签链路已断,需立即排查
# 查看本机 ACME 客户端台账:到期时间、证书路径、域名清单
certbot certificates
# 确认定时任务真的在跑
systemctl list-timers | grep certbot # 期望看到 certbot.timer,NEXT 为未来 12 小时内
客户端报错是最好的定位线索。同一张过期证书,在不同栈上给出的措辞完全不同,认错报错会白白浪费排查时间:
| 客户端 | 典型报错 | 含义 |
|---|---|---|
| Chrome / Edge | NET::ERR_CERT_DATE_INVALID |
系统时间或证书有效期越界 |
| Firefox | SSL_ERROR_EXPIRED_CERT_ALERT |
收到的是已过期证书 |
| curl | curl: (60) SSL certificate problem: certificate has expired |
校验失败,可加 -k 复现但不可用于生产判断 |
| Java (HttpsURLConnection) | PKIX path validation failed: java.security.cert.CertPathValidatorException: validity check failed |
信任链校验时命中过期节点 |
| Python requests | SSLError: certificate verify failed: certificate has expired |
同 curl,基于 OpenSSL |
反过来,只测”网页能不能打开”并不可靠:浏览器会复用 HTTP/2、HTTP/3 长连接、命中本地会话缓存,甚至提前预连接,你刷新十次可能都没真正重新握手。不同地区 DNS 解析到不同边缘 IP,也可能只有部分节点异常。因此域名证书到期查询要分三层做:单点实时探测(openssl s_client、curl --resolve)确认线上真实状态,本机 ACME 客户端台账(certbot certificates、acme.sh 的 --list)确认续签链路是否健康,持续监控(Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标、Zabbix 的 web.certificate.get)负责在过期前主动发出通知。三层里缺任何一层,都会退化成”用户先发现”。
第 1 步:先确认探测目标,别只测到一台机器。一个域名背后可能是多台源站或 CDN 边缘节点,证书到期时间未必一致。先用 dig 把解析结果全拿到:
# 列出域名解析出的全部 A / AAAA 记录(dig 属于 bind-utils / dnsutils 包)
dig +short A example.com
dig +short AAAA example.com
# 多 IP / CDN 场景:对每个 IP 单独探测
# -servername 必须写域名,写 IP 会拿到默认虚拟主机的证书,结果完全失真
openssl s_client -connect 203.0.113.10:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -dates
-servername 是 SNI 扩展参数,OpenSSL 1.1.0 起提供,1.1.1 与 3.x 全系列可用;默认不发送 SNI。
第 2 步:拉取线上实际下发的叶证书。-showcerts 会输出整条链,管道交给 x509 时只解析第一段 PEM,即叶证书:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Mar 3 00:00:00 2026 GMT
# notAfter=Jun 1 23:59:59 2026 GMT
两个时间均为 GMT(UTC)。据 RFC 5280 §4.1.2.5,notAfter 必须用 UTCTime/GeneralizedTime 并以 Z 结尾,所以不要用本地时区做减法。
第 3 步:换算剩余天数。-enddate 输出 notAfter=Jun 1 12:00:00 2026 GMT,注意月份与日之间有双空格,用 cut -d= -f2 取右值:
na=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
end_ts=$(date -d "$na" +%s) # GNU date;macOS 需 brew install coreutils 后用 gdate
# macOS 原生写法:date -j -f "%b %d %H:%M:%S %Y %Z" "$na" +%s
echo "剩余 $(( (end_ts - $(date +%s)) / 86400 )) 天"
第 4 步:阈值判断,用退出码而不是文本匹配。-checkend 直接返回 0/1,最适合接监控:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -checkend 2592000
echo $? # 0 = 30 天内不会过期;1 = 即将过期(含已过期)
| 告警档位 | 秒数 | 适用场景 |
|---|---|---|
| 30 天 | 2592000 | Let’s Encrypt 90 天证书的常规巡检阈值 |
| 14 天 | 1209600 | 自动续签已失败,需人工介入 |
| 7 天 | 604800 | 付费 OV/EV 证书走人工采购流程 |
| 1 天 | 86400 | P1 级告警,直接电话 |
第 5 步:查本机 ACME 台账,确认续签链路本身没坏。据 Let’s Encrypt 官方文档,证书有效期 90 天、剩余 30 天进入续签窗口,所以「证书快过期」往往意味着续签任务早就挂了:
certbot certificates --cert-name example.com # 输出 Expiry Date / Certificate Path / Private Key Path
acme.sh --list # 查看各域名的 renew 时间与 Next renewal
certbot renew --dry-run # 空跑验证续签流程,不写入 /etc/letsencrypt
第 6 步:批量巡检并留痕成 CSV。把域名逐行写进 domains.txt,封装成函数循环调用,按剩余天数升序排就是风险清单:
#!/usr/bin/env bash
check() {
local d=$1 na ts
na=$(openssl s_client -connect "$d:443" -servername "$d" </dev/null 2>/dev/null
| openssl x509 -noout -enddate 2>/dev/null | cut -d= -f2)
if [ -z "$na" ]; then printf '%s,%s,%sn' "$d" "UNREACHABLE" "-1"; return 1; fi
ts=$(date -d "$na" +%s)
printf '%s,%s,%sn' "$d" "$na" "$(( (ts - $(date +%s)) / 86400 ))"
}
while read -r d; do [ -n "$d" ] && check "$d"; done < domains.txt
| sort -t, -k3,3n > cert_report.csv
# 负数即已过期,UNREACHABLE 说明 443 不通或未下发证书
若要把这套逻辑接进 Prometheus,可用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标(返回 Unix 时间戳)替代自写脚本,原理与第 3 步的时间戳换算是同一套。
配置与命令示例:openssl、curl、certbot、acme.sh 怎么用
一条 OpenSSL 命令就能同时验证证书链和主机名吗?能。OpenSSL 3.0.13 / 3.2 推荐用下面这条完整命令,其中每个参数都有实际作用,并非装饰:
# -servername 发送 SNI(多域名共用 IP 时必需)
# -verify_return_error 让校验失败时直接以非零码退出,便于脚本判断
# -verify_hostname 校验证书 SAN 是否匹配目标域名
# -showcerts 打印服务器下发的完整证书链
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error -verify_hostname example.com -showcerts &1
| grep -E "Verify return code|verify error"
# 期望输出:Verify return code: 0 (ok)
# 注意:OpenSSL 3.x 把校验结论写到 stderr,不加 2>&1 会"看起来什么都没输出"
不想写脚本,curl 能直接取证书校验结果吗?curl 7.88.0 起支持 write-out 变量 %{ssl_verify_result},0 即通过:
# 输出形如 "200 0":HTTP 200 且证书链校验通过
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com
# 顺带验证 OCSP stapling 是否生效
curl -sS -o /dev/null --cert-status https://example.com
# 服务器未装订时返回:curl: (91) SSL: no OCSP response found
certbot 用户怎么批量看到期时间?据 Certbot 官方文档,certbot certificates 会列出每个证书的 Certificate Name、Domains、Expiry Date 与 cert.pem/fullchain.pem 路径;certbot renew --dry-run 模拟续签,只有输出 Congratulations, all simulated renewals succeeded 才说明续签链路(含 HTTP-01/TLS-ALPN-01 挑战)健康。Nginx 的 ssl_certificate 必须指向 fullchain.pem,指向 cert.pem 会缺中间证书,部分 Android 客户端报 unable to get local issuer certificate。
acme.sh 呢?它把续签时间直接写进列表,日常巡检最省事:
acme.sh --list # Main_Domain | KeyLength | Created | Renew
acme.sh --info -d example.com # 可见 Le_NextRenewTime、Le_CertCreateTimeStr
# 自动续签靠 cron 里那条每日任务:acme.sh --cron
内网一堆自签证书怎么批量发现?用 nmap 7.94 的 ssl-cert 脚本,输出里的 notAfter 即到期时间,适合揪出测试环境遗漏的证书:
nmap -p 443,8443 --script ssl-cert
--script-args ssl-cert.ports=443,8443 -T4 10.0.0.0/24
要接监控告警,blackbox_exporter 0.25 怎么配?在 blackbox.yml 的 modules 下新增一个模块,抓取目标填 https://域名,随后在 Prometheus 查 probe_ssl_earliest_cert_expiry(Unix 时间戳,秒级,可直接做 < time() + 86400*14 的告警):
modules:
https_2xx:
prober: http
http:
tls_config:
insecure_skip_verify: false # 默认 false,保持即可让证书错误暴露为探针失败
| 工具 | 最低版本 | 最适合的场景 | 到期时间取自 |
|---|---|---|---|
| openssl s_client | 1.1.1 / 3.x | 单域名深度排查链与主机名 | notAfter(-showcerts 输出) |
| curl | 7.88.0 | CI 里快速断言校验结果 | %{ssl_verify_result} |
| certbot | 2.x | Let’s Encrypt 证书续签自检 | certbot certificates 的 Expiry Date |
| acme.sh | 3.x | 多 CA、轻量自动化 | Le_NextRenewTime |
| nmap | 7.94 | 内网/自签证书资产发现 | notAfter |
| blackbox_exporter | 0.25 | 持续监控与告警 | probe_ssl_earliest_cert_expiry |
做域名证书到期查询时,别只看单个工具的返回值:用 curl 的 ssl_verify_result 做可用性断言、用 certbot/acme.sh 确认续签链路、再用 blackbox_exporter 把 probe_ssl_earliest_cert_expiry 接进告警,三层互补才不会在续签当天才发现链断。各工具的具体语义可对照 OpenSSL 手册页、curl 的 write-out 文档与 Prometheus blackbox_exporter README 核实。
openssl、curl、certbot、监控系统怎么选?参数对比与选型建议
选型的核心不是”哪个工具最强”,而是”你的域名数量和发现时效要求落在哪一档”。判断标准很直接:一次手工查询只覆盖一个时间点,而证书过期是随时间推进才暴露的风险,所以工具的时间覆盖能力比功能丰富度更重要。
| 工具 | 适用规模 | 是否校验证书链 | 关键参数 | 输出形式 |
|---|---|---|---|---|
| openssl s_client | 1-50 个域名 | 需显式加 -verify_return_error |
-servername、-showcerts |
文本,可配 -checkend 取退出码 |
| curl 7.88+ | 1-50 个域名 | 默认校验,-k 可跳过 |
-w %{ssl_verify_result}、--cert-status |
单行文本 |
| certbot certificates | 本机 ACME 证书 | 不校验线上 | --cert-name |
表格文本 |
| acme.sh –list | 本机 ACME 证书 | 不校验线上 | --info -d |
表格文本 |
| nmap ssl-cert | 内网网段 | 仅取证书,不校验链 | -p、--script-args |
结构化脚本输出 |
| blackbox_exporter | 100+ 域名 | 可配置是否跳过 | probe_ssl_earliest_cert_expiry |
Prometheus 指标 |
1-10 个域名:openssl 手工查就够。单次查询耗时约 0.2-1 秒,零依赖,几乎所有 Linux 发行版自带。据 OpenSSL 官方文档,-checkend 会在证书剩余时间低于指定秒数时返回非零退出码,正好可以直接嵌进 shell 判断:
# 剩余不足 7 天(604800 秒)时退出码非 0,可直接用于 cron 告警
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error -checkend 604800 </dev/null
echo "exit=$?" # 0=仍有效,1=即将过期或校验失败
它的独特价值是一次性看到协议版本(TLSv1.3)、协商套件(如 TLS_AES_256_GCM_SHA384)和完整链层级;缺点是输出需二次解析,不适合直接对接告警。
10-100 个域名:脚本化 + CSV 留痕。关键是用 curl 贴近真实客户端行为——它会同时验证 SNI、ALPN 和 OCSP stapling,且默认校验证书链。注意 %{certs} 变量是 curl 7.88.0 才引入的,旧版本拿不到 notAfter,必须回退到 openssl:
# curl >= 7.88.0:单行拿到校验结果与证书起始时间
curl -sS -o /dev/null -w '%{ssl_verify_result} %{certs}n' https://example.com
# 7.88 以下版本没有 %{certs},用 openssl 兜底取 notAfter
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate
100 个以上或要求分钟级发现:必须上 blackbox_exporter 或商业拨测。持续探测的价值在于趋势曲线和多节点并发。部署时注意默认 60 秒抓取间隔对短周期证书不够用(部分 CA 已提供 6 天有效期的短期证书),应把 scrape_interval 收紧到 5-15 分钟,并用 PromQL 直接算剩余天数:
# prometheus.yml 片段(blackbox_exporter 0.24+ 通用)
scrape_configs:
- job_name: 'ssl_expiry'
metrics_path: /probe
params:
module: [http_2xx] # 需在 blackbox.yml 中确认 tls 探测已启用
static_configs:
- targets: ['https://example.com']
relabel_configs:
- source_labels: [__address__]
target_label: __param_target
- target_label: __address__
replacement: 127.0.0.1:9115
# 剩余天数小于 14 天时触发告警
(probe_ssl_earliest_cert_expiry - time()) / 86400 < 14
怎么把三者串起来?线上对外域名一律接入持续监控作为兜底;日常排查用上面那行 openssl 命令;续签链路健康度则靠 certbot renew --dry-run 或 acme.sh --cron 单独验证——因为”证书还有 20 天”和”自动续签已经坏了”是两个完全不同的故障。据 Let’s Encrypt 文档,其证书有效期为 90 天并在到期前 30 天开放续签窗口,这意味着续签失败必须在 30 天内被发现,否则就会演变成线上事故。
常见报错与排查:从 certificate has expired 到 unable to get local issuer certificate
排查证书问题最快的方式是“先复现、再定位”:用 OpenSSL 把证书链完整打印出来,比在浏览器里点开锁形图标看到的细节多得多。下面按你实际会遇到的 6 类报错逐条拆解。
Q:verify error:num=10:certificate has expired 是不是意味着证书真过期了?
是的。这条来自 openssl s_client 的链校验,末尾还会打印 Verify return code: 10 (certificate has expired)(返回码 10 在 OpenSSL 的 X509_V_ERR_CERT_HAS_EXPIRED 中定义,见 OpenSSL 文档 verify(1))。但先做两个确认再动手续签:一是 -servername 必须写成目标域名,否则 SNI 会让服务器返回默认站点那张证书,你查到的可能根本不是自己的域名;二是确认探测的是 CDN 边缘 IP 还是源站 IP——两者常常不是同一张证书,边缘节点过期而源站正常的情况很常见。
# 指定 SNI 并只看有效期,避免拿到默认站点的证书
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 直连源站 IP 对比,判断是边缘还是源站过期
echo | openssl s_client -connect 203.0.113.10:443 -servername example.com 2>/dev/null
| openssl x509 -noout -dates
Q:verify error:num=20:unable to get local issuer certificate 怎么办?
这不是证书过期,而是服务器没有下发中间证书,客户端无法把叶证书链接到受信任根。用 -showcerts 数一下链长度,正常应为叶证书 + 1~2 张中间证书。Nginx 的 ssl_certificate 要指向 Let’s Encrypt 生成的 fullchain.pem(叶证书 + 中间证书拼接),而不是 cert.pem;Apache 2.4.8 以前需要 SSLCertificateChainFile 指向 chain.pem,2.4.8 起该指令已废弃,直接把 SSLCertificateFile 指向 fullchain 即可(据 Apache HTTP Server 2.4 文档)。
# 统计链中证书数量:grep -c 应为 2 或 3
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null
| grep -c "BEGIN CERTIFICATE"
# Nginx 正确写法
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 含中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
Q:浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,curl 报 (60) SSL: no alternative certificate subject name matches target host name?
证书的 SAN(Subject Alternative Name)列表不含当前访问的域名。现代浏览器与 curl 已完全忽略 CN 字段,只认 SAN(RFC 6125 第 6.4.4 节明确弃用 CN 匹配)。典型场景:只申请了 example.com 却用 www.example.com 访问;或泛域名 *.example.com 无法覆盖二级子域 a.b.example.com。用一条命令即可核对:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -text | grep -A1 "Subject Alternative Name"
下表把本节 6 类报错、根因与修复动作汇总,便于直接对照:
| 报错 / 输出 | 根因 | 修复动作 |
|---|---|---|
Verify return code: 10 (certificate has expired) |
证书确实过期,或探测到了 CDN 边缘/默认站点的另一张证书 | 核对 -servername,分别探测边缘 IP 与源站 IP,对过期者续签 |
verify error:num=20:unable to get local issuer certificate |
未下发中间证书 | Nginx 改用 fullchain.pem;Apache 用 fullchain 或 chain.pem |
curl: (60) ... no alternative certificate subject name matches |
SAN 不含该主机名 | 重新签发并加入该域名,或改用覆盖它的泛域名 |
Certificate not yet due for renewal |
未进入续签窗口(默认到期前 30 天) | 属正常提示,无需处理,切勿加 --force-renewal |
Problem binding to port 80: Could not bind to IPv4 or IPv6. |
standalone 插件与 Nginx/Apache 抢 80 端口 | 改用 --webroot -w /var/www/html,或用 hook 停启服务 |
| cron 中无输出、证书静默过期 | cron 的 PATH 只有 /usr/bin:/bin,找不到 /usr/local/bin/certbot |
写绝对路径并重定向日志 |
Q:certbot 提示 Certificate not yet due for renewal,要不要强制续一下?
不要。这是正常状态提示,说明还没进入续签窗口。频繁加 --force-renewal 会快速消耗 Let’s Encrypt 的重复证书速率限制——据 Let’s Encrypt 官方速率限制文档,同一组精确域名集合每 7 天最多签发 5 张重复证书(duplicate certificate),超限后返回 too many certificates already issued,反而拖慢真正需要续签的时刻。日常做“域名证书到期查询”用 certbot certificates 读本地状态即可,比反复触发签发安全得多。
# 查看本地所有证书的到期时间与剩余天数(不发网络请求)
certbot certificates
# 安全预演续签,不真正签发
certbot renew --dry-run
Q:cron 里续签总是静默失败,怎么查?
两个高频原因。其一是 PATH:cron 环境默认只有 /usr/bin:/bin,certbot 装在 /usr/local/bin 时会报 command not found,而 stderr 又被丢弃,于是看起来“什么都没发生”。其二是时钟:用 timedatectl 确认 NTP 同步状态,时钟偏差超过几分钟会让 openssl x509 -checkend 的判断失真,也会让 ACME 的 JWS 签名校验失败。
# crontab -e 中写入:绝对路径 + 完整日志
17 3 * * * /usr/local/bin/certbot renew --quiet --deploy-hook "systemctl reload nginx" >> /var/log/certbot.log 2>&1
# 确认时钟同步(System clock synchronized 应为 yes)
timedatectl
# 用 -checkend 做剩余秒数判断,86400 表示 1 天,返回非 0 即表示将到期
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -checkend 86400 || echo "证书 24 小时内到期"
顺带一提,-checkend 的返回值只反映本机时间与证书 notAfter 的比较,所以监控脚本里把它和 timedatectl 的健康检查放在一起,才能避免“时钟漂移导致误报/漏报”这类隐蔽故障——这也是把证书到期查询做进监控告警时最容易被忽略的一环。
怎么确认查询与告警配置真的生效?
配置写完不等于生效。证书到期查询的整条链路——证书链、HTTP 层、阈值判断、监控指标、CDN 边缘节点、客户端体验——每一环都可能静默失效,所以必须逐层验证。下面给出可直接复制的校验命令,以及每步”期望输出”和失败时的排查方向。
第一步:证书链与主机名是否匹配? 用 OpenSSL 的严格校验模式,让任何链错误或主机名不符都直接报错退出:
# -servername 模拟 SNI;-verify_return_error 让校验失败时非零退出
# -verify_hostname 校验证书 SAN 是否覆盖该域名
openssl s_client -connect example.com:443
-servername example.com
-verify_return_error -verify_hostname example.com
&1 | grep 'Verify return code'
# 期望输出:Verify return code: 0 (ok)
# 常见异常:code 10 (certificate has expired) / 62 (hostname mismatch)
# 21 (unable to verify the first certificate,多为中间证书缺失)
适用 OpenSSL 1.0.2 及以上;-verify_hostname 在 1.0.2 引入,更老的版本只能靠 -verify_return_error 加手工比对 SAN。
第二步:HTTP 层是否正常? 用 curl 把 TLS 校验结果和状态码一起打出来:
curl -sS -o /dev/null
-w '%{http_code} %{ssl_verify_result}n' https://example.com
# 期望输出:200 0
# ssl_verify_result 非 0 时,其数值与 `openssl verify` 返回码同源,
# 例如 10=证书过期、20=无法获取本地签发者证书、62=主机名不匹配
第三步:阈值判断逻辑对不对? -checkend 用秒为单位判断剩余有效期,退出码即结论,最适合塞进 shell 脚本或 cron:
# 2592000 秒 = 30 天;返回 0 表示 30 天内不会过期,1 表示即将过期
openssl x509 -checkend 2592000 -noout
-in /etc/letsencrypt/live/example.com/cert.pem
echo $?
# 反向测试:造一张已过期证书,确认脚本确实会报警
openssl req -x509 -newkey rsa:2048 -nodes -days -1
-subj "/CN=expired.test" -keyout /tmp/k.pem -out /tmp/expired.pem
openssl x509 -checkend 2592000 -noout -in /tmp/expired.pem; echo $? # 应为 1
第四步:监控指标与告警规则是否可信? 若用 blackbox_exporter 的 https 探针,证书到期时间以 Unix 时间戳暴露:
# PromQL:换算成"剩余天数",结果应与实际证书剩余天数一致
(probe_ssl_earliest_cert_expiry - time()) / 86400
# 告警规则片段:剩余不足 21 天进入 Pending
# 默认 for: 0m,建议设 for: 1h 以过滤单次探针抖动
- alert: SSLCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 21
for: 1h
验证方法:把一张 20 天后到期的测试证书挂到一个测试站点,观察告警是否从 Inactive 进入 Pending;Prometheus 的 for 默认值为 0,不设就等于”一命中立即 Firing”,容易误报。
第五步:换证是否在所有节点生效? 续签后先比指纹,再逐节点探测,避免只有源站更新、CDN 边缘仍是旧证书:
# 本地文件指纹(SHA-256)
openssl x509 -noout -fingerprint -sha256
-in /etc/letsencrypt/live/example.com/cert.pem
# 线上实际下发的指纹,逐个边缘 IP 或解析结果执行
echo | openssl s_client -connect example.com:443
-servername example.com 2>/dev/null
| openssl x509 -noout -fingerprint -sha256
两者不一致说明缓存或分发未完成。多节点可用 dig +short example.com 拿到全部 A 记录后循环探测。
第六步:客户端体验是否正常? 浏览器侧用 Chrome 开发者工具 Security 面板查看有效期与证书链、Firefox 页面信息中的”查看证书”确认 notAfter;命令行侧用 curl 验证 OCSP stapling 是否真的带上:
# --cert-status 要求服务端提供有效 OCSP 响应,缺失或超时会报错
curl -sS --cert-status -o /dev/null https://example.com
# 成功无输出;失败典型信息:
# curl: (91) SSL certificate status verification failed
OCSP stapling 失败不会让浏览器立刻拦截,但会让部分客户端在吊销检查超时时出现额外延迟甚至报错,属于”监控看不见、用户能感知”的隐性故障,值得单独纳入巡检。
多域名、多 CDN 节点、非 443 端口怎么统一查?
当资产清单从「一个域名」变成「几十个域名 + 多个 CDN 边缘节点 + 若干非 443 端口」,逐个手工敲 openssl s_client 就不可行了。核心思路是:把探测目标变成一张可枚举的清单,用并发把耗时压下来,再把输出收敛成可排序、可比对的表格——这样域名证书到期查询才能从”偶尔想起来查一下”变成”每天跑一次、异常自动进值班队列”。
最省事的是 xargs -P 并发批量探测。把域名一行一个写进 domains.txt(不要带 https://),然后执行:
# 依赖:GNU xargs(Linux)与 openssl 1.1.1+ / 3.x;macOS 自带 xargs 不支持 -P,需 brew install findutils 后用 gxargs
# -P 8 表示 8 个并发;-I{} 把 {} 替换成当前域名
# </dev/null 让 s_client 读完证书就退出,否则会一直等 stdin 阻塞
cat domains.txt | xargs -P 8 -I{} sh -c
'echo -n "{} "; openssl s_client -connect {}:443 -servername {} /dev/null
| openssl x509 -noout -enddate'
实测 200 个域名在 8 并发下约 15–30 秒完成,瓶颈是网络 RTT 而非 CPU。注意 -servername 必须显式给:现代 CDN 普遍启用 SNI 多租户,不传 SNI 往往拿到默认站点证书,notAfter 就完全对不上号。
CDN 场景下”域名查一次”是不够的。证书在各边缘节点是异步下发的,控制台显示已更新,不代表所有节点都已刷新。做法是先取 IP 列表,再逐 IP 带 SNI 探测:
# 拿到该域名所有 A 记录(含 CDN 返回的多个边缘 IP)
for ip in $(dig +short A www.example.com); do
printf '%s,%s,' "$ip" "$(openssl s_client -connect "$ip:443" -servername www.example.com /dev/null
| openssl x509 -noout -enddate | cut -d= -f2)"
done
若多个 IP 的 notAfter 不一致,说明部分边缘节点仍持旧证书,属于典型的”灰度未完成”。IPv6 必须单独测,因为 AAAA 指向的往往是另一批节点:
# 注意 IPv6 地址必须用方括号包裹,否则 openssl 会把冒号误判为端口分隔符
openssl s_client -connect '[2001:db8::1]:443' -servername www.example.com /dev/null
| openssl x509 -noout -enddate
很多”证书已更新但部分用户报错”的工单,根因就是 AAAA 记录指向的节点还挂着旧证书(据 Mozilla Server Side TLS 指南,SNI 与双栈行为需分别验证)。
非 443 端口与隐式 TLS 之外的协议同样要纳入清单:
# 非标准 HTTPS 端口
openssl s_client -connect www.example.com:8443 -servername www.example.com </dev/null
# SMTP 提交端口 587 用 STARTTLS 升级
openssl s_client -connect mail.example.com:587 -starttls smtp </dev/null
# IMAP 143 端口 STARTTLS
openssl s_client -connect mail.example.com:143 -starttls imap </dev/null
# LDAPS 636 端口本身就是 TLS,不需要 -starttls
openssl s_client -connect ldap.example.com:636 </dev/null
这些端口的证书过期同样会让邮件客户端和内部系统登录失败,但往往不在任何 Web 监控里。最后把结果收敛成四列 CSV,按剩余天数升序,把 30 天内到期的单独落到 risk.txt 交给值班:
# 输出 域名,IP,notAfter,剩余天数;剩余天数 < 30 的行另存 risk.txt
awk -F, 'NR==1 || $4<30' certs.csv | sort -t, -k4,4n > risk.txt
下表对比三种探测粒度的取舍:
| 粒度 | 命令核心 | 能发现的问题 | 成本 |
|---|---|---|---|
| 按域名 | -connect 域名:443 |
证书是否整体过期 | 最低,1 次/域名 |
| 按 IP | dig +short A 后逐 IP 探测 |
CDN 边缘节点灰度不一致 | 中,N 次/域名 |
| 按 IPv6/端口 | [IPv6]:443、-starttls |
双栈节点、邮件/LDAP 证书过期 | 较高,需维护端口清单 |
证书有效期越来越短,到期查询策略要怎么调整?
先给结论:“证书剩 30 天就告警”这条经验规则,在 2026 年之后会直接失效。因为证书寿命本身在缩短,固定的绝对天数阈值会让短周期证书在两次巡检之间就悄悄过期。据 CA/Browser Forum ballots SC-081v3(2025 年 4 月通过),公有 TLS 证书的最长有效期分三步收紧:2026-03-15 起 200 天、2027-03-15 起 100 天、2028-03-15 起 47 天。Let’s Encrypt 在 2025-01-30 的公告《Announcing Six Day and IP Address Certificate Options in 2025》中更进一步,计划把 90 天逐步缩到 45 天,并已实际签发 6 天有效期的测试证书,用于验证自动化链路。
这意味着到期查询必须从“绝对天数”切换到“剩余寿命比例”。按剩余寿命的 1/3 设告警线,探测频率随寿命同步收紧:
| 证书有效期 | 告警阈值(寿命 1/3) | 建议探测间隔 | 典型场景 |
|---|---|---|---|
| 200 天 | 66 天 | 60 分钟 | 2026-03-15 后的公有 CA |
| 90 天 | 30 天 | 60 分钟 | Let’s Encrypt 当前默认 |
| 100 天 | 33 天 | 30 分钟 | 2027-03-15 后的公有 CA |
| 45 天 | 15 天 | 15 分钟 | Let’s Encrypt 中期目标 |
| 6 天 | 2 天 | 5–15 分钟 | 短周期测试/高自动化环境 |
把上表落到脚本里,最省事的做法是用 OpenSSL 同时读出 notBefore 和 notAfter,自己算寿命与阈值,而不是写死 30 天:
#!/usr/bin/env bash
# 域名证书到期查询:输出剩余天数、总寿命、1/3 阈值,并检查 notBefore 是否在未来(时钟偏差)
# 适用 OpenSSL 1.1.1 / 3.x;-servername 必须显式指定,否则多域名站点会拿到默认证书
# 注意:date -d 为 GNU coreutils 语法,macOS 需 brew install coreutils 后用 gdate
HOST=example.com; PORT=443
PEM=$(openssl s_client -connect "$HOST:$PORT" -servername "$HOST" /dev/null
| openssl x509 2>/dev/null)
[ -z "$PEM" ] && { echo "UNKNOWN: 握手失败或未取到证书"; exit 2; }
now=$(date +%s)
nbf=$(date -d "$(echo "$PEM" | openssl x509 -noout -startdate | cut -d= -f2)" +%s)
exp=$(date -d "$(echo "$PEM" | openssl x509 -noout -enddate | cut -d= -f2)" +%s)
life=$(( (exp - nbf) / 86400 )); left=$(( (exp - now) / 86400 )); thr=$(( life / 3 ))
echo "CN=$(echo "$PEM" | openssl x509 -noout -subject | sed 's/.*CN *= *//') 寿命=${life}d 剩余=${left}d 阈值=${thr}d"
[ "$now" -lt "$nbf" ] && echo "WARN: notBefore 在未来,检查本机时钟/NTP" # 时钟偏差会让"新证书未生效"
[ "$left" -le "$thr" ] && exit 1 || exit 0
Prometheus 侧同理。blackbox_exporter 的 scrape_interval 默认 60 秒,短周期证书下建议压到 30 秒,并让超时小于间隔的一半,避免探测堆积:
# prometheus.yml —— 证书到期探测(blackbox_exporter 0.25+ 通用配置)
scrape_configs:
- job_name: 'tls-expiry'
scrape_interval: 30s # 默认 60s,寿命 < 45 天时收紧
scrape_timeout: 10s # 必须 < scrape_interval/2
metrics_path: /probe
params: { module: [https_cert] }
static_configs:
- targets: ['example.com:443']
relabel_configs:
- source_labels: [__address__]
target_label: __param_target
- target_label: __address__
replacement: 127.0.0.1:9115 # blackbox_exporter 地址
# 告警:剩余天数 < 寿命 1/3 时触发;短周期证书请同步下调该常数(200d→66, 100d→33, 6d→2)
# - alert: TLSCertExpiringSoon
# expr: (probe_ssl_earliest_cert_expiry - time()) / 86400 < 30
# for: 10m
续签逻辑本身也要改。ACME Renewal Information(ARI)扩展已在 RFC 9773 中标准化,客户端不再硬编码“剩 30 天续签”,而是向 CA 询问建议窗口。可以直接手工验证一次,确认你的 CA 是否已开放该端点:
# 1) 从 ACME 目录读取 renewalInfo 端点(RFC 9773 定义的目录字段)
curl -s https://acme-v02.api.letsencrypt.org/directory | jq -r .renewalInfo
# 2) 用 AKI + serial 拼 certID:两段都做 base64url(去填充、+→-、/→_)
b64url() { xxd -r -p | base64 | tr '+/' '-_' | tr -d '='; }
AKI=$(openssl x509 -in fullchain.pem -noout -text | awk '/Authority Key Identifier/{getline; print $2}' | tr -d ':')
SER=$(openssl x509 -in fullchain.pem -noout -serial | cut -d= -f2)
curl -s "https://acme-v02.api.letsencrypt.org/directory/../renewalInfo/$(echo "$AKI" | b64url).$(echo "$SER" | b64url)" | jq .
# 期望输出:{"suggestedWindow":{"start":"...","end":"..."},"explanationURL":"..."}
据 Let’s Encrypt 文档,certbot 自 2.7.0 起内置 ARI 支持,acme.sh 也在后续版本跟进;升级后用 certbot --version 与续签日志确认,若日志里出现 Certificate not yet due for renewal 且未带 ARI 窗口信息,说明仍在走旧的固定窗口逻辑。最后别忽略连带影响:寿命越短,时钟偏差、OCSP 缓存过期、Java truststore 更新滞后、IoT 固件内置证书不可替换的破坏力越大——把上面脚本里的 notBefore 一并输出到监控里,能在证书轮换后第一时间发现“新证书尚未生效”这类 NTP 故障,而不是等到 x509: certificate has expired or is not yet valid 报错才发现。
有。执行 openssl s_client -connect example.com:443 -servername example.com /dev/null | openssl x509 -noout -enddate,输出中的 notAfter 就是服务器实际下发的证书到期时间(UTC)。需要判断剩余天数时改用 openssl x509 -checkend 2592000 -noout,退出码 0 表示 30 天内不会过期。
通常是因为探测到的不是同一张证书。浏览器可能连接了另一个 CDN 边缘 IP 或复用了已有连接,而 openssl 默认解析到当前 DNS 返回的第一个 IP。用 dig +short A 域名 列出全部 IP,对每个 IP 分别执行 openssl s_client -connect IP:443 -servername 域名 对比 notAfter,即可定位是哪个节点没更新。
不是。verify error:num=20:unable to get local issuer certificate 表示服务器没有下发中间证书,客户端无法把链补全到根证书。用 -showcerts 看链长度,正常应有叶证书加 1-2 张中间证书;Nginx 应把 ssl_certificate 指向 fullchain.pem 而不是 cert.pem,改完 reload 后 Verify return code 应变为 0 (ok)。
certbot certificates 读的是本机 /etc/letsencrypt/live/ 目录下的文件,反映的是本地台账;线上实际下发的是 Web 服务器或 CDN 加载的那张证书。两者不一致说明续签成功但部署未生效,检查 Nginx 的 ssl_certificate 路径、是否执行了 reload,以及 CDN 控制台是否手动上传了旧证书。
两者用途不同。在线工具(如 SSL Labs 的 SSL Server Test)会给出协议支持、套件强度、链完整性和整体评级,适合换证后做一次全面体检,但探测间隔长、不提供告警;openssl 与 blackbox_exporter 适合纳入脚本和监控做高频、可留痕的到期查询。建议日常用脚本和监控,季度或换证时用在线工具复核。
多数情况是部署环节没跟上。certbot 只负责签发和写入 /etc/letsencrypt/live/,还需要 –deploy-hook 或 –post-hook 触发 nginx -s reload;如果证书在 CDN 上,需要在续签后调用 CDN 厂商的证书上传 API。用 openssl x509 -noout -fingerprint -sha256 对比本地文件与线上证书指纹即可确认。
建议按证书寿命的 1/3 设置:Let's Encrypt 90 天证书设 30 天,商业 200 天证书设 66 天,未来 6 天短周期证书设 2 天。监控探测间隔也要同步压缩,90 天证书每小时一次够用,6 天证书建议 5-15 分钟一次,避免在两次巡检之间就过期。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。