跳到主要内容
基础知识

通配符证书 fix:Certbot 续期后旧证书残留的 6 步修复与验证(2025)

通配符证书 fix — 通配符证书 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。