通配符证书 fix:Certbot 续期后旧证书残留的 6 步修复与验证(2025)
通配符证书 fix 的关键不是重新签发,而是让新证书落到实际监听路径并触发 reload;用 openssl s_client -servername 对比 serial,通常 1 分钟内可判断线上是否仍是旧证书。 Certbot 2.11 的 /etc/letsencrypt/live// 是符号链接;Nginx 应指向 live 下的 fullchain.pem 与 privkey.pem,指向 archive/ 带序号文件会在续期后继续使用旧证书。 续期后执行 nginx -t && systemctl reload nginx;仅重启 certbot 或等待定时器不会让 Nginx 重新加载证书。 K8s 场景检查 cert-manager 1.15 的 Certificate Ready=True 与 Secret resourceVersion;Ingress 控制器同步通常 30-120 秒,必要时滚动重启。 验证至少覆盖 serial、notAfter、证书链、OCSP stapling 四项;若 CA 提供 OCSP,openssl s_client -status 返回 OCSP Response Status: successful 才算 stapling 生效。
为什么续期成功,浏览器仍报证书过期?——通配符证书 fix 的问题背景
这是运维里最容易被误判的一类故障:certbot renew 明明输出了 Congratulations, all renewals succeeded,certbot certificates 显示新到期日也正确,但浏览器地址栏仍挂着”证书已过期”,或者某些客户端报 NET::ERR_CERT_DATE_INVALID。原因通常不在 ACME 环节,而在签发之后的”部署”这一步没有人做。据 Let’s Encrypt 文档,ACME 客户端只负责签发与写入磁盘,把新证书装进 Web 服务器、reload 进程,是由用户自己或 deploy hook 完成的——这一条正是绝大多数通配符证书 fix 案例的起点。
先看 Certbot 到底改了什么。它把每个 lineage 的历史版本都保留在 archive/ 下,续期时新增 cert2.pem、chain2.pem、fullchain2.pem、privkey2.pem,然后把 live/ 里的符号链接重新指向新文件。所以”文件已更新”和”服务已生效”是两件事:
# 查看 live 目录的符号链接指向哪个 archive 序号(应为最新 N)
ls -l /etc/letsencrypt/live/example.com/
# fullchain.pem -> ../../archive/example.com/fullchain2.pem ← 2 才说明续期已落盘
# 最直接的对比:线上握手拿到的证书 vs 磁盘上的证书
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -serial -dates -subject
certbot certificates --cert-name example.com # 看 Serial Number 与 Expiry Date
# 两者 serial 不一致 ⇒ 不是签发问题,是加载/部署问题
-servername 不能省:通配符证书通常与其他域名共享同一 IP,不发 SNI 会拿到默认 server 块的证书,得出的结论完全是错的。Nginx 在启动和 nginx -s reload 时把证书读入内存并常驻,未 reload 时即使磁盘文件已换,TLS 握手仍用旧证书——这是最高频的一类。
第二高频是路径写错。配置里硬编码 ssl_certificate /etc/letsencrypt/archive/example.com/fullchain1.pem; 时,续期后 archive 新增的是 fullchain2.pem,配置仍指向 1,表现就是”续期成功但证书日期不变”。用 nginx -T 直接看生效配置,比翻文件可靠:
nginx -T 2>/dev/null | grep -n "ssl_certificate" # 必须指向 live/ 下的软链,而非 archive/ 下带序号的实体文件
| 场景 | 典型症状 | 根因 | 一条命令判定 |
|---|---|---|---|
| Nginx/Apache 未 reload | 文件已新,握手 serial 仍旧 | 证书在启动/reload 时读入内存 | openssl s_client … | openssl x509 -noout -serial |
| 配置指向 archive/N.pem | “续期成功但日期不变” | 硬编码序号,续期生成 N+1 | nginx -T | grep ssl_certificate |
| K8s Secret 挂载 | Pod 内文件已新,对外仍旧 | kubelet 投影卷同步延迟 + 无 reload | kubectl exec … -- cat /etc/tls/tls.crt |
| 多节点各自签发 | 各节点 serial/到期日不一致 | 形成不同 lineage | 对每台机器分别跑上面的 s_client |
| CDN / 负载均衡回源 | 源站正常,边缘仍旧 | 边缘未重新上传或未触发同步 | 控制台证书列表 + 直连边缘测握手 |
容器场景要单独算一笔时间账:证书以 Secret 形式挂载后,kubelet 更新投影卷默认存在 60–120 秒的同步延迟(--sync-frequency 默认 1m,叠加 watch 缓存),而 Nginx 本身不会因为文件变化自动 reload。稳妥做法是加 reloader sidecar、用 inotify 监听 fullchain.pem,或在证书更新后触发滚动重启;用 cert-manager 时则依赖其 Certificate 资源配合 DNS-01 完成通配符签发与 Secret 轮转。
多节点各自跑 Certbot 会各自形成 lineage,serial 与到期日必然分叉,做通配符证书 fix 时极难定位——建议集中签发后分发,或用 cert-manager + ACME DNS-01 统一管理。边缘侧还要确认 CDN 控制台里重新上传了证书或已触发同步,常见同步 TTL 为 5–30 分钟;同时用 dig +short CAA example.com 检查 CAA 记录是否允许签发 CA,否则下次续期会直接失败(RFC 8659 定义了 CAA 的匹配语义)。ACME 协议本身见 RFC 8555。
通配符证书 fix 的 6 步实操:从定位旧证书到触发 reload
续期成功不等于线上生效。Certbot 只负责把新证书写进 /etc/letsencrypt/archive/,是否被 Web 服务器、容器、负载均衡真正加载,取决于后续的引用路径与 reload 动作。下面 6 步按”先取证、再改配置、最后复验”的顺序执行,每一步都用同一组指纹做前后对比,避免改完不知道有没有生效。
第 1 步:记录线上证书指纹,作为后续每一步的对照组。
# 取 443 端口实际返回的叶子证书,打印主体/签发者/序列号/有效期/SHA-256 指纹
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -serial -dates -fingerprint -sha256
# 建议存盘,后面每步 diff 一次
# 注意:必须带 -servername,否则 SNI 多站点会拿到默认站点证书,指纹对不上
这一步得到的 serial 与 notAfter 是唯一可信的”线上事实”。后面凡是与此不一致的,都说明旧证书仍在被引用。
第 2 步:确认 Certbot lineage 名称与域名集合。
certbot certificates --cert-name example.com
# 输出示例(Certbot 2.x / 3.x 格式一致):
# Certificate Name: example.com
# Serial Number: 4a1b2c3d...
# Key Type: ECDSA
# Domains: example.com *.example.com
# Expiry Date: 2025-11-02 03:12:44+00:00 (VALID: 62 days)
# Certificate Path: /etc/letsencrypt/live/example.com/fullchain.pem
重点看三处:Domains 必须同时含 example.com 与 *.example.com(通配符不覆盖裸域,这是通配符证书 fix 中最常见的漏配);Serial Number 应与第 1 步线上指纹一致;Certificate Name 若与目录名不同(例如 example.com-0001),后续所有命令都要显式加 --cert-name example.com,否则会操作到错误 lineage。
第 3 步:检查续期任务是否真的跑过、hook 是否挂上。
systemctl list-timers | grep certbot # Debian/Ubuntu 默认用 certbot.timer,12 小时随机延迟
cat /etc/cron.d/certbot # CentOS/RHEL 及旧版包走 cron,默认 0 */12 * * *
# 干跑验证:--dry-run 使用 staging 环境、不写入 archive,但 deploy-hook 仍会被执行
certbot renew --dry-run --cert-name example.com --deploy-hook 'systemctl reload nginx'
据 Certbot 官方文档,--dry-run 会触发 --deploy-hook,因此这是验证 reload 链路最安全的方式。但要注意:命令行上的 --deploy-hook 只对本次运行生效,要永久固化,必须写进 /etc/letsencrypt/renewal/example.com.conf 的 renew_hook = systemctl reload nginx。很多”续期后旧证书残留”的根因就在这里——证书换了,没人 reload。
第 4 步:修正引用路径,只指向 live/ 下的符号链接。
# /etc/nginx/conf.d/example.conf 中应为:
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
nginx -t && systemctl reload nginx # reload 不中断连接;restart 会丢握手
| 写法 | 续期后是否自动生效 | 说明 |
|---|---|---|
live/example.com/fullchain.pem |
是 | 符号链接由 Certbot 原子更新,指向最新 archive 文件 |
archive/example.com/fullchain3.pem |
否 | 带序号文件名固定不变,续期后仍加载旧证书 |
cert.pem(缺中间证书) |
是但链不完整 | 部分客户端报 unable to get local issuer certificate |
若路径写错,nginx -t 会直接报 nginx: [emerg] cannot load certificate "/etc/letsencrypt/live/example.com/fullchain.pem",属于一眼可定位的失败。
第 5 步:容器与多副本场景,Secret 不会自己更新。
# 记录更新前的 resourceVersion,更新后再取一次对比
kubectl get secret example-tls -n prod -o jsonpath='{.metadata.resourceVersion}'; echo
# 证书 Secret 更新后,Pod 内的挂载文件是旧快照,必须重建
kubectl rollout restart deploy/nginx -n prod
# 或交给 stakater/reloader 自动触发(注解写在 Deployment 上)
kubectl annotate deploy/nginx -n prod reloader.stakater.com/auto="true"
即使 Secret 已更新,kubelet 同步挂载卷存在分钟级延迟,且 Nginx 不会自动重读文件——这就是 K8s 里通配符证书 fix 反复失败的原因。
第 6 步:清缓存并按节点复验。
# 用 --resolve 绕过 DNS/CDN,直连单节点验证,避免"其实是 CDN 没刷"
curl --resolve example.com:443:10.0.0.11 -vI https://example.com 2>&1 | grep -E 'subject|issuer|expire'
# 复跑第 1 步命令,比对 serial 与 notAfter 是否已变化
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | openssl x509 -noout -serial -dates
关于 OCSP stapling:据 Let’s Encrypt 2025 年公告,其签发的证书已不再包含 OCSP URL 并逐步停止 OCSP 服务,因此 -status 返回 OCSP response: no response sent 属预期行为,不要据此判定证书异常;浏览器侧以无痕窗口新开页面确认地址栏证书详情中的序列号与第 1 步输出一致即可。
命令与配置示例:OpenSSL 3.0、Certbot 2.11、Nginx 1.26 怎么配?
本节直接给出可复制的命令与配置,工具版本以 2025 年主流发行版默认包为准:OpenSSL 3.0.13(Ubuntu 24.04 LTS)、Certbot 2.11.0(snap 通道)、Nginx 1.26.1(nginx.org 稳定版)、cert-manager 1.15。做完通配符证书 fix 后,先比对”线上实际在跑的证书”与”磁盘上 Certbot 管理的证书”是否同一张,这是排查旧证书残留的第一步。
1)用 OpenSSL 3.0.13 看线上真正下发的是哪张证书
# -servername 必须显式指定:通配符证书靠 SNI 选择,缺省可能拿到默认 server 块的另一张证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -serial -dates -fingerprint -sha256
# 输出示例(关键看 serial 与 notAfter 是否与本地一致)
# subject=CN = *.example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# serial=0A1B2C3D4E5F60718293A4B5C6D7E8F901
# notBefore=Jun 14 00:00:00 2025 GMT
# notAfter=Sep 12 23:59:59 2025 GMT
# sha256 Fingerprint=3F:1A:...:9C
如果这里显示的 serial/notAfter 比本地 fullchain.pem 旧,说明 Nginx 加载的还是续期前的旧证书(进程未 reload 或配置指向了别处),这正是通配符证书 fix 最典型的症状。
2)用 Certbot 2.11.0 确认本地证书状态
certbot certificates --cert-name example.com
# 输出示例:
# Certificate Name: example.com
# Domains: *.example.com example.com
# Expiry Date: 2025-09-12 23:59:59+00:00 (VALID: 89 days)
# Certificate Path: /etc/letsencrypt/live/example.com/fullchain.pem
# Private Key Path: /etc/letsencrypt/live/example.com/privkey.pem
--cert-name 建议始终显式带上:同一域名若存在 example.com 与 example.com-0001 两个 lineage,不带该参数时 Certbot 只会列出全部而无法定位续期目标。据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 验证签发,因此续期同样依赖 DNS 插件凭据仍有效。
3)Nginx 1.26.1 最小可用配置
server {
listen 443 ssl;
http2 on; # 1.25.1 起取代 listen ... http2
server_name example.com *.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 必须 fullchain,不能 cert.pem
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # 1.26 默认即 TLSv1.2 TLSv1.3
ssl_session_cache shared:SSL:10m; # 默认 none,1MB ≈ 4000 会话
ssl_session_timeout 1d;
}
nginx -t && systemctl reload nginx # reload 而非 restart,避免连接中断
4)deploy hook:让 reload 自动化
#!/bin/sh
set -e # 任一步失败即退出,Certbot 会记录 hook 失败
nginx -t # 配置不合法就不 reload,避免打挂线上
systemctl reload nginx
# 保存为 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh 后:
# chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
Certbot 2.11 在每次成功续期后执行 deploy hook;hook 失败不会回滚已签发的证书,但新证书不会生效,/var/log/letsencrypt/letsencrypt.log 中会出现 hook 退出码。
5)cert-manager 1.15 场景
kubectl get certificate -A
kubectl describe certificate example-tls -n prod | grep -A3 Conditions # 期望 Ready=True
kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx # Secret 已更新但控制器未重载时
6)吊销状态检查:OCSP 与 CRL 的取舍
openssl s_client -connect example.com:443 -servername example.com -status /dev/null
| grep -A2 'OCSP Response Status'
# 期望:OCSP Response Status: successful (0x0)
| 检查方式 | 典型响应 | 2025 年适用性 |
|---|---|---|
| OCSP stapling | successful (0x0) |
商业 CA(DigiCert、Sectigo)仍提供 |
| OCSP(Let’s Encrypt) | no response |
据 Let’s Encrypt 2024-07 公告,2025 年起逐步移除 OCSP URL,改用 CRL,属正常 |
| CRL 分发点 | X509v3 CRL Distribution Points |
所有公共 CA 的长期方案,RFC 5280 定义 |
因此看到 no response 不要误判为通配符证书 fix 失败——先用 openssl x509 -noout -ocsp_uri -text | grep -i ocsp 确认证书里是否还有 OCSP URL,没有就是预期行为。配置项默认值可对照 Mozilla SSL Configuration Generator 的 “Intermediate” 档与 OpenSSL 3.0 手册页核对。
deploy hook、acme.sh、cert-manager 与云托管怎么选?
续期成功不等于新证书已经在服务。选型的真正分水岭是”证书文件写盘之后,谁负责让进程或负载均衡器重新加载”。下表把四种常见路径放在同一维度上对比,参数均可直接复制。
| 方案 | 触发方式 | 生效延迟 | 适用场景 | 关键参数 |
|---|---|---|---|---|
| Certbot deploy hook | renew 成功签发后执行 hook 脚本 | 秒级 | 单机 Nginx / Apache | --deploy-hook 'systemctl reload nginx' |
| acme.sh reloadcmd | install-cert 后按 reloadcmd 重载 | 秒级 | 轻量单机、容器外挂证书 | --install-cert ... --reloadcmd ... |
| cert-manager 1.15 | Secret 更新后控制器同步到 Ingress/网关 | 30–120 秒 | K8s 多副本、多命名空间 | Certificate / Ingress shim |
| Caddy 2.8 | 内置 ACME 客户端自动加载 | 秒级 | 全站自动 HTTPS、反代 | tls *.example.com |
| 云 LB 证书托管 | 控制台或 API 上传后边缘节点同步 | 5–30 分钟 | 多区域、CDN 回源 | 证书 ID / ARN |
单机 Nginx 为什么首选 Certbot deploy hook?因为 hook 的触发点被绑定在”续期成功”这一事件上,而不是写死的定时任务。据 Certbot 官方文档,--deploy-hook 仅在证书确实发生续期时执行,未到期跳过时不会触发;hook 执行失败不会回滚已签发的证书,也不会阻止后续续期,只会在退出码中体现。这也是通配符证书 fix 场景里最容易踩的坑:旧证书残留往往是 hook 缺失,而非签发失败。可直接写入 renewal 配置,避免每次手敲参数:
# /etc/letsencrypt/renewal/example.com.conf 中追加(Certbot 2.x 通用)
# 注意:deploy_hook 只在"实际续期成功"后执行,跳过续期时不触发
[renewalparams]
deploy_hook = systemctl reload nginx
# 验证:干跑不触发 hook,只有真实续期才 reload
certbot renew --dry-run
# 手动补一次 hook(不重新签发),用于清理旧证书残留后立即生效
certbot renew --cert-name example.com --force-renewal --deploy-hook 'systemctl reload nginx'
acme.sh 的坑在于 reloadcmd 的注册时机。据 acme.sh 项目文档,--reloadcmd 只在执行 --install-cert 时写入账户配置,之后单独跑 acme.sh --renew 不会自动带上;若证书是手动 cp 过去的,reloadcmd 完全不存在。完整注册命令:
acme.sh --install-cert -d example.com -d '*.example.com'
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.pem
--reloadcmd 'systemctl reload nginx'
# 确认已注册:输出中应出现 Le_ReloadCmd 一行
acme.sh --info -d example.com | grep -i reloadcmd
K8s 多副本为什么必须用 cert-manager?因为证书是 Secret 对象,Pod 不会自己感知文件变化。用 Certificate 资源声明通配符 + 裸域,配合 DNS-01 校验(HTTP-01 无法签发通配符,这是 RFC 8555 与 CA/B Forum 基线要求的硬限制):
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: wildcard-example
namespace: prod
spec:
secretName: wildcard-example-tls
dnsNames:
- "*.example.com"
- "example.com"
issuerRef:
name: letsencrypt-dns01
kind: ClusterIssuer
# 提前 30 天续期,给控制器同步留出窗口
renewBefore: 720h
控制器把新证书同步进 Ingress 的延迟通常在 30–120 秒,取决于 --concurrent-certificate-workers(默认 5)与集群规模;这段时间内边缘仍在使用旧证书,滚动发布时要预留。
云 LB 托管是最容易被低估的一环。上传后 5–30 分钟才全网生效,且边缘证书与回源证书是两份独立配置,只换前者会出现”浏览器正常、回源握手失败”。上传后务必用 openssl s_client 核对实际下发的链与协议版本,并对照 Mozilla Server Side TLS 的 intermediate 配置检查 TLS 1.2/1.3 与密码套件:
# 检查边缘实际下发的证书与协议(-servername 必须带,否则可能命中默认证书)
openssl s_client -connect www.example.com:443 -servername www.example.com
-tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -dates -issuer
选型不要只看”谁能签发”。把 reload 机制、Secret 传播路径、回滚方式(保留上一份 key/fullchain 并能在 60 秒内切回)、到期监控告警一起纳入评估,否则免费证书的自动化收益会被一次人工 reload 全部抵消——这正是通配符证书 fix 反复出现的根因。
常见报错怎么排查?这 6 条真实错误信息对应什么原因?
这六条报错看起来都像”证书坏了”,实际分属六个完全不同的层:浏览器信任判定、OpenSSL 名称校验、Nginx 文件读取、Certbot 命令行解析、cert-manager RBAC、OCSP stapling。先按报错原文定位层级,再动手,比盲目重签证书快得多。这也是通配符证书 fix 里最容易被误判的一类问题——多数情况下证书本身是好的。
| 报错原文(截取) | 真实根因 | 首查命令 |
|---|---|---|
| NET::ERR_CERT_DATE_INVALID | 边缘/进程加载的仍是旧证书 | openssl s_client -servername |
| SSL_ERROR_BAD_CERT_DOMAIN | 通配符只覆盖一个标签 | openssl x509 -text | grep DNS |
| BIO_new_file() failed (Permission denied) | 私钥/目录权限或 SELinux 上下文 | namei -l |
| unrecognized arguments: –deploy-hook | 参数位置错或版本过旧 | certbot --version |
| secrets “example-tls” is forbidden | cert-manager 的 RBAC 缺 secrets update | kubectl auth can-i |
| OCSP response: no response sent | 未开 stapling / resolver 不可达 / 证书无 OCSP URL | openssl x509 -ocsp_uri |
1. ERR_CERT_DATE_INVALID:磁盘新、线上旧。用 SNI 取真实生效的证书,再和磁盘对比 notAfter,不一致就说明服务没重新加载:
# 线上实际下发的证书(必须带 -servername,否则拿到默认站点证书)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -dates
# 磁盘上的证书,两者 notAfter 应一致
openssl x509 -noout -dates -in /etc/letsencrypt/live/example.com/fullchain.pem
sudo systemctl reload nginx # reload 而非 restart,读取新文件即可
若线上仍是旧日期,依次排查:Nginx 未 reload、CDN 边缘缓存未刷新(需手动 purge)、K8s 容器挂载的 Secret 未更新(挂载型 Secret 有分钟级延迟,建议用 checksum/config 注解触发滚动)。
2. BAD_CERT_DOMAIN / Go 的 x509 报错。据 IETF 的 RFC 9525(2024 年 3 月发布,正式取代 RFC 6125 与 RFC 2818),通配符只匹配一个标签:*.example.com 匹配 a.example.com,不匹配 a.b.example.com。验证并扩容 SAN:
openssl x509 -noout -text -in fullchain.pem | grep -A1 "Subject Alternative Name"
# 通配符必须走 DNS-01;--expand 保留原有域名并追加
sudo certbot certonly --dns-cloudflare --expand
-d '*.example.com' -d 'example.com' -d 'a.b.example.com'
3. BIO_new_file() Permission denied。Let’s Encrypt 的 live/ 全是符号链接,权限问题通常出在 archive/:
namei -l /etc/letsencrypt/live/example.com/fullchain.pem # 逐级看权限
sudo chmod 755 /etc/letsencrypt/live /etc/letsencrypt/archive
sudo chmod 600 /etc/letsencrypt/archive/example.com/privkey*.pem
sudo chcon -R -t httpd_sys_content_t /etc/letsencrypt # 仅 SELinux 环境需要
4. unrecognized arguments: –deploy-hook。该参数属于子命令,必须写在 renew 之后。Certbot 自 0.31 起支持 hook,2.11.0 与 3.x 行为一致:
certbot --version # 确认版本
sudo certbot renew --deploy-hook "systemctl reload nginx" # 正确位置
grep -n "renew_hook" /etc/letsencrypt/renewal/example.com.conf # 旧版写在 renewal 配置里
5. cert-manager 的 secrets is forbidden。这属于权限问题,与证书无关:
kubectl auth can-i update secrets -n prod
--as=systemaccount:cert-manager:cert-manager # 返回 no 即命中
kubectl describe clusterrole cert-manager-controller | grep -A5 secrets
ClusterRole 必须含 secrets 的 get/list/watch/create/update/patch/delete,且 RoleBinding 的 namespace 与 Certificate 所在 namespace 一致。
6. OCSP response: no response sent。先确认证书是否真有 OCSP URL:openssl x509 -noout -ocsp_uri -in fullchain.pem,为空则此项不适用(据 Let’s Encrypt 官方公告,其 2025 年起分阶段停止 OCSP 支持,新证书不再带 OCSP URL)。非空则补齐三项配置:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
resolver 1.1.1.1 8.8.8.8 valid=300s; # 容器内无 DNS 时最容易漏
六条全部排除后仍有告警,下一个怀疑对象是证书链顺序(fullchain.pem 必须叶证书在前、中间证书在后)与 SNI 分流配置,而不是证书有效期本身。
怎么验证通配符证书 fix 已生效?
修复通配符证书后,”续期成功”并不等于”线上已生效”。Certbot 只是把新文件写进 /etc/letsencrypt/live/,真正对外提供服务的仍是监听进程内存里的旧证书。判断一次通配符证书 fix 是否闭环,建议按下面 6 项逐一核对,任何一项不通过都说明修复未完成。
1. serial 是否一致?这是最快、最不容辩驳的判据。先读线上证书的序列号,再与 Certbot 记录比对:
# 读线上实际下发的证书(-servername 对通配符/SNI 场景必须带上)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -serial -dates
# 输出示例:serial=03A1B2C3... notBefore=... notAfter=Oct 12 03:14:07 2025 GMT
# 读 Certbot 认为的当前证书(Certbot 2.x/3.x 通用)
certbot certificates --cert-name example.com
# 输出示例:Serial Number: 3a1b2c3d... Expiry Date: 2025-10-12 ...
两者序列号不一致,说明 nginx/apache 未 reload,新证书没进内存:执行 nginx -t && systemctl reload nginx(不要用 restart,reload 才会平滑重载证书)。据 Certbot 官方文档,certbot renew 只在成功续期时执行 --deploy-hook,而 --dry-run 不会触发 deploy hook——这是”续期了但没重载”的最常见根因。
2. 到期日是否是新的?notAfter 应等于新到期日。Let’s Encrypt 证书有效期固定 90 天,续期在剩余 30 天时启动(certbot renew 默认窗口),因此修复后 notAfter 距今天应接近 90 天;若仍显示 ~30 天,就是旧证书残留。
3. 证书链是否完整?只部署 cert.pem 是最常见的通配符证书 fix 返工原因:
# 线上应能看到 leaf + 至少 1 张 intermediate
openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c "BEGIN CERTIFICATE"
# 本地校验 fullchain
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
/etc/letsencrypt/live/example.com/fullchain.pem
# 期望:fullchain.pem: OK
缺中间证书时客户端会报 verify error:num=20:unable to get local issuer certificate,浏览器和 curl 表现不一致(curl 有系统 CA 缓存常掩盖问题),务必用 openssl verify 判定。
4. OCSP stapling 状态(仅商业 CA)。配置需同时满足 ssl_stapling on;、ssl_stapling_verify on;、ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;,验证:
openssl s_client -connect example.com:443 -servername example.com -status 2>/dev/null
| grep -A1 "OCSP Response Status"
# 正常:OCSP Response Status: successful (0x0)
注意:据 Let’s Encrypt 公告,其证书在 2025 年已停止提供 OCSP 响应、转向 CRL,此时响应里没有 OCSP URI 属正常现象,不要误判为故障;判断标准是”证书本身有无 OCSP URL”,而非 stapling 是否返回 successful。
5. 多节点抽检。负载均衡后各节点必须同 serial:
for ip in 10.0.0.11 10.0.0.12; do
echo "== $ip =="
echo | openssl s_client -connect $ip:443 -servername example.com 2>/dev/null
| openssl x509 -noout -serial -dates
done
6. 监控与演练。blackbox_exporter 的 probe_ssl_earliest_cert_expiry 返回 Unix 时间戳,告警表达式 probe_ssl_earliest_cert_expiry - time() < 21*86400;Zabbix 用 web.certificate.get 取 not_after 同阈值。每月跑一次 certbot renew --dry-run --cert-name example.com,确认 deploy hook 中的 reload 命令可执行。
| 验证项 | 判定标准 | 不通过的典型含义 |
|---|---|---|
| serial 对比 | 与 certbot certificates 的 Serial Number 完全一致 |
进程未 reload,旧证书残留 |
| notAfter | ≈ 90 天后 | 仍在用上一轮证书 |
| 链完整性 | openssl verify 返回 OK,-showcerts ≥2 张 |
只部署了 cert.pem |
| OCSP | 有 OCSP URL 时返回 successful (0x0) | 缺 chain.pem 或未开 stapling |
| 多节点 | 各 IP serial 一致 | 部分节点未更新 |
| 监控 | 剩余 >21 天 | 续期任务静默失败 |
通常是服务未 reload 或配置仍指向 archive/ 下带序号的旧文件。先用 openssl s_client 比对 serial 与 certbot certificates 的 Serial Number,再检查 deploy hook 与 Nginx 路径。
不能。RFC 6125 规定通配符只匹配一个标签,*.example.com 覆盖 a.example.com,不覆盖 a.b.example.com;后者需要加入 SAN 或单独签发。
单机 Nginx 用 Certbot 2.11 的 –deploy-hook 更直接;轻量或非 systemd 环境可用 acme.sh 的 –reloadcmd。两者都需确认 hook 在成功续期后执行,并用 openssl 验证 serial 变化。
检查 /etc/letsencrypt/live 与 archive 目录权限,私钥 600、目录 755;确认 Nginx worker 用户可读;SELinux 环境设置 httpd_sys_content_t 上下文后 reload。
先看 Certificate Ready=True 与 Secret resourceVersion 是否更新,再看 ingress-nginx 控制器日志;默认同步 30-120 秒,必要时 kubectl rollout restart 控制器或工作负载。
用 openssl s_client -status 连接域名,返回 OCSP Response Status: successful (0x0) 即生效;Nginx 需配置 ssl_stapling on、ssl_stapling_verify on 与 ssl_trusted_certificate。注意 Let's Encrypt 自 2025 年起逐步移除 OCSP URL,改用 CRL,此类证书无 OCSP 响应属正常。
签发验证不同:免费通配符需 DNS-01,付费 DV 常用 DNS/文件/API;续期周期不同:Let's Encrypt 90 天、付费 DV 常见 365 天;但 reload、链部署、OCSP/CRL 验证流程一致,自动化 hook 可复用。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。