通配符证书续期怎么做?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 步按”验证→签发→校验→灰度”顺序执行。
- 先盘点,确认续期对象:通配符证书的 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 - 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 排错是省钱省时间的做法。
- 锁死凭据文件权限:
/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。 - 正式续期并挂 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 触发时不会丢参数。 - 确认 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'。 - 验证证书与私钥是否配对(私钥轮换后最容易在这里翻车):
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之外的握手失败。 - 先灰度 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,这是灰度阶段最该避免的动作。 - 观察 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。