Nginx 报 PEM_read_bio: no start line:证书格式、转换与排查全指南
1. 问题现象:nginx -t 为什么报 no start line
执行 nginx -t 时出现 PEM_read_bio:no start line,本质是 Nginx 通过 OpenSSL 读取 ssl_certificate 或 ssl_certificate_key 指向的文件时,没有在文件开头找到合法的 PEM 起始行。PEM 证书应以 -----BEGIN CERTIFICATE----- 开头,PEM 私钥应以 -----BEGIN PRIVATE KEY-----、-----BEGIN RSA PRIVATE KEY----- 或 -----BEGIN EC PRIVATE KEY----- 开头。
常见真实报错如下,OpenSSL 1.1、3.x 的错误码会略有差异,但核心关键字一致:
nginx: [emerg] cannot load certificate /etc/nginx/ssl/cert.pem: PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)
nginx: [emerg] cannot load certificate key /etc/nginx/ssl/private.key: PEM_read_bio_PrivateKey() failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: ANY PRIVATE KEY)
nginx: [emerg] BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory:calling fopen(/etc/nginx/ssl/cert.pem, r) error:10000080:BIO routines::no such file)
nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
先不要急着重装 Nginx,也不要反复 reload。优先确认三件事:配置实际指向哪个文件、该文件是不是 PEM、证书和私钥是否匹配。
2. 根因拆解:哪些情况会触发 no start line
- 文件格式不对:把 DER、PFX/P12、JKS、PKCS#7 等二进制格式直接交给 Nginx。它们不是文本 PEM,OpenSSL 找不到 BEGIN 行。
- 路径指错文件:配置写的是证书,实际指向了私钥、CSR、配置文件、压缩包,甚至 HTML 错误页。
- 文件被截断或传输损坏:用 FTP ASCII 模式传输、复制不完整、磁盘写入中断,导致缺少 END 行或内容乱码。
- 文件开头有干扰字符:UTF-8 BOM、行首空格、空行、注释文字、Windows 编辑器附加内容,都会让 OpenSSL 认为没有合法起始行。
- 证书和私钥写反:
ssl_certificate指向私钥,或ssl_certificate_key指向证书,也会出现 Expecting: CERTIFICATE 或 Expecting: ANY PRIVATE KEY。 - 容器或 chroot 路径不一致:宿主机上文件存在,但 Nginx 容器内路径不存在,报错可能同时出现 cannot load certificate 和 No such file or directory。
- 权限问题:文件存在但 Nginx 进程不可读,通常报 Permission denied;如果文件内容同时不对,也会叠加 no start line。
3. 5 分钟排查流程:先定位文件,再验证内容
第一步,找出 Nginx 实际加载的证书路径。不要只看某个 server 块,配置中可能有 include、多个 server 或旧配置文件。
grep -RInE 'ssl_certificate|ssl_certificate_key' /etc/nginx
grep -RInE 'ssl_certificate|ssl_certificate_key' /etc/nginx/conf.d /etc/nginx/sites-enabled
nginx -T | grep -nE 'ssl_certificate|ssl_certificate_key'
第二步,确认文件类型、路径和权限:
ls -l /etc/nginx/ssl/cert.pem /etc/nginx/ssl/private.key
readlink -f /etc/nginx/ssl/cert.pem
file /etc/nginx/ssl/cert.pem
file /etc/nginx/ssl/private.key
第三步,检查文件开头和结尾。PEM 证书第一行应是 -----BEGIN CERTIFICATE-----,最后一行应是 -----END CERTIFICATE-----。
head -n 3 /etc/nginx/ssl/cert.pem
tail -n 3 /etc/nginx/ssl/cert.pem
head -n 3 /etc/nginx/ssl/private.key
tail -n 3 /etc/nginx/ssl/private.key
第四步,用 OpenSSL 直接解析。能解析成功,说明文件至少是合法 PEM;解析失败则继续看具体错误。
openssl x509 -in /etc/nginx/ssl/cert.pem -noout -subject -issuer -dates
openssl pkey -in /etc/nginx/ssl/private.key -noout -check
第五步,确认证书和私钥匹配。对 RSA、ECDSA 都适用:分别导出公钥并比较 SHA-256 指纹,两行结果必须一致。
openssl x509 -in /etc/nginx/ssl/cert.pem -pubkey -noout | openssl sha256
openssl pkey -in /etc/nginx/ssl/private.key -pubout | openssl sha256
4. 修复方法:格式转换、重新传输与权限修正
4.1 DER 转 PEM
如果 file 显示为 data 或 DER,且 head 看不到 BEGIN 行,先转换:
openssl x509 -inform DER -in cert.cer -out cert.pem
openssl x509 -in cert.pem -noout -subject -issuer -dates
4.2 PFX/P12 拆出证书和私钥
先查看 PFX 内容。Nginx 不能直接读取 PFX,也不能交互输入私钥密码,因此私钥需要导出为无密码 PEM,并严格限制权限。
openssl pkcs12 -in a.pfx -info -noout
openssl pkcs12 -in a.pfx -nokeys -out certs.pem
openssl pkcs12 -in a.pfx -nocerts -nodes -out private.key
openssl x509 -in certs.pem -noout -subject -issuer -dates
openssl pkey -in private.key -noout -check
chmod 600 private.key
chmod 644 certs.pem
如果 certs.pem 中包含多段证书,Nginx 的 ssl_certificate 可以使用这种 fullchain 文件,但必须确保第一段是服务器证书,后面是中间证书。若需要拆分:
openssl pkcs12 -in a.pfx -clcerts -nokeys -out cert.pem
openssl pkcs12 -in a.pfx -cacerts -nokeys -out chain.pem
cat cert.pem chain.pem > fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
如果 -clcerts 没有导出服务器证书,改用 -nokeys 输出全部证书,再按段落确认顺序,不要把中间证书放到服务器证书前面。
4.3 文件损坏或截断:用二进制方式重新传输
不要用 FTP ASCII 模式传证书。使用 scp、sftp、rsync 等二进制安全方式,并在源端和服务器端核对校验值。
sha256sum cert.pem
scp cert.pem root@server:/etc/nginx/ssl/cert.pem
ssh root@server sha256sum /etc/nginx/ssl/cert.pem
传输后再次检查 tail -n 1 cert.pem 是否有 END 行。若文件开头有 BOM、空行或多余空格,用编辑器另存为无 BOM 的 UTF-8,或重新生成 PEM。
4.4 权限与属主
Nginx master 进程通常以 root 启动并加载证书,但容器或非 root 运行场景要单独确认。证书可读、私钥最小权限:
chown root:root /etc/nginx/ssl/cert.pem /etc/nginx/ssl/private.key
chmod 644 /etc/nginx/ssl/cert.pem
chmod 600 /etc/nginx/ssl/private.key
ls -l /etc/nginx/ssl
5. Nginx 正确配置示例与生效方式
推荐 ssl_certificate 指向 fullchain(服务器证书加中间证书),ssl_certificate_key 指向单独的私钥文件。修改后必须先测试再 reload。
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/private.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
}
nginx -t
systemctl reload nginx
nginx -s reload
如果 nginx -t 仍失败,不要执行 reload。先回到第 3 节,用 openssl x509 和 openssl pkey 直接验证配置中出现的那个绝对路径。
6. 常见证书格式对比表
| 格式 | 典型扩展名 | 开头或特征 | Nginx 可直接用于 ssl_certificate | 转换或检查命令 |
|---|---|---|---|---|
| PEM | .pem .crt .cer .key | 文本,含 BEGIN CERTIFICATE 或 BEGIN PRIVATE KEY | 是 | openssl x509 -in cert.pem -noout -text |
| DER | .der .cer | 二进制,文本编辑器打开为乱码 | 否 | openssl x509 -inform DER -in cert.der -out cert.pem |
| PKCS#12 / PFX | .pfx .p12 | 二进制,通常含证书和加密私钥 | 否 | openssl pkcs12 -in a.pfx -nokeys -out certs.pem |
| PKCS#7 | .p7b .p7c | 文本或二进制,含证书链,不含私钥 | 否 | openssl pkcs7 -in cert.p7b -print_certs -out certs.pem |
| JKS | .jks | Java KeyStore 二进制 | 否 | 先用 keytool 转 PKCS#12,再用 openssl 转 PEM |
7. 常见报错与排查对照
| 真实报错关键字 | 含义 | 处理动作 |
|---|---|---|
PEM_read_bio_X509_AUX() failed ... no start line ... Expecting: TRUSTED CERTIFICATE |
证书文件不是 PEM、路径指错、文件截断或开头有 BOM | 检查 head -n 1,执行 openssl x509 -in cert.pem -noout -subject,必要时 DER/PFX 转 PEM |
PEM_read_bio_PrivateKey() failed ... no start line ... Expecting: ANY PRIVATE KEY |
私钥不是 PEM,或 ssl_certificate_key 指向了证书/其他文件 |
确认私钥以 BEGIN PRIVATE KEY 或 BEGIN RSA PRIVATE KEY 开头,重新导出 PEM 私钥 |
BIO_new_file() failed ... No such file or directory |
配置路径不存在,常见于容器内路径、软链接失效、拼写错误 | 在 Nginx 所在环境执行 ls -l、readlink -f,确认容器挂载 |
BIO_new_file() failed ... Permission denied |
Nginx 进程无权读取证书或私钥 | 检查属主和权限,私钥 600,证书 644,容器注意 UID 映射 |
SSL_CTX_use_PrivateKey() failed ... key values mismatch |
证书和私钥不是一对 | 分别导出公钥 SHA-256 并比较,替换为匹配的证书和私钥 |
cannot load certificate ... PEM_read_bio_X509_AUX() failed ... no start line |
Nginx 加载证书失败,OpenSSL 找不到 PEM 起始行 | 优先检查文件格式和绝对路径,再检查文件是否被截断 |
nginx: [emerg] cannot load certificate key ... no start line |
Nginx 加载私钥失败 | 不要用 PFX 或 DER 私钥,导出无密码 PEM 私钥并设置 600 权限 |
8. FAQ
Q1:证书文本看起来以 BEGIN CERTIFICATE 开头,为什么还报 no start line?
检查 BEGIN 前是否有 BOM、空格、空行、注释。用 head -n 3 和 od -c 观察前几个字节;最稳妥是重新从 CA 下载或重新转换 PEM。
Q2:PFX 可以直接写进 nginx.conf 吗?
不可以。Nginx 需要 PEM 格式的证书和私钥,PFX 必须先拆成 PEM。私钥不要带交互密码,否则 Nginx 启动时无法输入密码。
Q3:ssl_certificate 需要包含中间证书吗?
建议使用 fullchain,即服务器证书在前、中间证书在后。只放服务器证书可能被部分客户端判定链不完整;但不要把中间证书放在服务器证书前面。
Q4:报 key values mismatch 怎么办?
说明证书和私钥不匹配。用 openssl x509 -pubkey -noout 与 openssl pkey -pubout 分别计算 SHA-256,结果必须一致。
Q5:修改证书后需要重启 Nginx 吗?
通常 systemctl reload nginx 或 nginx -s reload 即可。执行前必须先 nginx -t,测试失败不要 reload。
Q6:Let’s Encrypt 证书应该指向哪个文件?
通常使用 /etc/letsencrypt/live/example.com/fullchain.pem 和 /etc/letsencrypt/live/example.com/privkey.pem。不要指向 cert.pem 作为唯一证书文件,除非你明确知道链已完整。
Q7:容器里宿主机路径明明存在,为什么 Nginx 找不到?
Nginx 只认容器内路径。进入容器执行 ls -l 和 nginx -T,确认证书已挂载到配置中的绝对路径。
9. 上线前检查清单
- 配置中的证书和私钥路径均为绝对路径,且在 Nginx 运行环境内真实存在。
head -n 1 cert.pem为-----BEGIN CERTIFICATE-----,私钥为合法 BEGIN PRIVATE KEY 行。openssl x509 -in cert.pem -noout -subject -issuer -dates能正常输出,证书未过期。openssl pkey -in private.key -noout -check通过,私钥无交互密码。- 证书与私钥公钥 SHA-256 指纹一致,排除 key values mismatch。
- fullchain 顺序正确:服务器证书第一段,中间证书随后。
- 私钥权限 600,证书权限 644,属主和容器 UID 可读。
nginx -t通过后再 reload,并观察systemctl status nginx与错误日志。