跳到主要内容

Nginx 报 PEM_read_bio: no start line 全解:证书格式排查、转换命令与修复清单

在 Nginx 上启用 HTTPS 时,nginx -t 抛出 PEM_read_bio ... no start line 几乎是最高频的一类证书故障。它和证书是否过期、域名是否匹配无关——Nginx(更准确地说是它链接的 OpenSSL)连文件开头都读不到 -----BEGIN CERTIFICATE----- 这一行。下面给出从定位、转换到验证的完整操作路径。

一、错误现象:报错长什么样,影响是什么

执行 nginx -t 或 systemctl reload nginx 时,配置测试直接失败,Nginx 不会加载新配置;若发生在启动阶段,则整个服务起不来,443 端口无响应。典型输出:

nginx: [emerg] cannot load certificate /etc/nginx/ssl/example.com.pem: PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line:Expecting: TRUSTED CERTIFICATE)
nginx: configuration file /etc/nginx/nginx.conf test failed

OpenSSL 1.1.1 环境下写法略有不同,但关键字一致:

nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line:crypto/pem/pem_lib.c:745:Expecting: TRUSTED CERTIFICATE)

私钥文件出问题时函数名会变成 PEM_read_bio_PrivateKey,期望值变成 ANY PRIVATE KEY:

nginx: [emerg] cannot load certificate key /etc/nginx/ssl/example.com.key: PEM_read_bio_PrivateKey() failed (SSL: error:0A00006E:SSL routines::no start line:Expecting: ANY PRIVATE KEY)

结论很明确:OpenSSL 在文件里找不到 PEM 起始行。这不是证书过期,也不是域名不匹配,而是文件内容根本不是合法 PEM 文本。

二、三步定位:先确认 Nginx 到底读了哪个文件

很多排障时间浪费在改错文件上。先用 nginx -T 打印合并后的完整配置,确认真正生效的路径(注意 include 顺序与 server 块覆盖):

nginx -T 2>/dev/null | grep -nE 'ssl_certificate|ssl_certificate_key'

拿到路径后,做三件事。

第 1 步:看文件真实类型与开头字节

file /etc/nginx/ssl/example.com.pem
head -c 64 /etc/nginx/ssl/example.com.pem | xxd | head -n 4
wc -c /etc/nginx/ssl/example.com.pem

判断标准:file 输出 ASCII text 才可能是 PEM;输出 data 基本是 DER/PFX 二进制;输出 HTML document 说明下载到的是错误页。十六进制中若前三字节是 ef bb bf,是 UTF-8 BOM;若是 30 82,是 DER 的 ASN.1 SEQUENCE 头。

第 2 步:让 OpenSSL 直接解析

openssl x509 -in /etc/nginx/ssl/example.com.pem -noout -subject -issuer -dates

能打印 subject 就是合法证书;报 no start line 是格式或内容问题;报 Permission denied 是权限问题,与格式无关。

第 3 步:区分证书与私钥

openssl pkey -in /etc/nginx/ssl/example.com.key -noout -check

常见低级错误是把 ssl_certificate 指向私钥、把 ssl_certificate_key 指向证书,此时同样报 no start line。

三、根因分析:五种典型场景

  • 格式不对:从 Windows 证书管理器/IIS 导出的 .cer 多为 DER 二进制;.pfx 是 PKCS#12 容器。二者都不是 PEM,Nginx 一律不能直接用。
  • 文件被截断:FTP 用 ASCII 模式传输、或用记事本另存,可能导致内容被改写、末尾 -----END CERTIFICATE----- 丢失;改用 scp/sftp 二进制传输可避免。
  • BOM 或行尾问题:文件开头被写入 UTF-8 BOM,或 -----BEGIN 前存在空格、空行、说明文字——OpenSSL 只认文件首行的标记。
  • 路径指错:指向了 .conf、日志、或下载失败的 HTML 页面;也可能是软链接指向已删除的旧版本文件(Let’s Encrypt 续期后常见)。
  • 私钥带密码:加密私钥开头是 -----BEGIN ENCRYPTED PRIVATE KEY-----,Nginx 无法交互输入密码,同样报 no start line 或 bad decrypt。

一句话总结:用文本编辑器打开,第一行必须是 -----BEGIN CERTIFICATE-----(私钥则是 -----BEGIN PRIVATE KEY----- 或 -----BEGIN RSA PRIVATE KEY-----),否则就要转换或修复。

四、格式转换:DER / PFX / PKCS#7 转 PEM 的完整命令

DER(.cer/.der/.crt 二进制)转 PEM:

openssl x509 -inform der -in cert.cer -out cert.pem
openssl x509 -in cert.pem -noout -subject -dates

PKCS#12(.pfx/.p12)拆分证书与私钥:

# 只导出终端证书(不含私钥)
openssl pkcs12 -in a.pfx -clcerts -nokeys -out cert.pem
# 导出私钥并解密(-nodes 表示不再加密,Nginx 可直接读)
openssl pkcs12 -in a.pfx -nocerts -nodes -out key.pem
# 导出完整证书链(含中间证书)
openssl pkcs12 -in a.pfx -nokeys -out chain.pem

-nodes 生成的是明文私钥,务必配合 chmod 600 和严格的目录权限。若私钥本来带密码,可用 openssl pkey -in key.enc.pem -out key.pem 解密;也可在 Nginx 中用 ssl_password_file 指定密码文件(不推荐,密钥管理更复杂)。

PKCS#7(.p7b/.p7c)转 PEM:

openssl pkcs7 -in cert.p7b -print_certs -out chain.pem

拼接 fullchain 并检查顺序:

cat cert.pem intermediate.pem > fullchain.pem
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout

顺序必须是「站点证书 → 中间证书」。顺序颠倒时 nginx -t 能通过,但浏览器会报证书链不受信任。

去掉 BOM / 修复行尾:

# 若前 3 字节是 BOM,跳过前 3 字节
tail -c +4 cert.pem > cert.clean.pem
# 删除 Windows 回车符
sed -i 's/r$//' cert.pem

五、常见证书格式对比

格式 编码方式 常见扩展名 Nginx 可直接使用 快速识别 转换为 PEM
PEM Base64 文本 .pem .crt .cer .key 是 首行可见 —–BEGIN—– 无需转换
DER 二进制 ASN.1 .der .cer .crt 否 file 显示 data,首字节 30 82 openssl x509 -inform der -in cert.cer -out cert.pem
PKCS#12 / PFX 二进制容器(证书+私钥+链) .pfx .p12 否 file 显示 data,需密码 openssl pkcs12 -in a.pfx -clcerts -nokeys -out cert.pem
PKCS#7 / P7B 二进制或 Base64(仅证书链) .p7b .p7c 否 openssl x509 解析失败 openssl pkcs7 -in cert.p7b -print_certs -out chain.pem
JKS Java KeyStore 二进制 .jks .keystore 否 keytool 才能打开 先 keytool 导出 PKCS#12,再按上一行拆分

六、完整修复流程(可直接照做)

  1. 备份现有文件:cp -a /etc/nginx/ssl /etc/nginx/ssl.bak.$(date +%F)
  2. 按第四节转换或修复,输出到新文件名,不要覆盖原件。
  3. 校验证书:openssl x509 -in fullchain.pem -noout -subject -issuer -dates
  4. 校验私钥:openssl rsa -in key.pem -noout -check(EC 私钥用 openssl pkey -in key.pem -noout -check)
  5. 校验配对,两行输出必须完全一致:
    openssl x509 -in fullchain.pem -noout -modulus | openssl md5
    openssl rsa -in key.pem -noout -modulus | openssl md5

    EC 证书没有 modulus,改用 openssl x509 -in cert.pem -noout -pubkey 与 openssl pkey -in key.pem -pubout 对比。

  6. 校验证书链:openssl verify -untrusted intermediate.pem cert.pem,期望输出 cert.pem: OK。
  7. 收紧权限:chown root:root key.pem && chmod 600 key.pem
  8. 测试并重载:nginx -t && systemctl reload nginx
  9. 外部验证:
    echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | openssl x509 -noout -subject -dates

七、故障排查:真实报错对照表

报错信息 含义 处理方式
PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line:Expecting: TRUSTED CERTIFICATE) 证书文件不是 PEM:DER/PFX、空文件、BOM、HTML 错误页 按第四节转换;用 file 与 head -c 64 | xxd 确认
PEM_read_bio_PrivateKey() failed (SSL: error:0A00006E:SSL routines::no start line:Expecting: ANY PRIVATE KEY) 私钥文件格式错误或仍带密码 openssl pkey -in key.enc.pem -out key.pem 解密,或重新从 PFX 导出
BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory:calling fopen(/etc/nginx/ssl/cert.pem, r)) 路径不存在(拼写错误、软链接失效) ls -l 检查软链接,续期后确认指向新目录
BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied:calling fopen(...)) Nginx worker 无读权限 目录 755、私钥 600 且属主为 root
x509 certificate routines::X509_check_private_key:key values mismatch 证书与私钥不配对 用 modulus / pubkey 对比,重新配对文件
SSL_CTX_use_PrivateKey(...) failed (SSL: error:0A00018A:SSL routines::ee key too small) RSA 密钥长度不足(1024 位) 重新签发 2048 位以上密钥
unable to load certificate ... Expecting: TRUSTED CERTIFICATE(openssl 命令行) 与 Nginx 同源,确认是文件本身问题 先用 openssl 修好,再改 Nginx 配置

注意区分:no start line 是「读不到 PEM 头」,key values mismatch 是「读到了但配不上」,两者修复路径完全不同,不要混为一谈。

八、预防措施:把校验放进部署流程

  • 证书部署前跑一遍校验脚本,失败即中止发布:
    #!/bin/sh
    set -e
    CRT=/etc/nginx/ssl/example.com.fullchain.pem
    KEY=/etc/nginx/ssl/example.com.key
    openssl x509 -in $CRT -noout >/dev/null
    openssl pkey -in $KEY -noout -check >/dev/null
    [ "$(openssl x509 -in $CRT -noout -modulus | openssl md5)" = "$(openssl rsa -in $KEY -noout -modulus | openssl md5)" ]
    echo OK
  • 只用 scp/sftp/rsync 传输证书,禁止 FTP ASCII 模式与 Windows 记事本编辑。
  • 续期(certbot / acme.sh)后自动执行 nginx -t,失败则回滚到上一版本文件。
  • 对到期时间做监控:openssl x509 -in cert.pem -noout -enddate 接入告警。
  • 证书与私钥分目录存放,私钥统一 chmod 600,并用 nginx -T 定期审计实际生效路径。

九、FAQ

Q1:文件后缀是 .crt,就一定是 PEM 吗?

不是。后缀只是习惯,.crt/.cer 既可能是 PEM 也可能是 DER,唯一可靠的判断是打开看首行或执行 openssl x509 -in file -noout -subject。

Q2:能不能让 Nginx 直接读 .pfx 或 .der?

不能。Nginx 的 ssl_certificate 只接受 PEM,必须先转换。

Q3:文件看起来就是文本,为什么还报 no start line?

三种可能:开头有 UTF-8 BOM;-----BEGIN 前有空行或说明文字;BEGIN 被写成小写或连字符数量不对。用 head -c 64 file | xxd 一看便知。

Q4:转换后 nginx -t 通过,浏览器仍提示证书不受信任?

这是链的问题不是格式问题。确认 ssl_certificate 指向的是 fullchain(站点证书在前、中间证书在后),可用 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout 核对顺序。

Q5:私钥带密码,Nginx 报错怎么办?

解密成无密码私钥(openssl pkey -in key.enc.pem -out key.pem),或用 ssl_password_file。生产环境更推荐前者配合 600 权限。

Q6:Windows 上编辑过的证书文件为什么容易坏?

记事本会写入 BOM、把 LF 改成 CRLF,甚至把文件另存为 UTF-16。用 sed -i 's/r$//' 清理行尾,或干脆重新从源文件转换。

Q7:如何一条命令确认证书与私钥是否配对?

RSA:openssl x509 -in cert.pem -noout -modulus | openssl md5 与 openssl rsa -in key.pem -noout -modulus | openssl md5 输出一致即配对;EC 则比对 -pubkey 与 -pubout 的结果。