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