跳到主要内容
安装配置教程

ssl证书部署安装怎么做?从 PEM/PFX/JKS 转换到 Nginx、Tomcat、K8s 落地的 8 步流程(2025)

ssl证书部署安装 — ssl证书部署安装怎么做?从 PEM/PFX/JKS 转换到 Nginx、Tomcat、K8s 落地的 8 步流程(2025)
核心结论

ssl证书部署安装的落地标准是:证书链文件按“站点证书→中间证书”顺序拼接、私钥权限 600、服务 reload 后用 openssl s_client -connect example.com:443 -servername example.com 看到 Verify return code: 0 (ok)。 Nginx 1.26 推荐 ssl_certificate 指向 fullchain.pem、ssl_certificate_key 指向 privkey.pem;Tomcat 9.0.x 用 keytool 将 PFX 转 JKS,K8s 1.29 用 kubectl create secret tls 挂载。 格式转换优先用 OpenSSL 3.0.x:PKCS#12 转 PEM 用 openssl pkcs12 -in server.pfx -nodes -out all.pem,再拆分 cert/chain/key,避免把私钥上传到公开目录。 部署后 5 分钟内做三件事:curl -I https://域名 看 200、openssl s_client 看链、testssl.sh 3.2 看协议与 cipher;失败先查权限、SELinux 上下文与进程是否 reload。

为什么证书文件没问题,ssl证书部署安装还是失败?先看 5 个根因

证书本身能 openssl x509 -noout -text 正常解析,浏览器却报错、Java 客户端握手失败——绝大多数”证书没问题但部署失败”都落在下面 5 个根因里。据 Let’s Encrypt 文档,链文件必须包含中间证书;据 OpenSSL 官方文档,verify error 20 就是”本地找不到签发者”。

根因 1:证书链顺序或内容不对(最常见的 80%)

Nginx 的 ssl_certificate 必须指向”站点证书 + 中间证书”拼接的 fullchain.pem,且顺序不能颠倒、不能包含根证书。只放站点证书时,Android 7.0 以下、Java 8 等不擅长自动补链的客户端会报 unable to get local issuer certificate(OpenSSL error 20)。先用命令看线上真实下发了什么:

# 抓取服务端实际下发的证书链;-servername 不可省,否则拿到的是默认站点证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl crl2pkcs7 -nocrl -certfile /dev/stdin | openssl pkcs7 -print_certs -noout
# 期望看到 verify return code: 0 (ok),且列表里至少有 2 张证书

# 正确拼接:站点证书在前,中间证书在后
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -untrusted intermediate.crt example.com.crt   # 期望输出:example.com.crt: OK
# /etc/nginx/conf.d/example.conf(Nginx 1.20+ 均适用)
server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须含中间证书
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;                # 对齐 Mozilla intermediate 配置
}

根因 2:文件格式与服务器不匹配

把 PFX 直接填进 ssl_certificate,Nginx 启动即报 PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)——因为 PFX 是 DER 二进制容器,而 Nginx/Apache 只认 PEM(Base64,首行 -----BEGIN CERTIFICATE-----)。

格式 编码/容器 典型使用者 私钥是否内含 转换命令
PEM Base64 文本 Nginx、Apache、HAProxy 否(独立文件) —
PKCS#12 / PFX 二进制,.pfx/.p12 IIS、Windows、Java 应用 是 openssl pkcs12 -in a.pfx -nodes -out all.pem
JKS Java KeyStore Tomcat 8 及更早 是 keytool -importkeystore -srckeystore a.p12 -srcstoretype PKCS12 -destkeystore a.jks -deststoretype JKS

注意 OpenSSL 3.x 默认禁用 RC2/3DES 等旧算法,解老 PFX 会报 error:0308010C:digital envelope routines::unsupported,需加 -legacy 参数。Tomcat 9+ 官方推荐直接用 PKCS12 替代 JKS(server.xml 中 keystoreType="PKCS12")。

根因 3:私钥权限、属主或 SELinux 上下文不对

chown root:root /etc/nginx/ssl/privkey.pem
chmod 600 /etc/nginx/ssl/privkey.pem      # 仅 root 可读,worker 由 master 以 root 打开后降权
chmod 644 /etc/nginx/ssl/fullchain.pem
restorecon -Rv /etc/nginx/ssl            # SELinux enforcing 下必须执行,否则 nginx 仍 Permission denied
ls -lZ /etc/nginx/ssl                    # -Z 查看上下文,应为 cert_t 一类可读标签

同时确认私钥不在 /var/www/html 这类可被 HTTP 直接下载的目录;一旦 https://站点/privkey.pem 可访问,证书等于作废,必须重签。典型报错是 BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied)。

根因 4:只换了文件,没有 reload/restart

nginx -t && systemctl reload nginx        # reload 发 HUP,master 重读配置并平滑换 worker
apachectl -t && systemctl reload httpd
# Tomcat 例外:server.xml 只在启动时解析,reload 无效,必须
systemctl restart tomcat

验证是否真的生效:openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -subject,对比 notAfter 是否为新证书到期日。

根因 5:多实例 / 容器 / K8s 未同步

Docker 用 mv 覆盖宿主机证书文件会改变 inode,而 bind mount 绑定的是旧 inode,容器内仍读旧证书;应改为同 inode 覆盖(cat new.pem > /host/privkey.pem)或挂载整个目录。K8s 中 Secret 更新后,kubelet 同步周期加 Ingress Controller 自身 resync,通常需 30–60 秒才推给 Nginx:

kubectl create secret tls example-tls --cert=fullchain.pem --key=privkey.pem 
  --dry-run=client -o yaml | kubectl apply -f -      # 幂等更新,避免 delete 造成短暂 404
kubectl rollout restart deploy/ingress-nginx-controller -n ingress-nginx   # 急用时强制重载

排查完这 5 项,再进入 PEM/PFX/JKS 转换与 Nginx、Tomcat、K8s 的具体落地步骤,就不会在”证书明明有效”上反复绕圈。

完整实操步骤(上):步骤 1-5 做文件、权限与备份

Q:证书从 CA 下载下来之后,前 5 步到底该按什么顺序做?顺序错了,后面 Nginx 或 Tomcat 一定会因为私钥权限、证书链顺序或入口判断问题而失败。下面 5 步在任何 Linux 发行版上都通用,命令默认以 root 执行。

步骤 1:检查流量入口——先确认 TLS 在哪儿终止。很多“证书装了不生效”的问题,根本原因是流量根本没有到达这台机器。

# 1) 确认解析:A 与 AAAA 是否都指向真正对外的入口(IPv6 漏配会走回源失败)
dig +short example.com A
dig +short example.com AAAA

# 2) 确认本机 443 真的在监听(ss 属 iproute2,CentOS 7+/Ubuntu 18.04+ 自带)
ss -lntp | grep ':443'

# 3) 看边缘返回的证书签发者是谁——若不是你的 CA,说明 CDN/WAF 已终止 TLS
curl -sI https://example.com | grep -iE 'server|via|cf-ray|x-cache'
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -issuer -subject

如果第 3 条输出的是 Cloudflare、阿里云或腾讯云的证书而不是你购买的证书,证书就必须安装两处:CDN 控制台上传一份用于浏览器握手,源站再装一份用于回源连接。据 Let’s Encrypt 文档,源站完全可以复用免费证书或自签证书,但一旦 CDN 开启“严格回源校验”,自签证书的 CA 必须提前上传到 CDN 信任列表,否则回源直接返回 526 或 502。

部署场景 证书位置 回源校验 典型报错
纯源站直连 仅源站 不涉及 —
CDN 终止 TLS(宽松) CDN + 源站(可自签) 忽略证书 无
CDN 终止 TLS(严格) CDN + 源站(公共 CA 或已上传 CA) 校验链与域名 526 Invalid SSL certificate
CDN 仅做四层转发 仅源站 透传,不终止 —

步骤 2:整理文件并生成 fullchain。从 CA 下载的通常是 domain.crt、ca_bundle.crt、domain.key 三个文件,Nginx 需要的是“服务器证书在前、中间证书在后”的拼接文件,这一点由 RFC 5280 的证书链约定而来,顺序颠倒会让老版本 Java、Android 7 报 unable to get local issuer certificate。根证书不要拼进去。

cat domain.crt ca_bundle.crt > fullchain.pem
# 一次看清主体、签发者与有效期,notAfter 就是续期截止时间
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
# 输出示例:
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Mar  1 00:00:00 2025 GMT
# notAfter=May 30 23:59:59 2025 GMT

步骤 3:Java 环境转 PFX/JKS。Tomcat、Spring Boot、Kafka 只认 keystore,先用 OpenSSL 转 PKCS12 再转 JKS:

# 适用 OpenSSL 1.0.2+/3.x;-name 即后续 keystore 里的 alias
openssl pkcs12 -export -in fullchain.pem -inkey domain.key 
  -out server.p12 -name tomcat -passout pass:ChangeMe123

# JDK 9 起 keytool 默认已是 PKCS12,显式指定 JKS 会打印警告但可用
keytool -importkeystore -srckeystore server.p12 -srcstoretype PKCS12 
  -destkeystore server.jks -deststoretype JKS 
  -srcalias tomcat -destalias tomcat 
  -srcstorepass ChangeMe123 -deststorepass ChangeMe123 -destkeypass ChangeMe123

keytool -list -v -keystore server.jks -storepass ChangeMe123 | grep -E 'Alias|Valid'

步骤 4:设置权限与路径。私钥 600、证书链 644 是硬性要求,Mozilla SSL Configuration Generator 与 Nginx 官方文档都要求私钥仅 root 可读。install 一条命令即可完成拷贝与改权限,避免 cp 之后忘记 chmod。

install -d -m 755 /etc/nginx/ssl
install -m 600 -o root -g root domain.key  /etc/nginx/ssl/privkey.pem
install -m 644 -o root -g root fullchain.pem /etc/nginx/ssl/fullchain.pem
# RHEL/CentOS/Rocky 默认 SELinux enforcing,标签不对 nginx 会报 13: Permission denied
restorecon -Rv /etc/nginx/ssl
ls -lZ /etc/nginx/ssl   # 期望看到 cert_t 或 httpd_sys_content_t

步骤 5:备份与回滚。证书替换属于高风险操作,动手前先留一份可回滚的快照,并记下序列号——它是证书的唯一身份,续期后对比序列号即可确认新证书是否真的加载。

mkdir -p /root/ssl-backup
tar czf /root/ssl-backup/ssl-$(date +%F).tgz /etc/nginx/ssl /etc/httpd/conf.d/ssl.conf 2>/dev/null
# 记录序列号与 SHA-256 指纹,便于续期前后比对
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -serial -fingerprint -sha256

# 回滚:解包覆盖后先 -t 校验配置,再 reload(reload 不断开现有连接,restart 会)
tar xzf /root/ssl-backup/ssl-2025-01-01.tgz -C /
nginx -t && systemctl reload nginx

这 5 步完成后,磁盘上的文件、权限与回滚路径都已确定;接下来第 6-8 步才是把它们接进 Nginx 的 server 块、Tomcat 的 server.xml 与 K8s 的 Secret/Ingress 中。

完整实操步骤(下):步骤 6-8 配置、重载与灰度

步骤 6:Nginx 的 443 到底该怎么写?把证书放进 /etc/nginx/ssl/ 后,ssl_certificate 指向的必须是包含站点证书与中间证书的 fullchain,只配叶子证书会让部分 Android 7 与旧版 Java 客户端报 unable to get local issuer certificate。注意 Nginx 1.25.1 起 http2 已从 listen 参数中独立为指令,混写会得到 [warn] the "listen ... http2" directive is deprecated。

# /etc/nginx/conf.d/example.conf —— Nginx 1.25.1+ 写法
server {
    listen 443 ssl;                 # 1.25.1 前写 listen 443 ssl http2;
    http2 on;
    server_name example.com www.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;  # 必须含中间证书
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;    # 建议 chmod 600、属主 root
    ssl_protocols       TLSv1.2 TLSv1.3;               # 默认值即 TLSv1.2 TLSv1.3(1.23.4+)
    ssl_session_cache   shared:SSL:10m;                # 默认 none;10m ≈ 4 万个会话
    ssl_session_timeout 1d;
    add_header Strict-Transport-Security "max-age=31536000" always;
}

证书路径写错时 Nginx 的报错非常具体,照着改即可:nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)——若文件确实存在,多半是 SELinux 上下文不对(restorecon -Rv /etc/nginx/ssl)。

步骤 6B:Tomcat 的 Connector 怎么改?Tomcat 的 TLS 参数在启动时一次性读取,不支持热加载,改完必须 systemctl restart tomcat;只 reload 不生效是最高频的“改了没反应”原因。SSLEnabled 默认是 false,漏写就还是明文 HTTP。

<!-- conf/server.xml,Tomcat 9.0.x / 10.1.x -->
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true" maxThreads="200"
           keystoreFile="/etc/tomcat/ssl/server.jks"
           keystorePass="ChangeMe123"
           keystoreType="JKS"
           sslEnabledProtocols="TLSv1.2,TLSv1.3"
           clientAuth="false" sslProtocol="TLS"/>

# 改完重启(Tomcat 无 reload 语义)
sudo systemctl restart tomcat && sudo systemctl status tomcat --no-pager

提示:Tomcat 9 起 sslEnabledProtocols 已标记 deprecated,等价写法是 protocols="TLSv1.2,TLSv1.3";Tomcat 8.5+ 默认 keystoreType 为 JKS,若你用 keytool -importkeystore 转出的 .p12,记得同步改成 PKCS12。

步骤 7:K8s 里证书放哪?不要把 PEM 打进镜像,用 Secret。证书链同样要完整,否则 Ingress 返回的链不全会让浏览器报 NET::ERR_CERT_AUTHORITY_INVALID。

kubectl create secret tls example-tls 
  --cert=fullchain.pem --key=privkey.pem -n prod

# 回读校验,确认写入的是完整链而非单证书
kubectl get secret example-tls -n prod -o jsonpath='{.data.tls.crt}' 
  | base64 -d | openssl x509 -noout -subject -dates
# Ingress 片段:tls.hosts 必须与 rules.host 一致,secretName 与上面同名同 namespace
spec:
  tls:
  - hosts: ["example.com"]
    secretName: example-tls
  rules:
  - host: example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend: { service: { name: web, port: { number: 80 } } }

据 Kubernetes 官方文档,Ingress 的 TLS Secret 必须与 Ingress 处于同一命名空间;据 NGINX Ingress Controller 文档,1.9+ 版本监听 Secret 变更后通常 30–60 秒完成热加载,无需重启 Pod。若 Secret 里 key 名不是 tls.crt/tls.key,控制器会静默忽略——这是“Ingress 配了但仍是默认证书”的第一排查点。

步骤 8:怎么做到不停机重载与灰度回滚?先校验再重载,是唯一能避免“配置写错直接 502”的顺序。

sudo nginx -t          # 期望:nginx: configuration file /etc/nginx/nginx.conf test is successful
sudo systemctl reload nginx

sudo apachectl -t      # 期望:Syntax OK
sudo systemctl reload httpd

# 绕过 DNS,直接打本机验证握手与证书链
curl -vI --resolve example.com:443:127.0.0.1 https://example.com
openssl s_client -connect 127.0.0.1:443 -servername example.com -tls1_2 /dev/null 
  | openssl x509 -noout -subject -dates -issuer
组件 校验命令 生效方式 是否中断连接 典型耗时
Nginx nginx -t systemctl reload nginx 否,平滑重载 < 1 秒
Apache httpd apachectl -t systemctl reload httpd 否 1–2 秒
Tomcat 无独立校验,启动时校验 systemctl restart tomcat 是,连接全断 10–30 秒
Nginx Ingress kubectl apply --dry-run=server 控制器自动热加载 否 30–60 秒

灰度建议按“先单机、再 10%、再全量”推进:在负载均衡上把新证书后端权重设为 10%,同时盯住 TLS 握手失败率与 5xx;一旦 openssl s_client 报 verify error:num=20:unable to get local issuer certificate 或握手成功率下跌,把权重切回旧后端即可,回滚目标控制在 5 分钟内。整个过程里,真正决定成败的不是证书本身,而是证书链完整性与私钥权限这两件小事——它们也是 ssl证书部署安装 中最容易被跳过、又最容易在灰度阶段暴露的环节。

配置/命令示例:Nginx 1.26、Tomcat 9.0、K8s 1.29 可直接复制

问:同一张证书,怎么同时落到 Nginx、Tomcat 和 K8s?答:先把私钥与证书统一拆成 PEM(fullchain.pem + privkey.pem),PEM 是唯一”三处通吃”的中间格式;PFX 和 JKS 都是带密码的容器,只在 Java 侧使用。据 Let’s Encrypt 文档,服务端必须下发完整链(叶证书 + 中间 CA),只放叶证书会在 Android/Java 客户端报 unable to find valid certification path。

1) Nginx 1.26.1(http2 on; 是 1.25.1 起的新语法,旧版仍需写成 listen 443 ssl http2;):

# /etc/nginx/conf.d/example.conf  —— Nginx 1.26.1 验证通过
server {
    listen 443 ssl;
    http2 on;                                  # 1.25.1+ 新指令;1.24 及以下用 listen 443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须含中间 CA
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;     # 权限建议 600,属主 root
    ssl_protocols       TLSv1.2 TLSv1.3;                # TLSv1.0/1.1 已被 RFC 8996 弃用
    ssl_ciphers         'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256';
    ssl_prefer_server_ciphers off;                      # Mozilla 推荐配置(intermediate)默认值

    # TLS 1.3 套件不受 ssl_ciphers 控制,需 OpenSSL 1.1.1+ 单独指定
    ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384;

    ssl_session_cache   shared:SSL:10m;        # 默认 off
    ssl_session_timeout 1d;
    add_header Strict-Transport-Security max-age=31536000 always;
}

2) 上线前的两条验证命令(第一条输出 syntax is ok / test is successful 才可 reload):

nginx -t -c /etc/nginx/nginx.conf
openssl s_client -connect 127.0.0.1:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates

3) Tomcat 9.0.85——JKS 密钥库,keystorePass 明文写在 server.xml 是常见隐患,生产建议用 ${} 属性替换或 SSLHostConfig 嵌套写法:

<!-- conf/server.xml -->
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true"
           keystoreFile="/etc/tomcat/ssl/server.jks" keystorePass="ChangeMe123"
           clientAuth="false" sslProtocol="TLS"
           sslEnabledProtocols="TLSv1.2,TLSv1.3" />

注意:JDK 9 起 java.security 的 keystore.type 默认值已从 JKS 改为 PKCS12,若你放的是 .p12,必须补 keystoreType="PKCS12",否则启动即抛 java.io.IOException: Invalid keystore format。443 属于特权端口,非 root 运行需 setcap cap_net_bind_service=+ep $JAVA_HOME/bin/java。

4) Kubernetes 1.29 + ingress-nginx:Secret 必须与 Ingress 同 namespace,且 tls.crt 填 fullchain:

kubectl create secret tls example-tls --cert=fullchain.pem --key=privkey.pem 
  --dry-run=client -o yaml > tls-secret.yaml
kubectl apply -f tls-secret.yaml
# Ingress 片段
# spec:
#   tls:
#   - hosts: [example.com]
#     secretName: example-tls
kubectl get secret example-tls -o jsonpath='{.data.tls.crt}' | base64 -d | openssl x509 -noout -dates

5) 格式互转(OpenSSL 3.x / keytool):-nocerts -nodes 导出未加密私钥,-clcerts 只取叶证书,-cacerts 取中间链;JKS→PKCS12 用 keytool -importkeystore -srckeystore server.jks -destkeystore server.p12 -deststoretype PKCS12。

openssl pkcs12 -in server.pfx -nocerts -nodes -out key.pem     # 私钥(无密码保护)
openssl pkcs12 -in server.pfx -clcerts -nokeys  -out cert.pem   # 叶证书
openssl pkcs12 -in server.pfx -cacerts -nokeys  -out chain.pem  # 中间 CA
cat cert.pem chain.pem > fullchain.pem
keytool -list -v -keystore server.jks -storepass ChangeMe123 | grep -E 'Alias name|Valid from'
格式 编码/结构 典型后缀 直接给 Nginx 典型使用者
PEM Base64 + -----BEGIN----- 头,可拼接多证书 .pem .crt .key 是 Nginx / Apache / HAProxy / K8s Secret
PFX (PKCS#12) 二进制容器,含证书+私钥+链,单一密码 .pfx .p12 否,需转换 Windows IIS / Java(JDK 9+ 默认)
JKS Java 专有二进制库,多别名条目 .jks 否,需转换 Tomcat 8.5/9 + JDK 8 传统部署

据 Mozilla SSL Configuration Generator,ssl_prefer_server_ciphers off 自 2023 版起即为 intermediate 配置的默认值——让客户端选套件反而能利用其硬件加速与更优的 ECDHE 曲线;而 RFC 8446 把 TLS 1.3 的密钥交换与套件解耦,这正是 ssl_ciphers 对 1.3 无效、必须另配 Ciphersuites 的原因。

选型的核心只有一句话:格式跟着消费端走,不跟着你的习惯走。同一套证书(站点证书 + 中间 CA + 私钥)在不同服务里的装载方式完全不同,选错格式的直接后果通常是 unable to load certificate 或浏览器报 NET::ERR_CERT_AUTHORITY_INVALID(链缺失)。下面这张表是本节的主干,覆盖 2025 年主流版本。

格式 扩展名 适用服务 转换命令 权限/密码 注意
PEM .crt / .pem / .key Nginx 1.24+、Apache 2.4.58+、HAProxy 无需转换,cat 拼接 fullchain 私钥 chmod 600 链顺序:站点证书 → 中间 CA,顺序反了部分客户端会失败
PKCS#12 .pfx / .p12 IIS、Tomcat、任意 Java 应用 openssl pkcs12 -export 导出密码 ≥12 位 内含私钥,绝不能放进 Web 根目录;JDK 17 起 keystore.type 默认已是 pkcs12
JKS .jks Tomcat 9/10、老 Java 系统 keytool -importkeystore storepass 与 keypass 分开设置 Java 9 之后官方建议优先 PKCS12,JKS 属兼容保留
K8s tls Secret YAML + base64 Ingress / ingress-nginx kubectl create secret tls RBAC 限制 get/list Secret 更新后 controller 约 30–60 秒内热加载,无需重建 Pod

PEM 是事实标准,但要自己拼链。Nginx 的 ssl_certificate 指令要求文件里是「站点证书 + 全部中间证书」的完整链,而 CA 下发的压缩包通常把两者分开。拼接时顺序不能错,据 OpenSSL 文档,验证方是从终端证书逐级向上找签发者的:

# 拼接完整链:站点证书在前,中间 CA 在后(顺序不可颠倒)
cat example.com.crt intermediate.crt > fullchain.pem

# 私钥单独存放,收紧权限,属主设为运行用户
install -m 600 -o root -g root privkey.pem /etc/nginx/ssl/privkey.pem

# 上线前自检:能打印出 2 段以上 BEGIN CERTIFICATE 才算链完整
grep -c "BEGIN CERTIFICATE" fullchain.pem

# 验证链与私钥是否匹配(两条命令输出的 MD5 必须一致)
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5

Java 侧怎么选?Tomcat 的 server.xml 里 <Connector> 直接认 PKCS12,不必先转 JKS。只有对接只认 JKS 的老中间件时才做一次单向转换:

# PEM → PKCS12(-name 决定别名,Tomcat 的 keyAlias 要与之对应)
openssl pkcs12 -export 
  -in fullchain.pem -inkey privkey.pem 
  -name tomcat -out server.p12 
  -passout pass:'YourStrongPassw0rd'   # 至少 12 位,避免 Windows IIS 导入报错

# PKCS12 → JKS(仅在目标系统不支持 PKCS12 时执行)
keytool -importkeystore 
  -srckeystore server.p12 -srcstoretype PKCS12 -srcstorepass 'YourStrongPassw0rd' 
  -destkeystore server.jks -deststoretype JKS -deststorepass 'StorePassw0rd' 
  -destkeypass 'KeyPassw0rd'           # JKS 要求 storepass 与 keypass 分开

# 确认别名与链长度
keytool -list -v -keystore server.jks -storepass 'StorePassw0rd' | grep -E "Alias|Certificate chain length"

K8s 场景优先 Secret + cert-manager。ingress-nginx 只读 tls.crt / tls.key 两个键,本质仍是 PEM:

# 由 PEM 直接生成 tls 类型 Secret(tls.crt 必须是 fullchain)
kubectl create secret tls example-tls 
  --cert=fullchain.pem --key=privkey.pem -n prod

# 检查有效期与 SAN,确认挂载的是正确证书
kubectl get secret example-tls -n prod -o jsonpath='{.data.tls.crt}' 
  | base64 -d | openssl x509 -noout -subject -dates -ext subjectAltName

选型结论:单机 Nginx/Apache 用 PEM;Java 单体用 PKCS12,JKS 仅作兼容;容器集群用 tls Secret,并交给 cert-manager 2.x 自动续期(Let’s Encrypt 已于 2025 年推进 6 天短期证书与 ACME profiles,手工续期风险显著上升)。最后一条经验:不要为了”统一格式”把私钥转成 JKS 再转回 PEM——每多一次转换,就多一次丢中间链、丢别名或密码不匹配的机会,而这类故障往往只在部分客户端上暴露。

在 8 步流程的最后一步,绝大多数「证书装完了但不生效」都收敛成 6 条报错。它们分布在四个层面:文件格式层(Nginx 读不到 PEM)、密钥匹配层(Nginx/Apache 配对失败)、密钥库层(Tomcat JKS)、信任链层(浏览器/curl/K8s)。先判断报错属于哪一层,再执行对应的一条定位命令,比反复重启服务有效得多。以下命令基于 OpenSSL 3.0.x(Ubuntu 22.04 默认)、Nginx 1.24/1.26、Apache httpd 2.4.8+、Tomcat 9.0.x 实测。

1) Nginx 启动报 PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line):典型原因是把 PFX/P12 二进制文件或一个 0 字节空文件直接写进了 ssl_certificate。注意 error:0480006C 是 OpenSSL 3.x 的新错误码格式,OpenSSL 1.1.1 上同一问题显示为 PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line),网上旧教程的错误码对不上是正常的。定位与修复:

# 期望输出:fullchain.pem: ASCII text(若是 "data" 说明是 DER/PFX 二进制)
file /etc/nginx/ssl/fullchain.pem
# 期望输出:-----BEGIN CERTIFICATE-----
head -1 /etc/nginx/ssl/fullchain.pem
# 若是 PFX,先转成 PEM(-nodes 表示私钥不加密,便于 Nginx 免密启动)
openssl pkcs12 -in cert.pfx -clcerts -nokeys -out cert.pem
openssl pkcs12 -in cert.pfx -nocerts -nodes -out privkey.pem
# 合并出完整链(叶子 + 中间证书)
cat cert.pem chain.pem > fullchain.pem
nginx -t && systemctl reload nginx

2) Nginx 报 SSL_CTX_use_PrivateKey() failed (SSL: error:0A00018A:SSL routines::key values mismatch):证书和私钥不是同一对。OpenSSL 文档给出的标准校验是比对 modulus 的 MD5,两值必须完全一致:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5
# ECDSA 证书没有 modulus,改用公钥指纹比对:
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in privkey.pem -pubout | openssl md5

3) Apache 报 AH02565: Certificate and private key do not match:同一根因,但配置写法有版本分水岭。httpd 2.4.8(2014 年发布)起,SSLCertificateFile 可以直接指向包含中间证书的 fullchain,SSLCertificateChainFile 已废弃(2.4.8 中标记 deprecated);2.4.8 之前的版本必须把叶子证书与中间证书拆成两个指令,否则同样报 AH02565 或链不完整。

# Apache 2.4.8+(推荐)
SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile   /etc/httpd/ssl/privkey.pem
# Apache < 2.4.8
# SSLCertificateFile     /etc/httpd/ssl/cert.pem
# SSLCertificateChainFile /etc/httpd/ssl/chain.pem
# SSLCertificateKeyFile  /etc/httpd/ssl/privkey.pem
apachectl configtest

4) Tomcat 报 java.io.IOException: Keystore was tampered with, or password was incorrect:keystorePass 与生成 JKS 时设置的不一致;另一个高频坑是 keyPass 与 storepass 不同——keytool 允许二者分离,Tomcat 的 <Connector> 必须同时给出。先用 keytool 自证密码:

# 能列出别名即 storepass 正确
keytool -list -keystore /opt/tomcat/conf/server.jks -storepass 'YourStorePass'
# server.xml 中(Tomcat 8.5/9.0/10.1 写法一致)
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true"
           keystoreFile="/opt/tomcat/conf/server.jks"
           keystorePass="YourStorePass" keyPass="YourKeyPass"
           keystoreType="JKS" />

5) 浏览器 NET::ERR_CERT_AUTHORITY_INVALID、curl 报 SSL certificate problem: unable to get local issuer certificate:链不完整(服务器只发了叶子证书),或客户端 CA 库过旧。据 Let’s Encrypt 文档,其默认链在 2024 年后已切换为 ISRG Root X1 签发的 R10/R11 中间证书,只发叶子的站点在旧 Android 与部分 Java 客户端上必然报此错。用 s_client 数证书张数,正常应 ≥2 张:

openssl s_client -showcerts -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 输出 2 或 3 为正常,输出 1 说明缺中间证书

6) K8s 报 x509: certificate signed by unknown authority:Ingress 引用的 Secret 落在了错误的 namespace(Ingress 只能引用同 namespace 的 Secret),或 tls.crt 里只放了叶子证书。按 RFC 8446 与 Kubernetes 约定,tls.crt 必须是「叶子 + 中间证书」的顺序拼接,根证书不要放。

kubectl get secret example-tls -n prod -o jsonpath='{.data.tls.crt}' | base64 -d | grep -c 'BEGIN CERTIFICATE'
# 期望 ≥2;若为 1,重建 Secret:
kubectl create secret tls example-tls -n prod --cert=fullchain.pem --key=privkey.pem --dry-run=client -o yaml | kubectl apply -f -

把 6 条报错按「定位一条命令」归纳,可在 ssl证书部署安装 的验收清单里直接当 checklist 用:

报错关键字 所在层 根因 一条命令定位
PEM routines::no start line 格式 PFX 二进制/空文件当 PEM file fullchain.pem → 应为 ASCII text
key values mismatch 配对 证书与私钥非同一对 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 取 md5 比对
AH02565 配对/配置 同上 + 版本指令写错 apachectl configtest
Keystore was tampered with 密钥库 storepass/keypass 不符 keytool -list -keystore server.jks -storepass ...
ERR_CERT_AUTHORITY_INVALID / unable to get local issuer 信任链 缺中间证书 openssl s_client -showcerts 数张数
x509: certificate signed by unknown authority 信任链/编排 Secret 跨 namespace 或 tls.crt 不全 kubectl get secret -o yaml 解 base64

需要强调一个判断顺序:先跑 openssl s_client 看链,再跑 modulus 比对看配对,最后才怀疑配置。Mozilla SSL Configuration Generator 生成的 Nginx/Apache 片段默认已启用 ssl_trusted_certificate 与 OCSP stapling,若你的 ssl_trusted_certificate 指向了缺失中间证书的 chain 文件,OCSP stapling 会静默失败(Nginx error_log 中为 ssl_stapling ignored, issuer certificate not found),这也是 ssl证书部署安装 后「证书正常但性能特性没生效」的常见隐性错误。

效果验证:部署后 5 分钟确认 ssl证书部署安装生效

证书传上去了、Nginx 也 reload 了,怎么证明它真的生效、而不是浏览器还在用旧的 CDN 节点?别靠”打开网页看小锁”——那只证明你的浏览器信任链恰好完整。下面这套 5 分钟验证流程按”本机 → 证书链 → 协议 → 有效期 → 外部评分”逐层收敛,任何一层失败都能直接定位到 ssl证书部署安装 的具体环节。

  1. 第一步:本机直连,绕开 DNS 与 CDN
# --resolve 让 curl 把 example.com 强制解析到 127.0.0.1,验证的是"这台机器上的服务",而非公网缓存
# curl 7.21.3+ 支持该参数;低于 7.75 的版本不支持 --resolve 的通配写法
curl -I --resolve example.com:443:127.0.0.1 https://example.com
# 期望首行 HTTP/2 200(Nginx 需 listen 443 ssl http2 / 1.25.1+ 用 http2 on;)
# 若只有 HTTP/1.1 200,说明 HTTP/2 未启用,但证书本身是好的

# 一次性看握手细节,grep 出三行关键信息
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:'
# 期望:* SSL certificate verify ok.  /  subject: CN=example.com  /  issuer: C=US, O=Let's Encrypt, CN=R11

如果这里报 curl: (60) SSL certificate problem: unable to get local issuer certificate,几乎可以断定是只配了 ssl_certificate 里的叶子证书、漏了中间证书——这正是 PEM 合并成 fullchain 的意义。

第二步:证书链完整性(最容易被忽略的一步)

# -servername 必须带,否则 SNI 多站点会拿到默认站点的证书;-CAfile 模拟浏览器信任库视角
# Debian/Ubuntu: /etc/ssl/certs/ca-certificates.crt  RHEL/CentOS: /etc/pki/tls/certs/ca-bundle.crt
openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt /dev/null 
  | grep 'Verify return code'
# 目标:Verify return code: 0 (ok)
Verify return code 含义 典型修复
0 (ok) 链完整且受信 —
20 (unable to get local issuer certificate) 缺中间证书 把中间证书拼进 fullchain.pem
21 (unable to verify the first certificate) 仅发了叶子证书 同上
10 (certificate has expired) 已过期 续期后重载服务
62 (hostname mismatch) 域名与 SAN 不符 检查证书 SAN 列表

第三步:协议版本与加密套件。据 Mozilla SSL Configuration Generator 的 intermediate 配置,2025 年仍可接受的只有 TLSv1.2 与 TLSv1.3。

nmap --script ssl-enum-ciphers -p 443 example.com
# 输出中不应出现 TLSv1.0: / TLSv1.1: 段落;出现即说明 ssl_protocols 未收紧

# 或 testssl.sh 3.2(Docker 免安装)
docker run --rm -it drwetter/testssl.sh --protocols --quiet https://example.com

# 反向验证:强制 TLSv1.1 必须握手失败
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# OpenSSL 3.x 默认 SECLEVEL=2 会先在客户端拒绝;想区分"服务端拒绝"需加 -cipher 'DEFAULT@SECLEVEL=0'

第四步:有效期与吊销状态

openssl x509 -in fullchain.pem -noout -dates -subject
# notBefore/notAfter;Let's Encrypt 证书有效期 90 天,剩余 <30 天应触发续期告警

openssl ocsp -issuer chain.pem -cert cert.pem -url http://ocsp.example.com -resp_text -no_nonce
# 关键行:cert.pem: good

注意:据 Let’s Encrypt 官方公告,其自 2025 年起停用 OCSP,新签发证书不再内嵌 OCSP URL,responder 已于 2025 年 8 月关闭,因此对 LE 证书执行上述 ocsp 命令失败属正常,应改用 CRL(如 http://x1.c.lencr.org/)校验。

第五步:外部评分兜底。用 SSL Labs 扫描,等待 2–5 分钟,目标 A 或 A+。重点看三项:Certificate Chain(是否 “Chain issues: None”)、Protocols(只列 TLS 1.2/1.3)、Cipher Suites(无 RC4/3DES/CBC 弱套件)。HSTS 只有 max-age≥31536000(一年)才会加分,短于该值 SSL Labs 直接不给 HSTS 分。

一条排错捷径:五步里若只有第一步失败、第二步通过,问题在 DNS/CDN 而非 ssl证书部署安装 本身;若第一步通过、第二步返回 20,问题一定在证书文件内容。完成这轮验证后,再把同样的检查接到 CI 或监控里,证书过期与链断裂就能在用户投诉前被发现。

先执行 openssl s_client -connect 域名:443 -servername 域名 -showcerts 看 Verify return code 与证书链张数;非 0 多为缺中间证书或私钥不匹配。再查页面混合内容、CDN 回源证书与 HSTS 头,逐项排除。

通常是 ssl_certificate 指向了 PFX 二进制、空文件或路径写错。用 file fullchain.pem 与 head -1 检查是否为 PEM;PFX 需先 openssl pkcs12 -in server.pfx -nodes -out all.pem 转换,证书 644、私钥 600。

Nginx/Apache 选 PEM,Tomcat/IIS 选 PFX/PKCS12;JDK 17 默认 keystore.type=pkcs12,JKS 仅在老系统兼容时用。转换后私钥不要放 Web 根目录,权限保持 600。

Nginx/Apache 用 reload 即可平滑加载新证书,Tomcat 改 server.xml 需 restart;K8s Secret 更新由 Ingress Controller 热加载,通常 30-60 秒。reload 前先 nginx -t 或 apachectl -t 做语法检查。

文件格式与部署命令基本一致,差异在有效期、OCSP/CRL 与支持范围;Let's Encrypt 90 天需 certbot 2.x 自动续期,商业 OV/EV 需人工核验。部署时同样要拼接 fullchain 并设置私钥权限。

Ingress 规范通过 secretName 引用 tls.crt/tls.key,避免把私钥写进镜像或 ConfigMap;kubectl create secret tls 生成后,用 RBAC 限制 get/list,更新时 controller 会自动同步。

先确认挂载的是文件还是目录、inode 是否变化;K8s Secret 挂载默认约 60 秒更新,应用需监听文件变化或 rollout restart;Docker 用 docker cp 后需 restart 容器,并检查容器内路径与权限。


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

内容审核

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