跳到主要内容
安装配置教程

SSL 证书安装教程 checker 版:8 步装完后如何用命令验证证书链、SAN 与续期

ssl证书 安装教程 checker — SSL 证书安装教程 checker 版:8 步装完后如何用命令验证证书链、SAN 与续期
核心结论

SSL 证书安装是否成功不看浏览器有没有小锁,而看 checker 的三项关键指标:服务端至少返回 2 张证书(叶证书 + 中间证书)、openssl s_client 的 Verify return code 为 0、SAN 覆盖全部访问域名,任一项不满足,Android 7 与 Java 8u261 客户端就会握手失败。 自检最快的一条命令:openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE',正常返回 2,返回 1 说明漏装中间证书。 Nginx 1.26.1 改完配置先 nginx -t 再 systemctl reload nginx,reload 不断开现有连接;ssl_certificate 必须指向 fullchain.pem 而不是单张 cert.pem。 证书剩余有效期可用 openssl x509 -checkend 1209600 -noout -in fullchain.pem 判断,返回 0 表示 14 天内不会过期,适合直接接进监控脚本。 checker 工具分工:交付前用在线 checker 做人工复核(10-30 秒),CI 里用 testssl.sh 3.2 拿退出码(40-120 秒),资产盘点用 nmap 7.95 的 ssl-enum-ciphers 脚本。

证书装完浏览器能打开就算成功吗?checker 会挑出的 5 类根因

问:证书装完,浏览器能正常打开,是不是就算装成功了?
不是。浏览器是容错能力最强的客户端之一,它会把证书链缺失、SNI 错配、协议残留这些问题悄悄兜住,而服务器端、移动端和自动化脚本不会。所以一份靠谱的 ssl证书 安装教程 checker 清单,第一步不是看浏览器绿锁,而是把这 5 类“浏览器看不出来”的根因逐条排掉。以下每条都给出可复制的判定命令。

根因一:证书链不完整(最高频)。Nginx 的 ssl_certificate 只配了域名证书 cert.pem,没有拼接中间证书。桌面 Chrome / Safari 会读取证书里的 AIA(Authority Information Access,定义见 RFC 5280 §4.2.2.1)字段自动下载中间证书补齐,因此“看起来正常”;但 Android 7 WebView、Java 8u261、CentOS 7 自带的 curl 7.29 不做 AIA 补齐,会直接失败。据 Let’s Encrypt 文档,应部署的是 fullchain.pem(叶子证书 + 中间证书),而不是 cert.pem。

# 1) 服务端实际下发的证书数量,正常应为 2(叶子+中间)或 3(含交叉签名)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c "BEGIN CERTIFICATE"

# 2) 用本地 CA 库严格校验,缺中间证书时立即失败
openssl s_client -connect example.com:443 -servername example.com -verify_return_error &1 | grep -i "SSL certificate problem"
# curl: (60) SSL certificate problem: unable to get local issuer certificate

# 4) Nginx 修复写法(注意顺序:叶子在前,中间在后)
# ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 关键行:用 fullchain
# ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
客户端 / 运行时 是否按 AIA 自动补齐中间证书 链不完整时的真实报错
桌面 Chrome / Safari / Edge 是 页面正常,绿锁照常显示
Android 7 WebView 否 SSL handshake aborted / 连接被重置
Java 8u261 默认 trustStore 否 PKIX path building failed: unable to find valid certification path
curl 7.29(CentOS 7 自带) 否 curl: (60) … unable to get local issuer certificate

根因二:SNI 与默认站点错配。同一台机器 443 端口有多个 server 块时,不带 SNI 的握手会落到第一个 listen 443 ssl default_server 的旧证书上。checker 若不加 -servername,拿到的就是别的域名证书,于是误判“证书与域名不匹配”——这往往是检测工具的坑,而不是你的证书有问题。

# 不加 SNI:拿到 default_server 的证书,常见误判来源
openssl s_client -connect 203.0.113.10:443 /dev/null | openssl x509 -noout -subject

# 加 SNI:这才是浏览器和 curl 的真实行为,同时打印 SAN
openssl s_client -connect 203.0.113.10:443 -servername www.example.com /dev/null 
  | openssl x509 -noout -subject -ext subjectAltName

根因三:私钥与证书不配对。CSR 在 A 机器生成、证书在 B 机器下载,中间重签过一次,就会出现公钥不匹配。Nginx 启动时表现为:

# Nginx 报错原文
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/privkey.pem") failed
       (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)

# 通用校验(RSA 与 ECDSA 均适用),两行输出必须完全一致
openssl x509 -in cert.pem -noout -pubkey | openssl sha256
openssl pkey -in privkey.pem -pubout  | openssl sha256

根因四:续期链路从未演练。Let’s Encrypt 证书有效期 90 天,certbot 默认在剩余 30 天时续期,由 certbot.timer 每天触发两次。装完从不跑 --dry-run,等到第 91 天过期,checker 才报 certificate has expired。

# 查看当前证书生效/失效时间与签发者
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -dates -issuer

certbot certificates              # 列出 CERTNAME / EXPIRY DATE / VALID
certbot renew --dry-run           # 装完必跑一次,走完整 ACME 流程但不实际签发
systemctl list-timers certbot.timer   # 确认定时器已激活(每日 2 次)

根因五:协议与套件残留。仍开着 TLSv1.0/1.1 或 RC4、3DES 的主机,checker 评级会被压到 B 甚至 C;反过来只开 TLSv1.3 又会与只支持 TLSv1.2 的老客户端撞出 SSL_ERROR_NO_CYPHER_OVERLAP。据 Mozilla SSL Configuration Generator 5.7 的 intermediate 档,TLSv1.2 + TLSv1.3 是当前兼顾兼容与安全的区间。

# 老协议应握手失败(返回 alert protocol version 即为已关闭,符合预期)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# error:1409442E:SSL routines:ssl3_read_bytes:tlsv1 alert protocol version

# Nginx 侧对齐 Mozilla intermediate(5.7)
# 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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
# ssl_prefer_server_ciphers off;
协议配置区间 客户端覆盖 典型 checker 评级
仅 TLSv1.0 / TLSv1.1 Chrome 98+、Firefox 74+ 已移除支持,直接握手失败 C 或更低
TLSv1.2 + TLSv1.3(Mozilla intermediate 5.7) 覆盖 2015 年后绝大多数客户端 A
仅 TLSv1.3(RFC 8446) Java 8、Android 9 以下、旧 curl 全部失败 A+,但可用性下降

换句话说,checker 挑出的从来不是“证书有没有装”,而是“装的那份文件、那个 server 块、那条续期链路是否真的对”。把上面 5 条命令固化成发布后必跑的自检脚本,比任何一次浏览器刷新都更接近“装成功”的定义——这也是完整的 ssl证书 安装教程 checker 流程里最容易被跳过、却最值钱的一步。

先定标准再动手:一份 checker 通过基线要包含哪些指标?

为什么”装完能打开”不等于”checker 能通过”?因为浏览器会帮你补链、容忍时钟偏差、静默降级,而 checker 只看服务端原始握手返回的内容。所以在敲第一条命令之前,先把”通过”定义成可测量的阈值——下面的五项基线就是后续 8 步验证的判分标准,也是 ssl证书 安装教程 checker 流程里最容易被跳过的一步。

基线项 通过阈值(checker 判据) 自检命令要点 不通过时的典型信号
链完整性 返回证书 ≥ 2 张(叶 + 至少 1 张中间证书),叶证书在前;根证书不下发;交叉签名 OV 链可为 3 张 openssl s_client -showcerts 计数 verify error:num=21 unable to verify the first certificate
域名覆盖 SAN 含主域名与全部别名,example.com 与 www.example.com 是两条独立条目 openssl x509 -ext subjectAltName does not match certificate's altnames
时间 notBefore ≤ 当前时间 < notAfter,剩余 > 14 天;服务器时钟偏差 ≤ 5 分钟 -checkend 1209600 + date -u certificate has expired
协议与套件 仅启用 TLSv1.2 / TLSv1.3,禁用 TLSv1.0/1.1;优先 AEAD 套件 nmap --script ssl-enum-ciphers 握手列表里出现 TLSv1.0
附加项 OCSP Stapling = successful;HSTS max-age ≥ 31536000;HTTP 301 跳 HTTPS;私钥 600 且属主 root curl -sSI / stat -c '%a %U' 响应头缺失或 key 为 644

链顺序为什么必须”叶在前、中间在后”?因为 TLS 握手的 Certificate 消息是按顺序下发的,客户端用前一张证书的公钥验证后一张的签名。把中间证书放前面,OpenSSL 会直接报 unable to get local issuer certificate。根证书不要部署——它本就在客户端信任库里,多下发一张只会增加握手字节数。据 RFC 6125 第 6.4.3 节,通配符只匹配最左侧一个标签,因此 *.example.com 既不覆盖 example.com 本身,也不覆盖 a.b.example.com。协议方面,RFC 8996(2021 年 3 月)已将 TLS 1.0/1.1 列为废弃,Mozilla Server Side TLS 指南同样只推荐 1.2 起的 AEAD 套件。

# 一次跑完五项基线(OpenSSL 1.1.1+ / LibreSSL 3.x 通用,替换域名即可)
D=example.com

# 1) 链完整性:张数 + 校验结果
openssl s_client -connect $D:443 -servername $D -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'      # 期望 >= 2
openssl s_client -connect $D:443 -servername $D -verify_return_error &1 
  | grep 'Verify return code'        # 期望 0 (ok)

# 2) SAN 覆盖
openssl s_client -connect $D:443 -servername $D /dev/null 
  | openssl x509 -noout -ext subjectAltName

# 3) 时间:-checkend 1209600 = 14 天,退出码 0 表示仍在有效期内
openssl s_client -connect $D:443 -servername $D /dev/null 
  | openssl x509 -noout -dates -checkend 1209600; echo "exit=$?"
date -u; ntpq -p                   # 无 ntpq 时用 chronyc tracking / timedatectl

# 4) 协议:TLSv1.1 必须握手失败;nmap 列出实际启用版本与套件
openssl s_client -connect $D:443 -tls1_1 </dev/null   # 期望 handshake failure
nmap --script ssl-enum-ciphers -p 443 $D

# 5) 附加项:OCSP Stapling、HSTS、跳转、私钥权限
openssl s_client -connect $D:443 -servername $D -status /dev/null 
  | grep -A1 'OCSP Response Status'  # 期望 successful
curl -sSI http://$D | grep -iE '^HTTP|^location'          # 期望 301 -> https
curl -sSI https://$D | grep -i 'strict-transport-security' # max-age >= 31536000
stat -c '%a %U %n' /etc/nginx/ssl/$D.key                   # 期望 600 root

时间基线要单独说一句:-checkend 只看证书,不看本机时钟。若 date -u 与真实 UTC 偏差超过 5 分钟,OCSP 响应和 CRL 的时间戳校验都会失败,checker 常报 certificate is not yet valid。据 Let’s Encrypt 文档,其证书有效期 90 天、官方建议在剩余 30 天时续期,所以”剩余 > 14 天”只是最低门槛,不是运维目标。把这五项阈值写进脚本,后面 8 步装完后逐条比对,ssl证书 安装教程 checker 的结论才有可复现的依据。

SSL 证书安装教程:8 个编号步骤从 CSR 到 checker 复核

很多人把“装完能访问”当成完成,结果上线三天被扫描器打回——因为能打开只证明私钥和证书对得上,不证明中间链完整、SAN 覆盖 www、到期时间还够。下面这套 8 步是 ssl证书 安装教程 checker 版的骨架:每一步都给出可复制的命令和可判读的输出,装完即可自证。

  1. 第 1 步:生成私钥与 CSR。-addext 是 OpenSSL 1.1.1 才加入的选项(见 OpenSSL 1.1.1 CHANGES),3.0.x / 3.0.13 同样支持;低于 1.1.0 只能靠 openssl.cnf 里的 req_extensions 段。
    # RSA 2048:-nodes 表示私钥不加密,便于服务自动加载
    openssl req -new -newkey rsa:2048 -nodes 
      -keyout example.com.key -out example.com.csr 
      -subj '/CN=example.com' 
      -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
    # ECC 证书只需替换密钥部分
    openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:P-256 -nodes 
      -keyout example.com.key -out example.com.csr -subj '/CN=example.com' 
      -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

    据 RFC 5280,现代客户端已忽略 CN、只认 SAN,漏写 www 是 checker 报 SAN 不匹配的头号原因。

  2. 第 2 步:校验证书与私钥是否配对。签发前后各做一次,避免“贴错证书”这种低级事故。RSA 用 modulus 摘要比对,两串必须完全一致;ECC 没有 modulus,改用公钥比对,命令差异见下表。
校验项 RSA 2048 ECDSA P-256
证书侧指纹 openssl x509 -noout -modulus -in cert.pem | openssl md5 openssl x509 -pubkey -noout -in cert.pem | openssl md5
私钥侧指纹 openssl rsa -noout -modulus -in example.com.key | openssl md5 openssl pkey -pubout -in example.com.key | openssl md5
不匹配的典型报错 SSL_CTX_use_PrivateKey: key values mismatch(Nginx 启动失败)
  1. 第 3 步:拼 fullchain,顺序不能颠倒。服务器证书在前、中间证书在后;反过来 checker 会报“链顺序错误”。
    cat cert.pem intermediate.pem > fullchain.pem
    # 打印两张证书的 subject/issuer,确认后者 issuer == 前者 subject
    openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
  2. 第 4 步:落盘与权限。私钥 644 会被绝大多数 checker 直接判为高风险项。
    install -d -m 700 /etc/nginx/ssl
    install -m 600 example.com.key /etc/nginx/ssl/   # 私钥仅 root 可读
    install -m 644 fullchain.pem /etc/nginx/ssl/     # 证书链公开可读
  3. 第 5 步:改配置并 reload。Mozilla SSL Configuration Generator 的默认模板同样指向 fullchain。
    # Nginx
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    nginx -t && systemctl reload nginx
    
    # Apache 2.4.62(httpd)
    SSLCertificateFile    /etc/nginx/ssl/fullchain.pem
    SSLCertificateKeyFile /etc/nginx/ssl/example.com.key
    apachectl configtest && systemctl reload httpd
  4. 第 6 步:本机自检,排除 DNS/CDN 干扰。
    openssl s_client -connect 127.0.0.1:443 -servername example.com </dev/null | 
      openssl x509 -noout -subject -issuer -dates -ext subjectAltName

    必须看到 Verify return code: 0 (ok) 与 Protocol: TLSv1.3;出现 unable to get local issuer certificate 说明第 3 步漏拼中间证书。

  5. 第 7 步:外网 checker 复核。在线工具看链、SAN、到期、协议四项;testssl.sh 3.2 跑全量:./testssl.sh --severity HIGH example.com;SSL Labs API v3 取评级 curl "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done",新域名首次分析 60–180 秒,且有速率限制,别写进循环。
  6. 第 8 步:续期演练,不做演练等于没装。
    certbot renew --dry-run                    # 必须返回成功
    systemctl list-timers | grep certbot       # 确认 timer 存在
    # 非 certbot 场景的 crontab
    0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'

    据 Let’s Encrypt 文档,–dry-run 使用 staging 环境验证 ACME 流程而不消耗速率限额。

把这 8 步的输出(md5 指纹、链顺序、s_client 返回码、checker 报告)存档,下次续期后逐项比对,ssl证书 安装教程 checker 的复核环节才算闭环。证书本身是短期资产,验证脚本才是长期资产。

配置与命令示例:Nginx 1.26 / Apache 2.4 与 OpenSSL 3.0 实测片段

把证书文件放对位置只是第一步,真正决定握手成败的是配置指令。下面三段配置均来自 Nginx 1.26.1、Apache 2.4.62 与 OpenSSL 3.0.x 的实测环境,可直接复制后替换域名路径。这也是大多数 ssl证书 安装教程 checker 流程中”配置—验证”闭环的标准起点。

Nginx 1.26.1:完整 server 块关键片段

server {
    listen 443 ssl;
    http2 on;                                  # 1.25.1 起用 http2 指令,旧的 listen ... http2 已废弃
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须含中间证书,顺序:叶证书→中间证书
    ssl_certificate_key /etc/nginx/ssl/example.com.key; # 权限 600,属主 root

    ssl_protocols       TLSv1.2 TLSv1.3;       # 默认值仅 TLSv1.2 TLSv1.3(1.23.4+)
    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;             # 默认 off;开启会削弱客户端偏好与前向保密选择

    ssl_session_cache   shared:SSL:10m;        # 默认 none;10m ≈ 40000 个会话
    ssl_session_timeout 1d;                    # 默认 5m
    ssl_session_tickets off;                   # 默认 on;关闭便于密钥轮换时彻底失效会话

    # OCSP Stapling
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;  # 仅中间证书,用于校验 OCSP 响应签名
    resolver 223.5.5.5 119.29.29.29 valid=300s;        # 必须显式配置,nginx 不会继承系统 resolv.conf
    resolver_timeout 5s;
}

两个高频坑:其一,ssl_ciphers 对 TLSv1.3 完全无效——TLS 1.3 的套件协商由 OpenSSL 3.0 的内部安全策略控制(RFC 8446 附录 B.4 明确移除了套件配置接口),要裁剪只能改 openssl.cnf 的 Ciphersuites 或 SSL_CTX_set_ciphersuites()。其二,漏写 ssl_trusted_certificate 时 nginx 不会启动失败,只在 reload 时打印告警,Stapling 静默失效:

nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate "/etc/nginx/ssl/fullchain.pem"

Apache 2.4.62:httpd-ssl.conf 片段

SSLEngine on
SSLCertificateFile      /etc/httpd/ssl/fullchain.pem   # 2.4.8+ 可把中间证书直接拼在此文件
SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1     # 默认 all,必须显式减掉旧协议
SSLOpenSSLConfCmd       Curves X25519:secp256r1:secp384r1  # 需 mod_ssl 链接 OpenSSL 1.1.0+
SSLUseStapling          on
SSLStaplingCache        shmcb:/run/httpd/ssl_stapling(32768)  # 缺失则启动报 AH01929
SSLStaplingResponderTimeout 5
SSLStaplingReturnResponderErrors off
能力 Nginx 1.26.1 Apache 2.4.62
协议开关 ssl_protocols(白名单) SSLProtocol(黑名单式 all -X)
套件配置 ssl_ciphers(仅 ≤TLS1.2) SSLCipherSuite(仅 ≤TLS1.2)
OCSP 依赖 需 resolver + ssl_trusted_certificate 需 SSLStaplingCache 共享内存
曲线选择 由 OpenSSL 默认策略决定 SSLOpenSSLConfCmd Curves

握手观测:openssl s_client(OpenSSL 3.0)

openssl s_client -connect example.com:443 -servername example.com 
  -tls1_2 -cipher 'ECDHE-RSA-AES128-GCM-SHA256' /dev/null 
  | grep -E 'Protocol|Cipher|Verify return code'
# 正常三行输出:
#     Protocol: TLSv1.2
#     Cipher  : ECDHE-RSA-AES128-GCM-SHA256
#     Verify return code: 0 (ok)

-servername 不可省,否则 SNI 缺失会拿到默认站点证书;Verify return code 非 0 说明链不完整或根不受信,常见 21 (unable to verify the first certificate) 即中间证书缺失。换 -tls1_3 时 -cipher 需改为 -ciphersuites,这是 OpenSSL 3.0 的接口区分。

curl 侧验证与版本差异

curl -vI https://example.com --tlsv1.2 --max-time 10 2>&1 | grep -E 'SSL connection|TLSv|strict-transport-security'

curl 8.5.0 默认使用系统 CA 库(多数发行版为 /etc/pki/ca-trust 或 /etc/ssl/certs),能正确校验完整链;而 CentOS 7 自带的 curl 7.29 对链构建更宽松,缺中间证书时仍可能返回 200。这正是 ssl证书 安装教程 checker 与浏览器/旧客户端结论不一致的根因——浏览器有 AIA Fetching 兜底,命令行工具没有。排查时用 --cacert /etc/ssl/certs/ca-bundle.crt 显式指定信任库,比 -k 更有诊断价值。据 Mozilla SSL Configuration Generator(v5.7)建议,现代配置应同时提供 TLS 1.2 与 1.3 并关闭会话票据以配合密钥轮换;Let’s Encrypt 文档亦提示 fullchain.pem 必须包含中间证书 R3/E1 而非仅叶证书。

方案选型对比:5 款 checker 工具与 5 类证书怎么选?

刚跑完 8 步安装流程,到底该用哪个工具做最后验收?证书又该买哪一档?这是最容易踩坑最容易浪费钱的一步。一份能落地的 ssl证书 安装教程 checker 清单,应该同时回答“用什么验”和“买什么证”两个问题——因为评分高低和证书贵贱几乎无关,验的是链、协议、套件、HSTS,买的是身份核验等级。

先看 5 款 checker 工具怎么分工:

工具(版本) 检查内容 典型耗时 依赖与限制 适用场景
sslgood 在线 checker 证书链、协议版本、到期时间、SNI 匹配 10–30 秒 免安装,浏览器即可 交付前人工复核
SSL Labs API v3 A+ 到 F 评级、全量套件与握手模拟 首次 60–180 秒 有速率限制,新主机分析需排队,返回 429 要退避 对外评级、客户交付截图
testssl.sh 3.2 200+ 检查项,支持退出码 40–120 秒 Linux + bash 4.0+ CI 流水线卡点
openssl s_client(OpenSSL 3.0.13) 证书链、协议、OCSP stapling 1–3 秒 系统自带 脚本、快速自查
nmap 7.95 ssl-enum-ciphers 套件枚举与强度标注 30–90 秒 需 nmap 与 NSE 脚本库 批量资产盘点

最快的那个永远是 openssl:1–3 秒出结果,且不依赖第三方服务。注意 -showcerts 会输出整条链,而管道里的 x509 只解析第一张(叶子证书),这正是我们想看的对象:

# 快速核对叶子证书的 SAN / 有效期 / 签发者,并强制校验证书链
# 适用 OpenSSL 1.1.1+ 与 3.0.x(示例版本 3.0.13)
openssl s_client -connect example.com:443 
  -servername example.com       # 必须显式传 SNI,否则拿到默认站点证书
  -showcerts -verify_return_error &1 | 
  openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# -verify_return_error:链校验失败时直接报错退出,而不是只打印 verify error 继续

要把它塞进 CI,用 testssl.sh 的退出码更省事(据 testssl.sh 3.2 文档:0 表示无高危发现,1 表示有发现,2 表示无法连通或致命错误):

# --severity HIGH:只把 HIGH 及以上问题计入退出码,避免中低危噪声阻断发布
testssl.sh --quiet --severity HIGH --protocols --server-defaults example.com:443
echo "exit=$?"   # 非 0 即阻断流水线

再看 5 类证书怎么选:价格随渠道波动,下表仅作区间参考。

证书类型 参考价格 有效期 验证方式 签发耗时
Let’s Encrypt DV 免费 90 天 HTTP-01 或 DNS-01 10–60 秒
付费 DV 约 100–400 元/年 1 年(398 天上限) HTTP-01 / DNS-01 分钟级
OV 约 800–3000 元/年 1 年 营业执照核验 1–3 个工作日
EV 约 2000–8000 元/年 1 年 严格主体核验 数个工作日
通配符 DV 付费 500–1500 元/年;Let’s Encrypt 免费 90 天 / 1 年 强制 DNS-01 10–60 秒

398 天上限来自 CA/Browser Forum 的 SC-22 基线要求(2020 年 9 月起生效),任何声称“买 2 年送 2 年”的渠道,实际都是分批签发。

结论一:个人站与内部系统,Let’s Encrypt + certbot 2.11 成本最低。代价是必须接受 90 天周期,所以要把续期演练写进发布流程,而不是等过期告警:

# certbot 2.11:dry-run 不会写盘、不会消耗 Let's Encrypt 速率限制配额
sudo certbot renew --dry-run --cert-name example.com
# 退出码 0 = 所有 lineage 均可成功续期;非 0 说明 webroot/DNS 插件已失效

结论二:子域超过 5 个,上通配符。据 Let’s Encrypt 文档,通配符证书只能走 DNS-01,因为校验方必须看到 _acme-challenge 的 TXT 记录。这意味着要把 DNS API 凭据交给服务器——用 acme.sh 3.0.9 的别名模式把风险隔离出去:

# acme.sh 3.0.9:验证 TXT 写到独立托管区 example-verify.com,
# 主域 example.com 的 DNS 账号全程不落地到这台机器
export Ali_Key="LTAI5t****"        # 仅对 example-verify.com 有写权限的子账号
export Ali_Secret="****"
acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' 
  --challenge-alias example-verify.com

结论三:对外电商、支付类业务选 OV,但别指望它抬高评分。SSL Labs 的 A+ 只取决于链是否完整、是否禁用了 TLS 1.0/1.1、套件顺序与 HSTS 头,与 DV/OV/EV 无关。OV 的真实价值是证书主体信息经过核验,能直接回答审计里的“证书归属证明”那一栏。顺带一提,上面这套 ssl证书 安装教程 checker 组合(openssl 自查 + testssl.sh 卡 CI + SSL Labs 出评级)跑完,才算真正把 8 步安装闭环。

常见错误与真实报错:9 条高频故障怎么排查?

这 9 条报错几乎覆盖了「ssl证书 安装教程 checker」流程里 90% 的翻车点。它们的共同特征是:报错位置在服务端,根因却分布在文件格式、密钥配对、证书链、SAN、系统时间、协议版本、反向代理七个层面。先用下面这张速查表定位层次,再往下看具体命令。

报错关键字 故障层 首条排查命令
PEM_read_bio_X509_AUX() failed 文件编码/格式 file fullchain.pem
key values mismatch 证书与私钥配对 openssl x509 -noout -modulus
unable to get local issuer certificate 中间证书缺失 grep -c 'BEGIN CERTIFICATE'
no alternative certificate subject name SAN 覆盖范围 openssl x509 -noout -ext subjectAltName
NET::ERR_CERT_DATE_INVALID 有效期/时钟 date -u
SSL_ERROR_NO_CYPHER_OVERLAP 协议与套件 openssl s_client -tls1_2
Cloudflare 525 / 526 源站可达性/链 curl -vI --resolve
AH02032 SNI 与 Host 不一致 反代改写 Host 抓包看 SNI 与 Host
ssl_stapling ignored OCSP 装订 查 ssl_trusted_certificate

Q:nginx 起不来,报 PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line) 怎么办?
这不是证书内容错,而是 OpenSSL 在文件里找不到 -----BEGIN CERTIFICATE----- 这一行。两种情况:文件其实是 DER 二进制,或开头被 Windows 记事本塞了 UTF-8 BOM、行尾是 CRLF。先确认,再修:

# 1) 确认格式:应输出 "PEM certificate" 或 ASCII text
file /etc/nginx/ssl/fullchain.pem

# 2) 若为 DER,转换后再用(OpenSSL 1.0.2+ / 3.x 通用)
openssl x509 -inform DER -in cert.der -out cert.pem

# 3) 去 CRLF 与 BOM(GNU sed 4.x;macOS 用 sed -i '')
sed -i 's/r$//' fullchain.pem
sed -i '1s/^xEFxBBxBF//' fullchain.pem

# 4) 校验能否被 OpenSSL 解析,无输出即正常
openssl x509 -in fullchain.pem -noout -subject
nginx -t && systemctl reload nginx

Q:SSL_CTX_use_PrivateKey: key values mismatch 或 X509_check_private_key: key values mismatch?
证书和私钥不是一对。最常见于续期时只替换了 fullchain.pem,私钥还是旧的。RSA 比 modulus,ECDSA 比公钥(依据 OpenSSL x509/pkey 手册):

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

# ECDSA / Ed25519:比公钥指纹(OpenSSL 1.1.1+)
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in privkey.pem -pubout     | openssl md5

Q:curl: (60) SSL certificate problem: unable to get local issuer certificate?
服务端只发了叶证书,没发中间证书,客户端无法把链补到受信根(RFC 5280 §6 的路径构建失败)。据 Let’s Encrypt 文档,fullchain.pem 必须是「叶证书 + 中间证书」顺序拼接:

# 正常应为 2(叶证书 + 中间证书),返回 1 即缺中间证书
grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/fullchain.pem

# 重拼:叶在前、中间在后,切勿把根证书放进来
cat cert.pem chain.pem > fullchain.pem
nginx -t && systemctl reload nginx

Q:curl: (60) SSL: no alternative certificate subject name matches target host name?
SAN 不含你访问的域名。注意通配符只匹配一级:*.example.com 覆盖 a.example.com,不覆盖 a.b.example.com,也不覆盖裸域 example.com——这是最高频的误判点。RFC 6125 §6.4.3 明确要求优先匹配 SAN,CN 早已被主流客户端忽略。

openssl x509 -noout -ext subjectAltName -in fullchain.pem
# 输出示例:DNS:example.com, DNS:*.example.com

Q:浏览器报 NET::ERR_CERT_DATE_INVALID 或 certificate has expired?
先分清是证书真过期,还是服务器时钟漂移(虚拟机休眠、容器无 NTP 时极常见)。

date -u                    # 与真实 UTC 对比
timedatectl status         # systemd 系统看 NTP 同步状态
ntpq -p                    # 有 * 前缀的才是当前同步源
openssl x509 -noout -dates -in fullchain.pem   # notBefore / notAfter

Q:Firefox 报 SSL_ERROR_NO_CYPHER_OVERLAP?
双方没有共同协议或套件,典型是服务端只留了 TLSv1.3,而旧客户端只支持 TLSv1.0/1.1。Nginx 自 1.23.4 起 ssl_protocols 默认值为 TLSv1.2 TLSv1.3,若你手写成只留 1.3 就会触发。复现并修复:

openssl s_client -connect example.com:443 -tls1_2 </dev/null
# 报 "no protocols available" 即服务端未开 1.2

# nginx.conf 的 http 或 server 块
ssl_protocols TLSv1.2 TLSv1.3;   # 保留 1.2 兼容旧客户端

Q:Cloudflare 报 525 / 526?
525 是 TCP 层握手失败(源站 443 没监听或防火墙拦了 CF 回源段),526 是证书校验失败(多为自签或链不全)。切 Full (strict) 之前,务必绕过 CDN 从源站 IP 直连验证,这也是 checker 类工具最有价值的一步:

curl -vI https://example.com --resolve example.com:443:203.0.113.10
# 关键看:* SSL certificate verify ok. 以及是否返回 200

Q:Apache 报 AH02032: Hostname example.com provided via SNI and hostname other.com provided via HTTP are different?
TLS 握手时客户端在 SNI 里声明 A 域名,HTTP 层 Host 头却是 B 域名,Apache 2.4.24+ 会直接拒绝以防域前置攻击。检查反向代理是否用 proxy_set_header Host $host; 正确透传,以及默认 vhost 是否配了兜底证书。

Q:nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate?
开了 ssl_stapling on;(默认 off)却没给 ssl_trusted_certificate,Nginx 找不到签发者就无法取 OCSP 响应。补齐后仍失败,多半是 resolver 不可达——OCSP 请求默认走 HTTP 80 端口(RFC 6960),只放行 443 出站的环境会一直超时。

ssl_stapling on;
ssl_stapling_verify on;                       # 建议同时开启
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;   # 含中间证书,勿含叶证书
resolver 223.5.5.5 1.1.1.1 valid=300s;
resolver_timeout 5s;

效果验证:怎么确认配置真的生效了?

很多人跑完 8 步 ssl证书 安装教程 checker 流程,看到浏览器地址栏的小锁就以为收工了。但小锁只证明“当前这个 Chrome 能握手”,证明不了链完整、SAN 覆盖、协议干净。下面几条命令是可复制的验收清单,按顺序跑一遍,任何一条不符合预期就回去改配置。

证书链到底装全了吗?一条 grep 就能看出来

# 抓取服务端发送的全部证书,统计 BEGIN CERTIFICATE 出现次数
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 期望输出:2(叶子证书 + 1 张中间证书)
# 返回 1 说明只发了叶子证书,Android 7 / Java 8 会直接报 PKIX path building failed

# 再看握手结尾的校验结果(OpenSSL 1.1.1 与 3.x 输出格式一致)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | tail -n 3
# Verify return code: 0 (ok)
# 非 0 时按码查 OpenSSL 文档:20 = unable to get local issuer certificate(缺中间证书)
#                                10 = certificate has expired
#                                62 = hostname mismatch(SAN 没覆盖该域名)

-servername 不能省,否则 SNI 虚拟主机可能返回默认站点的证书,验证结果会张冠李戴。

到期时间和 SAN 列表怎么一次看全?

openssl x509 -noout -dates -ext subjectAltName -in /etc/letsencrypt/live/example.com/fullchain.pem
# notBefore=Jul  1 00:00:00 2025 GMT
# notAfter=Sep 29 23:59:59 2025 GMT
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com

# 脚本化:14 天 = 1209600 秒,退出码 0 表示剩余寿命大于 14 天
openssl x509 -checkend 1209600 -noout -in fullchain.pem
echo $?   # 0 = 安全;1 = 14 天内到期,触发告警

注意 checkend 只检查文件里的第一张证书(叶子证书),这正是要监控的那张。据 Let’s Encrypt 文档,其证书有效期 90 天、官方建议在剩余 30 天时续期,把阈值设成 14 天是给续期失败留出的最后缓冲。

协议版本和加密套件有没有留后门?

# nmap 7.94 自带脚本,逐个 TLS 版本枚举套件
nmap --script ssl-enum-ciphers -p 443 example.com
# 检查点:输出里不应出现 TLSv1.0: 与 TLSv1.1: 段落

# testssl.sh 3.2 更细,直接按严重级别过滤
./testssl.sh --severity MEDIUM --protocols https://example.com
# 检查点:不应出现 RC4、3DES、EXP 字样

Mozilla 的 Server Side TLS 指南已把 TLS 1.0/1.1 列为 Old,现代配置应只保留 TLS 1.2 与 1.3。

OCSP 与 HSTS 生效了吗?

openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null 
  | grep -A1 'OCSP Response Status'
# 期望:OCSP Response Status: successful (0x0)

curl -sI https://example.com | grep -i strict-transport-security
# 期望:strict-transport-security: max-age=31536000; includeSubDomains

为什么要在多个客户端上验一遍?

不同客户端的证书库和协议下限差别很大,单一浏览器通过不代表全通过。至少覆盖下表四类:

客户端 硬性要求 失败时的典型症状
Android 7 必须发送完整链 App 内 WebView 报 SSLHandshakeFailed
Java 8u261 TLSv1.2 + 完整链 PKIX path building failed
curl 7.29(CentOS 7) OpenSSL 1.0.2 基线 unable to get local issuer certificate
Chrome 最新版 相对宽松,会自行补链 通常正常

如果前三个全挂、只有 Chrome 正常,基本可以断定是链不完整,而不是私钥或域名问题。

上线后怎么提前 14 天知道要续期?

# blackbox_exporter 0.25.0 的 ssl 探测模块会暴露 probe_ssl_earliest_cert_expiry(Unix 时间戳)
# prometheus 告警规则片段
- alert: SSLCertExpiringSoon
  expr: (probe_ssl_earliest_cert_expiry - time()) < 86400 * 14
  for: 1h
  labels:
    severity: warning
  annotations:
    summary: "{{ $labels.instance }} 证书剩余不足 14 天"

把这套检查固化成 ssl证书 安装教程 checker 脚本挂进 CI,每次换证自动跑一遍,比人工点浏览器可靠得多。

把 checker 变成常态:续期守护与自动化巡检怎么做?

certbot 装完就自动续期了吗?先确认 timer 真的在跑

certbot 2.11(2025 年 1 月发布)用官方 apt/snap 包安装时默认会装上 certbot.timer,并启用 certbot.service。但“默认安装”不等于“默认启用”,据 Let’s Encrypt 官方文档,Docker 镜像和部分最小化系统镜像里 timer 是缺失的。第一步永远是用下面这条命令验证:

systemctl list-timers certbot.timer
# 期望输出(时间会带随机偏移):
# NEXT                         LEFT     LAST                         PASSED  UNIT          ACTIVATES
# Tue 2025-03-18 07:41:12 UTC  3h 12m   Mon 2025-03-17 18:22:03 UTC  10h ago certbot.timer certbot.service

systemctl cat certbot.timer | grep -E 'OnCalendar|RandomizedDelaySec|Persistent'
# OnCalendar=*-*-* 00,12:00:00
# RandomizedDelaySec=43200   ← 基准点 00:00/12:00,再叠加最多 12 小时随机延迟
# Persistent=true            ← 关机错过的触发会在开机后补跑

看到 NEXT 有值才算数;如果输出 0 timers listed,说明需要 systemctl enable --now certbot.timer。不想用 systemd 的环境(容器、老发行版)可以退回 cron,但注意 cron 的 PATH 极简,命令必须写绝对路径:

# /etc/cron.d/certbot-renew,注意末尾换行,否则 cron 会忽略
0 3 * * * root /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'

renew-hook 和 deploy-hook 到底该用哪个?

这是 ssl证书 安装教程 checker 里最容易被写错的一行。certbot 默认续期窗口是到期前 30 天(90 天证书即约每 60 天真正续一次),但 timer 每天检查两次——用 --renew-hook 或 --post-hook 会导致每天两次无谓 reload,而 nginx reload 会新建 worker 进程、短暂占用内存,在低配机器上就是两次可感知的抖动。

钩子 触发时机 触发频率 典型用途
--pre-hook 每次 renew 尝试前 2 次/天 临时放行 80 端口做 HTTP-01
--post-hook 每次 renew 尝试后,无论是否更新 2 次/天 已不推荐,易造成无谓 reload
--deploy-hook 仅证书确实写入新文件后 0 或 1 次 / 约 60 天 reload nginx、推送 CDN

多站点场景不要在每个 lineage 上重复写 hook,改用全局钩子目录(certbot 按文件名顺序执行 renewal-hooks/{pre,deploy,post}/ 下所有可执行文件):

sudo install -d -m 755 /etc/letsencrypt/renewal-hooks/deploy
sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh >/dev/null <&2
EOF
sudo chmod 755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
sudo certbot renew --dry-run   # 演练,确认钩子路径被识别

权限必须是 755:certbot 只执行有可执行位的文件,0644 会被静默跳过。钩子失败时日志长这样,直接指向根因:

Hook command "/etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh" returned error code 1
Error output from reload-nginx.sh:
Job for nginx.service invalid.

怎么把 checker 接进 CI,又不拖慢每次提交?

用 testssl.sh 3.2 的退出码做门禁,它比 curl 只看握手成功要严格得多——会检查证书链完整性、协议版本、弱套件、HSTS:

#!/usr/bin/env bash
set -euo pipefail
# --severity HIGH:仅 HIGH/CRITICAL 级问题计入门禁,避免 B 级评级误伤
# --exitcode:发现问题返回 1,可直接驱动流水线失败
testssl.sh --quiet --severity HIGH --exitcode https://example.com
echo "exit=$?"   # 0 = 通过;1 = 存在 HIGH 及以上问题;2 = 参数错误

单次耗时 40–120 秒(含全部套件扫描),所以放在发布后的 post-deploy 任务,而不是每次 push 都跑。它和前面的 ssl证书 安装教程 checker 是互补关系:前者验证“装得对”,这里验证“上线后没退化”。

没有 Prometheus 也能巡检:14 天阈值脚本

certbot 只管“续”,不管“续完有没有生效”。下面的最小实现同时覆盖两种故障:

#!/usr/bin/env bash
# /usr/local/bin/cert-checker.sh
WARN=1209600                       # 14 天(秒),比 certbot 的 30 天续期窗口更靠后
OUT=/var/lib/node_exporter/textfile/cert_expiry.prom
: > "$OUT"
while read -r host; do
  end=$(openssl s_client -connect "$host:443" -servername "$host" /dev/null 
        | openssl x509 -noout -enddate | cut -d= -f2)   # 取 notAfter,RFC 5280 §4.1.2.5
  if [ -z "$end" ]; then
    echo "cert_checker_up{host="$host"} 0" >> "$OUT"; continue
  fi
  left=$(( $(date -d "$end" +%s) - $(date +%s) ))
  echo "cert_expiry_seconds{host="$host"} $left" >> "$OUT"
  [ "$left" -lt "$WARN" ] && echo "WARN $host 剩余 ${left}s" >&2
done < /etc/cert-checker/domains.txt

为什么是 14 天而不是 30 天?30 天窗口内 certbot 每天都在尝试,此时报警全是噪音;14 天意味着续期连续失败了两周——或者续期成功但 nginx 没 reload、仍在吐旧证书,两种情况都已被逼到墙角。配 cron 每小时跑一次:17 * * * * root /usr/local/bin/cert-checker.sh。

变更留痕:把哪四项写进运维记录?

每次安装或续期后,把 checker 的链张数、SAN 列表、协商出的协议版本、评级四项落盘并与上一次 diff。链张数从 2 变 1 通常意味着中间证书漏装(部分客户端如 Android 7 会直接握手失败),评级从 A 掉到 B 多半是误开了 TLS 1.0/1.1 或丢了 HSTS——这两类回归都能靠 diff 在几分钟内定位到是哪次变更引入的,而不是等用户投诉。

因为桌面浏览器会读取叶证书里的 AIA 字段自动下载中间证书补齐,所以本机看着正常;Android 7、Java 8u261、curl 7.29 不做这个动作,会直接握手失败。把 cert.pem 与 intermediate.pem 按顺序拼成 fullchain.pem 再 reload,用 grep -c 'BEGIN CERTIFICATE' 确认返回 2 即可。

多数情况是服务端确实没发中间证书,而 openssl s_client 用了本机 CA 库做补链判断。加 -showcerts 数一下返回张数,只有 1 张就是服务端的问题;若返回 2 张仍报错,则是客户端 CA 库过旧(如 CentOS 7 的 ca-certificates 版本),升级或指定 –cacert 即可。

三者定位不同:在线 checker 适合交付前 10-30 秒快速人工复核链、SAN、到期、协议四项;SSL Labs 适合拿对外评级,但首次分析要 60-180 秒且有速率限制;testssl.sh 3.2 适合放进 CI,因为它能用退出码表达结果。建议日常用前者,季度审计用后者。

没有区别。checker 的评分依据是证书链完整性、协议版本、加密套件、HSTS 等配置项,不看证书是 DV 还是 OV。真正的差异在有效期:Let's Encrypt 是 90 天,付费 DV 通常 1 年,90 天周期意味着续期失败的风险窗口更短,必须把 renew –dry-run 纳入流程。

这是证书与私钥不配对,常见于续期后只替换了证书文件。RSA 用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 各算一次 md5 对比,不一致就重新导出配对的那份私钥;ECC 证书改用 openssl pkey -pubout 与 openssl x509 -pubkey 比对。

不需要重启,systemctl reload nginx 就够。reload 会平滑加载新配置,老 worker 处理完存量连接后退出,不会断开长连接;restart 会直接终止进程,正在传输的大文件或 WebSocket 会中断。前提是 nginx -t 必须先通过。

blog.example.com 可以,example.com 本身不行,a.b.example.com 也不行。按 RFC 6125 的匹配规则,通配符只匹配一级标签,且不匹配裸域名。解决方式是在同一张证书的 SAN 里同时写 example.com 与 *.example.com,checker 会用 SAN 列表逐条比对。


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

内容审核

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