SSL证书批量管理怎么做?清单盘点、ACME自动签发与多节点分发实操(OpenSSL 3.x/certbot 2.x)
1. SSL 证书批量管理的核心是把证书当作配置资产:先用 CSV/YAML 清单记录域名、到期日、CA、验证方式和部署路径,再用 certbot 2.11 或 acme.sh 3.0.7 自动签发与续期,50 张以上证书可把每月人工续期时间从 2-4 小时降到 10 分钟以内。 2. 单机 50 张以内优先 certbot --webroot + --deploy-hook;跨 10 台以上服务器用 Ansible 调用 acme.sh --issue --dns dns_cf,配合 --install-cert 分发,避免 80 端口冲突。 3. 批量续期用 systemd timer 每天 02:30 跑一次 certbot renew --quiet --deploy-hook,acme.sh 用 --cron --home /etc/acme.sh,续期后执行 nginx -t && systemctl reload nginx。 4. 验证不要只看浏览器锁标:openssl s_client -connect example.com:443 -servername example.com -showcerts 检查证书链,openssl x509 -noout -dates -subject -issuer 核对到期日与 SAN,curl -I --tlsv1.2 确认协议。 5. 常见报错 urn:ietf:params:acme:error:unauthorized 多因 80 端口被占用或 DNS A 记录未生效;nginx: [emerg] cannot load certificate 多因 fullchain.pem 与 privkey.pem 不匹配,用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 对比。
为什么证书一多就乱?SSL 证书批量管理的根本原因
先给结论:证书管理之所以乱,通常是因为“签发、分发、重载”三件事里只有第一件被自动化了。据 Let’s Encrypt 文档,其证书有效期为 90 天,官方建议在到期前 30 天完成续期;RFC 8555(ACME 协议)只规定了签发流程,并未规定部署方式。于是规模一上去,漏续和配错就从偶发变成必然。
规模临界点在哪里?实践观察大致在 30–50 个域名、5 台以上服务器。此时你需要在 CA 后台逐个点续期,再把文件逐台 scp 覆盖。更关键的是工具默认续期窗口很窄,留给人工排查的时间只有 1–2 周:
| 工具/版本 | 默认提前续期 | 关键参数 | 默认值 |
|---|---|---|---|
| certbot 2.x | 30 天 | --days |
30 |
| acme.sh 3.x | 60 天 | --days |
60(DEFAULT_RENEW) |
| 商业 OV/EV | 无自动续期 | — | 有效期 1–2 年,需人工提醒 |
根因一:没有统一清单。证书散落在 Nginx 1.24、Apache 2.4、HAProxy 2.8、CDN 回源和邮件网关里,同一域名在 prod/staging 用的还是两张不同证书,结果灰度环境先过期。据 CA/Browser Forum Baseline Requirements,域名验证与最长有效期都有硬约束,清单必须按这些时间窗口设计告警,而不是靠人记。
根因二:验证方式混用。HTTP-01 要求 80 端口公网可达且不能 301 跳转到 HTTPS(跳转会导致 challenge 失败);DNS-01 依赖 TXT 记录传播,若域名 TTL 设为 600 秒,签发可能卡住 10 分钟甚至超时。同一批域名混用两种方式,失败原因就变得难以定位。
根因三:续期没有部署钩子。certbot renew 只更新 /etc/letsencrypt/live 下的文件,不会自动重载进程,Nginx 仍持有旧证书,浏览器里显示的还是旧到期日。修复方式是放置 deploy hook:
# /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
#!/usr/bin/env bash
set -euo pipefail # 任一命令失败即中止,避免带着坏配置 reload
nginx -t # 先校验配置,防止 reload 失败
systemctl reload nginx # reload 而非 restart,不断开现有连接
# 注意:脚本需 chmod +x,certbot 2.x 会在每次成功续期后自动执行该目录下所有可执行文件
# 验证钩子是否生效(不消耗签发配额)
certbot renew --dry-run
根因四:权限与密钥粗放。私钥被设成 644、多人共用 /etc/letsencrypt/archive,审计时无法定位谁在何时替换了证书。用一条命令就能批量体检(OpenSSL 3.x):
for f in /etc/letsencrypt/live/*/cert.pem; do
openssl x509 -in "$f" -noout -subject -enddate # 输出 CN 与到期时间
done
# 收紧权限:certbot 默认 privkey 为 600、archive/live 目录为 700
chmod 600 /etc/letsencrypt/archive/*/privkey*.pem
chmod 700 /etc/letsencrypt/{archive,live}
stat -c '%a %n' /etc/letsencrypt/archive/*/privkey*.pem # 复核
把上面四件事——清单、验证方式、部署钩子、权限——分别固化下来,才是 SSL 证书批量管理真正要解决的问题;ACME 自动签发只是其中最容易的一环。
SSL 证书批量管理怎么做?从盘点、签发到部署的 6 个步骤
手工给几十个域名续期,问题从来不是”会不会点”,而是”点漏了没人知道”。批量管理的本质是把签发、分发、重载、到期检查这四件事从人工操作变成可重复执行的流水线。下面按 6 个步骤拆开讲,命令可直接复制。
步骤 1:先盘点,别急着装工具——怎么把散落的证书盘成一张可审计的表?
把域名逐行写进 domains.txt,用 OpenSSL 3.x 批量探测线上实际生效的证书(注意 -servername 必须带,据 OpenSSL 文档,缺失该参数时客户端不发送 SNI,多域名服务器会返回默认虚拟主机的证书,盘出来的结果就是错的):
# domains.txt 每行一个域名,不含 https://
for h in $(cat domains.txt); do
echo "=== $h"
echo | openssl s_client -servername "$h" -connect "$h:443" 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
done > inventory.txt # 输出:subject/issuer/notBefore/notAfter/SAN 五个字段
探测结果只是”事实”,还要补”归属”。建议的 CSV 列:域名,IP,CA,到期日,验证方式(HTTP-01/DNS-01),部署路径,负责人,续期方式。最后一列决定后续走 certbot 还是 acme.sh,先填后动。
步骤 2:certbot、acme.sh、cert-manager 该选哪个?
| 工具 | 版本 | 适用场景 | 通配符 | 备注 |
|---|---|---|---|---|
| certbot | 2.11.0 | 单机、≤30 张、Nginx/Apache 原生集成 | 需 DNS 插件 | 官方推荐 snap 安装 |
| acme.sh | 3.0.7 | 跨云、多 DNS 商、纯 shell 无依赖 | 原生支持 | 内置 150+ DNS API |
| cert-manager | 1.14+ | Kubernetes 集群,Ingress/Gateway 自动注入 | 支持 | CRD 方式管理 |
无论选谁,先打 staging:https://acme-staging-v02.api.letsencrypt.org/directory。据 Let’s Encrypt 文档,生产环境对”完全相同的域名集合”限 5 张/周、每注册域名 50 张/周,调试期撞上就会看到 too many certificates already issued for this exact set of domains;staging 不占用生产配额。跑通后再切 https://acme-v02.api.letsencrypt.org/directory。
步骤 3:客户端怎么装,版本怎么核对?
# Ubuntu 22.04 / certbot
sudo snap install certbot --classic
certbot --version # 期望输出:certbot 2.11.0
# acme.sh(普通用户即可,安装到 ~/.acme.sh)
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --version # 期望输出:https://github.com/acmesh-official/acme.sh v3.0.7
步骤 4:首次签发——HTTP-01 和 DNS-01 分别怎么写?
# HTTP-01:webroot 模式,不碰 Nginx 配置,--no-eff-email 跳过 EFF 订阅
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--email ops@example.com --agree-tos --no-eff-email
# DNS-01:通配符 + ECC 证书;Cloudflare Token 权限最小化为 Zone.DNS Edit + Zone.Zone Read
export CF_Token="你的API令牌"
~/.acme.sh/acme.sh --issue --dns dns_cf
-d example.com -d '*.example.com'
--keylength ec-256 --dnssleep 120
--dnssleep 120 是给权威 DNS 传播留窗口,TTL 较长的域名常因省略它报 Error, can not get the txt record。RFC 8555 要求 ACME 账户显式同意服务条款,这就是 --agree-tos 的来源。
步骤 5:证书怎么落地并平滑重载?
# Nginx 1.24:必须用 fullchain.pem,否则部分客户端报证书链不完整
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# 校验后重载,不要 restart
nginx -t && systemctl reload nginx
# Apache 2.4
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
路径写错时 Nginx 会直接拒绝启动:nginx: [emerg] cannot load certificate ... BIO_new_file() failed,所以 nginx -t 永远排在 reload 前面。
步骤 6:续期、多节点分发与到期监控怎么全自动?
# certbot:续期成功后执行 hook
certbot renew --deploy-hook 'systemctl reload nginx'
# acme.sh:把证书安装到固定路径,并绑定重载命令
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.crt
--reloadcmd 'nginx -t && systemctl reload nginx'
多台服务器用 Ansible 2.16 的 copy 分发,serial: 5 做滚动,避免全部节点同时 reload 造成抖动:
- hosts: webservers
serial: 5 # 每批 5 台,失败即停
tasks:
- name: 分发 fullchain
ansible.builtin.copy:
src: /etc/letsencrypt/live/example.com/fullchain.pem
dest: /etc/nginx/ssl/example.com.crt
owner: root
mode: "0644"
notify: reload nginx # handler 里执行 nginx -t && systemctl reload nginx
监控侧每天导出一次到期日,剩余 <21 天告警:certbot certificates 或 ~/.acme.sh/acme.sh --list,把 VALID: N days 字段推进 Prometheus textfile 或直接 grep 告警。
FAQ
- 证书续期成功但浏览器仍报旧证书?多数是只 reload 了本机、没分发到其他节点,或负载均衡器还持有旧连接;核对
openssl s_client -servername输出的notAfter是否已更新。 - 一张证书放多个域名,还是每个域名一张?同 CA、同到期、同部署路径的域名合并成一张 SAN 证书可减少续期次数,但任一名单变更都会触发重签,注意别撞 Let’s Encrypt 的”相同域名集合”限制。
- 通配符证书能覆盖
a.b.example.com吗?不能,*.example.com只匹配一级子域,多级需要单独签发或改用*.b.example.com。
批量签发与部署的命令示例:certbot 2.11、acme.sh 3.0.7 与 Nginx 1.24 怎么配?
先把结论摆出来:certbot 2.11 与 acme.sh 3.0.7 解决的是“签发与续期”,Nginx 1.24 只负责“消费证书”,真正让批量管理可用的,是把这三段用 systemd timer / cron + deploy-hook 串成一条无人值守链路。据 Let’s Encrypt 官方文档,证书有效期 90 天、官方推荐在到期前 30 天续期,因此调度频率与失败重试比“签发命令怎么写”更决定成败。
Q:certbot 2.11.0 的续期任务怎么配才不踩坑?
发行版自带的 certbot-renew.timer 默认是 OnCalendar=*-*-* 00/12:00:00 + RandomizedDelaySec=43200(每天两次、随机抖动 12 小时)。如果证书量大、想让 reload 集中在低峰,可以改成固定凌晨并缩短抖动窗口——抖动的作用是避免几百台机器同时打 ACME 接口触发速率限制(Let’s Encrypt 对同一注册域名有每周 50 张的 Duplicate Certificate 上限)。
# /etc/systemd/system/certbot-renew.service (certbot 2.11.0)
[Unit]
Description=Certbot Renewal
After=network-online.target
[Service]
Type=oneshot
# --quiet 只输出错误;--deploy-hook 仅在"本次真的续期成功"时执行,不是每次运行都 reload
ExecStart=/usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'
# /etc/systemd/system/certbot-renew.timer
[Unit]
Description=Timer for Certbot Renewal
[Timer]
OnCalendar=*-*-* 02:30:00
RandomizedDelaySec=1800
Persistent=true # 关机错过的时间点,开机后补跑一次
[Install]
WantedBy=timers.target
# 生效并立即启用
systemctl daemon-reload
systemctl enable --now certbot-renew.timer
systemctl list-timers certbot-renew.timer # 确认 NEXT 时间
certbot certificates # 查看所有证书的到期日与路径
注意 certbot 2.x 起默认密钥类型已从 RSA 2048 改为 ECDSA P-256;若要与老设备兼容需显式加 --key-type rsa。
Q:acme.sh 3.0.7 怎么装、怎么把证书“落到”Nginx 目录?
acme.sh 默认安装到 ~/.acme.sh,并用一条 cron 完成续期;批量场景建议把 home 与 config-home 都指向 /etc/acme.sh,便于 Ansible 统一分发与备份(内含 account.key 与各域名配置)。据 acme.sh 官方 wiki,--install-cert 注册的 reloadcmd 会在每次续期成功后自动执行,这是它相对 certbot 的差异点:证书搬运逻辑写在签发阶段而非独立钩子。
# 安装(3.0.7)
git clone https://github.com/acmesh-official/acme.sh.git
cd acme.sh && ./acme.sh --install -m ops@example.com
--home /etc/acme.sh --config-home /etc/acme.sh
# 续期 cron(默认每天 00:00 跑一次,实际仅在到期前 30 天才真正续)
acme.sh --cron --home /etc/acme.sh --config-home /etc/acme.sh
# 签发 ECC 证书并安装到 Nginx 路径
acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html --keylength ec-256
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.crt
--ca-file /etc/nginx/ssl/example.com.ca
--reloadcmd 'nginx -t && systemctl reload nginx'
坑点:ec-256 证书的安装目录带 _ecc 后缀,--install-cert 必须同时带 --ecc,否则会报 Error, keylength does not match 之类的错并静默复用 RSA 证书。
Q:Nginx 1.24 的 TLS 参数该抄哪一档?
直接照 Mozilla SSL Configuration Generator 的 intermediate 档即可——它在“兼容 Android 4.4+/Chrome 49+ 等老客户端”与“禁用 TLS 1.0/1.1”之间取平衡,符合 RFC 7525 与 PCI DSS 对 TLS 1.2 的最低要求。
# /etc/nginx/conf.d/ssl.conf (Nginx 1.24, openssl 3.0.13)
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
ssl_prefer_server_ciphers off; # TLS1.3 下由客户端选序,关掉更利于性能
ssl_session_cache shared:SSL:10m; # 约可缓存 40000 个会话
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
resolver 1.1.1.1 8.8.8.8 valid=300s; # OCSP 抓取需要 resolver,否则 stapling 静默失效
resolver_timeout 5s;
需要说明:Let’s Encrypt 已从 2025 年起逐步关停 OCSP 响应服务,对 LE 证书 ssl_stapling 实际不再生效,保留配置无害,但不要再把它当作合规必需项。
Q:几百台机器怎么分发?
用 Ansible 2.16 的 serial 做分批滚动,任何一批失败立即中止,避免把一张有问题的证书推满全站。
# deploy-certs.yml
- hosts: webservers
serial: 5 # 每批 5 台,失败即停
vars:
cert_src: "/etc/letsencrypt/live/{{ inventory_hostname }}/"
tasks:
- name: 分发 fullchain(公开部分,0644)
ansible.builtin.copy:
src: "{{ cert_src }}fullchain.pem"
dest: "/etc/nginx/ssl/{{ inventory_hostname }}.crt"
mode: "0644"
owner: root
- name: 分发私钥(0600)
ansible.builtin.copy:
src: "{{ cert_src }}privkey.pem"
dest: "/etc/nginx/ssl/{{ inventory_hostname }}.key"
mode: "0600"
owner: root
notify: reload nginx
handlers:
- name: reload nginx
ansible.builtin.service:
name: nginx
state: reloaded
Q:推上去之前怎么本地自检?
# OpenSSL 3.0.13
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
openssl s_client -connect example.com:443 -servername example.com -tls1_2 /dev/null | openssl x509 -noout -dates
-untrusted chain.pem 是关键:只给 -CAfile 会因缺少中间证书报 unable to get local issuer certificate,这正是“浏览器正常、Java/curl 报错”的典型成因。
Q:通配符 + DNS API 怎么配权限?
# Cloudflare Token 只授予单 Zone 的 Zone.DNS Edit(最小权限)
export CF_Token="xxxxxxxx"
export CF_Account_ID="xxxxxxxx"
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com'
--keylength ec-256 --dnssleep 120 --debug 2
# --dnssleep 默认 120s;TXT 记录 TTL 建议 120-300s,缩短传播等待
| 维度 | certbot 2.11.0 | acme.sh 3.0.7 |
|---|---|---|
| 默认密钥 | ECDSA P-256(2.0 起) | RSA 2048,需 --keylength ec-256 |
| 续期调度 | systemd timer / cron,每天两次 | cron,每天一次 |
| 部署方式 | --deploy-hook |
--install-cert --reloadcmd |
| DNS API | 需装第三方插件 | 内置 100+ dnsapi |
| 依赖 | Python | 纯 Shell,无运行时依赖 |
选型上:已有 Python 运维栈、证书走 HTTP-01 的,用 certbot + timer 最省心;需要通配符、异构发行版、单机几百域名批量签发的,acme.sh 的 --install-cert 模型更可控。
certbot、acme.sh、cert-manager 与商业平台怎么选?一张表看清
“我到底该用 certbot 还是 acme.sh?”——这个问题的答案取决于三个具体数字:证书总数、DNS 服务商数量、是否运行 Kubernetes。与其凭感觉,不如先看下面这张按 2024 年主流版本整理的对照表。
| 方案 | 适用规模 | 关键参数/命令 | 证书类型与有效期 | 主要限制 |
|---|---|---|---|---|
| certbot 2.11.0 | 1–50 张,单机或少量节点 | certbot certonly --webroot -w /var/www/html |
DV,90 天 | 依赖 80 端口,DNS 插件少 |
| acme.sh 3.0.7 | 50–5000 张,多 DNS 商 | --dns dns_cf --dnssleep 120 --keylength ec-256 |
DV,90 天 | 需保管 DNS API Token |
| cert-manager 1.14+ | Kubernetes 100+ Ingress | ClusterIssuer + Certificate CRD |
DV/私有 CA,90 天 | CRD 学习曲线 |
| 商业证书平台 | 500+ 张,OV/EV 合规 | DigiCert CertCentral、Sectigo CM | OV/EV,1–2 年 | 500–5000 元/张/年 |
| Ansible 2.16 + 脚本 | 10–500 台服务器 | serial: 5、copy、reload |
任意 | 需自建清单与回滚 |
选型阈值怎么定?证书少于 30 张且单机部署,用 certbot 2.11 最省事,一条 webroot 命令即可完成续期;30–500 张、跨 3 个以上 DNS 商,换 acme.sh 3.0.7,它内置 150+ DNS 插件,通配符证书靠 TXT 记录验证,不需要公网 80 端口;Kubernetes 集群直接上 cert-manager 1.14+,证书随 Ingress 生命周期自动创建;有 OV/EV 合规、需要审计报告时只能选商业 CA。
# acme.sh 3.0.7:Cloudflare DNS-01 签发通配符 ECDSA 证书
export CF_Token="你的Cloudflare API Token" # 建议只授权 Zone.DNS Edit
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com'
--keylength ec-256
--dnssleep 120 # 默认 0,CF 生效慢时设为 120 秒避免验证失败
# 安装证书并热重载 Nginx(--reloadcmd 每次续期后执行)
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.pem
--reloadcmd "nginx -t && systemctl reload nginx"
# cert-manager 1.14+:一个 ClusterIssuer 覆盖整个集群
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
name: letsencrypt-prod
spec:
acme:
server: https://acme-v02.api.letsencrypt.org/directory
privateKeySecretRef:
name: le-account-key
solvers:
- http01:
ingress:
ingressClassName: nginx # 必须与你的 IngressClass 一致
价格与合规成本:DV 单域名 0–50 元/年(Let’s Encrypt 免费),DV 通配符 300–1500 元/年,OV 单域名 500–2000 元/年,EV 1500–5000 元/年;商业证书管理平台通常另收 10%–20% 管理费,按张数阶梯计价。
密钥算法与双栈:RSA 2048 兼容性最好,ECDSA P-256 握手更快、包更小。Nginx 1.24 支持同时配置两组 ssl_certificate 与 ssl_certificate_key 实现 RSA/ECC 双栈,证书链必须包含中间证书,否则 Android 7 以下和部分 Java 客户端会报 unable to get local issuer certificate。
自动化接口的速率限制是批量管理最容易出错的地方。据 Let’s Encrypt 官方文档,生产目录对每个注册域名限制每周 50 张证书、完全相同的证书集每周 5 张;商业平台 API 常见 10–20 QPS 限制,批量导入 1000 张证书建议分批 100 张、间隔 30 秒。调试验证请用 staging 目录 https://acme-staging-v02.api.letsencrypt.org/directory,它的配额宽松得多,避免测试请求耗尽生产配额导致后续签发失败。
批量续期失败常见报错有哪些?真实错误信息与排查命令
在 ssl证书批量管理 的日常里,一次 certbot renew 跑几百个域名,失败项高度集中在下面六类。据 Let’s Encrypt 文档,http-01 与 dns-01 的验证失败占了绝大多数工单,按报错原文对照排查最快。
Q1:报错 “Problem binding to port 80: Could not bind to IPv4 or IPv6.” 怎么办?这是 standalone 插件抢不到 80 端口,多数是 Nginx/Apache 已监听。certbot 2.11.0 中 –http-01-port 默认值为 80。
# 找出占用 80 的进程(ss 来自 iproute2:-l 监听 -n 数字端口 -t TCP -p 显示进程)
ss -lntp | grep ':80'
# 典型输出:LISTEN 0 511 0.0.0.0:80 users:(("nginx",pid=1421,fd=6))
# 方案 A:临时让出 80,续期后恢复
systemctl stop nginx && certbot renew --cert-name example.com; systemctl start nginx
# 方案 B:换端口,并在负载均衡/反向代理上把 80 转发到 8080
certbot certonly --standalone --http-01-port 8080 -d example.com
Q2:报错 “…urn:ietf:params:acme:error:unauthorized :: The key authorization file from the server did not match”?多为 webroot 路径错、站点 301 跳 HTTPS,或 CDN 缓存了挑战文件。
curl -I http://example.com/.well-known/acme-challenge/test
# 必须看到 HTTP/1.1 200;出现 301/302 说明跳转规则覆盖了 /.well-known/
# CDN 场景需给该路径设缓存绕过,或直接改用 DNS-01:
certbot certonly --manual --preferred-challenges dns -d example.com
Q3:报错 “DNS problem: NXDOMAIN looking up A for example.com”?A/AAAA 缺失或未生效。
dig +short A example.com @1.1.1.1
dig +short AAAA example.com @8.8.8.8
# 若 TTL 为 300–600 秒,改完记录后等 5–10 分钟再重试 renew
Q4:报错 “nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed”?证书为空、非 PEM 或 fullchain 不完整。
openssl x509 -in /etc/nginx/ssl/example.com.crt -noout -subject
# 报 error:09FFF06C:PEM routines::no start line 即文件损坏或为空
cat example.com.crt intermediate.crt > fullchain.crt # 站点证书在前、中间证书在后
nginx -t
Q5:报错 “SSL_CTX_use_certificate:key values mismatch”?证书与私钥不配对,直接比公钥指纹(OpenSSL 3.x 推荐 pkey 子命令)。
# RSA
openssl x509 -noout -modulus -in cert.pem | openssl md5
openssl rsa -noout -modulus -in key.pem | openssl md5
# ECC
openssl pkey -pubout -in key.pem | openssl md5
openssl x509 -pubkey -noout -in cert.pem | openssl md5
Q6:acme.sh 报 “error, cannot resolve domain” 或 “Please refer to https://curl.se/libcurl/c/libcurl-errors.html”?DNS API Token 权限不足、超时或域名拼写错误;certbot: error: unrecognized arguments: –deploy-hook 则是客户端太旧。
certbot --version # 低于 2.11.0 请先升级,否则部分 hook 参数不识别
acme.sh --issue --dns dns_cf -d example.com --debug 2 # CF_Token 需 Zone.DNS Edit 权限
| 报错关键词 | 根因 | 首查命令 | 修复动作 |
|---|---|---|---|
| Problem binding to port 80 | 80 被 Web 服务占用 | ss -lntp | grep ‘:80’ | 停服重试或改 –http-01-port |
| key authorization … did not match | webroot 错/301/CDN 缓存 | curl -I …/acme-challenge/test | 放行路径或转 DNS-01 |
| NXDOMAIN looking up A | 解析缺失或未生效 | dig +short A @1.1.1.1 | 补记录并等 TTL 过期 |
| PEM_read_bio_X509_AUX failed | 证书为空/链不全 | openssl x509 -noout -subject | 重建 fullchain 并 nginx -t |
| key values mismatch | 证书与私钥不配对 | openssl md5 比对公钥 | 重新签发同密钥对 |
| unrecognized arguments | 客户端版本过旧 | certbot –version | 升级至 2.11.0 |
批量场景下建议把上述检查固化成续期前置脚本:先 nginx -t 与端口探测,再逐域名执行 renew,失败即写日志并触发告警——这样 ssl证书批量管理 的失败率能被压缩到个位数,而不用等证书过期才发现。
怎么确认批量证书已经生效?6 个验证命令与监控指标
证书批量签发之后,”已经续上”和”已经生效”是两件事。证书文件更新了,但 Nginx 没 reload、或者 reload 了但旧 worker 还在服务,线上仍可能拿着旧证书。下面这套验证顺序是从”线上实际握手”倒推到”本地文件”,每一步都能独立定位故障。
第一步:直接看线上握手拿到的证书内容
# 从 443 端口真实握手取证书,-servername 必须带,否则 SNI 多站点会拿到默认站点证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望输出:
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11 ← 与预期 CA 一致(R10/R11 是 LE 当前中间证书)
# notBefore=Nov 1 00:00:00 2025 GMT
# notAfter=Jan 30 23:59:59 2026 GMT ← 必须是新日期,不是旧的
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com, DNS:*.example.com
三个判据缺一不可:notAfter 是新日期(证明文件已替换)、SAN 同时含 www 与通配符(证明配置没漏域名)、issuer 与预期 CA 一致(证明没被中间代理或默认站点串证)。据 OpenSSL 3.x 文档,x509 子命令的 -ext 需要 OpenSSL 1.1.1 以上,OpenSSL 3.0 起行为稳定。
第二步:确认协议版本与 HTTP 跳转
curl -I https://example.com --tlsv1.2 --tls-max 1.2 # 期望 HTTP/1.1 200 或 301
curl -I --tlsv1.3 https://example.com # 确认 TLS 1.3 可用
curl -I http://example.com # 期望 301 Location: https://example.com/
# 若返回 200,说明明文仍在服务,证书管理等于白做
第三步:本地校验证书链完整性
# ca-certificates 路径随发行版不同:Debian/Ubuntu 为 /etc/ssl/certs/ca-certificates.crt,
# RHEL/CentOS 为 /etc/pki/tls/certs/ca-bundle.crt
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
# 期望输出:cert.pem: OK
链不完整是最常见的”浏览器能开、Java/Android 报错”根因。Nginx 需把 ssl_certificate 指向 fullchain(含中间证书),而不是单独的 cert.pem。
第四步:OCSP Stapling 是否真的在工作
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -A3 "OCSP"
# Nginx 需配置:ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate chain.pem;
# 期望:OCSP Response Status: successful (0x0)
# 若为 "no response sent",检查 resolver 8.8.8.8 是否可达
第五步:客户端清单与到期日
certbot certificates
# Certificate Name: example.com
# Expiry Date: 2026-01-30 23:59:59+00:00 (VALID: 89 days)
acme.sh --list
# Main_Domain KeyLength SAN_Domains Created Renew
# example.com ec-256 www.example.com 2025-11-01 2026-01-29
批量场景下,把这两条命令每天 09:00 落盘并做 diff,是成本最低的”未续期”探测器:
# /etc/cron.d/cert-inventory
0 9 * * * root { certbot certificates; acme.sh --list; } >> /var/log/cert-inventory.log 2>&1
# 次日对比:到期日没变 = 续期静默失败
diff <(grep 'Expiry Date' /var/log/cert-inventory.log | tail -n 20)
<(grep 'Expiry Date' /var/log/cert-inventory.log | tail -n 40 | head -n 20)
第六步:监控指标与第三方审计
| 工具/指标 | 命令或配置 | 告警阈值 |
|---|---|---|
| blackbox_exporter | probe_ssl_earliest_cert_expiry |
剩余 < 21 天(Let’s Encrypt 90 天证书) |
| 商业证书(OV/EV) | 同上 | 剩余 < 45 天,因重新验证需 1–15 天 |
| Zabbix | web.certificate.get |
与上面阈值一致 |
| testssl.sh | testssl.sh --severity HIGH example.com:443 |
出现 HIGH 及以上即阻断发布 |
| sslyze | sslyze --regular example.com:443 |
须输出 Certificate is trusted |
最后别漏日志侧证据:journalctl -u certbot-renew.service --since '24 hours ago' 看续期单元是否真的跑过,tail -f /var/log/nginx/error.log | grep SSL_do_handshake 抓握手失败——批量分发最容易出问题的正是”部分节点 reload 失败”,证书文件正确但内存里还是旧的。
FAQ
为什么 openssl 显示新证书,浏览器却还报过期? 大概率是 CDN/负载均衡层持有独立证书副本,源站更新不影响边缘节点,需要在 CDN 侧单独上传或开启其托管 ACME。
curl 返回 200 但证书校验失败怎么办? 加 curl -vI 看具体报错,SSL certificate problem: unable to get local issuer certificate 说明服务端没发中间证书,回到第三步补 fullchain。
单机 50 张以内、以 HTTP-01 为主,certbot 2.11 与 systemd 集成更直接;30 张以上、跨多个 DNS 商或需要通配符,acme.sh 3.0.7 的 DNS 插件和 –install-cert 更省事。Kubernetes 集群优先 cert-manager 1.14+,500 张以上且有 OV/EV 合规要求再考虑商业证书管理平台。
据 Let's Encrypt 文档,生产环境每个注册域名每周有 50 张证书限制,重复证书每周 5 张;批量测试应使用 staging 目录或 certbot –dry-run。1000 张以上证书建议按域名分账户、错峰续期,并把续期窗口设在到期前 30-45 天。
先执行 `nginx -T | grep ssl_certificate` 确认配置路径指向 live 目录,再执行 `systemctl reload nginx`;reload 不中断连接,restart 才中断。若日期仍旧,检查 certbot 是否配置 `–deploy-hook 'systemctl reload nginx'`,以及 acme.sh 的 `–reloadcmd` 是否执行成功。
该报错表示 HTTP-01 挑战文件校验失败,常见原因是 80 端口未放行、站点 301 到 HTTPS、webroot 路径不对或 CDN 缓存。用 `curl -I http://example.com/.well-known/acme-challenge/test` 确认返回 200,不要 301/302;CDN 场景改用 DNS-01。
不能。通配符证书必须用 DNS-01,ACME 会要求添加 `_acme-challenge.example.com` 的 TXT 记录;acme.sh 可用 `–dns dns_cf –dnssleep 120`,certbot 需安装对应 DNS 插件。TXT 记录 TTL 建议 120-300 秒,传播慢时增加等待时间。
可以,DigiCert CertCentral、Sectigo Certificate Manager 等平台提供批量导入、API 续期和到期提醒;OV 单域名常见 500-2000 元/年,EV 1500-5000 元/年,有效期 1-2 年。OV/EV 续期需要重新做组织验证,通常预留 1-15 天,不宜等到期前一周才处理。
私钥统一 root 所有、权限 600,不要提交到 Git;Ansible 分发时用 ansible-vault 加密私钥文件,playbook 设置 `serial: 5` 做滚动更新。高价值域名可每台节点单独签发证书,离职交接时轮换私钥,EV 证书可考虑 HSM 或 CA 提供的密钥托管。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。