跳到主要内容
错误排查

通配符证书 expired 应急手册:过期判定、商业重签与 7 步热替换(OpenSSL 3.0)

通配符证书 expired — 通配符证书 expired 应急手册:过期判定、商业重签与 7 步热替换(OpenSSL 3.0)
核心结论

1)通配符证书 expired 表示证书 notAfter 已过,*.example.com 下所有一级子域的新 TLS 握手会返回 certificate_expired(45),必须在 30 分钟内完成替换而不是等待旧证书复活。2)用 openssl x509 -checkend 0 -noout -in fullchain.pem 判定,返回 1 即已过期;再用 openssl s_client -servername 验证每个边缘节点。3)商业 DV 通配符重签通常 30-60 分钟,公开价约 ¥800-3000/年;OV 通配符约 1-3 个工作日、¥2000-8000/年。4)Nginx 1.25.4 热替换执行 nginx -t && systemctl reload nginx,ssl_session_timeout 默认 5m,旧会话不会无限延续。5)验证至少覆盖 3 个地域、2 个运营商,并用 openssl s_client -status 检查 OCSP stapling 是否为 successful。

通配符证书 expired 是什么状态?为什么会让所有子域同时不可用?

一句话回答:“expired” 不是文件损坏,也不是 Nginx 挂了,而是 X.509 证书中的 notAfter 时间戳(UTC)已经早于客户端当前时间。判定字段只有一个,验证只需要一条命令。

# 适用版本:OpenSSL 3.0.x(示例为 3.0.13),其他版本参数一致
# 1) 读出绝对过期时刻,这是唯一判定依据
openssl x509 -noout -enddate -in /etc/nginx/ssl/fullchain.pem
# notAfter=Mar 18 23:59:59 2025 GMT      ← 客户端 UTC 时间超过它即判 expired

# 2) 更贴近运维:直接问"还能活 30 天吗"(参数单位=秒,默认 0 即只判断是否已过期)
openssl x509 -noout -checkend 2592000 -in /etc/nginx/ssl/fullchain.pem
echo $?    # 0 = 30 天内不会过期;1 = 已过期或将在 30 天内过期(退出码 1)

据 RFC 5280 第 4.1.2.5 节,证书有效期(notBefore–notAfter)之外不得用于任何认证目的,客户端必须拒绝。因此判定权不在服务器,而在每一个客户端——同一张证书,在时钟准确的浏览器上已失效,在时间漂移的设备上却可能”看着正常”,这也是排障时最容易误判的地方。

为什么一张证书能同时打掉几十个子域?因为通配符只匹配一级标签。SAN 里写的是 DNS:*.example.com,它的覆盖范围是固定的:

访问的主机名 *.example.com 是否覆盖 原因
api.example.com ✅ 覆盖 单个一级标签
pay.example.com ✅ 覆盖 同上
a.b.example.com ❌ 不覆盖 跨了两级标签,需 *.b.example.com 或单独 SAN
example.com(裸域) ❌ 不覆盖 通配符不含裸域,需显式加入 SAN

所以当一张通配符证书 expired 时,所有依赖它的一级子域会同时进入失败状态。新建握手会收到 TLS alert 45(certificate_expired),典型报错如下:

curl: (60) SSL certificate problem: certificate has expired
# openssl s_client 侧:
openssl s_client -connect api.example.com:443 -servername api.example.com
# verify error:num=10:certificate has expired
# 浏览器侧:NET::ERR_CERT_DATE_INVALID

已经连上的连接会立刻断吗?不会。TLS 1.3 的握手认证只发生在连接建立时,已建立的会话不会因 notAfter 到期被立即踢掉;但新建连接和会话恢复(session resumption)都会失败。Nginx 的 ssl_session_timeout 默认 5m,也就是说最多 5 分钟后复用票据耗尽,故障会全面暴露——不要指望长连接熬过去,按 P1 事件处理更稳妥。据 Let’s Encrypt 文档,其证书有效期 90 天,官方建议在剩余 30 天前完成续期;商业 DV/OV 通配符常见为 1 年,受 CA/Browser Forum 398 天上限约束,应在到期前 30–45 天发起重签。

证书来源 典型有效期 建议启动续期/重签时间 依据
Let’s Encrypt DV 通配符(ACME) 90 天 剩余 30 天 Let’s Encrypt 官方文档
商业 DV/OV 通配符 1 年(≤398 天) 到期前 30–45 天 CA/Browser Forum Baseline Requirements

最常见的四个根因(按现场命中率排序):

  • ACME 自动续期失败:DNS-01 的 _acme-challenge TXT 记录未生效或残留旧值,或 CA 侧 API 限流导致续期请求被拒。
  • 商业证书未提前重签:采购/审批链路长,卡在到期前一周才发现。
  • 私钥与证书不匹配:新证书已签发但私钥仍为旧文件,nginx -t 或 reload 失败,实际仍在用旧证书(可用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 的哈希比对确认)。
  • 监控盲区:只探测 443 端口连通性,不校验 notAfter,端口一直”健康”,证书一直没人管。

影响面估算时记住一个量级:一张 *.example.com 通常覆盖 20–200 个子域,过期瞬间 API、静态资源、移动端接口、CDN 回源与第三方支付回调可能同时报错。原则是先止血再复盘——不要在旧证书上反复 reload 试探,直接走热替换流程,后续章节的 7 步操作即为此设计。

通配符证书 expired 后怎么应急替换?6 个编号步骤

当通配符证书 expired 后,客户端会立刻返回 curl: (60) SSL certificate problem: certificate has expired,所有走 *.example.com 的 API 与静态资源同时不可用。如果私钥没有泄露,就只需要更换证书,不必走吊销流程;下面 6 步可以在 30 分钟内完成热替换,全程不会中断现有连接(reload 是平滑生效,老 worker 会处理完存量请求后再退出)。

  1. 判定过期与覆盖域。先确认线上实际下发的证书,而不是磁盘上你以为的那张:
    # 从真实握手取回证书:到期时间、主体、签发者、序列号
    echo | openssl s_client -connect api.example.com:443 -servername api.example.com 2>/dev/null 
      | openssl x509 -noout -dates -subject -issuer -serial
    
    # 本地文件判定:退出码 0=未过期,1=已过期(-checkend 0 意为“检查此刻”)
    openssl x509 -checkend 0 -noout -in /etc/nginx/ssl/example.com/fullchain.pem; echo "exit=$?"
    # 顺手确认 SAN 覆盖范围,通配符只匹配一级:*.example.com 不含 a.b.example.com
    openssl x509 -noout -ext subjectAltName -in /etc/nginx/ssl/example.com/fullchain.pem

    注意 -checkend 0 的返回值是反直觉的:返回 1 才代表已过期,脚本里别写成 if 成功分支。若 s_client 看到的序列号与磁盘文件不一致,说明流量打到了别的节点或 CDN 回源,先修拓扑再换证书。

  2. 备份旧材料并记录指纹。回滚能力比换证书本身更重要:
    tar czf /backup/ssl-$(date +%F-%H%M).tgz /etc/nginx/ssl/example.com
    cd /etc/nginx/ssl/example.com && sha256sum fullchain.pem privkey.pem > sha256.txt
    openssl x509 -noout -fingerprint -sha256 -in fullchain.pem   # 记录旧证书指纹

    旧证书与私钥至少保留 7 天(覆盖一个完整的工作周与观察窗口),并把回滚时间目标定在 5 分钟以内——这意味着备份包必须是“解压即用”的完整目录,而不是只留 crt 文件。

  3. 用 OpenSSL 3.0.13 生成新 CSR。以下命令在 OpenSSL 1.1.1 及以上均可运行,-addext 是 1.1.1 引入的:
    openssl req -new -newkey rsa:3072 -sha256 -nodes 
      -keyout privkey.new.pem -out wildcard.csr 
      -subj '/C=CN/O=Example/CN=*.example.com' 
      -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
    chmod 600 privkey.new.pem
    openssl req -in wildcard.csr -noout -verify -text | grep -A1 'Subject Alternative Name'

    openssl req 在未指定 -newkey 时的默认密钥是 RSA 2048、默认摘要是 SHA-256;建议显式抬到 3072 或换 ECDSA,2048 位以下不要再用于新签发。CA/Browser Forum Baseline Requirements 规定 TLS 证书最长有效期 398 天,所以重签时顺手把到期监控加上,别等下一次 expired。

    方案 签名体积 / 握手开销 兼容性 建议场景
    RSA 3072 签名 384 字节,握手包偏大 全兼容,含老旧 Java、嵌入式设备 默认首选,客户端不可控时
    ECDSA P-256 签名约 72 字节,握手省 1–2 KB TLS 1.2+ 现代客户端;纯 RSA 老客户端不支持 移动端、高 QPS 边缘节点
  4. 向原 CA 或备用 CA 提交重签。商业 DV 通配符通常 30–60 分钟出证,OV 因需人工核验要 1–3 个工作日。若原 CA 审核卡住(常见于企业主体信息变更或 DNS-01 记录被安全策略拦截),先用单域名证书给核心域止血:DV 单域名 10–20 分钟可上线,再并行重签通配符。据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 挑战签发,HTTP-01 不支持;这也解释了为什么换 DNS 服务商时通配符续签最容易失败。
  5. 校验证书链与私钥匹配。这一步能挡掉 90% 的线上事故:
    # 1) 链验证:输出 new.crt: OK 才继续
    openssl verify -CAfile chain.pem -untrusted intermediate.pem new.crt
    
    # 2) 私钥匹配:两行哈希必须完全一致(RSA)
    openssl x509 -noout -modulus -in new.crt | openssl sha256
    openssl rsa -noout -modulus -in privkey.new.pem | openssl sha256
    # ECDSA 证书无 modulus,改用公钥比对:
    # openssl x509 -pubkey -noout -in new.crt | openssl sha256
    
    # 3) 合并为 fullchain(顺序:叶证书在前,中间证书在后,切勿带根证书)
    cat new.crt intermediate.pem > fullchain.new.pem

    若漏做第 2 步,nginx -t 会直接抛出真实报错:SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。链顺序颠倒则表现为部分客户端报 unable to get local issuer certificate,浏览器却正常——因为浏览器会自行补链,命令行工具不会。

  6. 灰度分发并 reload。先换 1 台边缘节点,验证通过再推全量:
    install -m 644 fullchain.new.pem /etc/nginx/ssl/example.com/fullchain.pem
    install -m 600 privkey.new.pem   /etc/nginx/ssl/example.com/privkey.pem
    nginx -t && systemctl reload nginx        # reload 不丢连接;restart 会中断
    
    # 指定节点验证,避免 DNS 轮询看到别的机器
    curl -Iv --resolve api.example.com:443:10.0.0.10 https://api.example.com 2>&1 
      | grep -Ei 'subject|expire date|SSL certificate verify'
    
    # 回滚:解压备份并再次 reload,目标 < 5 分钟
    tar xzf /backup/ssl-2025-01-01-0930.tgz -C / && systemctl reload nginx

    观察 5 分钟无 5xx 与新证书告警后再推其余节点;如果用了 CDN,别忘了在控制台上传新证书,否则回源证书换了、边缘仍在下发旧证书。TLS 1.3 下会话恢复会让部分长连接继续使用旧证书,属于预期行为,不必误判为替换失败。

Nginx、Apache 与 HAProxy 怎么配置新证书?可直接复制的片段

拿到重签后的新证书文件后,真正容易出问题的地方在于旧配置还在引用旧路径,而不是证书本身。因此三个 Web 服务器都要遵循同一套做法:新文件以 .new.pem 后缀写入磁盘,旧文件保持不动,配置改指向新文件,校验通过后再 reload(不要用 restart,因为 reload 会平滑生效,不会中断已有连接)。这样即使新证书链有问题,回滚也只是改一行路径。

Q:Nginx 1.25.4 怎么配?把下面片段放进 server { listen 443 ssl; ... } 块,注意 resolver 是 OCSP stapling 能否工作的前提:

# /etc/nginx/conf.d/example.com.conf  (Nginx 1.25.4 验证通过)
server {
    listen 443 ssl;
    http2 on;                                     # 1.25.1 起用 http2 指令,旧写法 listen ... http2 已废弃

    ssl_certificate     /etc/nginx/ssl/example.com/fullchain.new.pem;  # 必须含中间证书
    ssl_certificate_key /etc/nginx/ssl/example.com/privkey.new.pem;    # 权限 600,属主 root

    ssl_protocols       TLSv1.2 TLSv1.3;          # 默认仅 TLSv1.2/1.3
    ssl_session_cache   shared:SSL:10m;           # 约 8 万会话,1MB≈8000
    ssl_session_timeout 1d;                       # 默认 5m,1d 适合长连接场景

    ssl_stapling        on;                       # 默认 off
    ssl_stapling_verify on;                       # 默认 off,需配合 ssl_trusted_certificate 更稳
    resolver            223.5.5.5 1.1.1.1 valid=300s;   # stapling 取 OCSP 必须配 resolver
    resolver_timeout    5s;
}
# 校验并平滑生效
nginx -t && systemctl reload nginx

Q:Apache 2.4.58 呢?Apache 的坑在于证书链要单独用 SSLCertificateChainFile 指定(2.4.8 之前更必须),2.4.58 也可直接把链拼进 SSLCertificateFile:

# /etc/httpd/conf.d/ssl.conf  (Apache 2.4.58 / httpd 验证通过)
<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/new.crt          # 叶子证书
    SSLCertificateKeyFile   /etc/httpd/ssl/privkey.new.pem  # 私钥,权限 600
    SSLCertificateChainFile /etc/httpd/ssl/intermediate.pem # 中间证书;不写会导致部分客户端链不完整
    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLSessionCache         "shmcb:/run/httpd/sslcache(512000)"
    SSLUseStapling          on                              # 默认 off
    SSLStaplingCache        "shmcb:/run/httpd/stapling(128000)"  # 不开这个 stapling 直接不生效
</VirtualHost>
apachectl configtest && systemctl reload httpd

Q:HAProxy 2.9.7 为什么只有一个 crt 文件?因为 HAProxy 要求 crt 是 叶子 → 中间 → 私钥 顺序拼接的单个 PEM,顺序错了会报 unable to load SSL private key from PEM file:

# 顺序必须是 leaf → intermediate → key,缺一不可
cat new.crt intermediate.pem privkey.new.pem > /etc/haproxy/certs/example.com.pem
chmod 600 /etc/haproxy/certs/example.com.pem   # HAProxy 进程用户需可读
chown haproxy:haproxy /etc/haproxy/certs/example.com.pem

# /etc/haproxy/haproxy.cfg
frontend https_in
    bind *:443 ssl crt /etc/haproxy/certs/example.com.pem alpn h2,http/1.1
    default_backend app

haproxy -c -f /etc/haproxy/haproxy.cfg && systemctl reload haproxy
对比项 Nginx 1.25.4 Apache 2.4.58 HAProxy 2.9.7
证书链配置 fullchain 单文件 CertFile + ChainFile crt 内拼接
私钥要求 独立文件 独立文件 并入 crt,权限 600
校验命令 nginx -t apachectl configtest haproxy -c -f
OCSP stapling 默认 off,需 resolver off,需 SSLStaplingCache 默认不主动 stapling

Q:reload 之后怎么确认真的换上了?单节点用下面两条命令,一条读证书元数据,一条读 TLS 握手摘要:

openssl s_client -connect 10.0.0.10:443 -servername api.example.com -showcerts 
  </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -serial
# 输出示例:notAfter=Apr 12 08:00:00 2026 GMT  ← 必须是新证书的到期日

curl -Iv --resolve api.example.com:443:10.0.0.10 https://api.example.com 2>&1 
  | grep -E 'expire|subject|issuer'

Q:几十台机器怎么批量换?Ansible 2.16 先分发再校验,copy 之后立刻跑一次 nginx -t,避免把坏配置 reload 到全部节点。滚动批次建议每批 5 台或 10%,间隔 60 秒,让监控有时间报警:

ansible all -i inventory -m copy 
  -a 'src=fullchain.new.pem dest=/etc/nginx/ssl/example.com/fullchain.pem mode=0644'
ansible all -i inventory -m shell -a 'nginx -t && systemctl reload nginx'

Q:stapling 没生效怎么看?正常返回应为 OCSP Response Status: successful (0x0):

openssl s_client -connect api.example.com:443 -servername api.example.com -status 
  </dev/null 2>/dev/null | grep -A2 'OCSP Response Status'

如果输出 no response sent,并且 Nginx 的 error.log 出现 ssl_stapling ignored,几乎总是漏配 resolver,或证书本身不含 OCSP URL(可用 openssl x509 -noout -ocsp_uri -in fullchain.new.pem 确认)。这一检查与前面提到的通配符证书 expired 判定是配套的:很多“浏览器提示证书过期”其实是链不全或 stapling 缓存里残留了旧证书的 OCSP 响应,据 Let’s Encrypt 文档,重签后 OCSP 响应会有数分钟缓存延迟,reload 后立刻测试可能仍看到旧序列号,等待 5–10 分钟复测即可。OCSP 协议细节可参考 RFC 6960,TLS 参数推荐值参考 Mozilla SSL Configuration Generator。

重签原 CA、切换备用 CA 还是先上单域名?三种应急方案对比

通配符证书 expired 之后,真正决定停机时长的是”走哪条签发路径”,而不是”哪家 CA 更便宜”。下表把五条常见路径放在一起对比,价格取 2025 年公开市场区间,含税、不含加急与人工部署费用;时长指从提交资料到拿到可部署证书的时间。

方案 适用场景 出证时长 2025 公开价(含税,不含人工) 主要风险
原 CA 重签同品牌通配符 品牌合规、审计要求、采购流程已固化 DV 30–60 分钟;OV 1–3 个工作日 DV ¥800–3000/年;OV ¥2000–8000/年 资料审核可能卡住,OV 电话核验遇节假日顺延
备用 CA 新签通配符 原 CA 故障、审核排队过长 45–120 分钟 ¥0(ACME)至 ¥1500/年 需更新信任链与内部白名单,旧终端可能缺新根
临时单域名证书 只保核心 API、支付回调域名 10–20 分钟 ¥0–200/张 覆盖子域少,需要逐张续期管理
内部 CA(自签/私有 PKI) 内网、mTLS、测试环境 5–10 分钟 ¥0 外部客户端不信任,公网浏览器直接报错
多域名 SAN 证书 子域少且固定(≤10 个) 30–90 分钟 ¥1000–5000/年 新增子域必须重签,SAN 字段不能事后追加

选型原则:对外生产优先原 CA 重签,保持品牌与合规一致。 但如果评估下来 30 分钟内拿不到证书,正确做法是先用单域名证书止血,同时并行提交通配符重签申请,避免几十个子域一起等审核。止血命令(certbot 2.x,HTTP-01 默认走 80 端口,无需 DNS API):

# 只签核心域名,--cert-name 固定名称便于后续替换与回滚
sudo certbot certonly --webroot -w /var/www/html 
  -d api.example.com -d pay.example.com 
  --cert-name emergency-2025 
  --deploy-hook 'systemctl reload nginx'   # 签发成功后自动重载,避免手动遗漏

切换备用 CA 前必须检查客户端信任库。据 Let’s Encrypt 兼容性文档,Android 7.1.1 及更早版本默认不包含 ISRG Root X1,Oracle Java 8 需 8u141 以上才内置该根;嵌入式设备与老式 IoT 固件同样常见缺根。据 Mozilla SSL Configuration Generator 的兼容性建议,面向公众的站点应保留至少一条现代链和一条兼容链的验证记录,而不是签发完就直接全量切流。

# 用 acme.sh 3.x 切到备用 CA 签发通配符;--server 默认是 letsencrypt
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --set-default-ca --server zerossl
export Ali_Key="LTAI..." Ali_Secret="..."      # 通配符只能走 DNS-01
~/.acme.sh/acme.sh --issue -d 'example.com' -d '*.example.com' 
  --dns dns_ali --keylength ec-256 --force     # --keylength 默认 ec-256

# OpenSSL 3.0 校验实际链、签发者与有效期(3.0 起 -dates 输出 notBefore/notAfter)
openssl s_client -connect api.example.com:443 -servername api.example.com 
  -showcerts /dev/null | openssl x509 -noout -dates -subject -issuer

时间与价格的两个隐藏坑:商业 OV 通配符需要组织验证,遇到节假日或电话核验会顺延 1–3 个工作日,DV 通配符通常只做域名控制验证,适合应急,但无法替代 OV 的组织身份展示。另外,据 CA/Browser Forum Ballot SC-081,公开 TLS 证书有效期上限将在 2026-03-15 起降为 200 天、2027-03-15 起降为 100 天、2029-03-15 起降为 47 天,当前仍为 398 天;因此即便购买 2 年及以上套餐,实际仍按 1 年周期重签,采购时不要把”多年期”理解为”多年不换证”。

通配符证书 expired 常见报错怎么排查?6 条真实错误与命令

线上看到 NET::ERR_CERT_DATE_INVALID 或 certificate has expired,第一件事不是急着重签,而是判定”过期”发生在哪一层:客户端时钟、服务端证书文件、还是中间层(SNI 虚拟主机、CDN 回源、负载均衡节点)。据 RFC 5280 §4.1.2.5,notBefore/notAfter 是叶子证书自身属性,任何 CA 或服务器配置都无法绕过;据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 挑战签发,重签必然产生新证书,因此”只换了 key 没换 crt”是通配符场景的高频事故。以下 6 条报错覆盖绝大多数 通配符证书 expired 现场。

  1. 浏览器报 NET::ERR_CERT_DATE_INVALID:先排除客户端,再看服务端文件。
    # 1) 客户端时间与时区(systemd 系统)
    timedatectl                      # 关注 "System clock synchronized: yes"
    # 2) 服务端证书有效期(OpenSSL 3.0)
    openssl x509 -noout -dates -in /etc/nginx/ssl/fullchain.pem
    # notBefore=Mar  1 00:00:00 2024 GMT
    # notAfter=Mar  1 23:59:59 2025 GMT

    若 notAfter 尚未到,浏览器仍报过期,说明浏览器拿到的不是这份文件:检查是否命中旧 SNI 虚拟主机(多个 server_name 复用了旧证书),或 CDN 回源仍指向旧节点。

  2. curl: (60) SSL certificate problem: certificate has expired:用 --resolve 绕过 DNS,锁定具体节点。
    # 强制把域名解析到指定后端 IP,保留 SNI 与 Host
    curl -Iv --resolve api.example.com:443:10.0.0.10 https://api.example.com
    # 直接看握手返回的证书链
    openssl s_client -connect 10.0.0.10:443 -servername api.example.com -showcerts </dev/null 2>&1 
      | grep -E 'verify error|notAfter'
    # verify error:num=10:certificate has expired

    -servername 不可省略,否则会命中 default_server 的证书,得出错误结论。

  3. Nginx: SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:X509_check_private_key:key values mismatch):证书与私钥不配对,多见于重签后只替换其中一个文件。
    # RSA 证书:比对模数哈希
    openssl x509 -noout -modulus -in fullchain.pem | openssl sha256
    openssl rsa  -noout -modulus -in privkey.pem  | openssl sha256
    # ECDSA 证书(OpenSSL 3.0 通用做法):比对公钥哈希
    openssl x509 -in fullchain.pem -noout -pubkey | openssl sha256
    openssl pkey -in privkey.pem -pubout       | openssl sha256

    两个值不同即重新配对,切勿用旧 key 签新 crt。

  4. openssl verify: error 10 at 0 depth lookup: certificate expired:error 10 对应 X509_V_ERR_CERT_HAS_EXPIRED,depth 0 就是叶子证书本身,与链是否完整无关。
    openssl verify -CAfile chain.pem -untrusted chain.pem fullchain.pem
    # error 10 at 0 depth lookup: certificate expired
    # 仅想验证链结构时可指定历史时间点(OpenSSL 3.0 verify(1))
    openssl verify -attime $(date -d '2024-06-01' +%s) -CAfile chain.pem -untrusted chain.pem fullchain.pem

    -CAfile 只改变信任锚,不会忽略 notAfter——过期只能重签或换证书。

  5. HAProxy: unable to load certificate / SSL_CTX_use_PrivateKey_file:pem 顺序或权限不对。
    # 顺序必须为 leaf → intermediate → key,合并为单文件
    cat fullchain.pem privkey.pem > /etc/haproxy/ssl/api.example.com.pem
    chown haproxy:haproxy /etc/haproxy/ssl/api.example.com.pem
    chmod 600 /etc/haproxy/ssl/api.example.com.pem
    # 配置语法 + 证书可加载性校验(HAProxy 2.x/3.x)
    haproxy -c -f /etc/haproxy/haproxy.cfg

    权限 644 虽通常可读,但在 systemd 加固或 SELinux 标签缺失的环境仍会加载失败,生产建议 600 + 正确属主。

  6. Java: PKIX path validation failed: CertPathValidatorException: validity check failed:客户端信任库或中间证书问题。
    # 查看 JVM 默认信任库中的根证书(默认口令 changeit)
    keytool -list -cacerts -storepass changeit | grep -i 'your-ca'
    # 确认服务端是否发送完整链(应看到 leaf + 至少一张 intermediate)
    openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null

    只发 leaf 时,Java 无法补链,报错常被误读成”证书过期”。

报错关键字 出错层 首要判据
ERR_CERT_DATE_INVALID 客户端时钟 / 服务端文件 timedatectl、x509 -dates
curl (60) … expired 单个后端节点 s_client 的 verify error:num=10
key values mismatch 证书/私钥配对 modulus 或 pubkey 哈希
verify error 10 depth 0 叶子证书有效期 depth 值定位链中位置
unable to load certificate pem 顺序 / 权限 haproxy -c
validity check failed JVM 信任库 / 链不全 keytool -list、-showcerts

把这 6 条命令固化成巡检脚本(x509 -checkend 604800 可在到期前 7 天返回非零,直接接入监控告警),比事后救火更划算;关于 通配符证书 expired 后的商业重签流程与热替换顺序,见后续章节。

怎么确认所有节点都已生效?6 项验证与监控指标

问:证书已经推下去了,怎么证明所有节点都真的生效了?

把「生效」拆成六个可判定的检查项:序列号、有效期、链、地域覆盖、协议/OCSP、监控。任何一项没有客观输出,就等于没有验证。以下命令均基于 OpenSSL 3.0(Ubuntu 22.04 / RHEL 9 自带版本),Prometheus 部分对应 blackbox_exporter 0.25。

  1. 比对序列号与日期(最直接的证据)。必须带 -servername,否则 SNI 多站点会返回默认站点证书,让人误以为通配符证书 expired 还没换掉:
    openssl s_client -connect api.example.com:443 -servername api.example.com 
      -showcerts /dev/null | openssl x509 -noout -dates -serial -subject
    # 输出示例:
    # notBefore=Jun  1 00:00:00 2025 GMT
    # notAfter=Sep  1 23:59:59 2026 GMT
    # serial=0A1B2C3D4E5F60718293A4B5C6D7E8F9
    # subject=CN = *.example.com

    serial 必须与 CA 回执(Let’s Encrypt 的 certbot certificates、商业 CA 邮件中的 Order Serial)逐字符一致;notAfter 应落在新周期内。两者任一不符,说明命中的是旧节点或旧 SNI 虚拟主机。

  2. 剩余有效期阈值。
    openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem 
      && echo "30天内不过期"
    # 退出码 0 = 2592000 秒(30 天)内不会过期;1 = 即将或已过期

    建议生产告警设 30 / 14 / 7 天三档,7 天内未处理升级为 P1。据 Let’s Encrypt 文档,其证书有效期 90 天、官方建议在剩余 30 天时续期,这也是 30 天阈值被普遍采用的原因。

  3. 链完整性。缺失中间证书时,桌面浏览器常自动补链,Android 与 Java 客户端却会直接失败,这是通配符证书 expired 事故后最常见的”隐性回退”:
    openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
      -untrusted intermediate.pem new.crt
    # 期望:new.crt: OK
    # 典型失败:verify error:num=21:unable to verify the first certificate
    
    openssl s_client -connect api.example.com:443 -servername api.example.com 
      -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'
    # 结果应 >= 2:leaf + 至少 1 张中间证书
  4. 多地域多运营商。至少覆盖 3 个地域(华北、华东、华南)× 2 个运营商,用 curl 一次拿到状态码和校验结果:
    curl -o /dev/null -s -w '%{http_code} %{ssl_verify_result}n' https://api.example.com
    # 期望:200 0        (ssl_verify_result=0 即证书链校验通过)

    若某地域返回非 0,先查 GeoDNS 与 CDN 缓存 TTL——证书换了但 DNS 仍指向旧 IP,是热替换阶段的高频假阴性。

  5. OCSP stapling 与协议版本。
    openssl s_client -connect api.example.com:443 -servername api.example.com 
      -status -tls1_3 /dev/null | grep -E 'OCSP Response Status|Protocol|Verify return code'
    # 期望:OCSP Response Status: successful / Protocol: TLSv1.3 / Verify return code: 0 (ok)
    
    nmap --script ssl-enum-ciphers -p443 api.example.com
    # 确认只开 TLS 1.2 与 1.3,TLS 1.0/1.1 必须为 closed

    旧协议本身不报证书错误,却会让客户端走另一条 TLS 栈,掩盖链与 SNI 问题;OCSP 返回 tryLater 或缺失 stapling,则会让部分客户端额外发起实时查询,增加握手延迟。

  6. 监控指标落地。blackbox_exporter 0.25 的 probe_ssl_earliest_cert_expiry 返回 Unix 时间戳,直接做减法即可分档:
    # blackbox.yml 片段
    modules:
      https_2xx:
        prober: http
        timeout: 5s
        http:
          valid_status_codes: [200]
          tls_config:
            ca_file: /etc/ssl/certs/ca-certificates.crt
    
    # PromQL 告警规则
    probe_ssl_earliest_cert_expiry - time() < 30 * 86400   # P2
    probe_ssl_earliest_cert_expiry - time() < 7 * 86400    # P1

    Zabbix 6.0+ 可用内置 web.certificate.get 键值取 expiry_timestamp,逻辑相同。

验证项 判定标准 失败时的典型现象 优先级
序列号 / notAfter 与 CA 回执一致 仍返回旧 serial P1
剩余有效期 > 30 天 -checkend 退出码 1 P2(<7 天升 P1)
链完整性 verify 输出 OK num=21 首证书无法验证 P1
多地域 ssl_verify_result=0 个别地域非 0 P1
协议 / OCSP 仅 TLS 1.2/1.3,stapling successful OCSP tryLater P2
监控探针 6 个指标全部上报 指标缺失 = 盲区 P2

补充一条实践细节:OpenSSL 3.0 起 s_client 默认会做链校验并在输出中打印 Verify return code,但在 OpenSSL 1.1.1 上需显式加 -verify_return_error 才会以非零码退出,脚本化检查时建议同时判断文本与退出码。据 RFC 5280 第 6 节,路径校验要求 leaf 到受信根之间每一级中间证书都可达,这也解释了为什么第 3 项必须单独验证,而不能只看浏览器地址栏的锁标。

如何避免下一次 expired?上线前的 4 个检查点

问:续期到底该提前多久动手?

据 Let’s Encrypt 文档,90 天证书在剩余 30 天时就应完成续期(ACME 客户端默认在剩余 1/3 有效期时首次尝试,失败后逐日重试);商业 1 年证书没有自动重试,必须在到期前 45 天建单——DV 通常 1–2 个工作日,OV 需组织审核,预留 5 个工作日并避开春节、国庆与 12 月审核高峰。判定依据只有一个字段:X.509 的 notAfter(RFC 5280 §4.1.2.5),其余”还剩几天”的换算都以它为起点。

证书类型 有效期 触发续期/建单的时间点 人工审核预留
Let’s Encrypt DV 90 天 剩余 30 天 0
商业 DV 1 年(≤398 天) 到期前 45 天 1–2 个工作日
商业 OV 1 年 到期前 45 天 5 个工作日
通配符证书 同上 同上,并先核对 *.example.com 覆盖的子域清单 同上

问:为什么只监控 443 端口会漏掉通配符证书 expired?

因为主域常挂独立证书或 CDN 回源证书,真正使用 *.example.com 的是 api、pay、static 这些子域。blackbox_exporter 导出的 probe_ssl_earliest_cert_expiry 是 Unix 秒时间戳,配合 Prometheus 做减法即可得到剩余秒数;对 20 个核心子域逐一探测,而不是只探主域。

# blackbox_exporter 0.25.x:显式指定 SNI,避免 CDN 回默认证书
modules:
  https_sni:
    prober: http
    timeout: 5s
    http:
      tls_config:
        server_name: api.example.com   # 关键行;按 IP 探测时必填

# prometheus 2.x 告警规则:30 天 = 2592000 秒
- alert: WildcardCertExpiringSoon
  expr: probe_ssl_earliest_cert_expiry - time() < 30 * 86400
  for: 1h
  labels: { severity: ticket }
# OpenSSL 3.0+:批量取 notAfter 并按剩余天数排序
for h in www api pay m static img admin cdn; do
  d=$(echo | openssl s_client -connect "$h.example.com:443" 
        -servername "$h.example.com" 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
  printf '%-26s %-32s %s 天n' "$h.example.com" "$d" 
    "$(( ($(date -d "$d" +%s) - $(date +%s)) / 86400 ))"
done | sort -k3 -n

问:怎么把 key values mismatch 挡在发布之前?

把 nginx -t、haproxy -c -f /etc/haproxy/haproxy.cfg、apachectl configtest 全部写进 CI。注意 nginx 在 -t 阶段就会加载证书与私钥,能直接暴露不匹配;Apache 2.4 的 configtest 在部分版本只校验语法,私钥匹配要到启动时才报错,所以仍需独立的公钥比对脚本。另外,传统的 -modulus 对比对 ECDSA 证书无效(EC 证书没有 modulus),OpenSSL 3.0 应改用 openssl pkey -pubout。

#!/usr/bin/env bash
# 适用 OpenSSL 3.0+;不一致返回 1,直接阻断 CI 发布
set -euo pipefail
CRT=${1:?fullchain.pem}; KEY=${2:?privkey.pem}
c=$(openssl x509 -noout -pubkey -in "$CRT" | openssl pkey -pubin -outform der | openssl sha256)
k=$(openssl pkey -in "$KEY" -pubout -outform der | openssl sha256)
[[ "$c" == "$k" ]] || { echo "FAIL: key values mismatch" >&2; exit 1; }
echo "OK: $c"

nginx: [emerg] SSL_CTX_use_PrivateKey_file(“/etc/nginx/ssl/privkey.pem”) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
OpenSSL 3.0 下同一故障显示为 error:0A080006:SSL routines::EVP lib,别被新错误码误导。

问:回滚包里装什么?

每次替换前保留 fullchain.pem、privkey.pem、sha256.txt 和 CA 回执(订单号 + 签发邮件),回滚时间目标小于 5 分钟;变更记录写清 serial、notBefore、notAfter 与受影响的子域清单,双人复核时一人比对 serial 与 CA 回执、一人执行替换。

# 发布前打包,回滚时解压即用
sha256sum fullchain.pem privkey.pem > sha256.txt
openssl x509 -noout -serial -dates -ext subjectAltName -in fullchain.pem
tar -czf cert-$(date +%Y%m%dT%H%M).tgz fullchain.pem privkey.pem sha256.txt ca-receipt.pdf
检查点 命令/工具 阈值 失败动作
续期窗口 日历 + CA 控制台 LE 剩 30 天 / 商业剩 45 天 立即建单
到期监控 blackbox_exporter / s_client < 30 天 工单 + 值班通知
变更门禁 nginx -t / haproxy -c / configtest + 公钥比对 任一失败 阻断合并
回滚就绪 tar 包 + sha256.txt + CA 回执 RTO < 5 分钟 禁止上线

不会立刻全部断开。已建立的 TLS 1.3 连接通常可继续到关闭,但新建连接、会话恢复和重新握手会失败,并返回 certificate_expired(45)。不要把长连接当作缓冲,应按 P1 事件在 30 分钟内替换证书。

可以重新签发,但旧证书不能复活。ACME 或商业 CA 的续期本质都是签发一张新证书,notAfter 重置;商业 CA 可能复用原 CSR 或要求新 CSR,私钥可复用但建议同时轮换。

常见原因是客户端命中不同节点、SNI 虚拟主机配置不一致,或 curl 使用了 –resolve 绕过了 DNS。先查服务端 notAfter,再用 openssl s_client -servername 对每个节点验证,最后检查 CDN 回源和负载均衡后端。

2025 年公开价参考:DV 通配符约 ¥800-3000/年,重签 30-60 分钟;OV 通配符约 ¥2000-8000/年,重签 1-3 个工作日;ACME 通配符约 5-15 分钟、费用 ¥0,但需要 DNS-01 自动化。对外生产若已有商业合规要求选原 CA 重签,纯技术应急可先用 ACME 或单域名证书止血。

这是证书与私钥不匹配,常见于复制错文件、CSR 与私钥不是同一对、或 fullchain 中混入了旧证书。用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 对比 SHA256,值一致后再 nginx -t。

不能。通配符只匹配一个标签,*.example.com 覆盖 api.example.com,但不覆盖 a.b.example.com。若需要多级子域,应在 SAN 中显式写入 DNS:a.b.example.com,或为该层级单独签发 *.b.example.com。

用 openssl s_client 分别连接 CDN 边缘 IP 和每台源站 IP,指定 -servername api.example.com,比对 serial 与 notAfter;再用 curl –resolve 从 3 个地域发起请求,ssl_verify_result=0 且 serial 一致才算完成。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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