pfx 转换 pem 怎么做?OpenSSL 命令、Nginx 配置、报错排查与验证指南
把 .pfx 转成 .pem 的核心命令是 openssl pkcs12 -in cert.pfx -out bundle.pem -nodes;拆分私钥用 -nocerts,拆分服务器证书用 -nokeys -clcerts,OpenSSL 3.x 处理旧 RC2 加密 PFX 时加 -legacy。 转换前先执行 openssl pkcs12 -info -in cert.pfx -noout 检查 MAC、加密算法与证书数量;OpenSSL 3.0.13/3.2.1 默认走 PBES2/AES-256-CBC,遇到 RC2-40-CBC 报错时用 -legacy。 Nginx 1.24/1.26 中 ssl_certificate 指向 fullchain.pem,ssl_certificate_key 指向 key.pem;key.pem 权限建议 chmod 600、chown root:root,且用 -nodes 输出的私钥不要放入代码仓库。 验证链路用 openssl verify -CAfile chain.pem cert.pem 和 openssl s_client -connect example.com:443 -servername example.com -showcerts,看到 Verify return code: 0 (ok) 才算链路通过。 PFX 是 PKCS#12 容器,PEM 是 Base64 编码的 DER 文本;PFX 适合 Windows/IIS 导入,PEM 适合 Nginx/Apache/HAProxy 与多数 Linux 服务。
为什么 .pfx 需要转换成 .pem?根本原因是什么?
根本原因是编码格式与容器模型不同,不是扩展名不同。PFX 即 PKCS#12(RFC 7292),是二进制容器,通常把私钥、服务器证书和中间证书链装在一起,并用密码做完整性保护和加密;PEM(RFC 7468)是 Base64 文本,用 —–BEGIN CERTIFICATE—–、—–BEGIN PRIVATE KEY—– 等头尾标识对象。Nginx 1.24/1.26 的 ssl_certificate、Apache 2.4.58 的 SSLCertificateFile、HAProxy 2.8 的 crt 都直接读 PEM;IIS 和部分 Windows 工具更习惯 .pfx,所以迁移到 Linux 或容器时才需要做 pfx 转换 pem。
| 维度 | PFX / PKCS#12 | PEM |
|---|---|---|
| 编码 | DER 二进制 | Base64 文本,带头尾标识 |
| 内容 | 可同时含私钥、证书、中间链 | 一个文件通常放一类对象,链需按顺序拼接 |
| 密码保护 | 整包 MAC 与加密 | 私钥可单独加密,证书通常明文 |
| 典型读取者 | IIS、Windows 证书存储 | Nginx、Apache、HAProxy、容器挂载 |
| 直接改扩展名 | 仍是二进制,PEM 解析器报错 | 不适用 |
所以不能执行 mv cert.pfx cert.pem 了事:文件内容仍是 DER 二进制,Nginx 会报 PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line),或 SSL_CTX_use_certificate_chain_file(“…”) failed。正确路径是先用 OpenSSL 解析 PKCS#12,再分别封装证书链与私钥;这也是 pfx 转换 pem 与“改后缀”的本质区别。
# OpenSSL 3.0+:只查看 PKCS#12 容器信息,不输出私钥
openssl pkcs12 -in cert.pfx -info -noout
# 旧 PFX 常用 RC2-40-CBC 加密;OpenSSL 3.x 默认只加载 default provider
# 需显式启用 legacy provider,否则报 RC2-40-CBC: Unsupported
openssl pkcs12 -legacy -in cert.pfx -info -noout
# 错误示范:仅改扩展名后检查文件类型
mv cert.pfx cert.pem
file cert.pem
# 输出示例:cert.pem: data(而非 ASCII text)
PFX 中的私钥可能被 RC2-40-CBC、3DES 或 AES-256-CBC 加密。OpenSSL 3.x 默认不加载 legacy provider,遇到旧 PFX 会报 RC2-40-CBC unsupported 或 error:0308010C:digital envelope routines:inner_evp_generic_fetch:unsupported;据 OpenSSL 3.0 的 openssl-pkcs12 手册,-legacy 等价于加载 legacy 与 default provider。这类报错是算法提供者差异,不是密码错误,OpenSSL 1.1.1 通常可直接处理同类 PFX。
转换时还要区分对象:fullchain.pem 放服务器证书加中间证书,根证书一般不放,因为客户端信任库已内置根;key.pem 只放私钥,不要把私钥和证书混在一个文件交给 Nginx。合规上,私钥离开本机就扩大暴露面,生产环境的 pfx 转换 pem 应优先在本机用 OpenSSL CLI 完成;在线工具只适合自签测试证书,且要确认是否记录上传文件。Nginx 官方文档也明确 ssl_certificate 使用 PEM 格式证书链,这正是迁移时绕不开格式转换的原因。
把 pfx 转换成 pem 的完整步骤是什么?(OpenSSL 3.x 实操)
把 pfx 转成 pem 本质上是”一次拆包、三次重新封装”:先用 openssl pkcs12 把 PKCS#12 容器里的私钥、服务器证书、中间证书分别抽出来,再用 openssl pkey / openssl x509 去掉 Bag Attributes 噪声,最后按”服务器证书在前、中间证书在后”拼成 fullchain。下面以 OpenSSL 3.x(3.0.x / 3.2.x 实测一致)为准,共 6 步,每步都可独立验证,出错能立刻定位到具体环节。
第 1 步:确认版本与文件完整性
# 记录版本,3.0.13 / 3.2.1 / 1.1.1w 行为基本一致,但 -legacy 参数只有 3.x 有
openssl version -a
# 确认是真正的 PKCS#12 二进制,而不是被改名的 PEM
file cert.pfx # 期望输出:cert.pfx: data
sha256sum cert.pfx # 留档,便于事后比对是否被替换
若 file 输出为 ASCII text,说明文件其实是 PEM 或被 base64 包过,直接 openssl pkcs12 会报 Could not read any data。
第 2 步:检查容器内容与密码是否正确
# 用环境变量传密码,避免密码进入 shell history 和 ps 输出
export PFX_PASS='你的密码'
openssl pkcs12 -info -in cert.pfx -noout -passin env:PFX_PASS
# 典型输出(3.x 导出的 pfx)
MAC: sha256, Iteration 2048
PKCS7 Encrypted data: pbeWithSHA1And40BitRC2-CBC, Iteration 2048
Shrouded Keybag: PBES2, PBKDF2, AES-256-CBC, Iteration 2048
看到 MAC: 行说明密码正确;只报 Mac verify error: invalid password? 则是密码错,不是文件坏。若加密算法显示 RC2-40-CBC(Windows IIS 老导出常见),OpenSSL 3.x 默认拒绝,需加 -legacy 并确保加载 legacy provider,否则报 error:0308010C:digital envelope routines::unsupported。
第 3~5 步:导出私钥、服务器证书、中间证书
| 目标文件 | 关键参数 | 作用 |
|---|---|---|
| key.pem | -nocerts -nodes |
-nodes(等价 -noenc)表示私钥不加密,Nginx 启动时无需交互输入密码;3.x 默认会用 AES-256-CBC 加密私钥 |
| cert.pem | -nokeys -clcerts |
只取终端实体证书,跳过中间证书 |
| chain.pem | -nokeys -cacerts |
只取 CA 证书,即中间证书 |
# 3.1 私钥:先导出原始文件,再用 pkey 重新封装去掉 Bag Attributes
openssl pkcs12 -in cert.pfx -nocerts -nodes -out key.raw.pem -passin env:PFX_PASS
openssl pkey -in key.raw.pem -out key.pem
# 3.2 服务器证书:-clcerts 只输出终端证书
openssl pkcs12 -in cert.pfx -nokeys -clcerts -out cert.raw.pem -passin env:PFX_PASS
openssl x509 -in cert.raw.pem -out cert.pem
# 若 cert.raw.pem 为空(pfx 里终端证书没打 client 标记),退化为全量导出后按 subject 拆分
openssl pkcs12 -in cert.pfx -nokeys -out allcerts.pem -passin env:PFX_PASS
openssl x509 -in allcerts.pem -noout -subject -issuer
# 3.3 中间证书 + 拼接 fullchain(顺序不可颠倒)
openssl pkcs12 -in cert.pfx -nokeys -cacerts -out chain.raw.pem -passin env:PFX_PASS
openssl x509 -in chain.raw.pem -out chain.pem
cat cert.pem chain.pem > fullchain.pem
第 6 步:权限与校验
chmod 600 key.pem fullchain.pem chain.pem
chown root:root key.pem
openssl x509 -in cert.pem -noout -subject -issuer -dates
openssl verify -CAfile chain.pem cert.pem # 期望输出:cert.pem: OK
openssl verify 返回 OK 才说明证书链闭合,可以进入 Nginx 的 ssl_certificate fullchain.pem; / ssl_certificate_key key.pem; 配置环节。据 OpenSSL 官方 pkcs12(1) 手册,-nodes 与 -noenc 同义,且对 -nocerts 之外的场景同样生效;Let’s Encrypt 与 Mozilla SSL Configuration Generator 也均建议私钥落盘权限为 600、属主为 root。
转换后的 PEM 在 Nginx、Apache、HAProxy 里怎么配置?
问:Nginx 里怎么把 fullchain.pem 和 key.pem 挂上去?
Nginx 1.24/1.26 的做法是在 server 块里声明证书与私钥路径,路径必须是绝对路径,且 ssl_certificate 要指向”服务器证书 + 中间证书”拼接后的 fullchain,而不是只含叶证书的 cert.pem。据 Mozilla Server Side TLS 指南(2024 版),仍建议只启用 TLSv1.2 与 TLSv1.3;注意 ssl_protocols 的默认值在 Nginx 1.23.4 起才改为 TLSv1.2 TLSv1.3,更早版本默认包含 TLSv1/1.1,所以显式写出来更安全。
# /etc/nginx/conf.d/example.conf —— Nginx 1.24 / 1.26 通用
server {
listen 443 ssl;
http2 on; # 1.25.1+ 的新写法;旧版用 listen 443 ssl http2;
server_name example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 叶证书 + 中间证书
ssl_certificate_key /etc/nginx/ssl/key.pem; # -nodes 导出的无密码私钥
ssl_protocols TLSv1.2 TLSv1.3; # 1.23.4 之前默认含 TLSv1/1.1,务必显式覆盖
ssl_session_cache shared:SSL:10m; # 默认 off,开启后可复用会话
ssl_session_timeout 1d;
}
# 改完先校验语法,再平滑重载;不要直接 restart 生产服务
nginx -t && systemctl reload nginx
nginx -t 通过时会输出 syntax is ok / test is successful;若私钥是加密 PEM,会看到 nginx: [emerg] cannot load certificate key ... PEM_read_bio_PrivateKey() failed (SSL: ...bad decrypt),或启动时被要求输入密码——后者只在配置了 ssl_password_file(Nginx 1.7.3+)时才会自动读取。
问:Apache 2.4.58 的配置和 Nginx 有什么不一样?
关键差异是链证书的处理方式。Apache 2.4.8 起 SSLCertificateChainFile 已被标记废弃,中间证书可以直接追加在 SSLCertificateFile 指向的文件末尾,所以 fullchain.pem 原样复用即可。另外 SSLProtocol 的默认值是 all(仅禁用 SSLv2/SSLv3,仍放行 TLSv1/1.1),必须显式收紧。
# /etc/httpd/conf.d/ssl.conf —— Apache 2.4.58(RHEL 系路径;Debian/Ubuntu 为 /etc/apache2/sites-available/)
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem # 2.4.8+ 可内含中间证书
SSLCertificateKeyFile /etc/httpd/ssl/key.pem
SSLProtocol -all +TLSv1.2 +TLSv1.3 # 默认 all 会放行 TLSv1/1.1
</VirtualHost>
apachectl configtest && systemctl reload httpd # Debian/Ubuntu 服务名为 apache2
问:HAProxy 为什么不能直接用 fullchain.pem + key.pem 两个文件?
因为 HAProxy 的 crt 参数只接受单个 PEM 文件,且该文件内必须同时包含服务器证书、私钥和中间证书。这是三者中唯一需要额外拼接的一步,也是最常见的踩坑点。HAProxy 2.8 官方文档明确:crt 也可指向目录(加载目录下所有 .pem),但单文件形式更直观。
# 1) 合并:顺序为 证书 → 私钥 → 中间证书,HAProxy 按 PEM 块类型解析
cat cert.pem key.pem chain.pem > /etc/haproxy/certs/example.pem
chmod 600 /etc/haproxy/certs/example.pem # 含私钥,必须收紧权限
# 2) haproxy.cfg 片段(HAProxy 2.8)
# frontend https_in
# bind *:443 ssl crt /etc/haproxy/certs/example.pem alpn h2,http/1.1
# 3) 配置校验通过后再 reload
haproxy -c -f /etc/haproxy/haproxy.cfg
若误把加密私钥拼进去,haproxy -c 会直接报 unable to load SSL private key from PEM file——HAProxy 不支持带密码的私钥,只能用 openssl pkcs12 -in cert.pfx -nodes -out key.pem 导出无密码版本。
| 对比项 | Nginx 1.24/1.26 | Apache 2.4.58 | HAProxy 2.8 |
|---|---|---|---|
| 证书指令 | ssl_certificate |
SSLCertificateFile |
bind ... ssl crt |
| 中间证书放哪 | 与叶证书拼在 fullchain.pem | 2.4.8+ 可追加在同一文件 | 与证书、私钥合并为单文件 |
| 协议默认值 | 1.23.4+ 为 TLSv1.2/1.3 | all(含 TLSv1/1.1) |
bind 未指定则用 openssl 默认 |
| 加密私钥 | 需 ssl_password_file |
需 SSLPassPhraseDialog |
不支持 |
| 校验 / 重载 | nginx -t + reload |
apachectl configtest + reload |
haproxy -c -f + reload |
问:fullchain.pem 里要不要把根证书也塞进去?
不要。多数客户端(浏览器、curl、Java)只缺中间证书,根证书由客户端本地信任库提供。据 Let’s Encrypt 文档,其签发的 fullchain.pem 就是”叶证书 + 中间证书”两级;再附加 ISRG Root X1 只会增加每次握手的字节数,并不能修复链缺失问题——排查链问题时应该看 openssl s_client -connect example.com:443 -showcerts 输出的 Verify return code,而不是靠多塞一张根证书。
pfx 转 pem 用 OpenSSL、certutil 还是在线工具?方案怎么选?
选方案前先把 5 个维度钉死:私钥是否必须不出本机、能否处理 OpenSSL 3.x 的 -legacy 老算法、能否保留完整中间证书链、能否脚本化、能否审计。这 5 项打完分,答案基本就唯一了。PKCS#12 容器格式定义在 RFC 7292,而各家工具对它的”读法”差异,恰恰集中在老加密算法和证书链顺序上。
| 方案 | 版本 | 典型命令 | 私钥位置 | -legacy 支持 | 适用场景 |
|---|---|---|---|---|---|
| OpenSSL CLI | 3.0.13 / 3.2.1 / 1.1.1w | openssl pkcs12 -in cert.pfx -out bundle.pem -nodes |
不出本机 | 3.x 需显式 -legacy |
Linux / 容器 / CI |
| Windows certutil | Win10 / Server 2016+ | certutil -p 密码 -importpfx My cert.pfx |
落在本机证书存储 | 依赖系统 CryptoAPI | IIS 临时处理 |
| PowerShell | 5.1 / 7.4 | Import-PfxCertificate -FilePath C:certscert.pfx -CertStoreLocation Cert:LocalMachineMy |
落在本机证书存储 | 依赖 .NET | 受控 Windows 环境 |
| 在线工具 | 浏览器 | 页面上传 pfx | 离开本机 | 不一定支持 | 仅自签测试证书 |
OpenSSL CLI 的真正优势是可重复:同一条命令能在 CI 里跑一千遍,产物一致。把密码放进环境变量,避免写进 shell history,再顺手记录指纹做审计:
# 适用 OpenSSL 3.0.13 / 3.2.1;-nodes 表示输出明文私钥(Nginx 直接可读)
export PFX_PASS='你的密码' # 别写进命令行,避免 history 泄漏
openssl pkcs12 -in cert.pfx -nocerts -nodes -passin env:PFX_PASS -out key.pem
openssl pkcs12 -in cert.pfx -nokeys -clcerts -passin env:PFX_PASS -out cert.pem # 站点证书
openssl pkcs12 -in cert.pfx -nokeys -cacerts -passin env:PFX_PASS -out chain.pem # 中间证书
cat cert.pem chain.pem > fullchain.pem # Nginx 的 ssl_certificate 指向它
sha256sum key.pem fullchain.pem # 记录指纹,便于变更比对与回滚
Windows 的两个工具更擅长”把 PFX 塞进证书存储”,而不是”产出标准 PEM”。据 OpenSSL 文档,pkcs12 在 3.x 上导出时默认 MAC 已从 1.1.1 的 SHA-1 改为 SHA-256,这也是同一条命令在两个版本上产物不同的原因之一。若目标服务跑在 Linux,仍建议装 OpenSSL 3.x 或用 WSL2 执行 openssl pkcs12,别指望 certutil 帮你拼 fullchain:
:: certutil:仅导入本机存储供 IIS 使用,不生成 PEM(管理员权限)
certutil -p 密码 -importpfx My cert.pfx
# PowerShell 5.1 / 7.4 通用,密码用 SecureString 交互输入
Import-PfxCertificate -FilePath C:certscert.pfx `
-CertStoreLocation Cert:LocalMachineMy `
-Password (Read-Host -AsSecureString)
老 PFX 的处理顺序是固定的:先跑普通命令,再上 -legacy,最后才退到 1.1.1w。典型报错长这样:
Error outputting keys and certificates
…:error:0308010C:digital envelope routines:inner_evp_generic_fetch:unsupported:…:Algorithm (RC2-40-CBC : 0), Properties ()
# OpenSSL 3.x:默认 provider 已停用 RC2-40/RC4,老 PFX 必须显式启用 legacy provider
openssl pkcs12 -legacy -in cert.pfx -out bundle.pem -nodes -passin env:PFX_PASS
# 仍失败时用 1.1.1w 做一次性转换(1.1.1 没有 -legacy 参数,默认就启用老算法)
# 原始 PFX 留在受控目录,转换后按需 chmod 600 bundle.pem
在线转换工具只配处理自签测试证书。上传前检查三件事:页面是否强制 HTTPS、是否明示删除周期、是否记录 IP 与文件名——三者缺一,私钥就等于交给了不可审计的第三方。生产私钥不该经过任何浏览器上传,这是选型里的硬约束,不是偏好。
pfx 转换 pem 时常见报错有哪些,如何排查?
pfx 转换 pem 的报错绝大多数落在三处:PKCS#12 的密码/MAC 校验、OpenSSL 3.x 的 provider 缺省配置、以及输出 PEM 的内容与顺序。下面按报错原文分组,先定位、再修复。
“Mac verify error: invalid password?”——密码错了,还是你给错了密码?
PKCS#12 的 MAC 校验(RFC 7292 定义)只认导出时设置的 PFX 密码,与私钥口令无关;最常见的原因是密码尾部混入换行、空格,或键盘布局把符号打成了别的字符。先只做校验、不落盘:
# 适用 OpenSSL 1.1.1 / 3.x;-passin env: 从环境变量读取密码
export PFX_PASS='YourPassw0rd' # 单引号包裹,避免 $ ! 被 shell 展开
printf '%s' "$PFX_PASS" | wc -c # 核对字符数,确认末尾没有 n
openssl pkcs12 -in cert.pfx -info -noout -passin env:PFX_PASS
# 若仍报错,改用交互输入排除环境变量问题:
openssl pkcs12 -in cert.pfx -info -noout
“Error outputting keys and certificates” + “RC2-40-CBC unsupported”——为什么 OpenSSL 3 转不了老 PFX?
据 OpenSSL 3.0 文档,RC2、RC4、40 位 RC2-40-CBC 等算法已被移入 legacy provider,默认 provider 不再加载,于是老 Windows/IIS 导出的 PFX 解不开。用 -legacy 显式加载,或退回 1.1.1w:
openssl list -providers # OpenSSL 3.x:确认 legacy 是否在列表中
openssl pkcs12 -in cert.pfx -nodes -legacy -out all.pem -passin env:PFX_PASS
# OpenSSL 1.1.1w(无 provider 机制,无需 -legacy):
# openssl pkcs12 -in cert.pfx -nodes -out all.pem
“unable to load private key”——key.pem 为什么 Nginx 不认?
多半是 -clcerts -nocerts 之外的输出里混入了 Bag Attributes 等非 PEM 文本,或导出时漏了 -nodes 导致私钥仍被加密。用 openssl pkey 重新封装成纯净私钥:
openssl pkcs12 -in cert.pfx -nocerts -nodes -out key.raw.pem -passin env:PFX_PASS
openssl pkey -in key.raw.pem -out key.pem # 丢弃 Bag Attributes,统一为 PKCS#8
head -1 key.pem # 期望输出:-----BEGIN PRIVATE KEY-----
“PEM_read_bio_X509” 或 “SSL_CTX_use_certificate_chain_file() failed”——链文件哪里错了?
Nginx 要求 fullchain.pem 按“站点证书 → 中间证书”顺序排列,且不能混入私钥。用下面这条命令把顺序打出来核对:
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 输出第一条必须是你的域名证书,其后才是中间证书(不要放根证书)
“No such file or directory” 与证书校验类报错
Nginx/Apache 以服务账户(nginx/www-data)运行,相对路径按服务工作目录解析,几乎必然找不到文件。配置里一律写绝对路径,并逐级检查目录权限:
namei -l /etc/nginx/ssl/key.pem # 检查每一级目录是否对服务账户可进入(需 x 位)
openssl x509 -in cert.pem -noout -dates -subject -issuer # 先看是否真的过期
若显示 unable to get local issuer certificate,说明缺中间证书,补进 fullchain 即可;只有 certificate has expired 才是真的到期。
| 报错片段 | 根因 | 一条命令定位 | 修复 |
|---|---|---|---|
| Mac verify error | PFX 密码错误或含隐藏字符 | openssl pkcs12 -in cert.pfx -info -noout |
用 -passin env: 或交互输入 |
| RC2-40-CBC unsupported | OpenSSL 3.x 未加载 legacy provider | openssl list -providers |
加 -legacy 或用 1.1.1w |
| unable to load private key | PEM 含 Bag Attributes 或私钥仍加密 | head -1 key.pem |
openssl pkey 重封装 + -nodes |
| SSL_CTX_use_certificate_chain_file failed | 证书顺序错/混入私钥 | openssl pkcs7 -print_certs -noout |
按叶子→中间顺序重排 |
最后提醒:-nomacver 只跳过 MAC 校验、不验证密码,仅在文件本身损坏需要应急读取时使用,用它“解决”密码问题只会让后续私钥匹配失败更难排查。配置验证可参考 Mozilla SSL Configuration Generator 给出的 ssl_certificate / ssl_certificate_key 成对写法,改完执行 nginx -t 再 reload。
转换后如何验证 PEM 与证书链是否生效?
证书转换完成不等于证书可用。常见的情况是:pfx 转换 pem 得到的文件里混入了根证书、私钥与证书不配对,或者只放了一张中间证书,导致浏览器能打开,但 Android 老版本或 Java 客户端报 unable to get local issuer certificate。下面按“证书本身 → 私钥配对 → 链路 → 真实握手 → 服务进程”五个层次逐项验证,每层都给出可复制的命令和判定标准。
第一步:单证书检查。看主体、签发者、有效期与指纹,据 OpenSSL 1.1.1/3.x 官方文档,-dates 输出 notBefore/notAfter,-fingerprint -sha256 用于与 CA 后台签发的指纹核对:
# OpenSSL 1.1.1 / 3.x 通用;逐张检查 leaf 与中间证书
openssl x509 -in cert.pem -noout -subject -issuer -dates -fingerprint -sha256
# 输出示例:
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R3
# notBefore=Jun 1 00:00:00 2024 GMT
# notAfter=Aug 30 23:59:59 2024 GMT
# SHA256 Fingerprint=3A:...:9F
# 确认 SAN 覆盖所有域名(CN 已不被现代客户端采信,RFC 6125 要求校验 SAN)
openssl x509 -in cert.pem -noout -ext subjectAltName
第二步:私钥是否配对。分别导出证书公钥与私钥公钥做 SHA-256 比对,哈希一致才说明二者属于同一密钥对;不一致时 Nginx 启动会报 SSL_CTX_use_PrivateKey ... key values mismatch:
openssl pkey -in key.pem -pubout -outform pem | sha256sum
openssl x509 -in cert.pem -pubkey -noout | sha256sum
# 两行输出必须完全相同;若私钥有密码,第一条命令会提示 Enter pass phrase
第三步:证书链校验。两种用法不能混用,区别如下表:
| 命令 | chain.pem 内容 | 适用场景 | 期望输出 |
|---|---|---|---|
openssl verify -CAfile chain.pem cert.pem |
根证书(自签) | 有完整根证书的私有 CA | cert.pem: OK |
openssl verify -untrusted chain.pem -CAfile /etc/ssl/certs/ca-certificates.crt cert.pem |
仅中间证书 | 公有 CA(Let’s Encrypt、DigiCert) | cert.pem: OK |
# 公有 CA 场景的标准写法(-untrusted 传入中间证书,-CAfile 用系统信任库)
openssl verify -untrusted chain.pem -CAfile /etc/ssl/certs/ca-certificates.crt cert.pem
# 失败典型输出:error 20 at 0 depth lookup: unable to get local issuer certificate
# → chain.pem 缺少中间证书,或顺序颠倒(必须 leaf → intermediate)
第四步:真实握手。本地文件对不代表线上生效,必须对实际端口发起 TLS 连接,据 OpenSSL s_client 文档,-servername 用于发送 SNI,-showcerts 打印服务端下发的整条链:
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| grep -E "Verify return code|depth="
# 期望:depth=0 ... / depth=1 ... / Verify return code: 0 (ok)
# 绕过 DNS 直连指定 IP 验证,排除 CDN 与负载均衡干扰
curl -Iv https://example.com --resolve example.com:443:1.2.3.4 2>&1 | grep -i "SSL certificate verify"
第五步:服务侧确认。配置语法通过不等于进程已加载新证书,需 reload 后确认监听:
# Nginx 1.18+ / 1.24+
nginx -t && systemctl reload nginx
ss -ltnp | grep ':443'
# Apache 2.4
apachectl configtest && systemctl reload apache2
# HAProxy 2.x
haproxy -c -f /etc/haproxy/haproxy.cfg
可选:OCSP 装订。仅当证书内含 AIA OCSP URL 时才检查,据 RFC 6960 与 Mozilla SSL 配置生成器的建议,装订可减少客户端额外请求:
openssl s_client -connect example.com:443 -servername example.com -status /dev/null | grep -A1 "OCSP Response Status"
# 正常:OCSP Response Status: successful (0x0)
# 无 OCSP URL 的证书不以此判失败
生产环境如何安全处理 PFX 密码、PEM 私钥与自动化转换?
在生产环境里做 PFX 转换 PEM,真正容易出问题的不是转换命令本身,而是明文私钥写入磁盘的那几秒和密码出现在 ps 输出里。据 OpenSSL 官方文档,-nodes(等价于 -noenc)导出的私钥完全不加密,任何能读该文件的进程都能直接使用它;因此权限必须和转换同时完成,不能事后补。
1. 私钥保存到磁盘后立即收紧权限
# 目录与文件权限:目录 700 防止遍历,私钥 600 只有 root 可读写
install -d -o root -g root -m 700 /etc/nginx/ssl
chown root:root /etc/nginx/ssl/key.pem
chmod 600 /etc/nginx/ssl/key.pem /etc/nginx/ssl/fullchain.pem /etc/nginx/ssl/chain.pem
chmod 700 /etc/nginx/ssl
# namei -l 逐级打印父目录权限,任何一级出现 o+r/x 都要修正
namei -l /etc/nginx/ssl/key.pem
# f: /etc/nginx/ssl/key.pem
# drwxr-xr-x root root /
# drwxr-xr-x root root etc
# drwxr-xr-x root root nginx
# drwx------ root root ssl
# -rw------- root root key.pem
fullchain.pem 是公开证书,理论上 644 可用,但统一设为 600 更省事:Nginx 的 master 进程以 root 打开文件后,worker 继承的是文件描述符,因此 600 不影响 TLS 握手。不要图省事把 PEM 放在 /tmp 或 /var/www:前者所有用户可写,后者往往属于 www-data,namei -l 会立刻暴露问题。
2. 密码用环境变量传递,绝不放进 argv
# 终端不回显读入密码,再通过 env: 让 OpenSSL 从环境变量取值
read -r -s -p "PFX 密码: " PFX_PASS; echo
export PFX_PASS
openssl pkcs12 -in cert.pfx -passin env:PFX_PASS -info -noout
unset PFX_PASS # 用完立即清除,避免被子进程继承
为什么不用 -passin pass:xxxx?因为在 Linux 上 /proc/<pid>/cmdline 对所有用户可读,转换期间密码会完整出现在 ps aux 里;写进脚本常量或 Git 同理不可接受。生产上更稳妥的做法是把 PFX 存进 Vault / KMS 或受控保险库,并且不要和 Web 根目录放在同一分区,以免备份或误挂载导致泄露。
3. 可直接复用的自动化脚本
#!/usr/bin/env bash
set -euo pipefail # 任一命令失败即退出,未定义变量报错
umask 077 # 新建文件默认 600
PFX=${1:?用法: $0 cert.pfx}
OUT=${2:-/etc/nginx/ssl}
read -r -s -p "PFX 密码: " PFX_PASS; echo
export PFX_PASS
# 先校验密码,错误时 OpenSSL 3.x 报 mac verify failure,1.1.1 报 invalid password
openssl pkcs12 -in "$PFX" -passin env:PFX_PASS -info -noout >/dev/null
TMP=$(mktemp -d) # mktemp 默认创建 0700 目录
trap 'shred -u "$TMP"/*.pem 2>/dev/null; rmdir "$TMP"' EXIT
openssl pkcs12 -in "$PFX" -passin env:PFX_PASS -nocerts -nodes -out "$TMP/key.pem"
openssl pkcs12 -in "$PFX" -passin env:PFX_PASS -clcerts -nokeys -out "$TMP/cert.pem"
openssl pkcs12 -in "$PFX" -passin env:PFX_PASS -cacerts -nokeys -chain -out "$TMP/chain.pem"
cat "$TMP/cert.pem" "$TMP/chain.pem" > "$TMP/fullchain.pem"
# 三重校验:私钥完整性、证书有效期、证书链可验证
openssl pkey -in "$TMP/key.pem" -check -noout
openssl x509 -in "$TMP/cert.pem" -noout -dates -subject
openssl verify -untrusted "$TMP/chain.pem" "$TMP/cert.pem"
install -o root -g root -m 600 "$TMP/key.pem" "$OUT/key.pem"
install -o root -g root -m 600 "$TMP/fullchain.pem" "$OUT/fullchain.pem"
install -o root -g root -m 600 "$TMP/chain.pem" "$OUT/chain.pem"
unset PFX_PASS
nginx -t && systemctl reload nginx # reload 后旧 worker 退出,旧密钥才真正失效
4. 版本固定:1.1.1w 与 3.x 行为不同
| 场景 | OpenSSL 1.1.1w | OpenSSL 3.0.13 / 3.2.1 | 生产处理 |
|---|---|---|---|
| RC2/40-bit 旧 PFX(Windows 2003 时代导出) | 默认可用 | 报 unsupported / 算法不可用 |
仅对单条命令加 -legacy |
| 密码错误提示 | Mac verify error: invalid password? |
error:...:mac verify failure |
脚本只看退出码,不解析文案 |
| 默认 PKCS#12 加密 | 3DES + RC2 | AES-256-CBC + PBKDF2 | 导出给旧客户端需显式 -certpbe PBE-SHA1-3DES |
| legacy provider 加载 | 不存在该机制 | 需 -legacy 或配置 openssl.cnf |
禁止全局加载,避免削弱其他服务 |
openssl version -a # 容器镜像构建时记录版本,写入镜像标签
openssl pkcs12 -legacy -in old.pfx -passin env:PFX_PASS -nodes -nocerts -out key.pem
批量任务务必固定镜像标签(如 alpine:3.19 对应 OpenSSL 3.1.x),否则某次基础镜像升级就可能让整批 pfx 转换 pem 任务集体失败。这套“校验—转换—验证—权限”的流程同样适用于 Let’s Encrypt 证书续期后的 PEM 轮换、OCSP stapling 的链文件更新,以及后续接入 HSM / KMS 托管私钥的迁移路径。
pfx 转换 pem 和 Let's Encrypt 自动申请相比,适合什么场景?
先给结论:pfx 转换 pem 解决的是”证书已经在手上、但格式不对”的问题;Let’s Encrypt(ACME)解决的是”证书还没签发、且我希望以后不用再管”的问题。两者不是替代关系,选型取决于你能不能控制 DNS 记录或 80 端口。
问:只用 certbot 就够了吗?它输出的 PEM 在哪、会不会过期?
据 Let’s Encrypt 官方文档,证书有效期固定为 90 天,官方推荐在到期前 30 天续期。certbot 2.x 安装后默认把私钥和证书链写到 /etc/letsencrypt/live/example.com/ 下:fullchain.pem(站点证书 + 中间 CA)与 privkey.pem(私钥,权限 0600),另有 cert.pem、chain.pem。启用自动续期的发行版会注册 systemd timer,可用下面的命令确认它真的存在——很多”证书莫名过期”的故障就是 timer 没装或被 mask 掉了:
# 适用于 certbot 2.x + systemd 的发行版(Ubuntu 22.04+/Debian 12+ 等)
systemctl list-timers | grep -i certbot
# 预期输出类似:certbot.timer ... (每日两次随机延迟触发)
systemctl status certbot.timer
# 演练续期,不真正写盘,用来验证 80/443 或 DNS 插件是否通
certbot renew --dry-run
注意这条路径下根本不存在 PFX,也就不需要做 pfx 转换 pem;直接让 Nginx 指向 fullchain.pem 和 privkey.pem 即可。
问:那什么时候必须做 pfx 转换 pem?
典型场景是:证书由商业 CA 或企业内部 CA 签发,你在 Windows 门户/AD CS 上只能下载 .pfx(PKCS#12,含私钥+证书链),而目标服务器是 Nginx / Apache / HAProxy——它们只吃 PEM。此时转换是迁移到 Linux 的直接路径,同时应保留原 PFX 归档并记录序列号与到期日,便于审计与续期比对:
# 适用 OpenSSL 1.1.1 与 3.x;-nodes 等价于 3.x 的 -noenc,表示私钥不加密存储
# 1) 导出站点证书(-clcerts 只取叶子证书,跳过根/中间证书)
openssl pkcs12 -in example.com.pfx -clcerts -nokeys -out cert.pem
# 2) 导出私钥(Nginx 启动时无法交互输入口令,必须 -nodes)
openssl pkcs12 -in example.com.pfx -nocerts -nodes -out privkey.pem
# 3) 导出中间证书链,与 cert.pem 拼接成 fullchain.pem
openssl pkcs12 -in example.com.pfx -cacerts -nokeys -out chain.pem
cat cert.pem chain.pem > fullchain.pem
chmod 600 privkey.pem # 私钥权限,建议属主 root
# 4) 归档信息:记录序列号、主体、有效期
openssl x509 -in cert.pem -noout -serial -subject -issuer -dates
若第 1 步报 Mac verify error: invalid password?,多为口令含特殊字符被 shell 转义,改用 -passin stdin 交互输入;若报 No cert in -in file,说明该 PFX 实际是空壳或口令错误,先 openssl pkcs12 -info -in example.com.pfx 验证。转换完成后务必用 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 与私钥的 modulus 比对,确认证书与私钥成对。
问:两种方式怎么选?
| 维度 | Let’s Encrypt / ACME 直接签发 PEM | PFX 经 OpenSSL 转换 PEM |
|---|---|---|
| 前置条件 | 能开 80 端口(HTTP-01)或能写 DNS TXT(DNS-01) | 能从 CA 门户下载 .pfx,无需改网络 |
| 有效期 | 90 天,自动续期 | 通常 1 年(商业 CA)或按内部 CA 策略 |
| 运维成本 | 一次性配置,之后无人值守 | 每次续期需重新转换 + reload |
| 通配符 | 支持,必须用 DNS-01 | 支持,取决于购买/签发的 SAN |
| 内网隔离环境 | 需 DNS-01 或内部 ACME(如 step-ca) | 最省事,离线可完成 |
| 典型适用 | 公网 Web、API 网关、K8s Ingress | 商业 OV/EV、内部 CA、合规要求固定签发方 |
还有一个常被忽略的折中方案:Windows/IIS 继续用 PFX 导入不动,在它前面加一层 Nginx 反向代理,由 Nginx 终止 TLS 并只维护一套 PEM,IIS 后端走 HTTP 或内网自签 TLS。这样证书只有一份需要续期,避免了”双份证书、两处过期”的经典事故。
无论走哪条路,最后两项检查都不能省:一是到期监控(openssl x509 -in fullchain.pem -noout -enddate 接入监控探针,或 certbot certificates 查看剩余天数),二是私钥权限与属主核对(stat -c '%a %U' privkey.pem 应为 600 root)。据 Mozilla Server Side TLS 指南,私钥泄露等同于证书作废,权限检查比证书格式更容易被忽视。
Nginx 的 ssl_certificate 应指向 fullchain.pem,它包含服务器证书和中间证书;只放 cert.pem 时部分客户端会报 unable to get local issuer certificate。ssl_certificate_key 指向单独的 key.pem,不要把私钥拼进 fullchain.pem。
多数情况是 PFX 密码错误,也可能是环境变量末尾带换行、键盘布局导致特殊字符不一致。用 openssl pkcs12 -in cert.pfx -info -noout -passin env:PFX_PASS 复现,并确认 PFX 密码与私钥密码不是同一个概念。
这是 OpenSSL 3.x 默认未加载 legacy provider 导致的旧算法兼容问题,不是证书损坏。对单次转换加 -legacy,例如 openssl pkcs12 -legacy -in cert.pfx -out bundle.pem -nodes -passin env:PFX_PASS;仍失败时用 OpenSSL 1.1.1w 做一次性转换。
公网 Web 且能开放 80 端口或用 DNS-01 时,优先用 certbot 2.x 直接签发 PEM,90 天自动续期更省维护。只有商业 CA/内部 CA 只给 PFX、或网络条件不允许 ACME 时,才用 OpenSSL 做 pfx 转换 pem。
Nginx 通常不以交互方式读取带密码私钥,服务启动时容易失败。生产上用 -nodes 导出无密码 key.pem,再用 chmod 600、chown root:root 和目录 700 保护;需要更高隔离时用独立主机或硬件密钥方案。
常见原因是缺少中间证书、fullchain 顺序错误,或 verify 没有提供正确的 CAfile。先用 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout 看顺序,再执行 openssl verify -untrusted chain.pem -CAfile /etc/ssl/certs/ca-certificates.crt cert.pem。
certutil 和 PowerShell 更适合导入/导出 PFX,不擅长直接生成标准 PEM。可在 Windows 安装 OpenSSL 3.x,或用 WSL2 执行 openssl pkcs12 -in cert.pfx -nocerts -nodes -out key.pem;转换后用 openssl x509 与 openssl pkey 校验。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。