跳到主要内容

Nginx 报 SSL_CTX_use_PrivateKey_file() failed:证书与私钥不匹配的定位、修复与验证

问题背景与根因:Nginx 为什么拒绝加载私钥

当 Nginx 启动或 reload 时出现 nginx: [emerg] SSL_CTX_use_PrivateKey_file('/etc/nginx/ssl/example.com.key') failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),本质是 ssl_certificate 指向的证书公钥与 ssl_certificate_key 指向的私钥不是同一次签发的一对。Nginx 在加载配置时会调用 OpenSSL 的 X509_check_private_key 校验,不匹配就直接拒绝启动或 reload,避免把错误证书上线。

常见根因有四类:一是文件错配,例如 A 域名证书配了 B 域名私钥;二是重签后只替换了 fullchain.pem 或只替换了 privkey.pem,两个文件来自不同签发批次;三是多个 server 块复制配置后路径未改,SNI 默认站点复用了错误文件;四是 RSA 与 ECDSA 证书、PKCS#1 与 PKCS#8 私钥混用后误判。现在公有 CA 证书最长有效期普遍为 398 天,Let’s Encrypt 证书有效期为 90 天,自动续期频率高,如果部署脚本只覆盖其中一个文件,就很容易触发该错误。

不要只看文件名或文件修改时间。正确做法是核对证书与私钥的公钥是否一致:RSA 比较 modulus 的哈希,ECC 比较公钥 PEM 的哈希;同时检查证书链顺序和私钥权限。下文命令均可直接执行,修复后用 nginx -t 验证再 reload。

完整实操步骤:定位、校验、替换与重载

第一步先定位实际生效的配置,避免改了未被 include 的文件:sudo nginx -T | grep -nE 'ssl_certificate|ssl_certificate_key',再执行 sudo grep -RInE 'ssl_certificate|ssl_certificate_key' /etc/nginx。记录每个 server 块的证书和私钥路径,重点检查默认 server、旧域名和复制来的配置。修改前备份:sudo cp -a /etc/nginx/ssl /root/nginx-ssl-backup-$(date +%F)。

第二步校验配对。RSA 证书执行 openssl x509 -noout -modulus -in fullchain.pem | openssl sha256,RSA 私钥执行 openssl rsa -noout -modulus -in privkey.pem | openssl sha256,两个 SHA256 必须相同。ECC 或通用写法执行 openssl x509 -in fullchain.pem -pubkey -noout | openssl sha256 与 openssl pkey -in privkey.pem -pubout | openssl sha256,哈希也必须相同。若私钥是 PKCS#8,openssl rsa 可能提示无法读取,改用 openssl pkey -in privkey.pem -noout -text 检查。

第三步修复。最稳妥是从 CA 重新下载同一次签发产物的证书链和私钥,或让 ACME 客户端重新签发并同时部署 fullchain.pem 与 privkey.pem。多 server 块逐项改路径;不要把证书内容粘进私钥文件。权限建议 chown root:root privkey.pem; chmod 600 privkey.pem; chmod 644 fullchain.pem。最后执行 sudo nginx -t,输出 syntax is ok 和 test is successful 后执行 sudo systemctl reload nginx;失败则看 journalctl -u nginx -n 50 --no-pager。

配置示例:证书链、私钥与多站点写法

推荐的 Nginx TLS server 配置如下,证书使用包含中间证书的 fullchain.pem,私钥使用 privkey.pem,两者必须来自同一签发批次:

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate     /etc/nginx/ssl/example.com.fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.privkey.pem;
    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';
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;
    add_header Strict-Transport-Security 'max-age=31536000' always;
}

Let’s Encrypt 场景可直接指向 live 目录:ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; 与 ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;。这两个软链在续期后会一起更新,通常比手工复制更安全;如果使用部署钩子复制到固定目录,必须同时复制两个文件。证书链顺序应为站点证书在前、中间证书在后,通常不包含根证书。

多个 server 块时,每个 HTTPS 站点都要写自己的证书路径;默认 server 也要配置正确,否则旧客户端或未带 SNI 的请求会命中错误证书。Nginx 1.11.0 及以上可在同一 server 块配置多组 ssl_certificate 和 ssl_certificate_key 实现 RSA/ECDSA 双证书,但每组必须严格配对。私钥目录不要放在 Web 根目录,权限用 chmod 600,属主为 root。

对比表格:不同对象的校验命令与判定标准

排查时不要用 md5sum cert.pem key.pem 比较两个文件,它们本来就不可能相同。应按下列对象选择命令:

校验对象 推荐命令 一致标准 常见误区
RSA 证书模数 openssl x509 -noout -modulus -in cert.pem | openssl sha256 与 RSA 私钥模数哈希相同 比较文件 MD5 无效
RSA 私钥模数 openssl rsa -noout -modulus -in privkey.pem | openssl sha256 与证书模数哈希相同 PKCS#8 私钥可改用 pkey
ECC 或通用公钥 openssl x509 -in cert.pem -pubkey -noout | openssl sha256 与私钥导出公钥哈希相同 ECC 没有 modulus
私钥导出公钥 openssl pkey -in privkey.pem -pubout | openssl sha256 与证书公钥哈希相同 不要用 rsa 命令读 EC 私钥
证书链内容 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout leaf 在前,intermediate 在后 根证书通常不放
CSR 自检 openssl req -in req.csr -noout -verify -subject 签名验证通过且 subject 对应 CSR 不参与 Nginx 加载

如果输出哈希一致但 Nginx 仍报 mismatch,检查是否改错了 server 块、是否存在 include 顺序覆盖、是否 reload 了错误实例。用 nginx -T 看最终合并配置,而不是只看单个文件。表格中的 cert.pem 可替换为 fullchain.pem,因为 openssl x509 默认读取第一张站点证书。

常见错误排查:真实报错与处理动作

报错一:SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。这是证书与私钥不匹配,按上一节比较 modulus 或公钥哈希;重签后同步替换 fullchain.pem 与 privkey.pem,并检查多 server 块路径。

报错二:PEM_read_bio_PrivateKey() failed (SSL: error:0909006C:PEM routines:get_name:no start line)。私钥不是 PEM、文件为空或下载成了 HTML 错误页。执行 file privkey.pem 和 head -n 2 privkey.pem,首行应为 -----BEGIN PRIVATE KEY-----、-----BEGIN RSA PRIVATE KEY----- 或 -----BEGIN EC PRIVATE KEY-----。用 openssl pkey -in privkey.pem -noout -check 验证私钥完整性。

报错三:cannot load certificate ... PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)。证书文件损坏、链顺序错误或混入文本。用 openssl x509 -in fullchain.pem -noout -subject 检查首证书,再用 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem 验证链。

报错四:BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)。用 namei -l /etc/nginx/ssl/privkey.pem 检查每一级目录权限;SELinux 环境执行 getenforce,必要时 restorecon -Rv /etc/nginx/ssl。若 nginx -t 通过但浏览器提示 unable to get local issuer certificate,通常是 fullchain.pem 缺少中间证书,用 openssl s_client -showcerts 核对线上链。

效果验证:确认线上证书已正确切换

先做本地语法和加载验证:sudo nginx -t 应返回 syntax is ok 与 test is successful;随后 sudo systemctl reload nginx。用 sudo nginx -T | grep -n 'ssl_certificate' 确认最终配置路径,避免 reload 了旧实例或改错文件。

抓取线上证书并与本地比对:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -serial -fingerprint -sha256。将输出的 serial 或 SHA256 指纹与本地 openssl x509 -in fullchain.pem -noout -serial -fingerprint -sha256 比较,一致才说明新证书已生效。再执行 echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep 'Verify return code',期望 Verify return code: 0 (ok)。

用 curl -sSI https://example.com | head -n 1 检查 HTTP 状态,用 curl -vI https://example.com 看 TLS 握手和证书主题。最后查看 tail -n 50 /var/log/nginx/error.log 是否还有 SSL 错误,并用 SSL Labs 或 openssl s_client -tls1_2、-tls1_3 分别验证协议。若证书链不完整,浏览器可能仍显示不受信任,但 Nginx 未必报错,必须做线上链验证。

常见问题

这表示 ssl_certificate 的证书公钥与 ssl_certificate_key 的私钥不配对。Nginx 加载时用 X509_check_private_key 校验失败。请按同一次签发核对 RSA modulus 或 ECC 公钥哈希,并同步替换 fullchain.pem 与 privkey.pem。

ECC 没有 RSA modulus,应比较公钥:openssl x509 -in cert.pem -pubkey -noout | openssl sha256 与 openssl pkey -in privkey.pem -pubout | openssl sha256,两个哈希相同即匹配。若私钥是 PKCS#8,用 openssl pkey 读取即可。

续期会生成新的证书和私钥,部署脚本只复制其中一个就会不匹配。检查 /etc/letsencrypt/live/example.com/ 下 fullchain.pem 与 privkey.pem 是否同批更新,重载前同时部署两个文件,或让 Nginx 直接指向 live 软链。

通常不需要。fullchain.pem 应包含站点证书和中间证书,顺序为站点证书在前、中间证书在后;根证书一般由客户端内置信任库提供。缺少中间证书会导致部分浏览器不信任,但 Nginx 可能仍能启动。

建议私钥 root:root、600,证书 644。Nginx master 进程通常以 root 读取私钥,worker 不直接读。若报 Permission denied,用 namei -l 检查目录权限,SELinux 环境用 restorecon -Rv /etc/nginx/ssl 修复上下文。

用 openssl s_client -connect example.com:443 -servername example.com -showcerts 抓取线上证书,比较 serial 或 SHA256 指纹与本地 fullchain.pem 是否一致;再检查 Verify return code 是否为 0,并用 curl -vI 验证握手。