跳到主要内容
基础知识

SSL证书批量管理怎么做?清单盘点、ACME自动签发与多节点分发实操(OpenSSL 3.x/certbot 2.x)

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

内容审核

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