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证书部署安装 的具体环节。
- 第一步:本机直连,绕开 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。