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,再按上一行拆分 |
六、完整修复流程(可直接照做)
- 备份现有文件:
cp -a /etc/nginx/ssl /etc/nginx/ssl.bak.$(date +%F) - 按第四节转换或修复,输出到新文件名,不要覆盖原件。
- 校验证书:
openssl x509 -in fullchain.pem -noout -subject -issuer -dates - 校验私钥:
openssl rsa -in key.pem -noout -check(EC 私钥用openssl pkey -in key.pem -noout -check) - 校验配对,两行输出必须完全一致:
openssl x509 -in fullchain.pem -noout -modulus | openssl md5 openssl rsa -in key.pem -noout -modulus | openssl md5EC 证书没有 modulus,改用
openssl x509 -in cert.pem -noout -pubkey与openssl pkey -in key.pem -pubout对比。 - 校验证书链:
openssl verify -untrusted intermediate.pem cert.pem,期望输出cert.pem: OK。 - 收紧权限:
chown root:root key.pem && chmod 600 key.pem - 测试并重载:
nginx -t && systemctl reload nginx - 外部验证:
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 的结果。