跳到主要内容
基础知识

通配符证书续期怎么做?30 天窗口、私钥轮换与多节点分发(2025)

通配符证书续期 — 通配符证书续期怎么做?30 天窗口、私钥轮换与多节点分发(2025)
核心结论

通配符证书续期不是重新申请一张证书,而是在到期前 30 天左右复用 ACME 账户和 DNS-01 授权重新签发并替换同一组 `*.example.com` 证书文件;Let's Encrypt 证书有效期 90 天,建议剩余 30 天触发续期。 certbot 2.11.0 默认在到期前 30 天续期,可用 `certbot renew --cert-name example.com --dry-run --deploy-hook 'systemctl reload nginx'` 演练。 acme.sh 3.0.8 默认按 60 天周期执行 `acme.sh --cron`,通配符域名需保留 `-d '*.example.com'` 与 DNS 插件参数。 续期后必须比对证书与私钥公钥指纹,避免 Nginx 报 `X509_check_private_key:key values mismatch`。 多节点分发建议先灰度 1 台,验证 `openssl s_client -servername example.com` 的 `notAfter` 与 SAN 后再全量 reload。

通配符证书续期为什么总在最后 30 天才出问题?

问:为什么 90 天的通配符证书,问题总在剩余 30 天才暴露?

因为续期触发点就设在剩余 30 天。据 Let’s Encrypt 文档,Let’s Encrypt 与 ZeroSSL 的 DV 通配符证书有效期通常为 90 天;certbot 2.11.0 的 renewal 配置默认 renew_before_expiry = 30 days,acme.sh 3.0.8 的 --cron 按 --days 默认 60 天判断,对 90 天证书也约剩 30 天。这 30 天是留给 DNS 传播、ACME 重试和多节点分发的缓冲,不是“最后期限”;DNS 授权或分发链有隐患时,失败会集中在此刻暴露。按 Let’s Encrypt 的 failed validation 限制(每账户每主机名每小时 5 次),连续重试很快撞限。

更关键的是,ACME 续期不是改日期。据 RFC 8555 §7.4,客户端要新建 order、提交 CSR 并重新完成 authorization;通配符证书续期仍只能走 DNS-01,*.example.com 的验证记录固定为 _acme-challenge.example.com 的 TXT,HTTP-01 无法覆盖通配符。证书同时含 example.com 与 *.example.com 时,未用 CNAME 的情况下同一验证名要放两条 TXT。

# certbot 2.11.0:默认 30 days;renewal 配置显式写入可覆盖
grep -R "^renew_before_expiry" /etc/letsencrypt/renewal/example.com.conf || echo "未显式配置,使用默认 30 days"
certbot renew --cert-name example.com --dry-run

# acme.sh 3.0.8:--cron 默认按签发后 60 天续期,90 天证书约剩 30 天
~/.acme.sh/acme.sh --cron --home ~/.acme.sh
~/.acme.sh/acme.sh --list | grep example.com
客户端/版本 默认续期触发 90 天证书剩余 查看/覆盖
certbot 2.11.0 renew_before_expiry = 30 days 约 30 天 /etc/letsencrypt/renewal/<name>.conf
acme.sh 3.0.8 --cron + --days 默认 60 天 约 30 天 acme.sh --list;--days 表示签发后多少天续期

问:为什么昨天还能续,今天 certbot renew 在 DNS 阶段失败?

第一类根因是授权链没有复用。通配符证书续期每次都要重新写 TXT,以下任一变化都会让 DNS-01 失败:_acme-challenge.example.com 的 CNAME 委派被删;Cloudflare API Token 缺少 Zone:DNS:Edit(还需 Zone:Zone:Read);Route53 的 route53:ChangeResourceRecordSets 权限被收回。certbot 只会报 ACME 授权失败,不会自动修权限。

# 检查验证名:应有 TXT,或指向可写区域的 CNAME
dig +short TXT _acme-challenge.example.com
dig +short CNAME _acme-challenge.example.com

# dns-cloudflare 凭据文件权限应为 600(certbot 2.11.0)
stat -c '%a %n' /etc/letsencrypt/cloudflare.ini

# 看真实 ACME 错误,而不是只看 cron 日志
certbot renew --cert-name example.com --dry-run -v

问:续期后 Nginx 报 X509_check_private_key:key values mismatch 是怎么回事?

第二类根因是私钥与证书文件不同步。certbot 续期默认生成新私钥(--reuse-key 默认关闭);如果只替换 fullchain.pem 而没替换 privkey.pem,Nginx 会报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。据 OpenSSL 文档,X509_check_private_key 校验的就是证书公钥与私钥是否成对。长期不轮换私钥也不符合变更审计要求;轮换后要同步更新所有引用该私钥的 HAProxy、K8s Secret 和 mTLS 客户端。

# OpenSSL 1.1.1+:两行公钥输出必须完全一致
openssl x509 -noout -pubkey -in /etc/letsencrypt/live/example.com/fullchain.pem
openssl pkey -pubout -in /etc/letsencrypt/live/example.com/privkey.pem

# 部署后先测试再 reload
nginx -t && systemctl reload nginx

问:为什么浏览器看到新证书,部分节点还是旧日期?

第三类根因是多节点分发缺失:只 reload 了入口 Nginx,HAProxy 的合并 PEM、Kubernetes Secret、内网 mTLS 客户端仍持有旧证书,于是出现“部分节点 notAfter 已更新、部分节点仍是旧日期”。据 Mozilla Server Side TLS 指南,证书与私钥必须成对部署;分发后要逐节点验证实际生效的证书,而不是只看文件时间。

# 逐节点检查实际生效证书的 notAfter
for h in 10.0.0.11 10.0.0.12; do
  echo "== $h =="
  ssh "$h" "echo | openssl s_client -connect 127.0.0.1:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate"
done

# Kubernetes Secret 也要更新并滚动 Pod
kubectl -n prod create secret tls example-tls --cert=fullchain.pem --key=privkey.pem --dry-run=client -o yaml | kubectl apply -f -
kubectl -n prod rollout restart deployment/example

# HAProxy 合并 PEM:证书链在前、私钥在后,权限 600
cat fullchain.pem privkey.pem > /etc/haproxy/certs/example.com.pem
chmod 600 /etc/haproxy/certs/example.com.pem
systemctl reload haproxy

把 30 天当告警线而不是执行点:剩余不足 35 天就应告警,不足 30 天必须已成功续期。

# 剩余不足 35 天返回非 0,可用于监控探针
openssl x509 -checkend $((35*86400)) -noout -in fullchain.pem || echo "ALERT: 证书将在 35 天内到期"

问:商业 CA 的通配符证书也能用 ACME 自动续吗?

通常不能。商业 CA 的通配符证书多按 1 年签发,续期是重新提交 CSR 并完成组织验证(OV/EV),不是 ACME 自动续期;中间链和 OCSP/CRL 地址可能变化,不能只替换 leaf 证书。续期后应重新核对链和吊销地址:

对比项 ACME DV 通配符(Let’s Encrypt/ZeroSSL) 商业 CA 通配符
有效期 90 天 通常 1 年
续期动作 新 order + DNS-01 授权 重新提交 CSR + 组织验证
能否自动 certbot/acme.sh 可自动 通常需人工或 CA API 流程
链与吊销 中间链可能随签发变化 中间链、OCSP/CRL 地址可能变化,不能只换 leaf
# 查看链中的证书与 OCSP/CRL 地址(商业 CA 续期后重点检查)
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
openssl x509 -noout -ocsp_uri -in cert.pem
openssl x509 -noout -crlDistributionPoints -in cert.pem

通配符证书续期前要准备什么?6 项检查清单

为什么通配符证书续期比普通证书更”输不起”?因为一张 *.example.com 一旦续期失败,所有一级子域会同时进入告警状态;而且据 Let’s Encrypt 的 Challenge Types 文档,通配符只能走 DNS-01(HTTP-01 与 TLS-ALPN-01 均无法验证通配符),整个通配符证书续期过程完全依赖 DNS API 凭证与 TXT 记录传播。动手前请逐项过完下面 6 条。

1. 版本与依赖对得上吗?DNS 插件与主程序版本错配是最高频的”静默失败”来源——certbot 2.11 起插件通过内部 API 与主程序通信,插件停留在 2.6.x 时常见 Error: Plugin dns-cloudflare is not installed 或认证阶段直接抛 AttributeError。

组件 最低版本 验证命令 默认续期阈值
certbot 2.11.0 certbot --version 30 天
certbot-dns-cloudflare 2.11.x(须与 certbot 同主次版本) pip show certbot-dns-cloudflare —
acme.sh v3.0.8 acme.sh --version 60 天
OpenSSL 3.0.13 openssl version —
# 逐条核对,任一低于上表就先升级再谈续期
certbot --version                                    # 期望 certbot 2.11.0 或更高
acme.sh --version                                    # 期望 .../acme.sh v3.0.8
openssl version                                      # 期望 OpenSSL 3.0.13+(3.0.13 修复多项 X.509 解析缺陷)
pip show certbot-dns-cloudflare | grep -i version    # 期望 2.11.x,与 certbot 主次版本一致

2. 备份 ACME 状态了吗?账户密钥与 renewal 配置一旦丢失,等于把证书当成新签,会撞上 Let’s Encrypt 的”每注册域名每周 5 张重复证书”速率限制。

umask 077                                            # 备份含私钥,先收紧默认权限
tar czf /root/le-backup-$(date +%F).tgz /etc/letsencrypt
tar czf /root/acme-backup-$(date +%F).tgz ~/.acme.sh
chmod 600 /root/*-backup-*.tgz
tar tzf /root/le-backup-$(date +%F).tgz | head -5    # 确认含 accounts/ 与 renewal/

保留至少 2 个续期周期(certbot 即 60 天以上)的备份,便于回滚到旧私钥定位问题。

3. 续期配置里的三项关键字段对吗?

certbot certificates                                  # 记录 Certificate Name / SAN / Expiry Date
grep -E 'renew_before_expiry|authenticator|credentials|server' 
     /etc/letsencrypt/renewal/example.com.conf
# 期望看到:
# renew_before_expiry = 30 days                     (默认 30 天,可按需改为 45 days)
# authenticator = dns-cloudflare
# dns_cloudflare_credentials = /etc/letsencrypt/cloudflare.ini

acme.sh 用户对应检查 ~/.acme.sh/example.com/example.com.conf 中的 Le_Api、Le_RenewalDays(默认 60)与 DnsProvider。

4. DNS API 权限是最小集吗?Cloudflare Token 只需 Zone:Read + DNS:Edit,并把 Zone Resources 限定到 example.com 单个区域;Route53 的 IAM 策略至少需要 route53:ListHostedZones 与 route53:ChangeResourceRecordSets。凭证文件建议 chmod 600,因为 certbot 的 --dry-run 会真实调用 API 建删 TXT,凭证失效会当场暴露。

5. _acme-challenge 有没有被 CNAME 或残留 TXT 抢占?这是通配符续期最隐蔽的坑:若该名字被 CNAME 委托到别的 zone,插件写入的 TXT 会落在错误区域,验证必然超时。

dig +short TXT   _acme-challenge.example.com @1.1.1.1
dig +short CNAME _acme-challenge.example.com @8.8.8.8
dig +short TXT   _acme-challenge.example.com @8.8.8.8   # 两个解析器结果应一致

TTL 建议 60–300 秒;设成 3600 秒会让 ACME 服务器在轮询窗口内读不到新记录。据 RFC 8555 §7.5.1,客户端需在验证前完成 TXT 的写入与传播,缓存过久只能等。

6. 维护窗口与 dry-run 安排好了吗?预留 30–60 分钟,先单节点演练:

# --dry-run 走 staging 环境,不消耗生产速率限制,但会真实创建/删除 TXT 记录
time certbot renew --cert-name example.com --dry-run
# acme.sh 等价写法:
acme.sh --renew -d example.com --staging

记录三项数据:staging 是否成功、DNS 传播耗时(从写入到 dig 可见的秒数)、reload 命令返回值(systemctl reload nginx; echo $?)。多节点场景下,第 6 步结论直接决定后续私钥轮换与分发策略——若传播耗时接近 60 秒,就该把 TTL 再压到 60 秒并给验证器留足重试次数。

通配符证书续期 8 步实操:从 dry-run 到灰度 reload

把通配符证书续期当成一次小规模发布,而不是一条 certbot renew 了事。据 Let’s Encrypt 官方文档,证书有效期 90 天、官方建议在剩余 30 天时续期,certbot 默认即按此窗口判断;acme.sh 的默认触发点则是剩余 60 天(--days 60)。窗口不同意味着两台机器上”同一张证书”的续期时刻可能差 30 天,多节点分发时必须统一由一台机器签发、其余机器只做分发。下面 8 步按”验证→签发→校验→灰度”顺序执行。

  1. 先盘点,确认续期对象:通配符证书的 SAN 里必须有 DNS:*.example.com,--cert-name 用错会续到另一张证书上。
    certbot certificates                 # 记下 Certificate Name / Domains / Expiry Date
    # Certificate Name: example.com
    #   Domains: example.com *.example.com
    #   Expiry Date: 2025-11-12 03:12:45+00:00 (VALID: 62 days)
    acme.sh --list                       # acme.sh 用户:看 Main_Domain 与 NotAfter
  2. dry-run 走 staging,先验 DNS 插件与凭据:
    certbot renew --cert-name example.com --dry-run
    # 内部指向 acme-staging-v02.api.letsencrypt.org,不消耗正式速率限制
    # 注意:dry-run 仍会真实调用 DNS API 写/删 TXT 记录

    Let’s Encrypt 对”每个注册域名”限制每周 50 张证书,通配符同样计入,所以先用 staging 排错是省钱省时间的做法。

  3. 锁死凭据文件权限:/root/.secrets/cloudflare.ini 应为 600、属主 root,内容只留一行 token。certbot 不会因为 644 报错,但任何本地用户读到它就能替你签发任意域名证书。
    install -m 600 /dev/null /root/.secrets/cloudflare.ini
    chown root:root /root/.secrets/cloudflare.ini
    cat /root/.secrets/cloudflare.ini
    # dns_cloudflare_api_token = <token>

    同时留意 --dns-cloudflare-propagation-seconds 默认仅 10 秒;当 example.com 与 *.example.com 同时校验时会出现两条同名 TXT,建议显式调到 60,否则常见报错是 urn:ietf:params:acme:error:unauthorized :: Incorrect TXT record ... found at _acme-challenge.example.com。

  4. 正式续期并挂 deploy-hook:
    certbot renew --cert-name example.com 
      --deploy-hook 'systemctl reload nginx'
    echo $?    # 必须为 0;未进入 30 天窗口时同样返回 0,且 deploy-hook 不执行

    把 hook 写进续期配置(/etc/letsencrypt/renewal/example.com.conf 的 renew_hook)比写在命令行更可靠,systemd timer 触发时不会丢参数。

  5. 确认 notAfter 延长、SAN 未丢:
    openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem 
      -noout -dates -ext subjectAltName
    # notAfter=Feb 10 03:12:45 2026 GMT
    # X509v3 Subject Alternative Name:
    #     DNS:example.com, DNS:*.example.com

    -ext 需要 OpenSSL 1.1.1 及以上;老版本改用 -text | grep -A1 'Alternative Name'。

  6. 验证证书与私钥是否配对(私钥轮换后最容易在这里翻车):
    openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -pubkey 
      | openssl pkey -pubin -outform DER | sha256sum
    openssl pkey -in /etc/letsencrypt/live/example.com/privkey.pem 
      -pubout -outform DER | sha256sum

    两行哈希必须完全一致。不一致说明分发时把新证书配了旧私钥,浏览器侧表现就是 SSL_ERROR_BAD_CERT_DOMAIN 之外的握手失败。

  7. 先灰度 1 台,再谈全量:Nginx / HAProxy / Kubernetes Secret 都一样,配置检查通过才 reload,绝不 restart 全量。
    rsync -a /etc/letsencrypt/live/example.com/fullchain.pem /etc/nginx/ssl/
    rsync -a /etc/letsencrypt/live/example.com/privkey.pem   /etc/nginx/ssl/
    nginx -t && systemctl reload nginx
    haproxy -c -f /etc/haproxy/haproxy.cfg && systemctl reload haproxy
    kubectl create secret tls example-com-tls --cert=fullchain.pem --key=privkey.pem 
      --dry-run=client -o yaml | kubectl apply -f -

    reload 走平滑重载、旧 worker 处理完存量连接后退出;restart 会掐断长连接与 WebSocket,这是灰度阶段最该避免的动作。

  8. 观察 5–10 分钟,留好回滚包:
    journalctl -u nginx --since '10 min ago' | grep -Ei 'ssl|handshake|error'
    curl -Iv https://example.com 2>&1 | grep -E 'SSL|subject|expire|HTTP/'
    tar czf /var/backups/cert-example.com-$(date +%F).tgz 
      /etc/letsencrypt/live/example.com /etc/letsencrypt/archive/example.com

    回滚包至少保留 7 天(覆盖一个完整观察周期)。确认日志中无 handshake_failure、sslv3 alert bad certificate 之后,再推进到其余节点。

工具 / 动作 默认续期触发点 续期命令 关键差异
certbot 2.x 剩余 ≤ 30 天 certbot renew 内置 --deploy-hook,支持 --dry-run 走 staging
acme.sh 剩余 ≤ 60 天(--days 60) acme.sh --renew -d example.com 需自建 --reloadcmd,无 dry-run 等价物
systemctl reload — 平滑重载 不中断存量连接,灰度首选
systemctl restart — 停止后启动 掐断长连接,仅回滚时使用

据 RFC 8555(ACME 协议)与 Mozilla Server Side TLS 指南,证书轮换后服务端应重新加载私钥与完整链(fullchain.pem),只换叶子证书、不换中间链是导致部分老旧客户端校验失败的常见原因。

通配符证书续期命令与配置示例:certbot、acme.sh、Nginx、cert-manager

问:certbot 2.11.0 怎么把通配符证书续期窗口改成 30 天?答:不要改命令行,改 /etc/letsencrypt/renewal/example.com.conf 的 [renewalparams] 段,因为 certbot renew 只读这个文件。通配符证书只能用 DNS-01 验证,HTTP-01 无法签发 *.example.com(据 Let’s Encrypt 文档《Challenge Types》)。

# /etc/letsencrypt/renewal/example.com.conf(certbot 2.11.0)
[renewalparams]
authenticator = dns-cloudflare
dns_cloudflare_credentials = /root/.secrets/cloudflare.ini   # chmod 600,内含 dns_cloudflare_api_token
renew_before_expiry = 30 days      # 默认值即 30 days(90 天证书的 1/3),显式写出便于审计
deploy_hook = /usr/local/bin/deploy-cert.sh   # 续期成功后触发,可读 $RENEWED_LINEAGE / $RENEWED_DOMAINS
key_type = ecdsa                   # 2.11.0 支持 ecdsa;不写则沿用原密钥类型
server = https://acme-v02.api.letsencrypt.org/directory

# 改完必须验证,--dry-run 走 staging 环境,不会消耗正式速率限制
certbot renew --dry-run
# 期望输出:Congratulations, all simulated renewals succeeded:
#   /etc/letsencrypt/live/example.com/fullchain.pem (success)

问:acme.sh 3.0.8 的签发、续期、安装三条命令分别怎么写?acme.sh 的 --issue 只负责签发,--install-cert 才是把文件落到 Nginx 路径并重载;二者分离是它比 certbot 更灵活的地方,也是新手最容易漏掉 --install-cert 导致证书”签了但没生效”的原因。

# 首次签发(EC P-256 私钥,Cloudflare DNS API)
acme.sh --issue -d example.com -d '*.example.com' --dns dns_cf --keylength ec-256

# 续期:--ecc 必须与签发时的 keylength 对应,否则会去找 RSA 目录而报 "domain key not found"
acme.sh --renew -d example.com --ecc

# 安装 + 重载:--reloadcmd 在每次续期成功后自动执行
acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem 
  --reloadcmd      'systemctl reload nginx'
# acme.sh 自带 cron(--install-cronjob,默认每天 00:00 检查),无需手写 crontab

问:Nginx 侧要改哪几行?通配符证书不覆盖裸域,dnsNames 必须同时包含 example.com 与 *.example.com,否则 curl https://example.com 会报 certificate is valid for *.example.com, not example.com。

server {
    listen 443 ssl;
    http2 on;                                    # Nginx 1.25.1+ 语法,旧版用 listen 443 ssl http2;
    server_name example.com *.example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 必须用 fullchain,缺中间证书会报 unable to get local issuer certificate
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;         # TLSv1/1.1 已在 RFC 8996 中弃用
    ssl_session_cache   shared:SSL:10m;          # 约 4 万个会话,跨 worker 共享
    ssl_session_timeout 1d;
}
# 改完先语法检查再重载,避免 reload 失败导致 443 全挂
nginx -t && systemctl reload nginx

问:HAProxy 怎么用 Let’s Encrypt 证书?HAProxy 不读分离的 cert/key,只认”证书链 + 私钥”合并的 PEM,顺序是 fullchain 在前、privkey 在后。

cat fullchain.pem privkey.pem > /etc/haproxy/certs/example.com.pem
chmod 600 /etc/haproxy/certs/example.com.pem   # 私钥在文件里,权限必须收紧
# haproxy.cfg
# frontend https_in
#     bind *:443 ssl crt /etc/haproxy/certs/example.com.pem alpn h2,http/1.1
haproxy -c -f /etc/haproxy/haproxy.cfg         # 期望:Configuration file is valid

问:Kubernetes 里 cert-manager 怎么写?1.15+ 用 renewBefore 控制 30 天窗口;privateKey.rotationPolicy 在 1.15 默认为 Never,1.18 起默认改为 Always(据 cert-manager 发布说明),想主动轮换私钥就显式写。

apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: example-com
  namespace: default
spec:
  secretName: example-com-tls
  duration: 2160h        # 90 天
  renewBefore: 720h      # 30 天,默认是 duration 的 2/3(约 60 天)
  privateKey:
    rotationPolicy: Always   # 每次续期生成新私钥,旧私钥失效
  dnsNames:
    - example.com
    - "*.example.com"
  issuerRef:
    name: letsencrypt-dns01
    kind: ClusterIssuer

kubectl get certificate example-com   # READY 列应为 True;False 时看 Reason 字段

问:怎么确认证书链真的完整?OpenSSL 3.0.13 两条命令缺一不可:第一条看有效期和 SAN,第二条验证链。

openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
# 必须输出 cert.pem: OK;出现 "unable to get local issuer certificate" 说明缺中间证书
工具/版本 通配符验证 续期触发 私钥轮换默认行为
certbot 2.11.0 DNS-01(dns-cloudflare 等插件) certbot.timer 每日两次 每次续期换新私钥;--reuse-key 可关闭
acme.sh 3.0.8 DNS-01(dns_cf 等 dnsapi) 自带 cron,每日检查 默认换新私钥
cert-manager 1.15+ DNS-01(Issuer/ClusterIssuer) 控制器按 renewBefore 自动 1.15 为 Never,1.18 起 Always

部署后最容易被忽略的一步是重载验证:echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates,输出日期必须与 fullchain.pem 一致,否则说明多节点中仍有节点未分发新证书。

通配符证书续期方案怎么选?certbot、acme.sh、cert-manager 与商业 CA 对比

先回答三个问题,再谈方案

你的节点有多少台?私钥能否离开这台机器或这个集群?证书主体必须是 OV 吗?这三个答案基本决定了你会落在下表哪一行。据 Let’s Encrypt 文档,ACME 签发的 DV 证书有效期固定 90 天,而 certbot 默认只在剩余 30 天时才真正续签;也就是说,任何“等快到期了再人工处理”的流程都必然失效——90 天证书必须配 systemd timer 或 cron。

方案 适用场景 续期触发 通配符续期命令/配置 成本区间
certbot 2.11.0 + dns-cloudflare 单机或少量 Nginx systemd timer 每日 2 次,剩余 30 天 certbot renew --cert-name example.com --deploy-hook 'systemctl reload nginx' 免费
acme.sh 3.0.8 容器、无 root、多域名 cron 每日 --cron,默认剩余 60 天 acme.sh --renew -d example.com --ecc 免费
cert-manager 1.15+ Kubernetes Ingress/Gateway renewBefore: 720h kubectl get certificate 自动更新 Secret 免费,消耗集群资源
商业 CA OV 通配符 企业合规、需 OV 主体 人工或 CA API,提前 30–60 天 重新提交 CSR + DNS TXT 验证 约 ¥2,000–8,000/年
云厂商托管证书 云内 CLB/CDN 控制台自动续期 绑定负载均衡,私钥托管 DV 免费,OV 另计

certbot 与 acme.sh 的通配符证书续期命令

# certbot 2.11.0:通配符必须走 DNS-01,Cloudflare 插件示例
certbot certonly --dns-cloudflare 
  --dns-cloudflare-credentials /root/.secrets/cf.ini 
  -d example.com -d '*.example.com' 
  --cert-name example.com --key-type ecdsa

# /etc/letsencrypt/renewal/example.com.conf 中可显式覆盖续期窗口
# renew_before_expiry = 30 days   # 默认值,90 天证书的 1/3

# 续期:timer 每天跑 2 次,但仅当剩余有效期 < 30 天才签发
certbot renew --cert-name example.com 
  --deploy-hook 'systemctl reload nginx'
# acme.sh 3.0.8:--days 控制 90 天证书的续期点,默认 60
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --keylength ec-256
acme.sh --renew -d example.com --ecc --days 45   # 提前到剩余 45 天续期
# cert-manager 1.15+:renewBefore 不写时默认在生命周期过去 2/3 时续期(90 天≈剩余 30 天)
spec:
  secretName: wildcard-example-tls
  duration: 2160h      # 90 天
  renewBefore: 720h    # 30 天
  dnsNames: [example.com, '*.example.com']

验证命令输出:

$ kubectl -n ingress get certificate wildcard-example
NAME               READY   SECRET                 AGE
wildcard-example   True    wildcard-example-tls   62d

续期窗口能不能压到 7 天?不建议。窗口越窄,DNS API 故障或 Cloudflare 限流时就越没有回滚余量;至少配 21 天、14 天两级到期告警(Prometheus probe_ssl_earliest_cert_expiry 或 openssl s_client -connect host:443 /dev/null | openssl x509 -noout -enddate)。

OV 通配符和云托管要注意什么?据 CA/Browser Forum Baseline Requirements,商业 CA 证书单张有效期上限 398 天,因此 OV 通配符多为 1 年,但私钥轮换、中间链更新、审计留痕仍须走变更流程;ACME 方案免费,代价是你要自己保管 DNS API Token 权限与操作日志。另外,若使用 CDN 或云负载均衡,先确认证书在源站终止还是边缘终止——边缘证书由云厂商托管时,源站通配符证书续期只影响回源链路,验证必须分别检查边缘与源站两条链(RFC 8555 定义的 ACME 流程也只覆盖你能控制私钥的那一端)。

通配符证书续期常见报错:DNS 传播、rate limit 与私钥不匹配怎么排查

先给结论:这六类报错里只有 Certificate not yet due for renewal 不是故障,其余按「DNS 记录 → 账户配额 → 证书私钥配对 → 认证器配置」的顺序查,10 分钟内基本能定位。所有通配符场景都必须走 DNS-01,这一点决定了后面一半的排错方向。

DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com —— 这条来自 Let’s Encrypt 的 DNS-01 校验器,表示它递归查询时拿到了 NXDOMAIN。按顺序跑三条命令,不要凭感觉猜:

# 1) 走公共递归确认 TXT 是否真的存在,排除本地缓存干扰
dig +short TXT _acme-challenge.example.com @8.8.8.8
# 2) 为空则看是否用 CNAME 把校验委派到了另一个区域
dig +short CNAME _acme-challenge.example.com @8.8.8.8
# 3) 确认权威 NS 与 SOA(判断 TTL 和区域是否配对)
dig +short NS example.com; dig +short SOA example.com

如果 CNAME 指向的区域已删除,或指向一个没有对应 NS 的域名,就会出现「记录明明加了却 NXDOMAIN」。用 Cloudflare 时有个高频误解:橙色云朵(代理状态)只影响 A/AAAA,不影响 TXT,所以关代理不是解法;真正的原因多半是 API Token 权限不足——certbot-dns-cloudflare 需要 Zone:DNS:Edit 与 Zone:Zone:Read 且限定到具体 zone,Token 只授权了别的域名时插件直接报 403,记录压根没创建。据 Let’s Encrypt 文档,DNS-01 校验会从多个网络位置发起查询,多 NS 场景下「部分地区未同步」同样会失败。

too many failed authorizations recently / urn:ietf:params:acme:error:rateLimited —— 这是 Failed Validation 限制:同一账户对同一主机名每小时最多 5 次失败校验(见 Let’s Encrypt Rate Limits 文档)。触发后等 1 小时自动解除,期间每次 --force-renewal 只会把计时重置。正确做法是先演练:

# certbot 2.x/3.x:--dry-run 默认走 staging 端点,不消耗生产配额
certbot certonly --dry-run -d '*.example.com' -d example.com 
  --authenticator dns-cloudflare 
  --dns-cloudflare-credentials /etc/letsencrypt/cloudflare.ini 
  --preferred-challenges dns

Certificate not yet due for renewal —— 不是错误。certbot renew 的 --days 默认 30,距到期超过 30 天就打印这句并跳过。验证续期链路而不签发:

certbot renew --cert-name example.com --dry-run
certbot certificates                    # 看真实到期时间
grep -E 'authenticator|pref_challs|key_type' /etc/letsencrypt/renewal/example.com.conf

别为了「看着成功」反复正式续期:Duplicate Certificate 限制是同一组域名每周 5 张,很容易误伤。

nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) —— 加载的 fullchain 与 privkey 不是同一批产物,多节点分发时最典型:只推了新证书没推新私钥。用公钥指纹比对,别看文件名和日期:

# 两行输出的 SHA-256 必须完全一致,否则重新分发 privkey.pem
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -pubkey | openssl sha256
openssl pkey -in /etc/letsencrypt/live/example.com/privkey.pem -pubout | openssl sha256

Unable to find a virtual host listening on port 80 —— 通配符只能走 DNS-01,出现这句说明 renewal 配置被 HTTP-01/webroot 污染了(同机别的任务或手工 -a webroot 覆盖过)。把认证器钉死在 renewal 文件里,避免每次靠命令行参数:

# /etc/letsencrypt/renewal/example.com.conf(certbot 2.x/3.x 格式)
[renewalparams]
authenticator = dns-cloudflare
dns_cloudflare_credentials = /etc/letsencrypt/cloudflare.ini
pref_challs = dns-01        # 等价于命令行 --preferred-challenges dns
key_type = ecdsa            # 可选,新签发用 ECDSA P-256

acme.sh 报 _acme-challenge.example.com is not ready —— acme.sh 的默认 DNS 等待约 20 秒(DEFAULT_DNS_SLEEP=20)就去查。权威 NS 的 SOA 最小 TTL 为 3600 时,递归缓存会返回旧值。显式加长等待:

export CF_Token="你的Token"
acme.sh --issue --dns dns_cf -d '*.example.com' -d example.com 
  --dnssleep 120   # 经验值:不小于 SOA 最小 TTL 的 1/10,且 ≥ 60 秒
报错 根因层 是否计入生产配额 典型恢复耗时
NXDOMAIN looking up TXT DNS 记录 / Token 权限 计入 Failed Validation TTL 到期,≤ 5 分钟
rateLimited 账户级失败计数 是(5 次/主机名/小时) 1 小时
not yet due for renewal 无(正常跳过) 否 无需处理
key values mismatch 分发一致性 否 重新推送即恢复

通配符证书续期后如何验证生效?openssl、curl 与监控的 5 个检查点

证书文件被覆盖不等于已经生效:nginx 可能没 reload、多节点中只有一台更新了、fullchain.pem 里的中间证书可能丢了一半。以下 5 个检查点由外到内排列,每次通配符证书续期后建议全部跑一遍。

检查点 1:线上返回的 notAfter 是不是新日期?从远程直接读取证书,不要看本地文件:

# -servername 必须带,否则 SNI 虚拟主机可能返回默认 server 块的证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望:notAfter 为新的到期日,且 SAN 中含 DNS:*.example.com 与 DNS:example.com
# 注意通配符只匹配一级标签,*.example.com 不覆盖 a.b.example.com(RFC 6125 §6.4.3)

检查点 2:本地文件与线上证书是同一张吗?比对 SHA-256 指纹,这是判断“reload 是否真的生效”最省事的办法:

# 本地
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -fingerprint -sha256
# 远程(输出形如 SHA256 Fingerprint=3A:1F:...,逐字符比对)
openssl s_client -connect 203.0.113.10:443 -servername example.com /dev/null 
  | openssl x509 -noout -fingerprint -sha256

多节点架构下要对每台入口分别执行,别只验证负载均衡后面的一台。据 Let’s Encrypt 文档,证书在到期前 30 天进入续期窗口,而分发延迟往往比签发本身更容易出问题。

检查点 3:curl 握手能通过吗?用 --resolve 绕过 DNS,直连指定 IP,可精确验证某一节点:

curl -Iv https://example.com --resolve example.com:443:203.0.113.10 2>&1 | grep -E 'expire date|SSL certificate|subject:'
# 期望:SSL certificate verify ok. 且 expire date 为新日期
# 若出现 SSL certificate problem: unable to get local issuer certificate
#   → fullchain.pem 缺中间证书,或 nginx 指向了 cert.pem 而非 fullchain.pem

检查点 4:证书链顺序与完整性对吗?fullchain.pem 必须是叶子证书在前、中间链在后:

# 拆分验证:-untrusted 传中间链,-CAfile 用系统根库
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
# 期望输出:cert.pem: OK
# 若报 error 20 at 0 depth lookup: unable to get local issuer certificate,即为链不完整

检查点 5:续期任务与到期监控是否正常?

systemctl status certbot.timer          # 默认每天运行两次并加随机延迟
journalctl -u certbot --since '24 hours ago'
nginx -T | grep -E 'ssl_certificate(_key)?'   # 确认加载的是 live/ 路径而非拷贝副本
kubectl describe certificate example-com | grep -A3 Conditions   # 期望 Ready=True

# 到期哨兵:14 天内不会过期则输出 Certificate will not expire 并返回 0
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -checkend 1209600 -noout
手段 能发现的问题 发现不了的问题
openssl s_client 证书未更新、SAN 错误、SNI 串证 链顺序错误(默认不校验证书链)
curl -Iv 链不完整、主机名不匹配、握手失败 私钥与证书不配对的具体原因
openssl verify 链顺序、缺中间证书 服务是否已 reload 加载新文件

监控告警建议设在剩余 21 天而非 14 天:-checkend 只回答“是否快过期”,一旦返回 Certificate will expire(退出码 1),留出的时间要够人工排查分发链路,而不是刚好卡在 30 天续期窗口边缘。

用 certbot、acme.sh、cert-manager 走 ACME 自动续期时,一般不需要手工生成 CSR,工具会自动创建新证书请求并完成 DNS-01。商业 CA 的通配符证书续期通常要重新提交 CSR,并按 CA 要求做组织验证。

因为 `*.example.com` 不对应固定主机,HTTP-01 无法为通配符域名放置验证文件。据 Let's Encrypt 文档,通配符证书只能通过 `_acme-challenge.example.com` 的 TXT 记录完成 DNS-01 验证。

certbot 依赖 `/etc/letsencrypt/renewal/*.conf` 与 systemd timer,适合单机或少量 Nginx;acme.sh 是纯 Shell,适合容器、无 root 和多域名场景,用 cron 执行 `acme.sh –cron`。两者都免费,关键是 DNS 插件权限和 reload 命令要配置正确。

说明证书和私钥不是同一批文件。重新把新生成的 `fullchain.pem` 与 `privkey.pem` 一起分发,执行 `openssl x509 -pubkey` 与 `openssl pkey -pubout` 的 SHA-256 比对,再 `nginx -t` 和 reload。

通常是 Let's Encrypt 的失败验证限制触发,常见为每账户每主机名每小时 5 次。等待 1 小时后再试,并先用 `certbot renew –dry-run` 在 staging 环境检查 DNS 记录与 API 权限。

需要 OV 主体审核、1 年有效期或合规审计时选商业 CA,预算约 ¥2,000–8,000/年;节点多、能维护 DNS API 与自动 reload 时选 ACME,成本为 0 但需要自己监控。

不够。多节点 Nginx、HAProxy 合并 PEM、Kubernetes Secret、CDN 回源证书都要更新;建议先灰度 1 台,验证远程 `notAfter`、SAN 和指纹后再全量 reload。


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

内容审核

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