跳到主要内容
基础知识

SSL 证书有哪些注意事项?从申请、部署到续期的 8 步运维清单(2025 版)

SSL证书注意事项 — SSL 证书有哪些注意事项?从申请、部署到续期的 8 步运维清单(2025 版)
核心结论

SSL 证书的核心注意事项集中在有效期管理、私钥保护、域名覆盖与信任链完整这四件事上;据 CA/Browser Forum Baseline Requirements(SC-081 提案),2026-03-15 起公开信任 TLS 证书最长有效期由 398 天降至 200 天,2027-03-15 起降至 100 天,续期频率将翻倍。 服务器必须下发叶子证书与中间证书两级,根证书不下发;用 openssl s_client -showcerts 数返回张数,少于 2 张即判定为链不完整。 Let's Encrypt 每注册域名每周限发 50 张、同一组域名重复证书每周限 5 张、验证失败每小时限 5 次,CI 调试务必加 --dry-run 或指向 acme-staging-v02。 certbot 的 --deploy-hook 只在真正续期成功时触发,配合 openssl x509 -checkend 2592000 做剩余 30 天告警,可覆盖“续期成功但服务未 reload”的静默故障。

为什么证书“装上了”仍然会出事?6 个高频根因

“证书装上了、浏览器出现绿锁”只是验收的第一步。线上 HTTPS 事故里,真正因为签发失败导致的极少,绝大多数是签发之后没人管。下面 6 个根因覆盖了 2025 年最常见的翻车场景,每条都给出可直接执行的排查命令。

1. 有效期管理失控——HTTPS 事故的头号原因

到期未续长期占据 HTTPS 线上事故首位。据 CA/Browser Forum《Baseline Requirements》的 SC-081 提案,公开信任 TLS 证书的最长有效期将分阶段缩短:

生效日期 单张证书最长有效期 对运维流程的影响
当前(2025) 398 天 一年一续,人工日历提醒尚可勉强应付
2026-03-15 起 200 天 一年至少续 2 次,必须自动化
2027-03-15 起 100 天 约每 3 个月一次,纯手工流程不可行
# 查看证书到期时间
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -enddate
# 剩余不足 30 天(2592000 秒)时返回非 0,可直接写进监控脚本
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -checkend 2592000 
  || echo "证书将在 30 天内过期"

2. 私钥保护缺位:文件权限与“删了就完事”的误区

私钥文件权限应为 600,属主为 root 或专用服务账号(如 www-data);Web 服务器进程只需读权限,不需要写权限。据 OpenSSL 文档,-check 参数会校验 RSA 密钥的数学一致性:

chmod 600 /etc/ssl/private/example.com.key   # 仅属主可读写
chown root:root /etc/ssl/private/example.com.key
openssl rsa -in key.pem -check -noout        # 输出 "RSA key ok",否则密钥已损坏
# 确认私钥与证书配对(两行 MD5 必须一致)
openssl x509 -in cert.pem -noout -pubkey | openssl md5
openssl pkey -in key.pem -pubout | openssl md5

私钥一旦进入 Git 历史、Docker 镜像层或备份快照,正确做法是吊销并重签,而不是删掉文件了事——Git 历史、镜像分层缓存、对象存储版本控制都会保留副本。

3. 域名覆盖不全:通配符的边界常被误解

一张证书的 SAN 列表必须覆盖所有实际被访问的主机名。通配符只匹配一级子域,这是漏配最集中的地方:

证书 SAN example.com www.example.com a.b.example.com
*.example.com ❌ 不匹配 ✅ 匹配 ❌ 不匹配
example.com + *.example.com ✅ ✅ ❌

4. 信任链不完整:桌面浏览器会“骗”你

服务器需要下发“叶子证书 + 中间证书”,根证书不要下发(客户端自带)。缺中间证书时,桌面 Chrome 可能靠缓存补齐而显示正常,但 Android、Java 客户端与 curl 会直接握手失败。典型报错:

curl: (60) SSL certificate problem: unable to get local issuer certificate
sun.security.validator.ValidatorException: PKIX path building failed

# 查看服务端实际下发的证书链(应看到叶子 + 中间,不含根)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

5. 协议与套件过旧

TLS 1.0/1.1 已被 RFC 8996 列为不可用,主流浏览器自 2020 年起停止支持;应至少启用 TLS 1.2,优先 TLS 1.3(RFC 8446),并关闭 RC4、3DES 与 CBC 类弱套件。配置可直接参考 Mozilla SSL Configuration Generator 的 intermediate 档位。验证命令:

# 若仍可协商 TLS 1.1,说明配置过旧(预期输出 handshake failure / no protocols available)
openssl s_client -connect example.com:443 -tls1_1 </dev/null

6. 吊销机制变了:别把 OCSP Stapling 当必选项

据 CA/Browser Forum 的 OCSP 弃用安排,2025-05-15 之后签发的多数公共 TLS 证书不再包含 OCSP URL,CRL 与“短有效期”成为主要吊销手段。硬性要求开启 OCSP Stapling 的旧监控项应当改为检查 CRL 可达性与证书剩余有效期。

一份可执行的 SSL 证书注意事项清单:申请到续期的 8 个步骤

把 SSL 证书注意事项写成清单,比写成“最佳实践”更有用——因为真正出问题的往往不是加密算法,而是漏掉一个子域、CAA 记录挡住签发、续期成功却忘了 reload。下面这份 8 步清单按真实运维顺序排列,每一步都给出可直接执行的命令。

  1. 盘点域名:三处交叉核对,别让 SAN 变成加价项。只从 Nginx 的 server_name 里数域名一定会漏。要同时核对 Nginx 配置、CDN 回源域名、DNS 的 CNAME 记录,列出裸域、www、api、静态资源域,以及所有测试子域(staging、test 常常被人遗忘却暴露在公网)。商业 OV 证书一般含 1 个主域 + 若干 SAN,超出部分按 100–500 元/个加价,盘点清楚能省下不必要的采购。

    # Nginx 侧:导出全部 server_name(-T 会打印含 include 的完整配置)
    nginx -T 2>/dev/null | grep -E '^s*server_name' | tr ';' 'n' | sort -u
    
    # DNS 侧:逐条确认 CNAME 指向,避免漏掉 CDN 回源子域
    dig +short cdn.example.com CNAME
    dig +short api.example.com A
  2. 选密钥算法:新项目 ECDSA P-256,兼容性优先用 RSA 3072。RSA 2048 是当前下限,1024 位已被主流 CA 拒绝签发(Let’s Encrypt 自 2015 年起即不接受)。据 Mozilla SSL Configuration Generator 的推荐配置,现代兼容档位已默认优先 ECDSA 套件。

    算法 握手与 CPU 开销 客户端兼容性 建议场景
    ECDSA P-256 签名短,握手最快 Windows 7+、Android 4.4+ 新项目首选
    RSA 3072 约为 2048 位的 3 倍 全兼容 存量老旧终端多
    RSA 2048 低 全兼容 过渡期下限
    RSA 1024 低 — CA 已拒签,勿用
    # 生成 ECDSA P-256 私钥(等效于 prime256v1 / secp256r1)
    openssl ecparam -genkey -name prime256v1 -out key.pem
  3. 生成 CSR 并离线保管私钥。RFC 6125 之后身份校验以 SAN 为准,CN 已非必填,但多数 CA 后台仍要求填写。私钥生成后立即移出 Web 服务器目录并设 chmod 600,CSR 可公开传输、私钥绝不能。

    openssl req -new -newkey rsa:3072 -nodes 
      -keyout example.com.key -out example.com.csr 
      -subj "/CN=example.com" 
      -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
    # -nodes 表示私钥不加密,便于服务自动加载;若加密码需每次启动手输
    chmod 600 example.com.key
  4. 完成域名验证。DV 走 HTTP-01(要求 80 端口可访问 /.well-known/acme-challenge/)或 DNS-01(添加 _acme-challenge 的 TXT 记录,TTL 建议 60 秒,便于验证后快速清理,也避免旧值缓存导致重复失败)。OV/EV 还需营业执照与电话回拨,审核通常 1–3 个工作日,跨境企业可能延到 5 天,排期时要留出余量。

  5. 检查 CAA 记录——这是最容易被忽略的签发阻断点。据 RFC 8659,若域已存在 CAA 记录而 issue 字段未包含所用 CA,签发请求会被直接拒绝,报错通常形如 CAA record for example.com prevents issuance。

    dig +short CAA example.com
    # 若返回为空或未包含你的 CA,补一条放行记录:
    # example.com.  CAA  0 issue "letsencrypt.org"
  6. 部署证书链:叶子在前、中间在后,根证书不放。Nginx 的 ssl_certificate 指向合并后的 fullchain.pem;Apache 2.4.8 起可用 SSLCertificateFile 放叶子、SSLCertificateChainFile 放中间证书,也可直接合并进 SSLCertificateFile(2.4.8 之前必须分开写)。

    # 合并顺序错误会导致部分客户端(尤其 Android)报证书链不完整
    cat example.com.crt intermediate.crt > fullchain.pem
    
    # 验证链是否完整:输出应以中间证书结尾,且末尾打印 "Verify return code: 0 (ok)"
    openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
  7. 配置协议与 HSTS,分两步走。先下发 Strict-Transport-Security: max-age=300 观察一周,确认无混合内容报错后再加到 31536000。开启 includeSubDomains 前必须确认所有子域都已启用 HTTPS;preload 一旦进入浏览器预加载列表,撤回需要数月,务必最后再加。

    # Nginx 片段:先短周期观察
    add_header Strict-Transport-Security "max-age=300" always;
    # 稳定一周后替换为:
    # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
  8. 建立续期与监控。Let’s Encrypt 证书有效期 90 天,官方建议到期前 30 天续期(certbot 默认在剩余 30 天内触发);商业证书 1 年期,提前 60 天触发采购流程。外部黑盒到期监控必须独立于续期系统部署——“续期成功但服务没 reload”是最典型的静默故障。

    # 干跑验证续期链路是否通(certbot 2.x)
    certbot renew --dry-run
    # 续期后必须 reload,否则 Nginx 仍持有旧证书
    certbot renew --deploy-hook "systemctl reload nginx"

问:为什么 certbot renew 显示成功,浏览器却仍报证书过期?因为续期只更新磁盘文件,进程内存中的证书要等 reload/restart 才生效。用 openssl s_client -connect 域名:443 2>/dev/null | openssl x509 -noout -dates 读取“线上实际生效”的到期时间,与磁盘文件对比,两者不一致即说明 reload 环节缺失。

具体命令与配置示例:OpenSSL 3.2 + Nginx 1.26 + certbot 2.11 怎么写

拿到 fullchain.pem 之后,光看浏览器的小锁说明不了什么——浏览器会自动补齐中间证书、会缓存 OCSP 结果,也不会告诉你私钥是否配错。下面这套命令覆盖了 SSL 证书注意事项里最容易出问题的三件事:有效期时区、密钥配对、链完整性,再给出 Nginx 1.26 与两个 ACME 客户端的可复制配置。OpenSSL 3.2 与 1.1.1 在下面这些 x509 子命令上行为一致,可直接套用。

第一步:先看清有效期和 SAN,别被 UTC 时区误导。

# OpenSSL 3.2 / 1.1.1 通用:一次打印有效期、主体、SAN 扩展
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem 
  -noout -dates -subject -ext subjectAltName

# 输出示例(注意结尾的 GMT):
# notBefore=Mar  1 00:00:00 2025 GMT
# notAfter=May 30 23:59:59 2025 GMT
# subject=CN = example.com
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com

# 推荐:用 -checkend 直接按剩余秒数判断,彻底绕开时区换算
# 剩余不足 1209600 秒(14 天)时返回码为 1,可直接进监控脚本
openssl x509 -checkend 1209600 -noout -in /etc/letsencrypt/live/example.com/fullchain.pem 
  && echo "OK: 剩余 > 14 天" || echo "WARN: 该续期了"

RFC 5280 规定证书时间字段一律用 UTC 表示,所以 notAfter 里的 23:59:59 GMT 对应北京时间次日 07:59:59。很多人把阈值写成“到期前一天”却按本地时间解析,结果监控提前或滞后整整一天。用 -checkend 或 epoch 比较就没有这个问题。

第二步:确认证书与私钥配对。

# RSA 私钥:两行输出的 md5 必须完全一致
openssl x509 -noout -modulus -in cert.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem | openssl md5

# OpenSSL 3.x 推荐做法:比对 SPKI 公钥指纹,RSA / ECDSA 私钥都通用
openssl x509 -in cert.pem -pubkey -noout 
  | openssl pkey -pubin -outform der | openssl sha256
openssl pkey -in privkey.pem -pubout -outform der | openssl sha256

两行 sha256 不一致就说明证书和私钥不是一对,Nginx 启动时会直接报 SSL_CTX_use_PrivateKey_file() failed (SSL: error:0A00018A:SSL routines::dh key too small) 之外的 key values mismatch,与其在 reload 时才发现,不如部署前就比对。

第三步:验证服务端下发的链是否完整。

# -servername 不能省,否则 SNI 不生效,拿到的是 default_server 的证书
openssl s_client -connect example.com:443 -servername example.com 
  -verify_hostname example.com -showcerts </dev/null 2>/dev/null 
  | openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
# 期望输出:stdin: OK

# 典型的链不完整报错(漏装中间证书时):
# error 20 at 0 depth lookup: unable to get local issuer certificate
# error stdin: verification failed

只加 -showcerts 而不加 -servername 时,若该 IP 的默认站点是另一个域名,你验的其实是别人的证书,结果照样 OK——这就是“链完整 ≠ 验对了域名”的典型陷阱,所以 -verify_hostname 也要一起给。

第四步:Nginx 1.26 的 TLS 片段。下面这组参数可直接以 Mozilla SSL Configuration Generator 5.7 的 intermediate 档为基线:

# /etc/nginx/conf.d/ssl.conf,放在 http{} 或 server{} 内
ssl_protocols TLSv1.2 TLSv1.3;   # Nginx 1.23.4 起默认已是 TLSv1.2 TLSv1.3,显式写便于审计
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;    # 默认 off;对 TLSv1.3 无效,套件顺序由 OpenSSL 决定
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约容纳 40000 个会话
ssl_session_timeout 1d;           # 默认 5m
ssl_stapling on;                  # 默认 off
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/chain.pem;  # 中间证书链(不含叶证书),供 OCSP 校验用

第五步:续期演练。据 Let’s Encrypt 速率限制文档,同一注册域名每周最多签发 50 张证书,别拿生产环境反复试。

# certbot 2.11.x:--dry-run 走 staging 环境、不写盘、不消耗生产速率限制,
# 同时验证 --deploy-hook 的命令能否正常执行
certbot renew --dry-run --deploy-hook "systemctl reload nginx"

# 确认无误后查看发行版自带的定时任务(Debian/Ubuntu 包默认装 systemd timer)
systemctl list-timers | grep certbot

# 正式续期:--deploy-hook 只在真正续期成功时执行,避免空跑 reload
certbot renew --quiet --deploy-hook "systemctl reload nginx"

第六步:acme.sh 3.0.x 的等价写法。

# 签发:webroot 模式 + ECC 证书(--keylength ec-256 表示后续安装要带 --ecc)
acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html --keylength ec-256

# 安装并绑定 reload 命令,acme.sh 会自动写入续期 cronjob
acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      "systemctl reload nginx"

# --install-cronjob 写入的默认条目(首次安装 acme.sh 时通常已自动写好)
17 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

两个客户端的差异决定了运维脚本怎么写,选型时可直接对照下表:

对比项 certbot 2.11.x acme.sh 3.0.x
默认 CA Let’s Encrypt(--server 可切换) ZeroSSL(需 --server letsencrypt 切回 LE)
运行依赖 Python 3 + 发行版包 纯 shell,无外部依赖
默认密钥类型 RSA 2048(2.x 支持 --key-type ecdsa) ec-256(由 --keylength 指定)
定时任务 systemd timer 或 /etc/cron.d/certbot 自带 17 0 * * * cron 条目
续期后重载 --deploy-hook --reloadcmd
演练方式 renew --dry-run(staging) --issue --staging

把这几条串起来,就是一条可自动化的部署前检查链:-checkend 判到期、公钥指纹判配对、s_client + verify 判链完整、renew --dry-run 判续期通道畅通。任一步返回非零,就不要 reload Nginx——这正是 SSL 证书注意事项里最值得写进 CI 的部分。

参数对比表:DV/OV/EV、RSA/ECDSA、ACME 与商业证书怎么选

选型阶段最容易踩的坑,是把”证书类型”当成”加密强度”来选。事实是:DV、OV、EV 使用完全相同的公钥算法与 TLS 握手流程(RFC 8446),浏览器地址栏的锁图标一模一样,差别只在身份背书与保险额度。这也是 SSL 证书注意事项里最常被销售话术混淆的一条。据 CA/Browser Forum Baseline Requirements,EV 证书自 Chrome 77(2019 年)起已不再显示绿色公司名,仅为 OV/EV 保留证书信息面板——所以面向公众的站点,DV 加自动化续期往往比 EV 更划算。

维度 DV OV EV
验证内容 仅域名控制权(HTTP-01 / DNS-01) + 工商注册信息、电话回拨核验 + 人工合规审查、法律主体确认
签发时长 1-10 分钟 1-3 个工作日 2-5 个工作日
参考价格 0-300 元/年 800-3000 元/年 2000-8000 元/年
保险额度 10 万美元级 50 万-100 万美元 最高 175 万美元
加密强度 三者完全相同:同为 RSA 2048/4096 或 ECDSA P-256 公钥体系,TLS 1.2/1.3 握手参数一致

密钥算法:RSA 还是 ECDSA?证书体积和握手开销差 3 倍以上,但兼容性有硬门槛。用下面命令查看线上证书实际用的是哪种:

# 读取服务端证书主体、有效期与 SAN 列表(OpenSSL 1.1.1+ / 3.x 通用)
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -text | grep -E "Public Key Algorithm|Signature Algorithm|DNS:"
# 输出示例:Public Key Algorithm: id-ecPublicKey  → 即 ECDSA 证书
指标 RSA 2048 ECDSA P-256
证书体积 约 1.5-2 KB 约 0.6-0.8 KB(≈1/3)
握手耗时 基准 1× 约 1/3-1/5
不支持的客户端 无 Android 7 以下、Windows XP、老版本 Java(< 8u161)

客户端分布复杂时不要二选一,Nginx 1.11.0 起支持同时加载两张证书并按客户端 cipher 能力自动择优:

server {
    listen 443 ssl;
    # RSA 证书对(老客户端兜底)
    ssl_certificate     /etc/nginx/certs/fullchain.rsa.pem;
    ssl_certificate_key /etc/nginx/certs/privkey.rsa.pem;
    # ECDSA 证书对(现代客户端优先命中,Nginx 自动选择)
    ssl_certificate     /etc/nginx/certs/fullchain.ecdsa.pem;
    ssl_certificate_key /etc/nginx/certs/privkey.ecdsa.pem;
    ssl_protocols TLSv1.2 TLSv1.3;   # 默认值 TLSv1.2;TLSv1.0/1.1 建议显式关闭
}

覆盖方式:单域名证书的 SAN 固定为 1 条;多域名证书(UCC)默认含 3-5 个 SAN,超出部分按 100-500 元/个加购;通配符证书价格约为同品牌单域名的 3-5 倍,只覆盖 *.example.com 一级子域,不含裸域。裸域必须单独写进 SAN,否则 https://example.com 直接报 NET::ERR_CERT_COMMON_NAME_INVALID:

# acme.sh ≥ 3.0:通配符走 DNS-01,-d example.com 必须显式追加,否则裸域不在 SAN 内
acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali

签发渠道:Let’s Encrypt / ZeroSSL 免费、固定 90 天有效期、全自动,据 Let’s Encrypt 官方文档,2025 年起还将提供 6 天短期证书档位;商业 DV 为 1 年期,卖点是人工支持与保险。内网或私有域名(如 *.corp.local)不要向公共 CA 申请,应使用 step-ca(≥ 0.25)、cfssl 或 Windows AD CS 自建 CA,成本是工时而非证书费。用 ACME 自动续期时,失败原因八成集中在两处:HTTP-01 要求 80 端口对公网可达,以及 DNS API Token 权限过期。

# 续期后必须 reload,漏掉这一步是"续期成功但浏览器仍报过期"的头号原因
acme.sh --install-cert -d example.com 
  --key-file       /etc/nginx/certs/privkey.pem 
  --fullchain-file /etc/nginx/certs/fullchain.pem 
  --reloadcmd      "systemctl reload nginx"   # 关键行:证书落盘后自动热加载

商业证书则需人工上传 CSR,单次平均耗时 30-60 分钟,且同样最容易漏掉 reload。把上面这条 --reloadcmd 写进定时任务,比事后人工巡检可靠得多。

常见错误与排查:这 8 条真实报错分别对应什么问题

下面这 8 条报错基本覆盖了 SSL 证书注意事项中最容易出问题的环节,按「证书链 → 私钥配对 → 有效期 → 签发配额 → CAA 授权 → 文件格式 → 客户端信任库 → 页面资源」排列。经验上,前 3 条占线上 HTTPS 事故的多数,且都能在 30 秒内用一条命令定位。

  1. curl: (60) SSL certificate problem: unable to get local issuer certificate——服务器只下发了叶子证书,没带中间证书;或 Nginx 的 ssl_trusted_certificate 指向了错误路径(该指令只用于 OCSP stapling 校验,不参与握手下发,配错不会报错但会掩盖问题)。数一下服务器实际发送的张数,正常应为 2–3 张:
# 统计服务器下发的证书张数;返回 1 说明缺中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c "BEGIN CERTIFICATE"

# 修复:Nginx 中 ssl_certificate 必须指向 fullchain.pem(叶子+中间),而非 cert.pem
# ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
nginx -t && systemctl reload nginx
  1. SSL_CTX_use_PrivateKey: key values mismatch(Nginx 启动失败)——证书与私钥不配对,高发于续期后只换了 .crt 没换 .key,或通配符证书误配单域名私钥。注意 Certbot 2.0 起默认签发 ECDSA P-256 密钥,此时 -modulus 无效,必须比对公钥:
# RSA 证书用 modulus 比对;ECDSA 证书改用 -pubkey(两种取 md5 后应完全一致)
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubkey -noout -in privkey.pem  | openssl md5
  1. NET::ERR_CERT_DATE_INVALID / SSL_ERROR_EXPIRED_CERT_ALERT——证书过期,或服务器时钟漂移(容器未同步 NTP 时最常见,表现为证书「尚未生效」)。先比时间,再查时钟:
date -u                                   # 与下面 notBefore/notAfter 对比
openssl x509 -noout -dates -in fullchain.pem
timedatectl status                        # 或 chronyc tracking,确认 NTP 同步状态
  1. too many certificates already issued for exact set of domains——触发 Let’s Encrypt 的「同一组域名每周 5 张重复证书」限制(另有每注册域每周 50 张上限,见 Let’s Encrypt Rate Limits 文档)。调试一律走 staging,或用 --dry-run(Certbot 内部即切换至 staging):
certbot renew --dry-run
# 或显式指定 ACME 服务端(RFC 8555 定义的 directory 资源)
certbot certonly --server https://acme-staging-v02.api.letsencrypt.org/directory 
  -d example.com -d www.example.com
  1. urn:ietf:params:acme:error:caa——CAA 记录(RFC 8659)不允许当前 CA 签发。注意通配符证书校验的是 issuewild 而非 issue:
dig +short CAA example.com
# 放行 Let's Encrypt(TTL 到期后重试,建议 TTL ≤ 300)
# example.com. CAA 0 issue "letsencrypt.org"
# example.com. CAA 0 issuewild "letsencrypt.org"
  1. nginx: [emerg] PEM_read_bio_X509_AUX() failed——文件不是 PEM,或证书链顺序颠倒。典型是把 PKCS#7 的 .p7b 直接当 PEM 用,需先转换:
openssl pkcs7 -print_certs -in cert.p7b -out cert.pem   # 输出为 PEM,含主题与签发者行
head -1 cert.pem                                       # 应为 -----BEGIN CERTIFICATE-----
  1. Java 客户端 PKIX path building failed——服务端缺中间证书,或 JDK 不读系统信任库(JDK 自带 cacerts)。确认根证书在库中,必要时显式指定:
keytool -list -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit | grep -i "digicert|isrg"
java -Djavax.net.ssl.trustStore=/etc/pki/java/cacerts -jar app.jar
  1. Mixed Content: … requested an insecure resource——页面硬编码了 http:// 的图片、脚本或接口。可先用 CSP 过渡止血,再逐项替换源地址(长期方案是 HSTS + 全站相对协议 URL):
# Nginx 中临时过渡(CSP Level 3 指令,主流浏览器均支持)
add_header Content-Security-Policy "upgrade-insecure-requests" always;

排查顺序建议固定为:先 openssl s_client 看链,再比对公钥,再看 -dates,最后才怀疑 CA 侧配额与策略。据 Mozilla Server Side TLS 指南,链完整性与有效期是评级中最先被扣分的两项,也正是上面第 1、3 条。

部署完不等于生效,浏览器不报错也不等于配置合规——很多问题只在特定协议版本、特定客户端或证书链缺失时才暴露。下面 6 个动作可以在 10 分钟内把「看起来没问题」变成「验证过没问题」。工具版本以 OpenSSL 3.0+、curl 8.x、testssl.sh 3.2 为准。

1)协议握手:TLS 1.3 必须通,TLS 1.1 必须死。RFC 8446 定义 TLS 1.3,而 TLS 1.0/1.1 已被 RFC 8996 正式弃用,PCI DSS 与主流合规审计均要求关闭。

# 期望通过:Protocol 为 TLSv1.3,且 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null

# 期望失败:握手被拒(good 配置的典型报错)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 若服务端已禁用:alert protocol version / handshake failure
# 若客户端本身禁用(OpenSSL 3.x 默认 SECLEVEL=2):no protocols available
# 想强制测试旧协议需显式降级:openssl s_client -tls1_1 -cipher 'DEFAULT@SECLEVEL=0' ...

2)证书链:服务端要下发中间证书。漏发中间证书时桌面浏览器常靠 AIA 自动补链「自愈」,而 Java、Android 老版本、curl 会直接失败。

# 方式一:让 curl 报告校验结论
curl -vI https://example.com 2>&1 | grep -i "SSL certificate verify"
# 通过时输出:SSL certificate verify ok.

# 方式二:抽出服务端下发的整条链做离线校验
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null > /tmp/s.out
openssl verify -untrusted /tmp/chain.pem /tmp/cert.pem   # 期望:OK

3)多客户端抽样:跑 testssl.sh。单点 curl 只覆盖一条路径,testssl.sh 覆盖 200 多项检查(协议、密码套件、漏洞、头部、证书),并支持 JSON 便于接 CI。

./testssl.sh --severity HIGH --jsonfile /tmp/report.json https://example.com
# 退出码 0 = 无 HIGH 及以上问题;1 = 存在问题,适合卡在发布流水线里

注意:SSL Labs 拿 A/A+ 只代表该主机名单点合规,不代表 www、api、静态资源等所有业务域名都已覆盖——按域名清单逐个跑一遍。

4)HSTS:核对三个字段,别只看有没有。RFC 6797 规定 HSTS 语义,preload 列表另有硬性门槛。

curl -sI https://example.com | grep -i strict-transport-security
# 合格示例(preload 要求 max-age ≥ 31536000 且含 includeSubDomains)
# strict-transport-security: max-age=31536000; includeSubDomains; preload

据 hstspreload.org 说明,提交 preload 后需等待 Chrome 版本更新才真正生效,通常 6–12 周;且一旦进入列表,回滚同样要等发布周期,误提交子域会连带影响所有子域名。

5)吊销状态:OCSP 查不到就查 CRL。

openssl ocsp -issuer chain.pem -cert cert.pem 
  -url http://ocsp.example-ca.com -resp_text
# 期望:Cert Status: good;失败会显示 revoked 或 Response Verify Failure

据 Let’s Encrypt 公告,其 OCSP 服务已停止提供响应,全面转向 CRL——这类 CA 请改用证书里的 CRL 分发点:openssl x509 -in cert.pem -noout -text | grep -A1 "CRL Distribution"。

6)CT 日志:公开证书至少 2 个 SCT。RFC 6962 定义证书透明度,Chrome 要求公开信任证书携带 SCT。

openssl x509 -in cert.pem -noout -text | grep -A2 "CT Precertificate SCTs"

私有 CA 或自签证书没有 SCT 属正常,但这类证书不要用在对外服务上。

检查项 命令/工具 通过标准 失败最常见原因
协议版本 openssl s_client -tls1_3 / -tls1_1 1.3 通过、1.1 失败 负载均衡与源站配置不一致
证书链 curl -vI、openssl verify verify ok 未下发中间证书
综合扫描 testssl.sh 3.2 无 HIGH 及以上 弱套件、RC4、CBC 优先
HSTS curl -sI max-age≥31536000 + 两字段 只加在应用层、CDN 未同步
吊销状态 openssl ocsp / CRL good CA 已弃用 OCSP
CT 日志 openssl x509 -text ≥2 个 SCT 用了私有 CA 签发对外证书

想进一步加固套件与参数,可对照 Mozilla SSL Configuration Generator(Intermediate/Modern 两档)和 SSL Labs 评分细则,把上面的命令串成一条 CI 任务,每次续期后自动重跑。

续期自动化与到期监控还有哪些注意点?5 条容易漏的细节

续期失败往往不是因为 certbot 不会跑,而是因为你以为它在跑。下面 5 个细节是 2025 年最常被漏掉的。

1. systemd timer 触发了,不代表证书续了。certbot 的打包版本(如 Ubuntu 22.04/24.04 的 certbot 2.x)默认安装 certbot.timer,每天触发两次,但 renewal 配置里只有当剩余有效期不足 30 天时才真正申请。先确认它活着:

# 查看 timer 是否启用及下次/上次触发时间
systemctl list-timers | grep certbot

# 试运行,验证所有 lineage 的续期逻辑(不实际下单)
certbot renew --dry-run

# 查看某个证书的续期配置与到期时间
certbot certificates

注意 --dry-run 走的是 staging 环境,成功只证明 ACME 流程通,不证明生产配额够用。真正可靠的是“部署钩子 + 外部告警”双保险:--deploy-hook 在证书真正更新后才执行(对比 --post-hook 每次 renew 都跑),适合放 reload 命令。据 Let’s Encrypt 文档,官方推荐用 deploy hook 而非 post hook 做服务重载。

# /etc/letsencrypt/renewal/example.com.conf 中追加
renew_hook = systemctl reload nginx   # 仅在新证书落盘后触发

2. 用 openssl 做独立探针,别只信 certbot 自己的日志。下面这条命令返回 “Certificate will expire” 表示剩余不足 30 天(2592000 秒),可直接塞进 Zabbix 用户参数或 Prometheus 的 blackbox exporter 脚本:

# 探测真实对外证书的剩余有效期;-servername 保证 SNI 命中正确站点
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -checkend 2592000

3. 速率限制会打爆 CI。Let’s Encrypt 现行限制:每个注册域名每周 50 张证书、同一组域名重复证书每周 5 张、验证失败每小时 5 次。流水线里务必固定 staging:

# CI 中一律加 --staging,避免循环重试耗尽生产配额
certbot certonly --staging -d example.com --webroot -w /var/www/html
续期方式 触发条件 失败可见性 适用场景
certbot.timer(默认) 每天 2 次,剩余 <30 天 仅本地日志 单机常规站点
deploy-hook 证书实际更新后 需自建通知 需要 reload 服务
外部 openssl 探针 剩余天数阈值 接入监控告警 所有生产域名
商业 OV 证书 人工采购,60 天触发 邮件+工单 金融/跨境业务

4. 商业证书的提前量要按“审核最坏情况”算。OV 审核通常 1–3 个工作日,跨境企业电话回拨可能拖到 5 天,营业执照变更时更久。把 60 天设为采购触发点,而不是 7 天。

5. 密钥轮换与公钥固定。certbot 默认每次续期生成新私钥,泄露影响面更小;若下游系统(如部分 IoT 固件)必须固定公钥,可加 --reuse-key,但要评估私钥泄露后的横向风险。HPKP 已于 Chrome 69 移除,不必再为公钥固定做额外设计——这也是 SSL 证书注意事项里最容易沿用过时资料的一条。

合规与团队协作:证书台账应该记哪些字段?

问:证书台账只记域名和到期时间,够用吗?

不够。到期时间只回答“什么时候续”,回答不了“续哪张、装在哪台机器、谁负责”。一张证书从签发到吊销,可变维度至少有签发 CA、验证类型、SAN 集合、密钥算法与长度、部署节点数。字段缺失最典型的后果是人员交接后“没人知道这张证书在哪台机器上”——这是 SSL 证书注意事项 里排查成本最高、却最常被跳过的一项。台账建议按下表 10 个字段固化:

字段 示例值 为什么必须记
主域名 api.example.com 续期与告警的主键
SAN 列表 api.example.com, www.example.com 漏记会导致续期后部分域名掉线
签发 CA Let’s Encrypt / DigiCert 决定续期方式与吊销通道
验证类型 DV / OV / EV 合规审计与品牌展示需求
签发 / 到期日期 2025-03-01 / 2025-05-30 公共证书有效期上限 398 天(CA/B Forum SC-081 起逐步缩短)
密钥算法与长度 ECDSA P-256 / RSA 2048 Mozilla 服务器安全指南要求 RSA ≥2048 位或 ECDSA P-256
部署节点清单 LB-01、10.0.1.21:443 换证时逐台核对,避免漏刷
续期方式 ACME 自动 / 手工上传 决定是否配 cron 与 reload 钩子
私钥存放位置 /etc/ssl/private/(600) 泄露时第一时间定位
负责人 / 备份人 张三 / 李四 交接不断档

问:台账记全了,怎么反查证书到底装在哪几台机器?

台账是“声明”,必须与实际部署定期比对。逐个节点抓取线上证书序列号与台账核对(OpenSSL 3.x,1.1.1 同样适用):

# 抓取指定节点的证书序列号、主体与有效期,与台账逐条比对
for h in 10.0.1.21 10.0.1.22; do
  echo "== $h =="
  openssl s_client -connect "$h":443 -servername api.example.com /dev/null 
    | openssl x509 -noout -serial -subject -dates
done
# 序列号与台账不一致 = 有人手工换证却没更新台账

这类“影子证书”只能靠变更留痕兜住:每次替换证书记录变更单号、操作人、reload 时间与验证结果,故障复盘时才能把时间线与监控曲线对齐。

问:内部域名用公共 CA 的免费证书,有什么副作用?

有,而且不可逆。公开信任的证书会被写入 Certificate Transparency 日志(RFC 6962),等于把完整域名清单对外公开,攻击者据此可枚举内网资产。用 crt.sh 一条命令即可验证:

# 查询某域名在 CT 日志中公开过的全部证书名(需 jq)
curl -s "https://crt.sh/?q=%25.example.com&output=json" 
  | jq -r '.[].name_value' | tr ',' 'n' | sort -u

因此内部系统与测试域名不要用公共 CA 签发,改用私有 CA:

# 自建私有 CA 并签发内部服务证书(OpenSSL 3.x;-addext 需 1.1.1+)
openssl req -x509 -newkey rsa:3072 -nodes -days 3650 -keyout ca.key -out ca.crt 
  -subj "/CN=Internal Root CA/O=Corp" -addext "basicConstraints=critical,CA:TRUE"
openssl req -newkey rsa:2048 -nodes -keyout svc.key -out svc.csr -subj "/CN=svc.internal"
openssl x509 -req -in svc.csr -CA ca.crt -CAkey ca.key -CAcreateserial -days 397 
  -extfile <(printf "subjectAltName=DNS:svc.internalnextendedKeyUsage=serverAuth") -out svc.crt

问:不同场景该用哪种证书?

场景 签发方式 验证类型 注意事项
对外生产域名 公共 CA(Let’s Encrypt / 商业 CA) OV 或商业 DV 写入 CT 日志;有效期 ≤398 天
内部服务 私有 CA 或 mTLS(RFC 8705) 自签/内部策略 不进 CT 日志;客户端需预置根证书
测试环境 自签证书 无 单独维护信任库,严禁流入生产

测试证书误配到生产时,客户端会直接报错:Go 程序为 x509: certificate signed by unknown authority,Chrome 为 NET::ERR_CERT_AUTHORITY_INVALID。看到这类报错先查证书来源,而不是盲目关掉校验。

问:私钥归档有哪些硬性要求?

备份必须加密存储、权限 600、禁止进入代码仓库。落地命令:

# 1) 私钥权限收紧为 600 且仅 root 可读
install -m 600 -o root -g root svc.key /etc/ssl/private/svc.key

# 2) 扫描工作区与历史提交中的私钥/证书泄露(gitleaks 8.x)
gitleaks detect --source . --report-format json --report-path leaks.json

# 3) 或使用 trufflehog 3.x 只报“已验证可用”的凭据
trufflehog git file://. --only-verified

一旦命中,正确处置是立即吊销重签,而不是 git rm 删文件——历史提交、CI 缓存和构建产物里都可能留有副本。把上述字段固化成 YAML 台账并接入 CI(到期前 30 天告警、序列号与线上不一致即失败),才算是可维护的 SSL证书注意事项 落地方式。

加密强度没有区别,两者都要求 RSA 2048 位以上或 ECDSA P-256,都受同一套 CA/Browser Forum 基线要求约束。差别在有效期(90 天对最长 398 天且即将缩短)、身份背书(DV 不验证企业主体)、保险赔付额度与人工支持响应。

都不能。*.example.com 只匹配 a.example.com 这一级,不匹配裸域 example.com,也不匹配 a.b.example.com。裸域需要单独写进 SAN;二级子域要么再签一张 *.b.example.com,要么改用多域名证书逐个列出。

先确认服务是否真的 reload:执行 systemctl reload nginx 后用 ps -ef | grep nginx 查看 master 进程启动时间是否更新。若前面挂了 CDN 或负载均衡,还需要在控制台重新上传证书并刷新边缘节点,否则回源正常、边缘仍是旧证书。

九成是服务器没有下发中间证书。用 openssl s_client -connect host:443 -servername host -showcerts

在 2030 年之前 RSA 2048 仍满足主流合规要求,但 ECDSA P-256 的握手更快、证书体积约为 RSA 的三分之一。如果客户端里还有 Android 7 以下设备或老式 IoT 终端,建议保留 RSA,或用 Nginx 双证书让服务端按客户端能力自动选择。

不建议。内部域名用公共 CA 签发会把主机名写进 CT 日志,等于对外暴露资产清单,而且内网域名往往无法完成 HTTP-01 验证。更合适的做法是用 step-ca、cfssl 或 AD CS 自建私有 CA,并把根证书分发到内部终端的信任库。

certbot 默认每次续期都会生成新私钥,安全性更好,建议保持默认。确有固定密钥需求时可加 –reuse-key,但要同时评估密钥一旦泄露的影响面,并配合更短的有效期与更严格的私钥访问控制。


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

内容审核

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