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

SSL 证书安装教程:证书链拼装、PEM/PFX 格式选择与 7 步验收(Best Practice 实操)

ssl证书 安装教程 best — SSL 证书安装教程:证书链拼装、PEM/PFX 格式选择与 7 步验收(Best Practice 实操)
核心结论

SSL 证书安装失败最常见的原因不是配置写错,而是只上传了服务器证书、漏掉中间证书,导致 fullchain 不完整;用 openssl verify 返回 OK 才算装对。 fullchain 的正确顺序是「服务器证书 → 中间证书」,根证书不要放进去;grep -c 'BEGIN CERTIFICATE' fullchain.pem 结果应为 2–3。 Nginx 1.26 的 ssl_certificate 必须指向 fullchain.pem,Apache 2.4.8 之后 SSLCertificateFile 直接写 fullchain、不再使用 SSLCertificateChainFile。 私钥与证书是否配对,用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 两个 sha256 值比对,不一致就会报 X509_check_private_key:key values mismatch。 验收至少跑三条命令:openssl s_client -verify_return_error 返回 0 (ok)、curl --cacert 返回 HTTP/2 200、openssl s_client -status 显示 OCSP Response Status: successful。

证书文件都传上去了,为什么浏览器还是提示不安全?

先说结论:文件传上去了,只代表 Nginx/Apache 能读到这个路径,不代表客户端能验证这条链。下面五类根因覆盖了绝大多数「上传成功但浏览器仍提示不安全」的工单,每一类都能用 openssl 在几十秒内判定,不必反复重装。

根因一:只部署了叶子证书(最常见)。据 Let’s Encrypt 文档,其签发的服务器证书必须与 R10/R11 这类中间证书一并下发。只配叶子证书时,桌面 Chrome 会通过 AIA 扩展自动去抓中间证书,看起来「正常」,但 Android 旧版本、Java 客户端、curl 会直接失败:curl: (60) SSL certificate problem: unable to get local issuer certificate。判断方法——数一下文件里有几段证书:

# 统计 PEM 文件中的证书段数;只有 1 段说明缺中间证书
grep -c "BEGIN CERTIFICATE" /etc/nginx/ssl/fullchain.pem
# 期望 >= 2(叶子 + 至少一张中间证书)

# 更严谨:打印每张证书的 subject / issuer,核对链是否首尾相接
openssl crl2pkcs7 -nocrl -certfile /etc/nginx/ssl/fullchain.pem 
  | openssl pkcs7 -print_certs -noout

根因二:fullchain 拼接顺序反了。正确顺序是服务器证书在前、中间证书在后。顺序颠倒时 nginx -t 依然返回 syntax is ok,属于典型的「配置不报错、客户端报错」。用 openssl 才能抓出来:

# 用系统根证书库验证 fullchain;顺序错时输出:
# error 2 at 1 depth lookup: unable to get issuer certificate
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted /etc/nginx/ssl/fullchain.pem /etc/nginx/ssl/fullchain.pem

# 修复:叶子在前、中间在后,重新拼接
cat server.crt intermediate.crt > fullchain.pem

根因三:文件格式与扩展名不匹配。CA 下发的 .crt 多数是 PEM 文本(首行 -----BEGIN CERTIFICATE-----),但 IIS、Tomcat、部分负载均衡只吃 PKCS#12。把 DER 二进制直接改名成 .pem,Nginx 启动即报 PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)。先判类型再转,别猜:

file server.crt
# PEM 文本 → "PEM certificate"
# 二进制   → "data" 或 "ASN.1 DER";此时用下面命令确认可解析
openssl x509 -in server.crt -inform DER -noout -subject
格式 典型扩展名 编码 典型使用方 互转命令(OpenSSL 3.x)
PEM .pem .crt .cer .key Base64 文本 Nginx、Apache、HAProxy;Let’s Encrypt 默认输出 openssl x509 -in in.der -inform DER -out out.pem
DER .der .cer 二进制 ASN.1 Java keystore 导入、部分 Windows 工具 openssl x509 -in in.pem -outform DER -out out.der
PKCS#12 .pfx .p12 二进制容器(证书+私钥+链) IIS、Tomcat、F5、Azure App Service openssl pkcs12 -export -out out.pfx -inkey key.pem -in fullchain.pem

注意 pkcs12 -export 默认会加密并交互式索要导出密码;OpenSSL 3.x 默认用 AES-256-CBC + PBKDF2,若目标系统是老版本 JDK/Windows,需加 -legacy 才能导入。

根因四:证书重签后私钥没同步替换。旧私钥配新证书,Nginx 报 SSL_CTX_use_certificate_chain_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),Apache 对应报 AH02565: Certificate and private key do not match。RSA 证书用模数比对,ECC 证书必须换用公钥比对:

# RSA 证书
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem  | openssl md5   # 两个 md5 必须一致

# ECDSA 证书(-modulus 不适用)
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout        -in privkey.pem   | openssl md5

根因五:只用浏览器验证。浏览器有根证书缓存和 AIA Fetching,会掩盖链不完整。据 RFC 5280 第 4.2.2.1 节,AIA 扩展只是辅助手段,客户端并不保证一定去抓取,因此验收必须以命令行结果为准。这也是这份 ssl证书 安装教程 best 实践里最容易被跳过的一步——用 s_client 模拟真实握手并强制校验证书链:

# 列出服务端实际下发的整条链;只有 1 段即链不完整
openssl s_client -connect example.com:443 -servername example.com 
  -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"

# 强制校验:链缺失或顺序错误会直接非零退出
openssl s_client -connect example.com:443 -servername example.com 
  -verify_return_error -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null

第 1–3 步:从 CA 下载包里挑对文件,先核对 SAN 与私钥

解压 CA 下载包后,哪些文件应该装到服务器上?这是 ssl 证书 安装教程 best 实践里最容易被跳过、也最容易出错的一步:如果把 ca_bundle.crt 当成服务器证书上传,或者把证书和私钥配错,后面所有配置都会白做。先看清包里各文件的职责,再动手。

典型文件名 格式 / 编码 作用 是否部署到服务器
example.com.crt PEM(Base64)或 DER 服务器证书(叶子证书),Subject 为你的域名 是,放链首
ca_bundle.crt / chain.crt PEM,可含多张 中间证书(部分 CA 附带交叉签名证书) 是,紧接叶子证书之后
example.com.key PEM(PKCS#8 或 PKCS#1) 私钥,与证书配对使用 是,仅存本机,权限设 600
example.com.pfx / .p12 PKCS#12(二进制,含证书+私钥+口令) Windows/IIS、Java 密钥库导入 否,Nginx/Apache 需先转 PEM
root.crt PEM 根证书 否,通常不应随链下发

第 1 步:确认证书主体和有效期对不对。用一条命令同时看 Subject、Issuer 和起止时间(-ext、-noout 等参数在 OpenSSL 1.1.1 及以上均可用;若系统为 CentOS 7 自带的 OpenSSL 1.0.2,-ext 不支持,改用 -text 再筛选):

# 确认 CN 是目标域名、签发者是哪个中间 CA、有效期是否正确
openssl x509 -in example.com.crt -noout -subject -issuer -dates
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R3
# notBefore=Mar  1 00:00:00 2025 GMT
# notAfter=May 30 23:59:59 2025 GMT

第 2 步:核对 SAN,而不是 CN。据 CA/Browser Forum《Baseline Requirements》规定,所有域名必须写入 SAN 扩展,CN 仅为兼容保留;Chrome 58 起已完全不再回退校验 CN。所以 www 没进 SAN 时,改 Nginx 配置毫无意义,只能回 CA 重签或换多域名证书。

# OpenSSL 1.1.1+:直接打印 SAN 扩展
openssl x509 -in example.com.crt -noout -ext subjectAltName
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com

# OpenSSL 1.0.2 兼容写法
openssl x509 -in example.com.crt -noout -text | grep -A1 "Subject Alternative Name"

第 3 步:确认私钥本身能读、能算。这一步只验证私钥完整性与是否加密,不涉及配对:

openssl pkey -in example.com.key -check -noout
# 正常输出:Key is valid
# RSA 2048 位校验通常 1 秒内完成,ECC P-256 更快

若私钥带口令,命令会提示 Enter pass phrase for example.com.key:;在脚本或自动化环境中直接报错,典型输出为 Could not read key from example.com.key 与 error:2807106B:UI routines:UI_process:processing error。此时先解密再部署(多数 Web 服务器启动时不交互输入口令):

# 交互输入原口令,输出未加密私钥;随后 chmod 600 plain.key
openssl pkey -in example.com.key -out plain.key

第 4 步:证书与私钥配对校验(RSA)。两者 modulus 的 SHA-256 必须逐字符相同,不同就说明拿错了私钥文件:

openssl x509 -noout -modulus -in example.com.crt | openssl sha256
openssl rsa  -noout -modulus -in example.com.key | openssl sha256
# 两行输出应完全一致,形如 (stdin)= 9f2c...(OpenSSL 3.x 显示 SHA2-256(stdin)= ...)

第 5 步:ECDSA / Ed25519 没有 modulus,改比公钥。这两类密钥走公钥比对,输出相同即配对成功:

openssl x509 -pubkey -noout -in cert.pem | openssl sha256
openssl pkey -pubout  -in key.pem | openssl sha256

第 6 步:数中间证书张数,别让链变胖。据 Let’s Encrypt 文档,其链文件通常只含 1 张中间证书;含交叉签名时为 2 张:

grep -c 'BEGIN CERTIFICATE' fullchain.pem   # 期望 2 或 3
# 2 = 叶子 + 1 张中间证书(最常见)
# 3 = 叶子 + 中间 + 交叉签名证书
# ≥5 说明链过长:TLS 握手包体积会从约 3.5 KB 涨到 6 KB 以上,
# 易撞上部分负载均衡器/客户端的证书链长度与记录大小限制,建议换 CA 提供的精简链

链过长还有一个隐蔽后果:某些旧客户端(如部分 Android 7 与 Java 8 早期版本)在证书链超过一定层数或体积时会直接握手失败。确认以上六项后再进入下一步的链拼装,能避免 90% 的“证书装了但浏览器报 NET::ERR_CERT_AUTHORITY_INVALID”问题。

第 4 步:fullchain 该怎么拼,顺序错了会怎样?

把叶子证书和中间证书按「服务器证书 → 中间证书」的顺序拼成一个文件,这是 Nginx 的 ssl_certificate、Apache 的 SSLCertificateFile 唯一认的输入格式。顺序颠倒时,Chrome 可能靠 AIA 抓取中间证书自动补齐而”看起来正常”,但 curl、Java、部分 Android 会直接报 unable to get local issuer certificate。

cd /etc/ssl/example
# 叶子证书在前,中间证书在后
cat example.com.crt ca_bundle.crt > fullchain.pem

# 校验:只应看到 2 条记录(叶子 + 1 张中间证书),首条 subject 必须是你自己的域名
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout

不要图省事写 cat *.crt。目录里通常还躺着旧版证书、交叉签名证书甚至自签根,一旦根证书进入链,服务端每次握手都会多发一张约 1.5 KB 的证书;更关键的是据 RFC 5280 的路径构造规则与多数客户端实现,链中出现的自签根会被判为异常,Java 8 老客户端和部分 Android 版本会抛 PKIX path building failed。据 Let’s Encrypt 文档《Chain of Trust》,其下发的 fullchain 只含叶子 + 中间证书,根证书永远由客户端本地信任库提供。

第 5 步:离线跑一遍链校验,期望输出是什么?

用系统信任库验证,不依赖浏览器缓存:

# -CAfile 提供信任锚,-untrusted 提供中间证书(不当作信任锚)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted ca_bundle.crt fullchain.pem
# 期望输出:fullchain.pem: OK
发行版 系统信任库路径 备注
Ubuntu 22.04 / Debian 12 /etc/ssl/certs/ca-certificates.crt 由 ca-certificates 包生成
RHEL 9 / Rocky 9 / CentOS Stream 9 /etc/pki/tls/certs/ca-bundle.crt 软链到 /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem
Alpine 3.18+ /etc/ssl/certs/ca-certificates.crt 需先 apk add ca-certificates

常见报错与对应原因:error 20 at 0 depth lookup: unable to get local issuer certificate 表示中间证书缺失或顺序颠倒;error 19 at 0 depth lookup: self-signed certificate in chain 表示 cat *.crt 把根证书打进了 fullchain。

第 6 步:转 PFX / DER 时,默认算法兼容性怎么看?

# IIS、Windows Server、Tomcat 用 PFX;-in 用叶子证书,不要用 fullchain.pem(否则中间证书重复入包)
openssl pkcs12 -export -out example.pfx 
  -inkey example.key -in example.com.crt -certfile ca_bundle.crt 
  -name "example.com" -passout pass:你的口令
OpenSSL 版本 私钥加密默认值 证书加密默认值 可导入的目标
1.1.1 des-ede3-cbc rc2-40-cbc Windows Server 2012 R2 及更早
3.0 / 3.1 / 3.2 / 3.3 aes-256-cbc + PBKDF2 aes-256-cbc + PBKDF2 Windows Server 2016+、JDK 8u301+
3.x 追加 -legacy RC2/3DES 回退 RC2/3DES 回退 老系统;需 legacy provider 可用
# 目标为 2012 R2 等老系统时回退(先确认 provider:openssl list -providers 应含 legacy)
openssl pkcs12 -export -legacy -out example.pfx 
  -inkey example.key -in example.com.crt -certfile ca_bundle.crt -passout pass:你的口令

# DER:Java 老版本、部分硬件负载设备
openssl x509 -in example.com.crt -outform der -out example.der
openssl x509 -inform der -in example.der -out example.pem

# 拆分 PFX 排查:只取叶子证书 / 取未加密私钥(用完立即 shred -u key.pem)
openssl pkcs12 -in example.pfx -nokeys -clcerts -out server.crt
openssl pkcs12 -in example.pfx -nocerts -nodes -out key.pem

最后收紧权限。默认 umask 022 下文件是 644,任意本地用户都能读走私钥:

chown root:root example.key fullchain.pem
chmod 600 example.key fullchain.pem

Nginx 的 worker 进程以 nginx 用户运行,但读私钥发生在 root 启动的 master 进程里,nginx -s reload 同样由 root 触发,所以 600 + root:root 既能正常加载,也不会把私钥暴露给 worker 或普通用户。

第 7 步:Nginx 1.26 / Apache 2.4.58 / HAProxy 2.8 配置片段

这一步的前提是:三款服务器都要求你手上有一份 fullchain.pem(叶子证书 + 中间证书,按链序排列)。如果只上传 example.com.crt,浏览器在 Android 7、Java 客户端和部分 IoT 设备上会直接报 unable to get local issuer certificate——这是整份 ssl证书 安装教程 best practice 里最容易踩的坑。下面片段均以 example.com 为例,路径请按实际替换。

Nginx 1.26:最小可用片段

server {
    listen 443 ssl;
    http2 on;                                            # 1.25.1 起的新语法,替代 listen ... http2
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;    # 必须 fullchain,不能只放叶子证书
    ssl_certificate_key /etc/nginx/ssl/example.key;      # 建议 chmod 600,属主 root
    ssl_protocols       TLSv1.2 TLSv1.3;                 # 1.26 默认值即 TLSv1.2 TLSv1.3
    ssl_session_cache   shared:SSL:10m;                  # 默认 none;10m ≈ 4 万个会话
    ssl_session_timeout 1d;                              # 默认 5m,会话票据场景可放宽

    # OCSP Stapling:注意 ssl_trusted_certificate 只放中间证书,不含叶子证书
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;    # 放错(含叶子)会导致 stapling 静默失效
    resolver 223.5.5.5 1.1.1.1 valid=300s;
    resolver_timeout 5s;
}

改完必须先校验再重载,reload 不会替你检查语法:

sudo nginx -t && sudo systemctl reload nginx   # 输出 syntax is ok / test is successful 才生效

Apache 2.4.58:链信息直接写进 SSLCertificateFile

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile    /etc/httpd/ssl/fullchain.pem   # 2.4.8 起该文件可含多张证书(叶子+中间)
    SSLCertificateKeyFile /etc/httpd/ssl/example.key
    # SSLCertificateChainFile 自 2.4.8 起已废弃,继续写会触发 AH02559 警告
    SSLUseStapling on
</VirtualHost>

# 以下必须写在全局(server config)层,不能放进 VirtualHost
SSLStaplingCache shmcb:/var/run/ocsp(128000)   # 128 KB 起,过小会频繁回源取 OCSP 响应
sudo apachectl configtest && sudo systemctl reload httpd   # Debian/Ubuntu 为 apache2ctl / apache2

HAProxy 2.8:crt 必须是“证书在前、私钥在后”的合并文件

# 合并顺序不可颠倒,反了会报 unable to load SSL private key from PEM file
cat fullchain.pem example.key > /etc/haproxy/certs/example.pem
chmod 600 /etc/haproxy/certs/example.pem

# haproxy.cfg
frontend https_front
    bind *:443 ssl crt /etc/haproxy/certs/example.pem alpn h2,http/1.1 ocsp-update on
    default_backend app
sudo haproxy -c -f /etc/haproxy/haproxy.cfg && sudo systemctl reload haproxy
项目 Nginx 1.26 Apache 2.4.58 HAProxy 2.8
证书文件 fullchain.pem + 独立 key fullchain.pem + 独立 key 证书与私钥合并的单个 .pem
证书指令 ssl_certificate SSLCertificateFile bind ... ssl crt
OCSP Stapling ssl_stapling on SSLUseStapling on + 全局缓存 ocsp-update on(2.8 新增)
语法校验 nginx -t apachectl configtest haproxy -c -f
平滑生效 systemctl reload nginx systemctl reload httpd systemctl reload haproxy

统一验收与加固口径

# 验证证书链是否完整(应看到 Verify return code: 0 (ok))
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep "Verify return code"

# 验证 OCSP Stapling 是否真的生效(应出现 OCSP Response Status: successful)
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -A1 "OCSP Response Status"

加密套件层面,按 Mozilla SSL Configuration Generator(当前 v5.7)的 Intermediate 档位配置即可;据 Mozilla 文档说明,TLS 1.3 的三套 cipher suite 由 RFC 8446 固定、无需也不应在 ssl_ciphers 中声明,该指令只对 TLS 1.2 及以下版本生效——这也是为什么你会在很多 ssl证书 安装教程 best 实践清单里看到“ssl_ciphers 只写 ECDHE 段”的原因。重载后若 openssl 仍报 verify error:num=21:unable to verify the first certificate,说明 fullchain 里漏了中间证书,回到第 3 步重新拼装即可。

选型对比:证书类型、文件格式与部署方式怎么选

选型不是”越贵越安全”,而是三件事依次定下来:先看域名结构定证书类型,再看服务器定文件格式,最后看运维能力定部署方式。据 CA/Browser Forum Baseline Requirements(SC-62 生效后),公有证书单张有效期上限为 398 天,所以任何选型都要把”续期自动化”算进成本,这也是这份 SSL 证书安装教程 best 实践清单的第一原则。

一、证书类型怎么选?价格参考 2025 年主流 CA 官网及一级代理公开报价,实际以购买页为准。

类型 参考价(元/年) 适用场景 格式建议与常见坑
单域名 DV 0–300(Let’s Encrypt 免费) 个人站、测试环境 PEM:fullchain.pem + privkey.pem
多域名 SAN / UCC 600–2500 同一主体下 5–100 个域名,如 example.com、example.cn、api.example.com PEM;单证书 SAN 条目上限常见为 100 个
通配符 DV 500–1500;OV 3000–8000 数量不定的一级子域名 *.example.com 不覆盖 a.b.example.com,也不覆盖裸域 example.com,需额外加 SAN
OV / EV OV 800–2500;EV 2000–6000 金融、政企对外门户 PEM 或 PFX;Chrome 77 起地址栏不再显示 EV 绿色公司名,选型应依据合规要求而非视觉效果

二、PEM、PFX、DER、P7B 到底用哪个?据 RFC 7292,PKCS#12(PFX)是”证书 + 链 + 私钥”的二进制容器;PEM 则是 RFC 7468 定义的 Base64 文本,可多段拼接,是 Nginx / Apache / HAProxy 的通用交换格式。

格式 含私钥 典型使用者 注意
PEM (.pem/.crt/.key) 分离文件 Nginx、Apache、HAProxy、Traefik 链文件顺序必须是”服务器证书 → 中间证书”
PFX / PKCS#12 (.pfx/.p12) 是 IIS、Tomcat、Windows 证书库 OpenSSL 3.x 默认 PBKDF2 + AES-256-CBC,旧版 IIS 导入会报 The specified network password is not correct
DER (.der/.cer) 否 Java 老版本 truststore、部分硬件网关 单证书二进制,不含链
P7B (.p7b) 否 只导入中间证书 无私钥,不能直接用于部署
# 1) 校验 PEM 链顺序:输出中 s: 为服务器证书,i: 为中间证书,缺 i: 说明链没拼全
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout

# 2) 导出 IIS/Tomcat 可用的 PFX(OpenSSL 3.x;老 IIS 追加 -legacy 降级为 RC2/3DES)
openssl pkcs12 -export -out example.pfx -inkey privkey.pem -in cert.pem 
  -certfile chain.pem -name "example.com" 
  -certpbe AES-256-CBC -keypbe AES-256-CBC -macalg sha256

# 3) 查看证书实际覆盖的域名,确认 SAN 是否包含裸域
openssl x509 -in cert.pem -noout -ext subjectAltName

三、手工放文件、certbot、acme.sh 还是云托管?据 Let’s Encrypt 文档,其 DV 证书有效期 90 天且推荐自动续期,纯手工放置意味着每年至少 4 次人工介入,这是事故高发点。

方式 入口命令 适合 限制
手工放置 复制文件后 nginx -t && systemctl reload nginx 固定 IP、强合规审计场景 续期全靠人工
certbot 2.x certbot --nginx -d example.com 单机 Nginx / Apache 需 80 或 443 端口完成 HTTP-01 验证
acme.sh 3.0.x acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' 通配符、内网、无公网端口 依赖 DNS 服务商 API Token
云负载均衡托管 控制台上传证书 免运维、弹性扩容 私钥托管在云厂商侧,需先过合规评估

一句话决策:域名少且固定用 DV 单域名 PEM;子域多先用通配符但记得补裸域 SAN;Windows 栈直接导出 PFX 并显式指定加密算法;能自动续期就绝不手工——把这条写进你的 SSL 证书安装教程 best 检查表,7 步验收才有意义。

常见报错与排查:从 curl 60 到 key values mismatch

证书装完服务起不来,或者浏览器能开、脚本却报错——这类问题八成不是证书本身签错了,而是链没发全、格式不对、密钥配错这三件事。下面按报错原文逐条给排查路径,每条都能直接复制执行。

curl: (60) unable to get local issuer certificate —— 到底少了几张证书?

先别改配置,数一数服务端实际下发了多少张证书:

# 统计服务端在 TLS 握手时下发的证书数量(含叶子证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 返回 1  → 只发了叶子证书,中间证书缺失
# 返回 2~3 → 链已完整,问题在客户端信任库

返回 1 时,把 Nginx 的 ssl_certificate 指向 fullchain.pem(叶子+中间按顺序拼接),而不是单张 cert.pem。返回 2~3 仍报错,则是客户端 CA 库过期:CentOS 7 执行 update-ca-trust,Ubuntu/Debian 执行 update-ca-certificates。据 RFC 5280 第 6 节,证书路径构建要求中间证书由服务端提供(或客户端预置),服务端只发叶子证书是线上最常见的一类不合规。

nginx: PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)

“no start line”直译就是找不到 -----BEGIN CERTIFICATE-----,文件要么是 DER 二进制,要么被截断。用 file 一眼定性:

file fullchain.pem
# 正常输出:fullchain.pem: ASCII text
# 异常输出:fullchain.pem: data          ← DER 二进制
#           fullchain.pem: empty        ← 空文件,复制时被截断

# 若为 DER,先转成 PEM(注意输入输出用不同文件名,避免同名截断)
openssl x509 -inform der -in fullchain.der -out fullchain.pem
head -1 fullchain.pem   # 应输出 -----BEGIN CERTIFICATE-----

key values mismatch / AH02565: Certificate and private key do not match

证书和私钥不配对。回到模数比对流程:

# RSA 证书与私钥的 modulus 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5
# 两条输出相同 → 配对;不同 → 拿错了 key

# ECDSA 证书不支持 -modulus,改用公钥比对
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout -in privkey.pem | openssl md5

另一种高频误操作是把 chain.pem 写进了 ssl_certificate_key——私钥文件必须只含 -----BEGIN PRIVATE KEY-----(或 RSA/EC PRIVATE KEY)块,用 grep -c 'PRIVATE KEY' privkey.pem 应为 1。

Apache AH02217: ssl_stapling_init_cert: can’t retrieve issuer certificate!

开了 OCSP Stapling 却拿不到签发者证书。两处必须同时满足:SSLCertificateFile 指向 fullchain(不是单证书),并且配置了共享缓存:

# Apache 2.4.6+,放在全局或 VirtualHost 内均可
SSLUseStapling          on
SSLStaplingCache        "shmcb:logs/ssl_stapling(32768)"  # 默认未配置,必须显式声明
SSLCertificateFile      /etc/ssl/fullchain.pem            # 必须是 fullchain
SSLCertificateKeyFile   /etc/ssl/privkey.pem

openssl verify 报 error 20,但浏览器访问正常

这几乎总是本地信任库的问题,不是服务器配置。CentOS 7 的 ca-certificates 包长期停留在 2021.2.50 一类的旧版本,缺少后续新增的根证书:

rpm -q ca-certificates          # CentOS/RHEL:查看当前版本
sudo yum update ca-certificates && sudo update-ca-trust

apt policy ca-certificates      # Debian/Ubuntu
sudo apt update && sudo apt install --only-upgrade ca-certificates
sudo update-ca-certificates

IIS 导入 PFX 报 A certificate chain could not be built to a trusted root authority

导出 PFX 时漏了 -certfile,中间证书没被打包进去:

# 重新导出,ca_bundle.crt 为中间证书链(不含根证书)
openssl pkcs12 -export -out site.pfx 
  -inkey privkey.pem -in fullchain.pem 
  -certfile ca_bundle.crt -name "example.com"
# 验证 PFX 内的证书条数,应为 叶子 + 中间
openssl pkcs12 -in site.pfx -info -nokeys 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

导入后在 IIS 管理器的「中间证书颁发机构」中确认对应中间证书已存在,否则仍需手动导入一次。

reload 后 openssl s_client 看到的还是旧证书

长连接没断。Nginx 的 keepalive_timeout 默认 75 秒,nginx -s reload 只会让 worker 优雅退出,已建立的 TLS 连接继续用旧证书,属正常行为。新建连接即可看到新证书;要立即生效用 systemctl restart nginx 强制断开。

报错关键字 根因 一分钟验证命令
curl: (60) / error 20 链不全或客户端 CA 库过期 openssl s_client -showcerts … | grep -c 'BEGIN CERTIFICATE'
no start line DER 格式或文件截断 file fullchain.pem
key values mismatch 证书与私钥不配对 openssl x509 -noout -modulus … | openssl md5
AH02217 缺 fullchain 或 SSLStaplingCache apachectl -t -D DUMP_VHOSTS + 检查指令

多站点场景额外注意:AH02565 与 key values mismatch 同时出现在两个不同域名下,通常是两个 server 块共用了同一个 ssl_certificate_key,把 A 站点的私钥配到了 B 站点。逐个 server{} 核对证书与密钥路径即可定位。

怎么确认配置真的生效?7 项验收命令

执行 nginx -t 通过、systemctl reload nginx 也没有报错,但这只能说明配置语法正确,并不代表客户端实际拿到的新证书是正确的。证书链是否拼全、OCSP 是否真的被 stapling、SAN 是否覆盖了裸域,这些都必须从客户端一侧探测才能确认。很多 ssl 证书 安装教程 讲完上传文件就结束了,而下面这 7 条验收命令才是 best practice 中最该固化成 checklist 的部分。建议每次换证后按顺序原样跑一遍。

# 验收 1:证书链条数(OpenSSL 1.0.2+ 支持 -showcerts)
openssl s_client -connect example.com:443 -servername example.com 
  -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'
# 期望 2–3(叶子 + 1~2 张中间证书);返回 1 即链不完整

# 验收 2:链校验结果(s_client 默认不校验证书,必须显式开启)
openssl s_client -connect example.com:443 -servername example.com 
  -verify_return_error -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# 输出末尾必须是:Verify return code: 0 (ok)

据 OpenSSL 文档,s_client 在默认模式下即使证书校验失败也照常完成握手并返回 0 退出码,所以第 2 条命令里的 -verify_return_error 不能省。-servername 同样不能省:SNI 多站点环境下漏掉它会拿到默认站点证书,让你误判成“配错了”。

# 验收 3:应用层握手,用 fullchain.pem 当信任锚可反向验证链完整性
curl -sSI https://example.com --cacert fullchain.pem | head -1
# 期望 HTTP/2 200
# 典型失败:curl: (60) SSL certificate problem: unable to get local issuer certificate

# 验收 4:OCSP Stapling 是否生效(nginx 需 ssl_stapling on + ssl_stapling_verify on)
openssl s_client -connect example.com:443 -status /dev/null 
  | grep -A1 'OCSP Response Status'
# 期望 OCSP Response Status: successful
# 未生效显示 "OCSP response: no response sent",多为 ssl_trusted_certificate 配错或 resolver 不可达

# 验收 5:有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -dates -ext subjectAltName

# 验收 6:配置语法 + 平滑重载
nginx -t && systemctl reload nginx          # Apache: apachectl configtest && systemctl reload httpd
# reload 后 1–2 秒内新建连接即生效,无需重启进程

出现 curl: (60) 时不要急着怀疑系统 CA 库:既然已经用 --cacert fullchain.pem 指定了信任锚仍然失败,问题就出在链本身——常见是中间证书缺失,或者顺序写反(中间证书必须排在叶子证书之后)。验收 4 中若看到 no response sent,先确认 ssl_trusted_certificate 指向的是包含中间证书的 fullchain 文件,再看服务器能否解析并访问 OCSP 响应者。

# 验收项 通过标准 不通过的常见根因
1 证书链条数 grep 计数 2–3 只部署了叶子证书,中间证书未拼接
2 链校验 Verify return code: 0 (ok) 根/中间证书缺失、顺序错误、时间不同步
3 应用层响应 HTTP/2 200 链问题(curl 60)、HTTP/3 或 HSTS 回跳异常
4 OCSP Stapling OCSP Response Status: successful ssl_trusted_certificate 错、resolver 不可达
5 有效期与 SAN notAfter 覆盖预期,SAN 含全部域名 漏签裸域、证书与私钥不匹配
6 进程与语法 nginx -t 无 error,reload 成功 旧 worker 未退出、配置未 include
7 外部评分 SSL Labs 达 A+ 缺 HSTS、未启 TLS 1.3、无 stapling

最后一项验收不要只看本机:把域名提交给 Qualys SSL Labs,扫描排队通常 1–3 分钟;同时用手机 4G 网络访问一次,绕过公司代理或 CDN 缓存带来的假阳性。TLS 1.3 默认开启、Strict-Transport-Security: max-age=31536000(可加 includeSubDomains; preload)、OCSP Stapling 三者齐全时基本能稳定拿到 A+,据 Mozilla SSL Configuration Generator 的 intermediate 配置档,这套组合也是兼容性与安全性的平衡点。

文件层面没有区别,都是 PEM 格式的 fullchain + privkey,Nginx/Apache 配置完全一致。差异在续期:Let's Encrypt 有效期 90 天,需要 certbot 或 acme.sh 自动续期并配置 reloadcmd;付费 DV 通常 1 年,到期前 30 天手工更换。另外免费证书不支持 OV/EV 的组织信息校验,也不含商业 SLA。

不要放。标准做法是「服务器证书 + 中间证书」,根证书由客户端本地信任库提供。把根证书打进链里会让握手包增大 1–2 KB,个别老客户端还会因链中出现自签证书而判定失败。用 grep -c 'BEGIN CERTIFICATE' 检查,结果为 2 或 3 即可。

先做哈希比对:RSA 用 openssl x509 -noout -modulus -in cert.pem | openssl sha256 与 openssl rsa -noout -modulus -in key.pem | openssl sha256,两值不同即证明拿错私钥;ECDSA 改用 openssl pkey -pubout 与 openssl x509 -pubkey 比对。确认拿错后,从 CA 后台重新下载私钥或重新签发即可,不要试图修改配置绕过。

看部署目标:Nginx、Apache、HAProxy、Traefik 用 PEM(fullchain.pem + privkey.pem);IIS、Windows 证书存储、Tomcat 的 keystoreType=PKCS12 用 PFX。两者可以互转,openssl pkcs12 -export 生成 PFX,openssl pkcs12 -in xxx.pfx -nodes 拆回 PEM,转换过程不改变证书本身。

常见原因是电脑系统时间偏差超过证书有效期,或本地根证书库过期(例如长期未更新的 Windows 7)。也可能是企业代理做了 SSL 中间人,向浏览器下发了自签证书。先用 openssl s_client 直连源站确认链正常,再排查终端环境与代理。

reload 就够,systemctl reload nginx 会重新加载配置并让 master 进程重新读取证书文件,新连接立即使用新证书,业务不中断。但已建立的 keepalive 长连接会继续沿用旧证书直到超时(Nginx 默认 keepalive_timeout 75 秒),对证书轮换敏感的场景可改为 restart。

不能。*.example.com 只匹配 a.example.com 这一级,不匹配 a.b.example.com,也不匹配裸域 example.com。需要覆盖多级子域时,要么在 SAN 中显式列出具体域名,要么购买多张通配符证书分别对应不同层级。


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

内容审核

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