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

通配符证书安装教程:PEM/PFX/JKS 转换与 IIS、Tomcat、Kubernetes 落地(2025)

通配符证书安装教程 — 通配符证书安装教程:PEM/PFX/JKS 转换与 IIS、Tomcat、Kubernetes 落地(2025)
核心结论

通配符证书安装的核心是“把 leaf 证书与中间证书按顺序拼成 fullchain,再按运行时转成 PEM、PFX、JKS 或 K8s Secret”,装完用 openssl s_client -showcerts 确认服务端发送 2 张证书且 Verify return code 为 0。 文件检查:openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 的 SHA256 必须一致,私钥权限执行 chmod 600、chown root:root。 格式转换:IIS/Tomcat 用 openssl pkcs12 -export 生成 .pfx;Java 用 keytool -importkeystore 生成 PKCS12;K8s 用 kubectl create secret tls,tls.crt 必须是 fullchain。 价格与时间:商业 DV 通配符约 300-1500 元/年,OV 通配符约 2000-6000 元/年;Let's Encrypt 通配符免费但必须 DNS-01 验证,90 天续期。 报错定位:Java 报 unable to find valid certification path 先补中间证书;浏览器报 ERR_CERT_COMMON_NAME_INVALID 先确认是否访问了二级子域。

通配符证书安装为什么总卡在“文件对了却不受信任”?

先确认 *.example.com 到底匹配谁,否则后面全是在排查不存在的问题。据 RFC 6125 第 6.4.3 节,通配符只能出现在最左侧标签,且不得匹配公共后缀;实践中 *.example.com 只覆盖 api.example.com 这一级,裸域 example.com 与二级子域 a.b.example.com 都不在范围内——裸域必须额外写进 SAN 才能用。装完先验证证书本身,别靠浏览器猜:

# 查看 SAN,确认同时包含 *.example.com 和 example.com
openssl x509 -in wildcard.crt -noout -text | grep -A2 "Subject Alternative Name"

# 查看服务端实际下发的证书张数,正常应为 2 张以上(leaf + 中间)
openssl s_client -connect api.example.com:443 -servername api.example.com 
  -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"

“文件对了却不受信任”,九成是只发了 leaf 证书、没带中间证书。Android 7+、Java 11/17、curl 7.81+ 都不会通过 AIA 字段自动补链,缺中间证书时 Java 客户端直接抛 unable to find valid certification path to requested target,而桌面 Chrome 因为缓存了中间证书往往显示正常,于是问题只在移动端暴露。修复方式是把中间证书拼在 leaf 之后:cat wildcard.crt intermediate.crt > fullchain.crt,Nginx 的 ssl_certificate 必须指向 fullchain.crt。据 Let’s Encrypt 文档,其默认链由 ISRG Root X1 签发,E系列中间证书须一并下发。

私钥与证书不匹配时,Nginx 根本起不来。典型报错:SSL_CTX_use_PrivateKey_file("...") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。用模数指纹比对定位(ECC 证书无 modulus,改用 openssl pkey -pubout 比对公钥):

# 两行输出的 SHA256 必须完全一致,否则就是配错了 key
openssl x509 -in wildcard.crt -noout -modulus | openssl sha256
openssl rsa  -in wildcard.key -noout -modulus | openssl sha256

不同运行时对“安装”的定义完全不同,这是通配符证书安装教程里最容易踩空的一环:

运行时 接受的格式 关键要求
Nginx / Apache PEM 文本 证书文件内须含完整链
IIS .pfx(PKCS#12) 导入时勾选“包含所有证书”,否则同样缺链
Tomcat JKS 或 PKCS#12 keystoreFile/keystorePass,库内须含链
Java 客户端 JKS/PKCS12 信任库 根证书与中间证书都要 keytool -import
Kubernetes Ingress tls.crt/tls.key tls.crt 必须是 leaf+中间拼接后的全链

成本与时间要有预期,别把“装不上”误判成“买错了”。商业 DV 通配符约 300–1500 元/年,签发 5 分钟到 1 小时;OV 通配符约 2000–6000 元/年,需人工核验主体,1–3 个工作日;Let’s Encrypt 通配符免费,但强制 DNS-01 验证且 90 天必须续期,续期后还需重载服务进程,否则线上仍是旧证书——这也是“明明续了还是过期”的常见来源。

从证书包到可用文件:6 步安装流程(按顺序执行)

这份通配符证书安装教程按“先验证、再转换、最后热加载”的顺序展开,六步不可颠倒:前四步只做只读校验,出错不会影响线上;第五步才开始生成运行时文件;第六步才动正在运行的进程。据 RFC 8446 第 4.4.2 节,服务端必须发送足以把 leaf 证书连到受信根的证书链,漏发中间证书在桌面浏览器可能被自动补链掩盖,但在 Java、curl、移动端 SDK 上会直接报 unable to get local issuer certificate。

  1. 解压并核对交付包。典型商业证书包含 example.com.crt(leaf,仅服务器证书)、intermediate.crt 或 ca-bundle.crt(中间证书)、example.com.key(私钥)、example.com.pfx、example.com.csr。先看清文件再动手:
    # 列出交付包,确认 leaf / 中间 / 私钥 / pfx / csr 五类文件齐全
    ls -l
    
    # 私钥只允许 root 读取;Nginx 若以非 root 的 worker 启动会报 13: Permission denied
    chmod 600 example.com.key
    chown root:root example.com.key

    真实报错长这样:nginx: [emerg] cannot load certificate key "example.com.key": BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied)。

  2. 拼接 fullchain,顺序不能反。
    # leaf 在前、中间证书在后;根证书绝对不要拼进来
    cat example.com.crt intermediate.crt > fullchain.crt
    
    # 确认行数与张数:BEGIN CERTIFICATE 出现 2 次即为正确
    grep -c "BEGIN CERTIFICATE" fullchain.crt

    据 Mozilla Server Side TLS 指南,服务端应发送 leaf 与“必要的”中间证书,链越长握手字节越多;把根证书或交叉签名的冗余中间证书塞进去,会多出 1–2 KB 的握手开销,个别老 Android 版本还会因此握手失败。

  3. 校验私钥与证书是否匹配。取两边的公钥指纹对比,哈希一致才继续:
    # 证书里的公钥指纹
    openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
    
    # 私钥推导出的公钥指纹(OpenSSL 1.1.1+ 才有 pkey 子命令,1.0.2 用 openssl rsa -pubout)
    openssl pkey -in example.com.key -pubout | openssl sha256

    两行输出必须完全相同。不一致说明包拿错了(多域名证书混发)或私钥已被替换,此时任何格式转换都是白做。

  4. 校验证书链是否完整。先用离线方式验证,再验证服务端实际发送了什么:
    # 离线验链,期望输出 example.com.crt: OK
    openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
    
    # 连本机 443,SNI 必须显式给出,否则通配符站点可能返回默认站点证书
    openssl s_client -connect 127.0.0.1:443 -servername test.example.com -showcerts </dev/null 
      | grep -c "BEGIN CERTIFICATE"   # 期望 2

    输出 1 表示只发了 leaf,输出 3 及以上表示多塞了根证书,两者都要回到第 2 步修正。

  5. 按目标运行时转换格式。同一套密钥在四个环境里的落地方式完全不同,密码统一 12 位以上并存进密码管理器(据 OWASP 建议,PKCS12/JKS 口令至少 12 位随机字符):
目标运行时 目标文件 核心命令(示例) 关键参数与默认值
IIS 8.0+ example.com.pfx openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in fullchain.crt -certfile intermediate.crt IIS 导入需可导出私钥;-keypbe 默认 AES-256-CBC(OpenSSL 3.x)
Tomcat 9/10 tomcat.p12 keytool -importkeystore -srckeystore example.com.pfx -srcstoretype PKCS12 -destkeystore tomcat.p12 -deststoretype PKCS12 -deststorepass '<12位以上>' JDK 9+ 默认 keystore 类型已是 PKCS12,JKS 仅作兼容
Kubernetes 1.19+ Secret wildcard-tls kubectl create secret tls wildcard-tls --cert=fullchain.crt --key=example.com.key -n default cert 必须含中间证书;Ingress 通过 tls.secretName 引用
Java 信任库 truststore.jks keytool -importcert -alias corp-root -file root.crt -keystore truststore.jks -storepass changeit -storepass 默认 changeit,生产必须改

第五步的具体转换命令与踩坑细节在下一节展开;这里只需记住一条:通配符证书安装教程里最容易出错的地方不是命令,而是密码与别名——Tomcat 的 -srcalias 与 K8s 的 Secret 名不一致,都会让证书加载成功但握手失败。

6. 热加载并留好回滚。先备份旧文件再加载,回滚窗口至少 30 天:

# 备份当前可用文件(按日期打标签,便于回滚)
cp fullchain.crt fullchain.crt.bak.$(date +%F)
cp example.com.key example.com.key.bak.$(date +%F)

# Nginx:先测语法,通过才 reload(reload 不中断连接)
nginx -t && nginx -s reload

# Apache httpd 2.4:graceful 会等在途请求结束
apachectl configtest && apachectl -k graceful

# Tomcat 不支持证书热加载,只能重启容器;记录实际下发的证书链
openssl s_client -connect 127.0.0.1:443 -servername test.example.com -showcerts </dev/null 
  >> /var/log/cert-check.log 2>&1

nginx -s reload 之后若日志出现 SSL_CTX_use_PrivateKey 相关错误,说明第 3 步没做或私钥被换过;/var/log/cert-check.log 里的 Verify return code 应为 0 (ok),这是日后排查“证书到底换没换成功”最直接的证据。

配置/命令示例:IIS、Tomcat、Kubernetes 与 Java 信任库怎么落地?

把同一张通配符证书落到不同运行时上,真正的坑几乎都不在”证书本身”,而在私钥格式、中间证书链、文件权限这三件事。下面按平台给出可直接复制的命令,并标注适用版本。

IIS 10(Windows Server 2016/2019)怎么导入 PFX?用管理员 PowerShell 导入,并显式允许后续导出(否则在”证书”MMC 里无法再导出为 PFX):

# -p 后为 PFX 保护密码;-f 强制覆盖同名条目
certutil -importPFX -p "YourPfxPassw0rd!" -f C:certswildcard.pfx
# 中间证书装入"中间证书颁发机构",避免 443 绑定后链不完整
certutil -addstore CA C:certsintermediate.crt
# 核对:应能看到证书的颁发者与到期时间
certutil -store My "*.example.com"

注意 certutil -importPFX 默认把密钥标记为不可导出;如需导出备份,加 -exportPFX 或改用图形向导勾选”允许导出此证书”。443 站点绑定必须选择列表中带完整链的那一条证书(名称旁会显示颁发者),否则移动端与 Java 客户端会报链不完整。

Tomcat 9.0.x / 10.1.x 如何把 PFX 转成 keystore?Tomcat 9 起 SSLHostConfig 已取代旧的 SSLCertificateFile 属性组合:

# 把 PFX 重新打包为 PKCS12 keystore(源类型必须显式声明 PKCS12)
keytool -importkeystore -srckeystore wildcard.pfx -srcstoretype PKCS12 
  -srcstorepass "YourPfxPassw0rd!" 
  -destkeystore tomcat.p12 -deststoretype PKCS12 -deststorepass "StrongPass!2025"

<!-- conf/server.xml:protocol 用 TLS,指向 p12 -->
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="conf/tomcat.p12"
                 certificateKeystoreType="PKCS12"
                 certificateKeystorePassword="StrongPass!2025" />
  </SSLHostConfig>
</Connector>

Kubernetes 1.24+ 与 ingress-nginx 怎么配?Secret 里的 tls.crt 必须是叶子证书 + 中间证书的拼接(顺序:域名证书在前):

kubectl create secret tls wildcard-tls 
  --cert=fullchain.crt --key=example.com.key -n prod
# Ingress 中 tls.hosts 可写 *.example.com,也可写具体子域
# ingress-nginx 会校验 tls.crt 链,缺中间证书时 Pod 日志报:
# x509: certificate signed by unknown authority

Java 应用信任库(JDK 11/17)为什么不要直接改 cacerts?JDK 升级会覆盖 $JAVA_HOME/lib/security/cacerts。临时验证可用:

keytool -importcert -alias intermediate -file intermediate.crt 
  -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
# 生产推荐独立库 + JVM 参数,默认密码 changeit 仅对 JDK 自带库成立
java -Djavax.net.ssl.trustStore=/opt/app/truststore.p12 
     -Djavax.net.ssl.trustStorePassword=AppTrust2025 -jar app.jar

Nginx 1.20+ 对照配置与常见报错:

ssl_certificate     /etc/nginx/ssl/fullchain.crt;  # 必须含中间证书
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols       TLSv1.2 TLSv1.3;
ssl_stapling on;            # OCSP 装订,需证书带 AIA 扩展
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.crt;  # 校验装订响应

链顺序写反(中间证书在前)时,nginx -t 报 SSL_CTX_use_certificate_chain_file() failed (SSL: error:...)。据 OpenSSL 文档,SSL_CTX_use_certificate_chain_file 要求文件内第一张为终端实体证书。

平台 证书格式 链的存放位置 典型失败现象
IIS 10 PFX(含私钥) 中间证书存储区 浏览器提示链不完整
Tomcat 9/10 PKCS12 keystore 内条目 PKIX path building failed
ingress-nginx PEM Secret tls.crt 拼接 x509: unknown authority
Nginx PEM 两文件 fullchain.crt SSL_CTX_use_certificate_chain_file

RHEL 9 上”证书装好了却 403/13″?多半是 SELinux 而非证书:

restorecon -Rv /etc/pki/tls/private
# 自定义目录时显式打标签
semanage fcontext -a -t cert_t '/etc/pki/tls/private(/.*)?'

否则 Nginx error.log 出现 13: Permission denied,极易被误判为私钥损坏。据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 挑战签发,这也意味着续期后必须重新走一遍上面的分发流程。

PEM、PFX、JKS、K8s Secret 怎么选?格式与场景对照表

先给结论:格式不是”哪个更先进”的问题,而是由运行时决定的。Linux 反向代理(Nginx / Apache / HAProxy / CDN 回源)用 PEM + fullchain;IIS 与 Windows 证书存储用 PFX;Java 应用用 PKCS12 keystore;Kubernetes 用 Secret。同一张通配符证书的同一份私钥,可以通过下面的命令在四种形态之间无损转换。这份通配符证书安装教程的第二部分,先看对照表,再逐行看命令与容易出问题的地方。

格式 典型文件 适用运行时 是否含私钥 转换 / 安装命令 关键注意
PEM(Base64 文本,RFC 7468) .crt / .pem / .key Nginx、Apache、HAProxy、Envoy、CDN 回源 否,私钥单独一个文件 cat leaf.crt intermediate.crt > fullchain.crt 叶子证书必须排在中间证书之前;.key 权限 600
PKCS#12(RFC 7292) .pfx / .p12 IIS、Windows 证书存储、Tomcat 是,证书 + 链 + 私钥打包 openssl pkcs12 -export ... 密码 ≥12 位;IIS 导入时勾选”允许导出”
JKS / PKCS12 keystore .jks / .p12 Java 应用、Tomcat 8 及更老版本 是 keytool -importkeystore ... JDK 9+ 默认 PKCS12,JKS 需显式 -deststoretype JKS
Kubernetes Secret tls.crt / tls.key Ingress、Gateway API、cert-manager 是(Base64 存储在 etcd) kubectl create secret tls ... tls.crt 必须是 fullchain;命名空间须与 Ingress 一致

1. PEM:先解决”链的顺序”这个最常见故障。Nginx 的 ssl_certificate 只接受一个文件,若只放叶子证书,Android 与部分 Java 客户端会直接握手失败。按 RFC 7468 的建议,证书按”叶子 → 中间 → 根(根可省略)”排列:

# 拼接 fullchain:叶子证书在前,中间证书在后,顺序反了 Nginx 能启动但客户端报错
cat example.com.crt intermediate.crt > fullchain.crt

# 验证链能否闭合(-untrusted 指定中间证书)
openssl verify -untrusted intermediate.crt fullchain.crt
# 期望输出:fullchain.crt: OK

# 确认证书与私钥匹配:两条命令输出的哈希必须完全一致
openssl x509 -noout -pubkey -in example.com.crt | openssl sha256
openssl pkey -pubout -in example.com.key       | openssl sha256

# 私钥权限收紧(Nginx worker 以 nginx 用户运行时可用 640 + chown root:nginx)
chmod 600 example.com.key

2. PFX:给 IIS 与 Windows 用。IIS 的”导入”向导只认 .pfx。据 OpenSSL 3.x 文档,pkcs12 -export 的默认 PBE 算法已改为 AES-256-CBC + PBKDF2,而 1.1.1 及更早版本默认用 RC2-40;如果目标机是 Windows Server 2012 之前的系统或旧版 Java,需要用 -legacy 或显式指定算法参数来兼容:

openssl pkcs12 -export 
  -out wildcard.pfx 
  -inkey example.com.key 
  -in fullchain.crt 
  -certfile intermediate.crt 
  -name wildcard-2025 
  -keypbe AES-256-CBC -certpbe AES-256-CBC -macalg sha256
# 交互式输入导出密码,建议 ≥12 位;-name 即 IIS/Tomcat 中显示的别名

# 反向校验:不打印私钥内容,只看别名与算法
openssl pkcs12 -info -in wildcard.pfx -noout

IIS 导入时务必勾选”允许此证书可导出“,否则后续无法再导回 PEM 或转 JKS,只能重新签发。

3. JKS / PKCS12 keystore:Java 生态的默认值已经变了。据 Oracle JDK 文档,从 JDK 9 起 keytool 的默认 keystore 类型从 JKS 改为 PKCS12;而 Tomcat 8.5/9 的 <Certificate> 元素 certificateKeystoreType 默认值仍是 JKS。把 .p12 直接丢给 Tomcat 而不声明类型,启动即报 java.io.IOException: Invalid keystore format 或 Keystore was tampered with, or password was incorrect。

# 从 PFX 转成 keystore;要给 Java 8 / 老 Tomcat 用,显式指定 JKS
keytool -importkeystore 
  -srckeystore wildcard.pfx -srcstoretype PKCS12 -srcstorepass 'ChangeMe_2025' 
  -destkeystore app.jks     -deststoretype JKS     -deststorepass 'ChangeMe_2025' 
  -alias wildcard-2025

# 确认条目类型为 PrivateKeyEntry(若变成 trustedCertEntry,说明私钥没进去)
keytool -list -v -keystore app.jks -storepass 'ChangeMe_2025' | grep -E 'Alias|Entry type|Valid'
<!-- Tomcat server.xml:用 p12 时必须显式声明 keystoreType -->
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="conf/app.p12"
                 certificateKeystorePassword="ChangeMe_2025"
                 certificateKeystoreType="PKCS12"
                 type="RSA" />
  </SSLHostConfig>
</Connector>

4. Kubernetes Secret:最常见的坑是只放了叶子证书。Ingress Controller 直接读取 tls.crt 与 tls.key 两个键,tls.crt 必须等于 fullchain:

kubectl create secret tls wildcard-tls 
  --cert=fullchain.crt 
  --key=example.com.key 
  --namespace=prod
# 报错 x509: certificate signed by unknown authority 基本可判定 tls.crt 缺中间证书

kubectl get secret wildcard-tls -n prod -o jsonpath='{.data.tls.crt}' 
  | base64 -d | openssl x509 -noout -subject -dates

选型结论与成本。Linux 反代优先 PEM + fullchain;Windows/IIS 用 PFX;Java 用 PKCS12 keystore,并把证书链单独导入 cacerts 作为 truststore(keystore 与 truststore 职责不要混用);K8s 用 Secret,配合 cert-manager 可自动续期。最后一条纪律:同一份私钥不要在生产与测试之间复制,每个环境单独签发,避免测试环境私钥泄露连带生产。商业通配符证书按 DV / OV 区分,年费大致 300–6000 元,OV 与更高保障级别会附带企业身份核验。

安装时最常见的 6 个报错:原文、原因与处理

下面这 6 条报错覆盖了通配符证书安装中约 90% 的翻车场景,按”出错层”归类后,用一条命令就能定位到具体环节:

报错关键词 出错层 30 秒判定命令
key values mismatch 私钥/证书配对 openssl pkey -pubout 与 openssl x509 -pubkey 比 SHA256
SunCertPathBuilderException Java 信任链 openssl s_client -showcerts
中间证书丢失 / AUTHORITY_INVALID Windows 证书存储 certutil -verify -urlfetch
x509: certificate signed by unknown authority K8s Secret 内容 kubectl get secret -o jsonpath 解出 crt 看行数
ERR_CERT_COMMON_NAME_INVALID 名称匹配 openssl x509 -text | grep -A1 "Alternative Name"
Keystore was tampered with 密钥库口令 keytool -list

1. Nginx 启动报 SSL_CTX_use_PrivateKey_file('/etc/nginx/ssl/example.com.key') failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥和证书不是同一批产物——常见于从 PFX 拆包时把旧 key 和新 fullchain 配在了一起。用公钥指纹比对,两个 SHA256 必须逐字节相同:

# 私钥导出的公钥指纹
openssl pkey -in /etc/nginx/ssl/example.com.key -pubout | openssl sha256
# 证书(fullchain 首个即 leaf)导出的公钥指纹
openssl x509 -in /etc/nginx/ssl/fullchain.crt -pubkey -noout | openssl sha256
# 两者不一致 → 回到签发批次,用同一次导出的 fullchain + key 重新部署
nginx -t && systemctl reload nginx

2. Java 报 sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target:要么服务端只发了 leaf 没发中间证书,要么客户端 truststore 里没有对应根/中间证书。先看服务端实际发送的链:

openssl s_client -showcerts -servername example.com -connect example.com:443 /dev/null | grep -E "s:|i:"
# 若只出现 1 张证书 → 服务端缺中间证书;若链完整 → 导入客户端 truststore
keytool -importcert -alias intermediate -file intermediate.crt 
  -keystore truststore.jks -storepass changeit -noprompt
# 默认 JVM truststore 为 $JAVA_HOME/lib/security/cacerts,默认口令 changeit

3. IIS/浏览器提示”证书链中的一个或多个中间证书丢失”或 NET::ERR_CERT_AUTHORITY_INVALID:导入 PFX 时未勾选”包括所有证书”,中间证书没进”中间证书颁发机构”存储。按 Microsoft Learn 的 certutil 用法补装后重启 IIS:

certutil -addstore CA intermediate.crt   # 需管理员权限的 CMD
certutil -verify -urlfetch example.com.crt   # 复查链是否可构建
iisreset                                  # 或回收对应应用程序池

4. ingress-nginx 日志刷 x509: certificate signed by unknown authority:Secret 的 tls.crt 只放了 leaf,控制器回源时上游校验失败。必须拼成 fullchain 再建 Secret,控制器通常 30–60 秒内热加载,无需重启 Pod:

cat leaf.crt intermediate.crt > fullchain.crt
kubectl create secret tls wildcard-tls --cert=fullchain.crt --key=example.com.key 
  --dry-run=client -o yaml | kubectl apply -f -
kubectl get secret wildcard-tls -o jsonpath='{.data.tls.crt}' | base64 -d | grep -c "BEGIN CERTIFICATE"  # 应为 2

5. 访问 a.b.example.com 报 ERR_CERT_COMMON_NAME_INVALID:通配符只覆盖一级子域。据 RFC 6125 第 6.4.3 节,通配符不跨点,*.example.com 匹配 a.example.com 但不匹配 a.b.example.com。查 SAN 后改用多 SAN 证书(*.example.com 与 *.b.example.com 同证)或为多级子域单独签发:

openssl x509 -in example.com.crt -noout -text | grep -A1 "Subject Alternative Name"

6. Tomcat 报 java.io.IOException: Keystore was tampered with, or password was incorrect:server.xml 里的 certificateKeystorePassword 与生成 PKCS12 时的 -deststorepass 不一致(Tomcat 8.5+ 默认 certificateKeystoreType 已是 PKCS12)。先用 keytool 验证口令:

keytool -list -keystore tomcat.p12 -storetype PKCS12 -storepass 你的口令
# server.xml 中保持一致:
# <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
#   SSLEnabled="true" scheme="https" secure="true"
#   certificateKeystoreFile="/opt/tomcat/conf/tomcat.p12"
#   certificateKeystoreType="PKCS12"
#   certificateKeystorePassword="你的口令" />

据 Let’s Encrypt 文档,其签发的 fullchain.pem 顺序为 leaf → 中间证书,任何平台拼接时都不要反过来;顺序错误同样会触发第 2、4 条报错。

证书装完、nginx -t 通过、reload 成功,都不代表客户端看到的就是新证书——CDN 缓存、SNI 默认站点、漏配中间证书,任何一项都能让浏览器继续报错。下面 5 个动作按「证书本身 → 信任链 → 业务域名 → 多客户端 → 到期回滚」的顺序执行,每一步都有可判定的通过标准。

① 证书主体、SAN 和有效期对得上吗?

# 必须带 -servername 触发 SNI,否则可能拿到该 IP 上的默认站点证书
openssl s_client -connect example.com:443 -servername test.example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

期望看到 subject=CN = *.example.com、DNS:*.example.com, DNS:example.com。注意通配符只匹配一级:据 RFC 6125 第 6.4.3 节,*.example.com 不覆盖 a.b.example.com,多级子域需要额外 SAN。若 notAfter 与交付包不一致,说明加载的是旧文件或 reload 未生效。

② 信任链完整吗?

openssl s_client -connect example.com:443 -servername test.example.com 
  -verify_return_error -CAfile /etc/ssl/certs/ca-certificates.crt &1 
  | grep -E 'Verify return code|verify error'

只有 Verify return code: 0 (ok) 才算通过。典型报错 Verify return code: 21 (unable to verify the first certificate) 表示服务器没下发中间证书——应把「叶子+中间」拼成的 fullchain 配给 ssl_certificate,只配叶子在桌面 Chrome 上可能侥幸通过,在 Java 与 Android 上必挂。

③ 业务域名经真实端口能握手成功吗?

# --resolve 绕过 DNS 直接打到目标节点,适合上线前灰度验证
curl -I --resolve test.example.com:443:192.0.2.10 https://test.example.com -v 2>&1 
  | grep -Ei 'SSL certificate verify|subjectAltName|HTTP/'

出现 SSL certificate verify ok 且 HTTP 状态为 200/301 即正常;若报 SSL: no alternative certificate subject name matches target host name,通常是请求落到了别的 server 块或 CDN 回源证书未更新。

④ 多客户端抽测结果一致吗?

# testssl.sh 3.2+,-S 只跑证书与协议相关检查
./testssl.sh -S -p --quiet https://test.example.com

重点看 chain issues、OCSP stapling、TLS 1.0/1.1 是否仍为 offered。再抽测 Chrome 120+、Android 7+、Java 11/17、curl 7.81+ 各一次——Java 使用 JDK 自带 cacerts,最容易抛 PKIX path building failed,是验证链完整性的最佳探针。

⑤ 到期时间与回滚路径记录了吗?

openssl x509 -in fullchain.crt -noout -enddate    # 把 notAfter 写进监控
# 回滚:先恢复旧 fullchain,语法检查通过再热加载,避免整站 502
cp /backup/fullchain.crt /etc/nginx/ssl/ && nginx -t && nginx -s reload
echo "$(date -Is) rollback to previous fullchain" >> /var/log/cert-check.log

据 Let’s Encrypt 文档,90 天证书建议在剩余 30 天左右(约第 60 天)自动续期;商业证书按到期前 30 天设置告警。回滚演练本身也属于「装好了」的一部分。

动作 工具 / 关键参数 通过标准 典型失败信息
主体与 SAN openssl s_client + -servername SAN 含 *.example.com,notAfter 一致 CN 显示为默认站点域名
链完整性 -verify_return_error -CAfile Verify return code: 0 (ok) code 21 unable to verify the first certificate
业务域名 curl –resolve -v SSL certificate verify ok,200/301 no alternative certificate subject name matches
多客户端 testssl.sh 3.2 -S -p 无 chain issues,TLS 1.0/1.1 关闭 PKIX path building failed
到期与回滚 openssl x509 -enddate 监控记录 notAfter,回滚脚本可用 续期后仍返回旧 notAfter

Let's Encrypt 通配符与商业通配符,安装差异和选型怎么定?

问:同样是 *.example.com,Let’s Encrypt 和商业 CA 在”装”这一步到底差在哪?

差在三个地方:验证通道、交付物形态、续期模型。Let’s Encrypt 只发 DV,通配符强制走 DNS-01(据 Let’s Encrypt 官方文档《Challenge Types》,通配符证书不接受 HTTP-01);商业 CA 走 DNS TXT 或 CNAME 代验证,OV 还要额外做组织核验。交付物上,Let’s Encrypt 给你一套 PEM(fullchain.pem + privkey.pem),商业 CA 常给 .crt+.key+.pfx,且中间链经常要你自己拼——这也是”通配符证书安装教程”里翻车最多的一步。

维度 Let’s Encrypt 通配符 商业 DV 通配符 商业 OV 通配符
费用(2025 参考) 0 元 约 300–1500 元/年 约 2000–6000 元/年
签发时长 1–5 分钟(加完 TXT 即时签) 5–30 分钟 1–3 个工作日(需组织验证)
验证方式 仅 DNS-01 DNS TXT / CNAME DNS + 电话/邮件核验组织
有效期 90 天,建议 60 天续 通常 365 天(受 CA/B Forum 398 天上限约束) 同左
典型交付 PEM:fullchain.pem / privkey.pem .crt + .key + .pfx(链需自拼) 同左,附 OCSP 与保修条款
自动化 certbot / acme.sh 全自动 API 或手动重签 手动为主
适用 内部系统、K8s Ingress、测试环境 对外门户、电商 金融、政企招投标

问:Let’s Encrypt 通配符用 certbot 具体怎么签?

# certbot 2.11.x(2025 主流版本),通配符只能 DNS-01
sudo certbot certonly --manual --preferred-challenges dns 
  -d '*.example.com' -d example.com
# 按提示在 _acme-challenge.example.com 添加 TXT,值为随机串;裸域要单独再加一条
# 成功后证书落在 /etc/letsencrypt/live/example.com/
#   fullchain.pem(叶证书+中间链)、privkey.pem、chain.pem、cert.pem
# 有效期 90 天,certbot renew 默认在到期前 30 天开始尝试
sudo certbot renew --deploy-hook 'systemctl reload nginx'
# --deploy-hook 仅在“确实续期成功”后触发;reload 而非 restart,避免断连

如果你漏了 --preferred-challenges dns,certbot 会直接报:Client with the currently selected authenticator does not support any combination of challenges that will satisfy the CA. 另外 --manual 续期时仍要人工贴 TXT,生产环境应换成 certbot-dns-cloudflare 等 DNS 插件或 acme.sh。

问:商业证书拿到 .crt/.key 后怎么转 PFX 给 IIS/Tomcat?

# 关键:-certfile 必须带中间证书,否则 IIS 报“证书链不完整”
openssl pkcs12 -export -out example.com.pfx 
  -inkey example.com.key -in example.com.crt 
  -certfile intermediate.crt 
  -name "wildcard-example-2025" -passout pass:YourPfxPass
# 反向:从 PFX 提 fullchain 给 Nginx/Tomcat
openssl pkcs12 -in example.com.pfx -nodes -nokeys -out fullchain.pem

问:*.example.com 到底覆盖谁?

按 RFC 6125 与 CA/B Forum 基线要求,通配符只能占最左一个标签:覆盖 a.example.com,不覆盖 example.com,也不覆盖 a.b.example.com。需要裸域就在 SAN 里加 example.com;需要多级就再加 *.api.example.com 或改用多域名 SAN 证书。

问:acme.sh 怎么一条命令装完并自动续?

acme.sh --install-cert -d '*.example.com' 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.crt 
  --reloadcmd      'nginx -s reload'
# acme.sh 默认 60 天自动续期,无需 cron 手写
sudo chmod 700 /etc/nginx/ssl && sudo chmod 600 /etc/nginx/ssl/example.com.key

私钥目录 700、文件 600 是最低要求,否则备份系统、日志采集器会把 privkey.pem 明文带出机器——这比证书过期更危险。

不能只靠 *.example.com。通配符只匹配一级子域,裸域 example.com 需要单独加入 SAN。Let's Encrypt 申请时写成 -d '*.example.com' -d example.com,商业证书下单时也要在 SAN 中勾选裸域,否则访问 https://example.com 会报名称不匹配。

先查服务端是否发送完整链。执行 openssl s_client -connect example.com:443 -servername test.example.com -showcerts,若只看到 1 张证书,说明缺中间证书。再把 leaf 与 intermediate 按顺序拼成 fullchain 并重载服务,最后检查系统时间、SNI 与证书是否过期。

可以,同一私钥可部署到多台服务器,但复制范围越大泄露面越高。建议私钥文件权限 600、目录 700,生产与测试环境分别签发。商业通配符通常允许同一主域下多台服务器使用,具体以 CA 的订阅协议为准。

只有一级子域且数量超过 5 个时,通配符更省管理成本;跨多个主域、需要裸域或多级子域时,SAN 证书更合适。预算方面,Let's Encrypt 通配符免费但 90 天续期,商业 DV 通配符约 300-1500 元/年,OV 通配符约 2000-6000 元/年。

通常是密码不一致或 pfx 损坏。先用 openssl pkcs12 -info -in wildcard.pfx 验证密码,再用 keytool -importkeystore 重新生成 PKCS12,确保 -deststorepass 与 server.xml 的 certificateKeystorePassword 完全一致。若仍失败,检查 pfx 是否包含私钥。

不需要。Nginx 用 nginx -t 检查后执行 nginx -s reload;Apache 用 apachectl -k graceful;Tomcat 重启应用容器即可;IIS 绑定后回收应用程序池通常足够。Kubernetes 更新 Secret 后由 Ingress 控制器热加载,一般 30-60 秒生效。

文件路径和续期方式不同。Let's Encrypt 使用 /etc/letsencrypt/live/example.com/ 下的 fullchain.pem 与 privkey.pem,90 天自动续期;商业证书常交付 .crt、.key、.pfx,需要自己拼链或转 PFX。两者对 fullchain 顺序、私钥权限和中间证书的要求一致。


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

内容审核

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