跳到主要内容
基础知识

证书格式转换工具怎么用?PEM、DER、PKCS#12、JKS 互转的 OpenSSL 与 keytool 实操指南

证书格式转换工具 — 证书格式转换工具怎么用?PEM、DER、PKCS#12、JKS 互转的 OpenSSL 与 keytool 实操指南
核心结论

证书格式转换本质只改封装不改密钥:PEM 是 RFC 7468 定义的 Base64 文本,DER 是同一份 ASN.1 结构的二进制,PKCS#12(RFC 7292)与 JKS 才是带私钥的容器,用 openssl x509、openssl pkcs12、keytool -importkeystore 三条命令即可覆盖 90% 场景。 OpenSSL 3.x 导出 PKCS#12 时默认用 AES-256-CBC + PBKDF2(HMAC-SHA256),给 JDK 8u301 之前或 Windows Server 2012 R2 使用时需追加 -legacy 参数回退到 RC2-40/3DES,否则导入端报 unsupported。 Nginx 的 ssl_certificate 必须指向『叶子证书 + 中间证书』顺序合并的 fullchain.pem(cat cert.pem chain.pem > fullchain.pem),根证书不要放进去,否则部分 Android 与 Java 客户端报 unable to get local issuer certificate。 JDK 9 起 JEP 229 已把默认 keystore.type 改为 pkcs12,JDK 21 新建密钥库默认即 PKCS#12,JKS 只保留读取兼容,新部署建议直接用 keystore.p12 + certificateKeystoreType=PKCS12。 转换后必须做公钥指纹比对:openssl x509 -in cert.pem -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256 与私钥侧输出一致,才算转换成功。

为什么证书格式总是对不上?PEM、DER、PKCS#12、JKS 的差异根源

为什么同一张证书,certbot 生成的文件 Nginx 能用,导入 Tomcat 就报 “unable to find valid certification path”?因为「证书格式」这个词其实混了三层彼此独立的东西:编码层(PEM/DER)、私钥语法层(PKCS#1/PKCS#8)、容器层(PKCS#12/JKS)。任何一层对不上,都会在加载时报错,而且报错信息完全不提示是哪一层出了问题。

第一层:PEM 与 DER 只是同一份 X.509 的两种写法。据 RFC 7468,PEM 是把 DER 二进制做 Base64 后按 64 字符换行,再套上 -----BEGIN CERTIFICATE----- / -----END CERTIFICATE----- 边界行;DER 就是原始 ASN.1 字节流。因为 Base64 有 4/3 膨胀再加上头尾行与换行,DER 体积约为 PEM 的 73%。这一层转换不涉及任何密码学运算,也不需要密码,纯粹是编码解码:

# PEM → DER(-inform 默认就是 PEM,可省略)
openssl x509 -in cert.pem -outform DER -out cert.der
# DER → PEM(关键:必须显式指定 -inform DER,否则报 "unable to load certificate")
openssl x509 -inform DER -in cert.der -out cert.pem
# 校验两者是同一张证书:输出的 SHA-256 指纹必须完全一致
openssl x509 -in cert.pem -noout -fingerprint -sha256
openssl x509 -inform DER -in cert.der -noout -fingerprint -sha256

第二层:私钥的 algid parse error 是怎么来的?PKCS#1 私钥的首行是 -----BEGIN RSA PRIVATE KEY-----,只描述 RSA 一种算法;PKCS#8 首行是 -----BEGIN PRIVATE KEY-----,带 AlgorithmIdentifier 字段,可承载 RSA/EC/Ed25519 任意算法。OpenSSL 3.x 的 genpkey 默认输出 PKCS#8,而 Java 的 KeyFactory 与部分 .NET 版本只认 PKCS#8,把 PKCS#1 喂进去就会抛出 java.security.InvalidKeyException: IOException : algid parse error, not a sequence。转换命令:

# PKCS#1 → PKCS#8(-nocrypt 表示私钥本身不加密;OpenSSL 1.0.0+ 均支持)
openssl pkcs8 -topk8 -nocrypt -in rsa.key -out pkcs8.key
# PKCS#8 → PKCS#1(-traditional 是 OpenSSL 3.x 的写法,1.1.1 用 openssl rsa 即可)
openssl rsa -in pkcs8.key -traditional -out rsa.key

第三层:PKCS#12 的加密算法默认值变了,这是跨平台导入失败的头号原因。PKCS#12(.p12/.pfx)定义于 RFC 7292,是「私钥 + 叶子证书 + 中间链」的加密容器。据 OpenSSL 官方文档,1.1.1 的 pkcs12 -export 默认用 RC2-40-CBC 加密证书、3DES 加密私钥、SHA-1 做 MAC;3.0 起改为 AES-256-CBC + PBKDF2 + SHA-256。Windows IIS 和旧版 Java 8 不认 PBKDF2 派生,导入时会笼统地报密码错误。要在 3.x 上产出兼容包:

# OpenSSL 3.x:-legacy 回落 1.1.1 的算法套件(自动加载 legacy provider)
openssl pkcs12 -export -legacy 
  -in fullchain.pem -inkey privkey.pem 
  -name tomcat -out server.p12
# 验证容器里到底装了什么,以及用的是哪种加密算法
openssl pkcs12 -in server.p12 -info -noout

第四层:JKS 是历史包袱,不是需求。JKS 是 Sun 的私有密钥库格式,JDK 9 通过 JEP 229 把 java.security 中 keystore.type 的默认值从 jks 改成了 pkcs12,此后 keytool -genkeypair 新建的就是 PKCS#12。只有 Tomcat 7、JBoss EAP 6 这类老容器仍硬编码只认 JKS,才需要显式转换:

# PKCS#12 → JKS(-deststoretype 在 JDK 9+ 需显式写 JKS,否则默认还是 PKCS12)
keytool -importkeystore 
  -srckeystore server.p12 -srcstoretype PKCS12 -srcstorepass 你的密码 
  -destkeystore server.jks -deststoretype JKS -deststorepass 你的密码
# 确认实际类型:第一行输出应为 "Keystore type: JKS"
keytool -list -keystore server.jks -storepass 你的密码
格式 规范/编码 含私钥 典型消费者 互转关键参数
PEM RFC 7468,Base64 文本 可选(独立文件) Nginx、Apache、certbot 默认输出 openssl x509 -outform PEM
DER ASN.1 二进制 否 Java CertificateFactory、Windows 双击安装 -inform DER
PKCS#12 RFC 7292,加密容器 是(含链) IIS、macOS 钥匙串、Tomcat 8.5+ openssl pkcs12 -export
JKS Sun 私有格式 是(含链) Tomcat 7、JBoss EAP 6、老 Hadoop keytool -importkeystore

还有一个看不见的坑:证书链顺序。Nginx 的 ssl_certificate 与 Apache 的 SSLCertificateFile 都要求文件内先叶子、后中间,且不含根证书——根证书客户端本来就有,塞进去只会让握手多传 1.5 KB。顺序放反时桌面浏览器往往能靠 AIA 扩展补链,看起来「正常」;但 Java 客户端不做 AIA 抓取,会直接抛 sun.security.validator.ValidatorException: PKIX path building failed,部分 Android 版本同理。用一条命令即可验证顺序是否正确:

# 按顺序列出链中每个证书的 Subject,第一行必须是你的域名(叶子证书)
openssl crl2pkcs7 -nocrl -certfile fullchain.pem 
  | openssl pkcs7 -print_certs -noout | grep subject

据 Let’s Encrypt 文档,certbot 默认产出的就是 PEM 的 privkey.pem、cert.pem、chain.pem、fullchain.pem 四个文件。换句话说,绝大多数「需要证书格式转换工具」的场景,本可以在签发环节直接消除——例如用 --key-type rsa --rsa-key-size 2048 配合后置钩子输出 PKCS#12,比事后用 OpenSSL 反复转换更不容易出错。真正必须转换的只剩两类:目标平台只吃 JKS 的老 Java 容器,以及上游只提供 DER 的 CA。

证书格式转换的完整操作步骤(8 步,从识别格式到部署上线)

证书格式转换最怕的不是命令记不住,而是中途”格式漂移”——同一个域名在 Nginx 上是 PEM、在 Tomcat 上是 JKS、给 Windows 运维同事的又是 PFX,续期时谁也不知道哪份是最新的。下面这套 8 步流程把”识别 → 备份 → 归一 → 拆分 → 合并 → 导出 → 灰度 → 留档”固定下来,可直接写进运维手册。

第 1 步:识别输入格式。先看文件本质,再决定加不加 -inform:

file cert.pfx                  # 输出 "data" 多为 DER/PKCS#12;"ASCII text" 多为 PEM
head -1 cert.crt               # 出现 -----BEGIN CERTIFICATE----- 即 PEM
openssl x509 -in cert.crt -noout -subject   # 试读,报错则基本是 DER

# 典型报错(说明是 DER 编码,需要加 -inform DER):
# 40B7...:error:0D0680A8:asn1 encoding routines:asn1_check_tlen:wrong tag:
# 40B7...:error:0D07803A:asn1 encoding routines:asn1_item_embed_d2i:nested asn1 error

遇到上面这类 asn1 encoding routines 报错,把命令改成 openssl x509 -in cert.crt -inform DER -noout -subject 即可读出主题。注意 -inform 的默认值是 PEM(OpenSSL 3.x 与 1.1.1 一致),这是 DER 文件”读不出来”的最常见原因。

第 2 步:备份与权限收敛。转换全程在离线目录进行,私钥不允许出现在 Web 根目录下:

cp -a /etc/nginx/ssl /backup/ssl-$(date +%F)   # -a 保留权限与时间戳做快照
mkdir -p /root/cert-work && cd /root/cert-work
chmod 700 /root/cert-work                      # 目录本身也要收权限
# 转换结束后统一处理私钥
find . -name "*.key" -o -name "*key*.pem" | xargs -r chmod 600
chown -R root:root .

第 3 步:统一到 PEM。把 DER、P7B、PFX 一律先转成 PEM 文本作为中间格式——OpenSSL 对 PEM 的容错最好,后续拆分合并都基于它。据 OpenSSL 官方文档,openssl x509 默认输出 PEM;Mozilla 服务器端 TLS 配置指南(Mozilla SSL Configuration Generator)推荐的 Nginx/Apache 证书格式同样是 PEM 单文件 + fullchain。

# DER → PEM
openssl x509 -in cert.der -inform DER -out cert.pem -outform PEM
# PKCS#7(.p7b) → PEM(只取证书,不含私钥)
openssl pkcs7 -in bundle.p7b -print_certs -out bundle.pem

第 4 步:拆分 PKCS#12。三个开关分别控制”要不要私钥/要不要叶子/要不要 CA”,不要用 -nodes 一把梭导出一个大文件再手工剪切,极易漏掉中间证书:

# 1) 只导私钥(-nocerts 表示不要证书);PKCS#12 传统加密需 -legacy(OpenSSL 3.x)
openssl pkcs12 -in cert.pfx -nocerts -nodes -out key.pem
# 2) 只导叶子证书(-clcerts 客户端/叶子证书,-nokeys 不要私钥)
openssl pkcs12 -in cert.pfx -clcerts -nokeys -out cert.pem
# 3) 只导 CA 链
openssl pkcs12 -in cert.pfx -cacerts -nokeys -out chain.pem

-nodes 的默认行为是”加密私钥”,加上它才输出明文私钥;若报 Mac verify error: invalid password? 或 pkcs12: Unsupported PKCS12 PFX data,通常是老 Windows 导出的 RC2/3DES 加密包,OpenSSL 3.x 需追加 -legacy 参数(OpenSSL 1.1.1 无此参数)。

第 5 步:合并 fullchain。顺序必须是叶子在前、中间证书在后,根证书不要放进去:

cat cert.pem chain.pem > fullchain.pem
grep -c 'BEGIN CERTIFICATE' fullchain.pem   # 应为 2 或 3(叶子 + 1~2 张中间证书)

如果结果是 1,说明中间证书缺失,移动端和部分 Java 客户端会直接握手失败;如果是 4 及以上,多半把根证书也拼进去了,需剔除。

第 6 步:按目标平台导出。不同运行时的容器格式差异如下,选错会直接导致启动报错:

目标平台 推荐格式 生成命令要点 默认值/注意
Nginx / Apache / HAProxy PEM(fullchain + key) cat cert.pem chain.pem > fullchain.pem 证书链顺序不可颠倒
IIS / Tomcat / .NET PKCS#12 (.pfx) openssl pkcs12 -export -out cert.pfx -inkey key.pem -in fullchain.pem -certfile chain.pem OpenSSL 3.x 导出默认 AES-256-CBC;老客户端读取需加 -legacy
Java 老系统 JKS / PKCS#12 keytool -importkeystore -srckeystore cert.pfx -srcstoretype PKCS12 -destkeystore keystore.jks -deststoretype JKS JDK 9 起 -deststoretype 默认已改为 PKCS12
Windows 证书服务分发 PKCS#7 (.p7b) openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -outform DER -out bundle.p7b 仅含证书,不含私钥

第 7 步:灰度替换。先改备用 server 块或测试站点,配置校验通过后再热加载:

nginx -t                          # 语法校验,失败则不改动线上
systemctl reload nginx            # reload 发 HUP 信号,worker 平滑替换;restart 会中断连接
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | openssl x509 -noout -dates

第 8 步:留档。把上述命令固化成一个脚本,并记录工具版本,避免下次续期时不同人操作导致格式再次漂移:

#!/usr/bin/env bash
# /root/cert-work/convert.sh —— 证书格式转换工具的统一入口
set -euo pipefail
openssl version -a > versions.log     # 记录 OpenSSL 版本与编译参数
keytool -J-version 2>> versions.log    # 记录 JDK 版本
# 以下依次调用第 4~6 步命令,输入输出路径全部写死

据 Let’s Encrypt 文档,其签发的证书有效期已缩短至 90 天并支持自动续期,这意味着格式转换脚本一年至少被执行 4 次——把它版本化(放进 Git 或至少加注释头)比记住命令更重要。当你在排查 unable to get local issuer certificate 或 Java 的 PKIX path building failed 时,回看第 5 步的证书数量校验,往往比重新签发更快定位问题。

配置与命令示例:OpenSSL 3.2、keytool(JDK 17/21)与 Nginx/Tomcat 片段

第一步先确认工具版本,否则默认算法对不上

OpenSSL 3.x 与 1.1.1 在 PKCS#12 导出时的默认加密算法完全不同,keytool 的默认密钥库类型在 JDK 9 之后也从 JKS 改成了 PKCS12。动手前先跑一遍版本确认,避免“命令没错但对方解不开”的扯皮。

# 确认 OpenSSL 版本;本文示例基于 OpenSSL 3.2.1
openssl version
# OpenSSL 3.2.1 11 Sep 2023 (Library: OpenSSL 3.2.1 30 Jan 2024)

# 确认 JDK 与 keytool 版本;本文示例基于 JDK 17.0.10 与 21.0.2
keytool -version
# keytool 21.0.2

PEM 与 DER 怎么互转?私钥要不要单独处理?

DER 是 ASN.1 的二进制编码,PEM 则是同一份 DER 数据做 Base64 后再套上 -----BEGIN CERTIFICATE----- 头尾(RFC 7468 定义的“文本编码”)。所以证书互转用 openssl x509,方向靠 -inform 与 -outform 控制,默认值都是 PEM:

# DER 证书 → PEM(-inform 指定输入格式,默认 PEM)
openssl x509 -inform DER -in cert.der -out cert.pem

# PEM 证书 → DER(-outform 指定输出格式)
openssl x509 -in cert.pem -outform DER -out cert.der

# PKCS#1 私钥 → PKCS#8(-nocrypt 表示私钥不再加密;去掉则用 -passout 设口令)
openssl pkcs8 -topk8 -nocrypt -in rsa.key -out pkcs8.key

# 查看转换结果,确认密钥类型与位数
openssl pkey -in pkcs8.key -text -noout | head -5

PKCS#12 里同时装着私钥、叶子证书和中间链,怎么一次性拆干净?

用 -nocerts / -nokeys 加 -clcerts(只输出客户端/叶子证书)、-cacerts(只输出 CA 证书)三个开关组合,就能把 .p12 拆成 Nginx 需要的两三个文件。-nodes 意为“不对私钥做加密”,别和“no certs”搞混:

# 取私钥(-nocerts 跳过证书,-nodes 输出不加密的 PEM 私钥)
openssl pkcs12 -in bundle.p12 -nocerts -nodes -passin pass:changeit -out privkey.pem

# 取叶子证书(-clcerts 只输出客户端/服务器证书)
openssl pkcs12 -in bundle.p12 -nokeys -clcerts -passin pass:changeit -out cert.pem

# 取中间证书链(-cacerts 只输出 CA 证书)
openssl pkcs12 -in bundle.p12 -nokeys -cacerts -passin pass:changeit -out chain.pem

# 自查:确认私钥与证书公钥匹配,输出两个相同的 hash 才算配对成功
openssl x509 -in cert.pem -noout -pubkey | openssl sha256
openssl pkey -in privkey.pem -pubout | openssl sha256

导出 PKCS#12 时 OpenSSL 3.x 默认用什么算法?为什么老系统会报错?

据 OpenSSL 3.2 文档,openssl pkcs12 -export 的默认值已从 1.1.1 时代的 RC2-40/3DES 换成 AES-256-CBC + PBKDF2 + SHA-256 MAC。JDK 8u301 之前、Windows Server 2012 R2、部分老版本 .NET/Java 客户端不认 AES 加密的 PKCS#12,导入时会抛 java.security.UnrecoverableKeyException: Cannot recover key 或 keytool error: java.io.IOException: keystore password was incorrect——报错指向口令,实际是算法不兼容。此时追加 -legacy 回退到 RC2-40/3DES 即可。

# OpenSSL 3.x 显式指定算法导出(推荐写法,跨版本行为可预期)
openssl pkcs12 -export -inkey privkey.pem -in fullchain.pem 
  -name example.com -out bundle.p12 -passout pass:changeit 
  -keypbe AES-256-CBC -certpbe AES-256-CBC -macalg sha256

# 兼容 JDK 8u301 之前 / Windows Server 2012 R2:回退旧算法
openssl pkcs12 -export -inkey privkey.pem -in fullchain.pem 
  -name example.com -out bundle-legacy.p12 -passout pass:changeit -legacy
转换方向 命令 关键默认值 / 注意点
DER → PEM openssl x509 -inform DER 输入默认按 PEM 解析,必须显式写 -inform
PEM → DER openssl x509 -outform DER 输出默认 PEM,需显式写 -outform
私钥 → PKCS#8 openssl pkcs8 -topk8 -nocrypt 为明文;省略则交互式设口令
PKCS#12 导出 openssl pkcs12 -export OpenSSL 3.x 默认 AES-256-CBC;-legacy 回退 RC2-40
PKCS#12 ↔ JKS keytool -importkeystore JDK 9+ 默认 -storetype 为 PKCS12

JKS 和 PKCS#12 怎么互转?

用 keytool -importkeystore,源和目标的 storetype 明确写出来,不要依赖默认值(JDK 17/21 默认已是 PKCS12,写 JKS 会悄悄产出 PKCS12)。反向转换只需把 -src/-dest 两组参数对调:

# PKCS#12 → JKS(JDK 17.0.10 / 21.0.2 实测)
keytool -importkeystore 
  -srckeystore bundle.p12 -srcstoretype PKCS12 -srcstorepass changeit 
  -destkeystore keystore.jks -deststoretype JKS -deststorepass changeit -destkeypass changeit

# JKS → PKCS#12:把 -src/-dest 的 storetype 对调即可
keytool -importkeystore 
  -srckeystore keystore.jks -srcstoretype JKS -srcstorepass changeit 
  -destkeystore bundle.p12 -deststoretype PKCS12 -deststorepass changeit

Nginx 和 Tomcat 里该填哪个文件?

Nginx 只吃 PEM:证书与私钥各指一个文件,证书文件里应含叶子证书 + 中间证书(即 fullchain.pem)。密码套件可对照 Mozilla SSL Configuration Generator 的 intermediate 档核对,不要手抄过时列表:

# /etc/nginx/nginx.conf 或站点 conf 中的 server 块(Nginx 1.24)
ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 叶子证书 + 中间链
ssl_certificate_key /etc/nginx/ssl/privkey.pem;     # 对应私钥(PEM)
ssl_protocols       TLSv1.2 TLSv1.3;                # 关掉 TLSv1.0/1.1
ssl_session_cache   shared:SSL:10m;                 # 默认 none,10m 约可缓存 4 万会话
ssl_session_timeout 1d;                             # 默认 5m

Tomcat 9/10 走 SSLHostConfig,直接指向 .p12 或 JKS 均可,certificateKeystoreType 必须与文件真实格式一致:

<!-- conf/server.xml:Tomcat 9 / 10 -->
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="conf/keystore.p12"
                 certificateKeystoreType="PKCS12"
                 certificateKeystorePassword="changeit"
                 type="RSA"/>
  </SSLHostConfig>
</Connector>

Apache httpd 则简单得多:自 2.4.8 起,中间证书可直接拼接进 SSLCertificateFile 指向的 fullchain.pem,SSLCertificateChainFile 已废弃,无需再单独指定。这也是 PEM 成为事实标准的原因——多数服务器只认这一种“证书 + 链”的拼接形式,而 PKCS#12/JKS 更多是 Java 生态与 Windows 证书导入向导的产物。

格式与工具怎么选?证书格式转换方案对比表

证书格式转换工具到底该按什么顺序选?先看“消费方”是谁,而不是先选工具:Nginx/Apache 读 PEM;Java 新应用优先 PKCS#12;老 Tomcat/JBoss 才要 JKS;IIS/macOS 导入 PFX(PKCS#12);只分发证书链给 Windows,用 .p7b(PKCS#7)。据 Let’s Encrypt 文档,其签发的 fullchain.pem 与 privkey.pem 就是 PEM 文本,可直接给 Nginx 使用,这也是 PEM 成为事实标准的原因。

格式 编码/是否含私钥 典型用途 关键注意点
PEM Base64 文本,可含私钥与链 Nginx、Apache、Let’s Encrypt 默认 用 -----BEGIN CERTIFICATE----- 识别;私钥必须单独权限保护
DER 二进制,常见为单证书,不含私钥与链 Java 导入、Windows 证书导入 扩展名常为 .der/.cer,需用 -inform DER 读取
PKCS#12 加密容器,含私钥与链 IIS、Tomcat、macOS 钥匙串 扩展名 .p12/.pfx;导出时必须设密码
JKS Java 私有容器,含私钥与链 老 Tomcat、JBoss JDK 9 起 keytool 默认存储类型已改为 PKCS12
PKCS#7 .p7b 只含证书与链,不含私钥 Windows 证书分发 不能用于 TLS 握手部署,只适合信任链分发
工具 版本/平台 强项 短板与关键参数
OpenSSL CLI 3.0.13 / 3.2.1 / 3.3.x;Linux、macOS、Windows 覆盖 PEM/DER/PKCS#12/PKCS#7 全部转换,免费开源 参数多、无图形界面;3.x 的 pkcs12 -export 默认 AES-256-CBC + PBKDF2,读旧文件可能要 -legacy
Java keytool 随 JDK 17.0.10、JDK 21.0.2 分发 专精 JKS 与 PKCS#12 互转,免费 PKCS#12 不允许 keypass 与 storepass 不同
Windows certutil Windows Server 2019/2022,10.0.17763 以上 -encode/-decode、-split、-p 导出 PFX,适合 IIS 运维 命令语义偏 Windows 证书存储,跨平台差
KeyStore Explorer / XCA 5.5.2(GPL)/ 2.4(开源) 桌面图形化批量处理,降低参数记忆成本 需本地安装;自动化流水线不如 CLI

PEM 转 PKCS#12、再转 JKS 的命令怎么写?下面两段可直接复制。第一段用 OpenSSL 3.x 把证书、私钥、链打包为 .p12;第二段用 JDK 17/21 的 keytool 转成 JKS,并显式指定 -deststoretype JKS,因为 JDK 9 起 keytool 默认存储类型是 PKCS12。

# OpenSSL 3.0.13/3.2.1/3.3.x 适用:fullchain.pem 已含站点证书与中间链
# -passout pass: 设置导出密码;未指定 -keypbe/-certpbe 时,3.x 默认 AES-256-CBC + PBKDF2
openssl pkcs12 -export 
  -in fullchain.pem -inkey privkey.pem 
  -name "example.com" 
  -out example.p12 
  -passout pass:ChangeMe123

# keytool 来自 JDK 17.0.10 / 21.0.2:PKCS#12 转 JKS
# -srcstorepass 与 -deststorepass 可不同;JKS 的 -destkeypass 也可单独设置
keytool -importkeystore 
  -srckeystore example.p12 -srcstoretype PKCS12 
  -srcstorepass ChangeMe123 
  -destkeystore example.jks -deststoretype JKS 
  -deststorepass ChangeMe456 
  -destkeypass ChangeMe456

# 验证 JKS 中的别名、证书链与有效期
keytool -list -v -keystore example.jks -storepass ChangeMe456

据 Oracle JDK 17 keytool 文档,把私钥导入 PKCS#12 目标库时,keypass 必须等于 storepass,否则会看到:Warning: Different store and key passwords not supported for PKCS12 KeyStores. Ignoring user-specified -destkeypass value. 这不是致命错误,但意味着你设的 keypass 被忽略,实际生效的是 storepass。

Windows/IIS 只有 PFX,certutil 怎么导出?据 Microsoft Learn 的 certutil 文档,Windows Server 2019/2022(10.0.17763+)可用 -p 指定密码、-exportPFX 从证书存储导出 PFX;-split 可把 PFX 拆成 PEM 证书与私钥,便于迁到 Nginx:

# 从 My 存储导出带私钥的 PFX;CertId 可用证书指纹或 CommonName
certutil -p "PfxPass123" -exportPFX -f My example.com C:certsexample.pfx

# 拆分 PFX:生成 PEM 证书与私钥文件,适合迁移到 Nginx/Apache
certutil -split -p "PfxPass123" C:certsexample.pfx

在线转换网站为什么不能碰生产证书?因为 PKCS#12/JKS 转 PEM 往往要求上传私钥,等于把服务器身份交给第三方;即使站点声称“转换后删除”,私钥也可能已被记录。生产环境应使用本地 OpenSSL、keytool 或 certutil,或 KeyStore Explorer、XCA 这类离线图形工具。上述本地工具成本均为 0 元;商业 SSL 厂商控制台常随证书附赠格式转换,DV 单域名约 100~600 元/年、OV 约 800~3000 元/年,付费买的是签发审核与保障,不是转换能力本身。选择证书格式转换工具时,优先本地、可审计、能给出完整命令的方案。

转换过程中最常见的报错与排查方法(附真实报错信息)

证书格式转换工具真正让人卡住的往往不是命令语法,而是转换后报错——下面按真实报错信息逐条排查,每条都给出可复制的验证命令。先看速查表:

报错关键字 典型根因 首条验证命令
ASN1_get_object:too long / wrong tag PEM/DER 输入格式判断错 openssl x509 -in f -inform DER -noout -subject
Mac verify error: invalid password? P12 密码错,或 MAC 算法不兼容 openssl pkcs12 -in f.p12 -nomacver -info -noout
rc2-40-cbc unsupported OpenSSL 3.x 未加载 legacy provider openssl list -providers
X509_check_private_key:key values mismatch 私钥与证书不配对 openssl x509 -in c.pem -noout -pubkey | openssl sha256
curl: (60) unable to get local issuer certificate fullchain 缺中间证书或顺序反了 grep -c 'BEGIN CERTIFICATE' fullchain.pem
Cannot recover key / keystore password was incorrect keypass 与 storepass 不一致 keytool -list -v -keystore k.p12

为什么把 DER 当 PEM 读会报 asn1 encoding routines:ASN1_get_object:too long?因为 PEM 是 Base64 文本(据 RFC 7468),首字节是 0x2D(-),而 DER 首字节是 0x30(SEQUENCE 标签),解析器按 DER 规则读文本自然长度溢出;反过来把 PEM 当 DER 读则报 wrong tag 或 nested asn1 error。用 -inform 显式指定即可:

# 不确定文件是 PEM 还是 DER?先看首字节
head -c 1 cert.der | xxd        # 30 = DER;2d = PEM

openssl x509 -in cert.der -inform DER -text -noout   # DER 读入
openssl x509 -in cert.pem -outform DER -out cert.der # PEM 转 DER
openssl x509 -in cert.der -inform DER -out cert.pem  # DER 转 PEM(默认 -outform PEM)

为什么 PKCS#12 报 Mac verify error: invalid password? 却可能是密码对的?据 OpenSSL 3.0 CHANGES 说明,3.x 导出 PKCS#12 默认用 AES-256-CBC + HMAC-SHA256(RFC 7292 的 PBMAC1 风格),而 OpenSSL 1.1.1、Java 8 早期版本只认 SHA1 MAC。先跳过 MAC 校验确认内容能否读出:

openssl pkcs12 -in bundle.p12 -nomacver -info -noout   # 不校验 MAC,只验证密码/结构
openssl pkcs12 -in bundle.p12 -nodes -legacy -out all.pem  # 读取端不支持 SHA256 MAC 时加 -legacy

给旧客户端导出时报 Error outputting keys and certificates ... rc2-40-cbc unsupported 怎么办?OpenSSL 3.x 默认只加载 default provider,RC2-40-CBC、DES 等已移入 legacy provider。加 -legacy,或显式指定 PBE 算法:

openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem 
  -certfile chain.pem -out compat.p12 
  -certpbe PBE-SHA1-3DES -keypbe PBE-SHA1-3DES -macalg sha1 
  -passout pass:changeit   # 兼容 Java 8 / Windows Server 2012 等旧栈

Nginx 报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 一定是拿错私钥吗?多数是续期后仍指向上一年的私钥,或同一目录下多域名证书混用。比对公钥指纹最快:

openssl x509 -in fullchain.pem -noout -pubkey | openssl sha256
openssl pkey -in privkey.pem -pubout | openssl sha256   # 两行哈希必须一致

curl 报 (60) unable to get local issuer certificate 是证书没签好吗?通常是 fullchain.pem 只放了域名证书,或把中间证书写在了前面。据 Let’s Encrypt 文档,fullchain 顺序应为「域名证书 → 中间证书」:

grep -c 'BEGIN CERTIFICATE' fullchain.pem   # 正常为 2;输出 0 说明拿错文件
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout  # 逐张列出 subject/issuer

Tomcat 报 java.io.IOException: Cannot recover key 或 keytool error: java.io.IOException: keystore password was incorrect 怎么修?PKCS#12 里私钥口令(keypass)与库口令(storepass)不一致。自 JDK 9 起 keytool 默认 keystore 类型已是 PKCS12,用 -importkeystore 重新导出时把两者设为同一值即可:

keytool -importkeystore -srckeystore old.jks -srcstoretype JKS 
  -destkeystore new.p12 -deststoretype PKCS12 
  -deststorepass changeit -destkeypass changeit 
  -srcalias tomcat -destalias tomcat   # keypass 必须等于 storepass,否则 Tomcat 启动失败

排查顺序建议固定为:先确认输入格式(-inform)→ 再确认口令与 MAC/加密算法(-nomacver、-legacy)→ 最后确认密钥配对与证书链完整性。把这三步固化成脚本,证书格式转换工具带来的大部分”玄学报错”都能在 30 秒内定位。

转换完不代表装对了。下面 6 个动作按”本地 → 线上 → 服务端”顺序排列,每条都有明确的期望输出和失败含义,全部通过才算转换真正生效。据 OpenSSL 3.x 文档,verify 的退出码 0 表示链路可信,非 0 时务必看具体错误串,不要只看命令有没有跑完。

1) 链验证:中间证书到底带没带?

# -CAfile 用系统根证书库;Debian/Ubuntu 为 /etc/ssl/certs/ca-certificates.crt,RHEL 系为 /etc/pki/tls/certs/ca-bundle.crt
# -untrusted 传入中间证书;若 fullchain.pem 已含中间证书,也可直接 -untrusted fullchain.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
               -untrusted chain.pem cert.pem
# 期望输出:cert.pem: OK
# 报 "unable to get issuer certificate" = 中间证书缺失(PEM 拼接顺序错或只导出了叶子证书)
# 报 "unable to get local issuer certificate" = 自签根未被系统信任

2) 公私钥配对:转换后私钥和证书是不是一对?

# 两条命令各自把公钥转成 DER 再算 SHA-256,输出必须完全一致
openssl x509 -in cert.pem -noout -pubkey 
  | openssl pkey -pubin -outform DER | openssl dgst -sha256
openssl pkey -in privkey.pem -pubout -outform DER | openssl dgst -sha256
# 一致示例:(stdin)= 9f2c...(两行哈希相同)
# 不一致说明 PKCS#12/JKS 导出时选错了别名或私钥,https 会直接起不来

3) 证书信息核对:有效期与序列号

# 一次看清主体、签发者、起止时间、序列号与 SHA-256 指纹
openssl x509 -in fullchain.pem -noout 
  -subject -issuer -dates -serial -fingerprint -sha256
# 确认 notAfter 与签发端一致:Let's Encrypt 当前默认有效期为 90 天(据 Let's Encrypt 官方文档)
# 若 notAfter 比预期早很多,多半是转换时误用了旧证书或备份文件

4) 线上比对:CDN 或旧进程是否还在用老证书?

# 只取叶子证书指纹,与本地 fullchain.pem 比对
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -fingerprint -sha256
openssl x509 -in fullchain.pem -noout -fingerprint -sha256
# 两行 SHA256 Fingerprint 不同 = 证书未生效:检查 CDN 回源证书、负载均衡多节点、未 reload 的旧进程
# 注意 -servername 不可省,SNI 缺失会拿到默认站点证书

5) Java 侧验证:条目类型必须是 PrivateKeyEntry

# JDK 8u301+/11+ 均支持直接读取 PKCS#12
keytool -list -v -keystore keystore.p12 -storepass changeit | grep -E 'Owner|Valid|SHA256'
# 期望看到 Entry type: PrivateKeyEntry(若为 trustedCertEntry,说明只导入了证书没导入私钥,Tomcat 会报
# java.security.KeyStoreException: Cannot get key)
# 默认口令 changeit 仅为示例,生产环境用 -storepass:env 传入

6) 服务侧验证:配置、回环请求与协议扫描

nginx -t && systemctl reload nginx
# --resolve 强制走指定 IP,绕过 DNS 与 CDN,直连源站看真实证书链
curl -vI https://example.com --resolve example.com:443:1.2.3.4
# 协议与链扫描(testssl.sh 3.2+)
./testssl.sh --protocols --server-defaults example.com
# 确认 TLS 1.0/1.1 已关闭、链中无多余根证书(据 Mozilla Server Side TLS 指南,现代配置应仅启用 TLS 1.2+)
验证项 关键命令 通过信号 失败最常见原因
链完整性 openssl verify -untrusted cert.pem: OK 缺中间证书、拼接顺序错
密钥配对 openssl pkey -pubout 取哈希 两行哈希一致 JKS 导出选错别名
有效期 openssl x509 -dates notAfter ≈ 90 天 用了旧备份文件
线上一致性 openssl s_client 指纹与本地相同 CDN/多节点未更新
Java 条目 keytool -list -v PrivateKeyEntry 只导入了证书
协议合规 testssl.sh --protocols 仅 TLS 1.2/1.3 旧版 nginx 默认配置

批量转换与安全实践:多域名、多服务器场景怎么做

单个域名手工敲三条命令没问题,但当你手上是 20 个域名、3 台 Tomcat、外加一套 CI 流水线时,手工转换就会变成事故来源:密码靠复制粘贴、别名随手写、JDK 升级后产物悄悄变样。下面这套做法把“证书格式转换工具”从一次性命令行操作,变成可重复执行的流水线步骤。

为什么要先记录版本?因为 PKCS#12 的默认加密算法在不同版本间会变。据 OpenSSL 官方文档,3.0 起 openssl pkcs12 -export 默认使用 PBKDF2 + AES-256-CBC,而 1.1.1 默认是 3DES/RC2-40。老版本 JDK(如 8u2xx 早期版本)导入新产物时常见报错:

keytool error: java.io.IOException: failed to decrypt safe contents entry:
javax.crypto.BadPaddingException: Given final block not properly padded

所以脚本开头必须把 openssl version 与 java -version 写进日志,否则三个月后没人能解释“本地能导入、线上报错”。

#!/usr/bin/env bash
# convert-all.sh —— 幂等转换:fullchain.pem + privkey.pem -> p12 / jks / der
# 验证环境:OpenSSL 3.2.1、eclipse-temurin:21-jre 的 keytool
set -euo pipefail

DOMAIN="${1:?用法: ./convert-all.sh example.com [/etc/ssl/example.com]}"
CERT_DIR="${2:-/etc/ssl/$DOMAIN}"
: "${P12_PASS:?请用环境变量传入密码,不要写死在脚本里}"
OUT="$CERT_DIR/out"; mkdir -p "$OUT"; LOG="$OUT/convert.log"

{ echo "=== $(date -Is) ==="
  openssl version -a | head -3      # 记录版本,便于复现算法差异
  java -version 2>&1 | head -2      # keytool 行为随 JDK 版本变化
} | tee -a "$LOG"

# 1) PEM -> PKCS#12。-name 用主域名;SAN 覆盖的其它域名不要各建别名
openssl pkcs12 -export -in "$CERT_DIR/fullchain.pem" -inkey "$CERT_DIR/privkey.pem" 
  -name "$DOMAIN" -passout env:P12_PASS -out "$OUT/$DOMAIN.p12"

# 2) PKCS#12 -> JKS。先删后建,否则重复执行会因别名已存在而失败
rm -f "$OUT/$DOMAIN.jks"
keytool -importkeystore -srckeystore "$OUT/$DOMAIN.p12" -srcstoretype PKCS12 
  -srcstorepass "$P12_PASS" -srcalias "$DOMAIN" 
  -destkeystore "$OUT/$DOMAIN.jks" -deststoretype JKS 
  -deststorepass "$P12_PASS" -destalias "$DOMAIN" -noprompt

# 3) PEM -> DER(仅叶子证书;需要整链请先拆分 fullchain.pem)
openssl x509 -in "$CERT_DIR/fullchain.pem" -outform DER -out "$OUT/$DOMAIN.cer"

一张 SAN 证书怎么配别名?让 example.com 同时覆盖 www、api 时,PKCS#12 里的 -name 和 JKS 的 -destalias 都只写主域名 example.com;Tomcat 的 Connector 用 defaultSSLHostConfigName="example.com" 去匹配,域名覆盖交给证书的 SAN 扩展本身完成。别名越多,keytool -list 越乱,轮换时漏改一个就是 502。

私钥为什么绝不能出内网?任何把 privkey.pem 或 .p12 上传到在线转换站的做法,都等于把私钥交给了不可控第三方——即便站点声称“本地浏览器处理”,你也无法审计。全部转换用本地 OpenSSL/keytool 完成;确需图形界面核对别名时,选 KeyStore Explorer 这类离线客户端。

转换方式 私钥是否离开主机 可脚本化/幂等 适用场景
本地 openssl + keytool 否 是 批量、CI、容器镜像构建
KeyStore Explorer(离线 GUI) 否 否 单次排障、核对别名与链
在线证书转换网站 是 否 仅可用于公开证书,禁止带私钥

怎么做到到期前自动提醒?用 -checkend 判断剩余秒数,比解析日期字符串可靠:

# 打印到期时间;剩余不足 21 天时返回码为 1
openssl x509 -in /etc/ssl/example.com/fullchain.pem -noout -enddate
openssl x509 -in /etc/ssl/example.com/fullchain.pem -noout -checkend $((21*86400)) 
  || echo "剩余不足 21 天,触发续期" | mail -s "证书告警" ops@example.com

# crontab -e:每周一 03:00 巡检
0 3 * * 1 /usr/local/bin/cert-check.sh /etc/ssl/example.com/fullchain.pem >> /var/log/cert-check.log 2>&1

按 Let’s Encrypt 文档,其证书有效期 90 天且推荐在剩余 30 天时续签,因此巡检阈值取 21 天既能留出人工兜底时间,又不会被续签前的正常窗口刷屏。

CI 里怎么避免“换个机器就导入失败”?锁定镜像与主版本,别用浮动 tag:

# 基础镜像固定到具体版本,openssl 主版本随之固定
FROM eclipse-temurin:21-jre
RUN openssl version   # 期望输出 OpenSSL 3.2.x;1.1.1 与 3.x 的 PKCS#12 默认算法不同
# 仅当必须兼容老设备时才显式降级,并在此处注释原因与工单号
# RUN openssl pkcs12 -export -legacy ...

把上面这套脚本当成你的默认“证书格式转换工具”,openssl version、别名规则、巡检阈值三处都固化在代码里,换人、换机器、换季度都不会改变产物。

能不能不转换?用 ACME 客户端直接产出目标格式

能,而且推荐这么做。现代 ACME 客户端本身就能把证书写到目标路径,Nginx、Java、IIS 需要的 PEM/PKCS#12 不必再经过一次“证书格式转换工具”的二次加工。转换工具更适合离线排障,而不是续期流水线的一环。先看各客户端直接产出格式的能力:

客户端与版本 可直接落盘的格式 关键参数与默认值 续期后自动重载
certbot 2.x+ PEM(cert/key/chain/fullchain) --cert-path、--key-path、--chain-path、--fullchain-path;默认写入 /etc/letsencrypt/live/<domain>/ 是,--deploy-hook
acme.sh 3.x PEM、PKCS#12/PFX --install-cert 的 --key-file/--fullchain-file/--cert-file/--ca-file;--to-pkcs12 --password;默认目录 ~/.acme.sh/<domain>/ 是,--reloadcmd
win-acme 2.x PFX、PEM --store pfxfile 或 --store pemfiles 是,安装后执行脚本

Nginx 场景用 certbot 2.x 的 certonly 模式,四个路径参数只在 certonly 下生效,run --nginx 会由插件自行管理文件:

# certbot 2.x:直接写出 Nginx 需要的 fullchain.pem 与 privkey.pem
sudo certbot certonly --webroot -w /var/www/html -d example.com 
  --cert-path       /etc/nginx/ssl/cert.pem 
  --key-path        /etc/nginx/ssl/privkey.pem 
  --chain-path      /etc/nginx/ssl/chain.pem 
  --fullchain-path  /etc/nginx/ssl/fullchain.pem 
  --deploy-hook     'systemctl reload nginx'
# 注意:私钥默认权限 0600;不要把 --key-path 指到 Web 根目录

acme.sh 3.x 更适合多服务落盘,一条 --install-cert 就把文件写死并登记续期钩子。注意 acme.sh 3.x 默认 CA 是 ZeroSSL,要 Let’s Encrypt 需显式加 --server letsencrypt:

acme.sh --issue -d example.com -w /var/www/html --server letsencrypt
acme.sh --install-cert -d example.com 
  --key-file       /etc/nginx/ssl/privkey.pem 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      'systemctl reload nginx'
# 续期成功后自动重写上述文件并执行 reloadcmd

那 Java 应用怎么办?用 --cert-file 导出叶子证书、--ca-file 导出中间链,把打包命令放进 --reloadcmd 指向的脚本,就无需每次手工调用证书格式转换工具:

acme.sh --install-cert -d example.com 
  --key-file   /etc/pki/app/privkey.pem 
  --cert-file  /etc/pki/app/cert.pem 
  --ca-file    /etc/pki/app/chain.pem 
  --reloadcmd  '/usr/local/bin/build-keystore.sh'

# build-keystore.sh 核心两行
openssl pkcs12 -export -inkey /etc/pki/app/privkey.pem 
  -in /etc/pki/app/cert.pem -certfile /etc/pki/app/chain.pem 
  -name tomcat -out /tmp/app.p12 -passout pass:changeit
keytool -importkeystore 
  -srckeystore /tmp/app.p12 -srcstoretype PKCS12 -srcstorepass changeit 
  -destkeystore /etc/pki/app/keystore.p12 -deststoretype PKCS12 
  -deststorepass changeit
# 旧应用只认 JKS 时,把 -deststoretype 改为 JKS、后缀改为 .jks;
# JDK 9+ 的 keytool 默认 keystore 类型已是 PKCS12

若 -srcstorepass 与 openssl 的 -passout 不一致,会得到真实报错:keytool error: java.io.IOException: keystore password was incorrect,先核对两处密码再查 alias。

IIS 场景可让 acme.sh 直接输出带密码的 PFX,省去 certutil -exportPFX 的手工步骤(在 WSL/Cygwin 中执行):

acme.sh --to-pkcs12 -d example.com --password 'S3cret!'
# 输出:~/.acme.sh/example.com/example.com.pfx,直接导入 IIS 绑定即可

据 Let’s Encrypt 文档,续期应通过 deploy hook 或 reloadcmd 自动重载服务;据 Mozilla SSL Configuration Generator(v5),ssl_protocols TLSv1.2 TLSv1.3 等 TLS 参数也应按版本固化。把证书路径、上述钩子脚本和 TLS 配置一起放进 Git 或 Ansible,才能把证书格式转换工具从流水线里彻底拿掉。

按目标格式选:跨格式通用转换用 OpenSSL 3.x 命令行;JKS 与 PKCS#12 互转必须用 JDK 自带的 keytool;Windows 环境用系统自带 certutil;需要图形化批量处理选 KeyStore Explorer 5.5.2 或 XCA。在线转换站虽然免安装,但要求上传私钥,生产证书不建议使用。

先确认 -passin 传入的密码与导出时 -passout 一致;若密码正确仍报错,多为 OpenSSL 3.x 导出的 PKCS#12 使用 HMAC-SHA256 MAC,而读取端不支持。可加 -nomacver 跳过校验先取出证书内容,或让导出端加 -legacy 重新生成一份兼容格式。

这是 ssl_certificate 指向的证书与 ssl_certificate_key 指向的私钥不配对,常见于同名目录里混放了上一年的私钥,或从 PKCS#12 拆分时把别的域名私钥覆盖进来。用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 分别计算 DER 哈希比对即可定位。

JDK 9 的 JEP 229 已把默认 keystore.type 改为 pkcs12,JDK 21 新建密钥库默认即 PKCS#12,JKS 只保留读取兼容。除非对接 Tomcat 7、JBoss EAP 6 这类老中间件,新部署直接用 keystore.p12 并在 Connector 里写 certificateKeystoreType="PKCS12"。

功能上差别不大,风险差别很大:转换 PKCS#12 到 PEM 必须提供容器密码,等于把私钥与口令一起交给第三方服务器,且无法确认对方是否留档。本地 OpenSSL 与 keytool 均为免费开源,成本为零,没有理由把生产私钥外传。

不会。转换只改变编码与封装(Base64 文本、二进制 ASN.1、加密容器),X.509 字段与签名原样保留,因此 SHA-256 指纹、序列号、Not Before/Not After 完全不变。如果指纹变了,说明拿到的根本不是同一张证书。

转换命令完全相同,区别只在 CN 与 SAN 字段内容。PKCS#12 导出时的 -name 别名建议用主域名(如 example.com),Java 侧通过别名区分条目;通配符证书的 SAN 里是 *.example.com,转换后可用 openssl x509 -noout -ext subjectAltName 核对,避免别名与实际域名不一致导致 Tomcat 匹配失败。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。