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

通配符证书如何安装(how to install):CSR 校验、PFX 导入与 6 步上线

通配符证书 how to install — 通配符证书如何安装(how to install):CSR 校验、PFX 导入与 6 步上线
核心结论

通配符证书安装的核心是:把包含完整中间链的 fullchain 与私钥按目标平台要求导入,并确认 SAN 含 *.example.com;Nginx 1.24.0 用 ssl_certificate 指向 fullchain.pem,IIS 10 导入 PFX 后绑定 443,Kubernetes 1.29 用 tls Secret。 安装前先跑两条命令:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in wildcard.key | openssl md5,输出必须一致,否则会报 key values mismatch。 证书链合并顺序是 leaf 在前、中间证书在后:cat cert.pem chain.pem > fullchain.pem;只装 leaf 会让客户端报 unable to get local issuer certificate。 验证不要只看浏览器:用 openssl s_client -connect app.example.com:443 -servername app.example.com -showcerts 检查 Verify return code 为 0,再用 curl --resolve 对每台后端 IP 复测。

很多人把 通配符证书 how to install 当成”改两行 Nginx 配置”的活,结果重启后浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID、Go 服务报 x509: certificate is valid for *.example.com, not foo.bar.example.com。这两类报错跟证书文件本身无关,先弄清下面四个问题再动手装,能省掉大半排错时间。

Q1:*.example.com 到底能覆盖几级域名?

据 RFC 6125 第 6.4.3 节,通配符只匹配最左一个标签:*.example.com 匹配 api.example.com,但不匹配 foo.bar.example.com,也不匹配裸域 example.com。所以安装前先盘点业务域名层级;若确有二级子域,只能单独加 SAN 或另签证书。检查现有证书覆盖范围:

# 查看证书里实际签发的 SAN 列表(现代证书以 SAN 为准,CN 仅作兼容)
openssl x509 -noout -text -in wildcard.crt | grep -A1 "Subject Alternative Name"
# 输出示例:DNS:*.example.com, DNS:example.com

据 CA/Browser Forum Baseline Requirements 3.2.2.6,自 2017 年起公共 CA 必须把域名写入 SAN 扩展,CN 字段已不再是校验依据。因此 CSR 阶段就要写全:DNS:*.example.com,需要裸域时再加一条 DNS:example.com,漏写在安装后无法补救,只能重签。

Q2:浏览器正常,为什么 Java / Go 客户端报证书链错误?

安装失败最常见的根因不是证书文件损坏,而是服务只加载了 leaf(站点证书)、没加载中间证书。Nginx 1.24.0 的 ssl_certificate 应指向 fullchain.pem(站点证书在前、中间证书在后),顺序颠倒同样会握手失败:

# /etc/nginx/conf.d/example.conf —— Nginx 1.24.0 及 1.18+ 通用
server {
    listen 443 ssl;
    server_name *.example.com;
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;  # leaf 在前,中间证书在后
    ssl_certificate_key /etc/nginx/ssl/wildcard.key;   # 私钥单独文件,权限 600
    ssl_protocols       TLSv1.2 TLSv1.3;
}
# 验证链完整性:应输出 OK,否则说明缺中间证书
openssl verify -CAfile chain.pem -untrusted chain.pem wildcard.crt

Q3:私钥和证书真的是一对吗?

两者必须成对,比对 modulus 的 MD5 是最快的判定方法,不一致时 OpenSSL 直接报 key values mismatch:

openssl x509 -noout -modulus -in wildcard.crt | openssl md5
openssl rsa  -noout -modulus -in wildcard.key | openssl md5
# 两行输出必须完全相同,例如 (stdin)= 8f3c1a... 

Q4:有效期与文件权限怎么定?

据 Let’s Encrypt 文档,其证书有效期 90 天,建议在剩余 30 天前完成续期并向所有节点分发(通配符证书走 DNS-01 挑战,需提前配置 DNS API 凭据);商业 CA 常见 1 年,按合同续期并保留旧证书 7 天以上以便回滚。权限方面私钥应 chmod 600、属主 root:root;若 Nginx 以 nginx 用户运行 worker 且私钥归 root,需保证 master 以 root 启动(默认行为),否则会报 SSL_CTX_use_PrivateKey_file() failed 或 permission denied。

典型报错 根因 排查命令
x509: certificate is valid for *.example.com, not foo.bar.example.com 域名层级超出通配符范围(RFC 6125 6.4.3) openssl x509 -noout -text -in wildcard.crt
unable to get local issuer certificate 只部署 leaf,缺中间证书 openssl verify -CAfile chain.pem wildcard.crt
key values mismatch 证书与私钥不成对 modulus MD5 比对
SSL_CTX_use_PrivateKey_file() failed 私钥权限过严或属主错误 ls -l wildcard.key、nginx -t

把这四项确认完,再进入 CSR 校验与 PFX 导入环节,才算真正开始通配符证书 how to install 的正式流程;否则后面每一步都会在同一个报错上反复打转。

很多人把通配符证书装完,浏览器依旧报 NET::ERR_CERT_AUTHORITY_INVALID,原因通常不在证书本身,而是漏掉了链文件,或者把旧私钥配到了新证书上。下面按“通配符证书 how to install”的实际顺序拆成 6 步,每一步都给出可直接复制的命令和判定标准。据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 挑战签发,因此你手里至少应有 wildcard.key、cert.pem、chain.pem、fullchain.pem 四个文件(IIS 10 另需 wildcard.pfx;Kubernetes 1.29 的 Secret 里叫 tls.crt 与 tls.key)。

  1. 核对文件清单并做私钥匹配。先用 modulus 比对确认私钥与证书同源,避免“新证书 + 旧私钥”这种最难排查的错配:
# OpenSSL 3.x(Ubuntu 22.04 默认为 3.0.2):RSA 与 ECDSA 私钥都适用
openssl x509 -in cert.pem -noout -pubkey > cert.pub
openssl pkey -in wildcard.key -pubout      > key.pub
diff cert.pub key.pub && echo "MATCH"      # 无输出差异即匹配

# 若证书是 RSA,还可用传统 modulus 比对,两行哈希必须一致
openssl rsa -in wildcard.key -noout -modulus | openssl sha256
openssl x509 -in cert.pem   -noout -modulus | openssl sha256
  1. 合并完整证书链。Nginx、Apache 需要的是“叶证书 + 中间证书”,根证书不要放进去:
cat cert.pem chain.pem > fullchain.pem
openssl verify -untrusted chain.pem cert.pem
# 期望输出:cert.pem: OK

# 若报错:error 20 at 0 depth lookup: unable to get local issuer certificate
# 说明 chain.pem 里缺中间证书(常见是只放了叶证书),补中间证书而非换根证书
  1. 备份旧证书并记录指纹。把 SHA-256 指纹、序列号、到期日写进变更单,旧 fullchain 与私钥保留 7–30 天:
openssl x509 -in cert.pem -noout -fingerprint -sha256 -dates -subject -serial
# 输出示例:
# sha256 Fingerprint=3A:1F:...:9C
# notBefore=Mar  1 00:00:00 2025 GMT
# notAfter=May 30 23:59:59 2026 GMT
  1. 按目标平台导入。三个平台的落点与生效方式差异很大,务必对号入座:
平台 放置/导入位置 关键配置 生效命令
Nginx 1.24.0 /etc/nginx/ssl/ ssl_certificate 指向 fullchain nginx -t && systemctl reload nginx
IIS 10(Win Server 2016+) certlm.msc → 个人 → 证书 导入 PFX 时勾选“允许导出” iisreset /noforce
Kubernetes 1.29 命名空间 prod 的 TLS Secret 键名固定为 tls.crt / tls.key 重启 Ingress Controller 或 Pod
# Nginx:通配符证书的关键是 server_name 与证书 SAN 对齐
server {
    listen 443 ssl;
    server_name *.example.com;                          # 不匹配 example.com 与 a.b.example.com
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须含中间证书
    ssl_certificate_key /etc/nginx/ssl/wildcard.key;
    ssl_protocols       TLSv1.2 TLSv1.3;                # 1.24.0 默认含已弃用的 TLSv1/1.1,建议显式覆盖
}

# Kubernetes:Secret 用 PEM 原文,不要传 PFX
kubectl create secret tls wildcard-tls --cert=fullchain.pem --key=wildcard.key -n prod
kubectl get secret wildcard-tls -n prod -o jsonpath='{.data.tls.crt}' | base64 -d | openssl x509 -noout -subject
  1. 重载服务并看日志。Nginx 执行 nginx -t && systemctl reload nginx;IIS 执行 iisreset /noforce 或在绑定中重新选择证书;Kubernetes 中 Secret 更新后 ingress-nginx 一般会自动 reload,但如果你用的是较老的控制器或外部证书注入,需要显式 kubectl rollout restart deploy/ingress-nginx-controller -n ingress-nginx,否则会出现“Secret 已换、证书未加载”。
  1. 留好回滚路径。Nginx 换回旧 fullchain.pem 与私钥后再次 nginx -t && systemctl reload nginx;IIS 在站点绑定里重新选择旧证书;Kubernetes 用 kubectl apply -f secret-backup.yaml 恢复上一版 Secret,并记录回滚后的验证输出:
echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null 
  | openssl x509 -noout -subject -dates -fingerprint -sha256
# 与变更单上的指纹一致,才算回滚成功

为什么 nginx -t 通过、浏览器仍报错?最常见是 fullchain.pem 只放了叶证书;其次是通配符匹配范围问题——按 RFC 6125,*.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。这类问题在“通配符证书 how to install”的排查里占比极高,建议先跑一次 openssl s_client 看服务端实际下发的证书链,再决定改配置还是重签。

通配符证书安装的配置与命令示例:Nginx 1.24、IIS 10、K8s 1.29 怎么写

证书签发下来之后,通配符证书 how to install 的差别其实全在“服务端怎么加载”这一步:同一份 fullchain.pem,Nginx 读的是文件路径,IIS 认的是 Windows 证书存储,Kubernetes 要的是 Secret 对象。下面按三个平台给出可直接复制的片段。

Nginx 1.24.0:把 fullchain.pem(叶子证书 + 中间证书)与私钥分开存放,ssl_certificate 只认 fullchain,漏掉中间证书会让部分安卓客户端报 unable to get local issuer certificate。

# /etc/nginx/conf.d/app.conf —— Nginx 1.24.0 实测通过
server {
    listen 443 ssl http2;                 # 1.25.1 起 http2 拆为独立指令,1.24 仍可合并写
    server_name app.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须含中间证书
    ssl_certificate_key /etc/nginx/ssl/wildcard.key;

    ssl_protocols       TLSv1.2 TLSv1.3;  # TLSv1.0/1.1 已不推荐,默认值因版本而异
    ssl_session_cache   shared:SSL:10m;   # 1m 约容纳 4000 个会话
    ssl_session_timeout 1d;
    ssl_session_tickets off;              # 关闭 ticket,规避前向保密争议
}
# 改完必须语法检查再平滑重载,别直接 restart
nginx -t && systemctl reload nginx

参数不要凭感觉调,据 Mozilla SSL Configuration Generator 的 “intermediate” 预设作为起点即可;它同时会给出 OCSP stapling 与 HSTS 的建议值。

IIS 10:运行 certlm.msc(本地计算机存储,不是 certmgr.msc 的用户存储),导入 wildcard.pfx 到“个人 → 证书”,双击确认“证书路径”里中间 CA 齐全;随后在站点“绑定 → https/443”中选中 *.example.com,应用后执行 iisreset /noforce,再用浏览器无痕窗口复测——普通窗口的 HTTP/2 连接复用会掩盖配置未生效。

Kubernetes 1.29:Secret 有 1 MiB 上限,只放 fullchain 与私钥,不要塞无关根证书。

kubectl create secret tls wildcard-tls 
  --cert=fullchain.pem --key=wildcard.key -n prod
# Ingress 片段
# spec:
#   tls:
#   - hosts: [app.example.com]
#     secretName: wildcard-tls

上线后本地校验(OpenSSL 3.0.13):

openssl s_client -connect 192.0.2.10:443 -servername app.example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 重点看 SAN 是否含 DNS:*.example.com,以及 notAfter 日期

文件权限与 SELinux:chown root:root /etc/nginx/ssl/*、chmod 600 私钥、chmod 644 fullchain;RHEL 9 启用 SELinux 时还需 restorecon -Rv /etc/nginx/ssl,否则 Nginx 报 permission denied 而非证书错误,很容易误判。

平台 证书形态 生效命令 典型报错
Nginx 1.24 PEM 文件对 nginx -t && systemctl reload nginx key values mismatch
IIS 10 PFX / 证书存储 iisreset /noforce 链不完整,移动端告警
K8s 1.29 tls Secret 更新 Ingress 后由控制器热加载 secret is too large

最后提醒一句:只替换证书文件而不复测,等于没验证。TLS 版本协商、HTTP/2 是否仍启用、OCSP stapling 是否成功,都要在换证后重新跑一遍上面的 s_client 命令。

通配符证书安装方式怎么选?文件拷贝、PFX 导入、K8s Secret、负载均衡器对比

关于通配符证书 how to install,第一个要回答的问题不是”敲什么命令”,而是”证书从哪条通道进入运行时”。同一张 *.example.com 证书,放进 Nginx 是两次文件拷贝,放进 IIS 是一次 PFX 导入,放进 Kubernetes 是一个 Secret 对象,放进云负载均衡器则是一次 API 上传。四条通道的失败模式、回滚粒度和耗时完全不同,先看对比:

安装方式 适用场景 关键参数或命令 变更耗时 回滚方式
PEM 文件拷贝 Nginx、Envoy 等 Linux 服务 ssl_certificate fullchain.pem 5–15 分钟 替换旧文件并 reload
PFX 导入 IIS 10、Windows 服务 certlm.msc 导入并绑定 443 10–30 分钟 重新绑定旧证书
K8s Secret Kubernetes 1.29 Ingress kubectl create secret tls 5–20 分钟 恢复上一版 Secret
云负载均衡器 多可用区入口 上传证书链到托管平台 10–40 分钟 切回旧证书

PEM 文件拷贝:可控、易审计,但分发靠工具链。Nginx 的 ssl_certificate 没有默认值,必须显式指向一个按”叶证书 → 中间证书”顺序拼接的文件;顺序颠倒时浏览器报 NET::ERR_CERT_AUTHORITY_INVALID,而 openssl s_client 只显示叶证书。多节点分发用 Ansible 或 rsync,但每台机器都要执行 sha256sum 校验,避免半截文件落盘。

# 1) 校验链与私钥是否配对(模数哈希一致即配对)
openssl x509 -noout -modulus -in fullchain.pem | openssl sha256
openssl rsa  -noout -modulus -in wildcard.key  | openssl sha256

# 2) 目标机落盘并收紧权限(Nginx worker 以 nginx 用户读取 key)
sudo install -m 644 fullchain.pem /etc/nginx/ssl/fullchain.pem
sudo install -m 600 wildcard.key  /etc/nginx/ssl/wildcard.key

# 3) 先语法检查再平滑 reload,避免 443 直接不可用
sudo nginx -t && sudo nginx -s reload
server {
    listen 443 ssl;
    server_name *.example.com;
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;  # 必须含叶证书+中间证书
    ssl_certificate_key /etc/nginx/ssl/wildcard.key;
    ssl_protocols TLSv1.2 TLSv1.3;  # Nginx 1.23.4 起默认值即为此,旧版默认含 TLSv1
}

PFX 导入:图形化最直观,风险在私钥外流。PFX 是”证书 + 私钥 + 中间链”的单文件容器,导出时必须带 -certfile 追加中间证书,否则 IIS 绑定后链不完整。IIS 10 从”计算机”存储区(Cert:LocalMachineMy)查找证书,因此导入位置不能选错。导入完成后删除临时 PFX,或移入受控目录并限制 ACL。

# 导出 PFX(-certfile 追加中间证书;务必设置导出密码)
openssl pkcs12 -export -out wildcard.pfx -inkey wildcard.key -in cert.pem -certfile chain.pem

# Windows Server 2022 / IIS 10:导入到计算机存储区,IIS 只在这里查找
Import-PfxCertificate -FilePath C:certswildcard.pfx `
  -CertStoreLocation Cert:LocalMachineMy -Password (Read-Host -AsSecureString)

K8s Secret:滚动更新友好,坑在控制器不重载。Secret 类型固定为 kubernetes.io/tls,键名必须是 tls.crt 与 tls.key。更新 Secret 后,部分 Ingress Controller 不会自动感知文件变化,需重启控制器 Pod 才能让通配符证书安装真正生效——这是排查”证书换了但浏览器还显示旧的”时最先要看的地方。

# 先生成声明式 YAML,便于纳入 Git 与审计
kubectl create secret tls wildcard-tls -n prod 
  --cert=fullchain.pem --key=wildcard.key 
  --dry-run=client -o yaml > wildcard-secret.yaml
kubectl apply -f wildcard-secret.yaml

# 回滚:变更前先备份,出问题直接回放上一版
kubectl get secret wildcard-tls -n prod -o yaml > backup-secret.yaml
kubectl apply -f backup-secret.yaml

# 控制器不热加载时强制重建
kubectl rollout restart deployment ingress-nginx-controller -n ingress-nginx

云负载均衡器:卸载 TLS 省事,区域与链格式最易踩坑。据 AWS 文档,CloudFront 只接受 us-east-1 区域的 ACM 证书,在其他区域上传的证书在 CloudFront 控制台里根本看不到。另外 ACM 的导入证书不会自动续期,到期前必须重新导入同一张证书,这一点与 ACM 签发的证书不同。

# 上传带完整链的通配符证书到 us-east-1(CloudFront 的硬性要求)
aws acm import-certificate 
  --certificate fileb://cert.pem 
  --private-key fileb://wildcard.key 
  --certificate-chain fileb://chain.pem 
  --region us-east-1

无论走哪条通道,通配符的匹配范围都由 RFC 6125 约束:*.example.com 只覆盖一级子域,a.b.example.com 和裸域 example.com 都不在其中。据 Let’s Encrypt 文档,签发通配符证书必须使用 DNS-01 验证,这也意味着你无法用 HTTP-01 的方式为它续期。

选型时把三个变量放在一起评估:区域(证书能否上传到托管平台要求的区域)、链格式(PEM 拼接顺序 / PFX 是否含中间证书 / Secret 的键名)、回滚窗口(文件回滚是秒级,Secret 回滚是分钟级,云平台切回旧证书可能要等健康检查)。多可用区且团队没有配置管理能力时优先云负载均衡器;单机 Nginx 且要求审计留痕时优先 PEM 拷贝;容器化入口统一用 Secret,但把”控制器是否热加载”写进上线检查清单。

安装通配符证书常见错误有哪些?6 条真实报错与排查顺序

先把排查顺序记牢:私钥匹配 → PEM 格式 → 证书链 → 域名覆盖 → 平台配置。下面 6 条报错正好按这个顺序排列,前一条没排除就跳下一条,只会浪费重启 Nginx 的时间。

1. Nginx 启动报 SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:...X509_check_private_key:key values mismatch)

含义是证书里的公钥和 ssl_certificate_key 指向的私钥不是一对。最常见原因是换证书时忘了换私钥,或私钥被同名覆盖成旧文件。RSA 证书用 modulus 比对(OpenSSL 1.1.1 / 3.x 通用,-modulus 仅支持 RSA,ECDSA 需用 openssl pkey -pubout):

# 两个 md5 值必须完全一致
openssl x509 -noout -modulus -in /etc/nginx/ssl/wildcard.crt | openssl md5
openssl rsa  -noout -modulus -in /etc/nginx/ssl/wildcard.key | openssl md5
# ECDSA 证书改用公钥指纹比对
openssl x509 -in wildcard.crt -noout -pubkey | openssl md5
openssl pkey -in wildcard.key -pubout    | openssl md5

2. PEM_read_bio_X509_AUX(...) failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)

OpenSSL 在文件里找不到 PEM 起始行,三种可能:路径写错、文件为空、把二进制 PFX 直接改了后缀。先做三秒判定:

file /etc/nginx/ssl/fullchain.pem      # 期望: ASCII text
head -1 /etc/nginx/ssl/fullchain.pem   # 期望: -----BEGIN CERTIFICATE-----
# 若拿到的是 PFX,需先转换(-nodes 表示私钥不加密)
openssl pkcs12 -in wildcard.pfx -nokeys -clcerts -out cert.pem
openssl pkcs12 -in wildcard.pfx -nocerts -nodes  -out wildcard.key
文件形态 file 输出 首行特征 典型用途
PEM 证书 ASCII text —–BEGIN CERTIFICATE—– Nginx / Apache
PEM 私钥 ASCII text —–BEGIN PRIVATE KEY—– Nginx / Apache
PKCS#12 data 二进制,无首行 IIS / Java / Windows
DER data 二进制 Java KeyStore 导入

3. 客户端报 unable to get local issuer certificate

服务器只发了 leaf 证书,没发中间证书。据 Let’s Encrypt 文档与 CA/B Forum 基线要求,服务器应发送 leaf 加全部中间证书(根证书不必发)。拼接后重载并验证数量:

cat cert.pem chain.pem > fullchain.pem   # 顺序: leaf 在前, 中间链在后
nginx -t && systemctl reload nginx
# 返回的证书数应 ≥2(leaf + 中间)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 
  | grep -c "BEGIN CERTIFICATE"

4. curl 报 x509: certificate is valid for *.example.com, not foo.bar.example.com

通配符只覆盖一级标签,*.example.com 匹配 foo.example.com,不匹配 foo.bar.example.com——这是 RFC 6125 §6.4.3 的明确规定,与具体 CA 无关。安装前先核对 SAN:

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

层级超出的域名只能另购单域名证书或第二张通配符证书。

5. IIS 10 绑定 443 报 The certificate cannot be used for Server Authentication

说明 PFX 导入时私钥丢失,或增强型密钥用法缺少服务器身份验证。导出时必须带私钥并勾选”允许导出”,导入后在 certlm.msc 中确认证书带小钥匙图标、链完整:

openssl pkcs12 -export -out wildcard.pfx -inkey wildcard.key 
  -in fullchain.pem -certfile chain.pem     # -certfile 负责把中间链打包进 PFX
openssl x509 -in wildcard.crt -noout -text | grep -A1 "Extended Key Usage"
# 必须包含 TLS Web Server Authentication

6. Kubernetes 报 x509: certificate signed by unknown authority 或 Tomcat 报 java.security.cert.CertificateException: No subject alternative names present

前者几乎都是 Secret 里的 tls.crt 不是 fullchain;后者是应用导入了旧 CN 证书或漏了 SAN。分别解码核查:

kubectl get secret wildcard-tls -o jsonpath='{.data.tls.crt}' | base64 -d 
  | openssl x509 -noout -issuer -subject
keytool -list -v -keystore /opt/tomcat/conf/keystore.jks -alias wildcard | grep -A3 "SubjectAlternativeName"

注意通配符证书的 *.example.com 在 Java 中同样只匹配一级域名,这与 OpenSSL 行为一致,排查时不要误判为应用 Bug。

如何验证通配符证书安装生效?OpenSSL、curl 与浏览器三路确认

部署完 通配符证书(wildcard certificate)后,最容易出现的情况是:浏览器能打开,但链不完整或旧证书还挂在某台节点上。下面三路确认分别覆盖「证书内容」「网络路径」「真实浏览器」,任何一路失败都说明 通配符证书 how to install 的流程还没真正闭环。

第一路:用 OpenSSL 读取实际下发的证书内容。关键看 SAN 里是否有 DNS:*.example.com,以及末尾的 Verify return code。注意 -servername 必须带上,否则 SNI 缺失会拿到默认站点证书,这是最常见的误判来源。以下命令适用于 OpenSSL 1.1.1 及以上(-ext 参数在 1.1.1 引入;1.0.2 请改用 openssl x509 -text):

# 读取服务端实际链并解析叶子证书:SAN / 颁发者 / 有效期
openssl s_client -connect app.example.com:443 
  -servername app.example.com -showcerts /dev/null 
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望输出包含:DNS:*.example.com, DNS:example.com
# 注意:通配符只匹配一级,*.example.com 不覆盖 a.b.example.com(RFC 6125 §6.4.3)

同一命令去掉 2>/dev/null 就能看到握手尾部的手工验证结果,各返回码含义如下(取自 OpenSSL verify 手册):

Verify return code 含义 处置
0 (ok) 链完整且主机名校验通过 通过
10 certificate has expired 检查是否仍在用旧证书
20 unable to get local issuer certificate 服务器未下发中间证书
21 unable to verify the first certificate fullchain 顺序错或缺失
62 hostname mismatch SNI 或 SAN 不匹配

出现 20 / 21 时,回到 fullchain.pem 的合并顺序排查:叶子证书在前、中间证书在后,根证书不要放进去。用系统信任库显式验证一次链完整性:

# 用系统 CA 库验证服务端下发的链,Debian/Ubuntu 路径如下,RHEL 系为 /etc/pki/tls/certs/ca-bundle.crt
openssl s_client -connect app.example.com:443 -servername app.example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# 只看最后一行:Verify return code: 0 (ok) 才算链完整

第二路:用 curl 验证真实 HTTP 路径。用 --resolve 把域名钉到目标 IP,绕过本机 hosts 与 DNS 缓存,这是切换节点时最可靠的验证方式:

# 指定解析到后端 IP,验证状态码(期望 HTTP/2 200 或 301)
curl -I https://app.example.com --resolve app.example.com:443:192.0.2.10
# 加 -v 确认握手信息,输出中应出现 SSL certificate verify ok
curl -v https://app.example.com --resolve app.example.com:443:192.0.2.10 -o /dev/null

只测本机 hosts 或直接刷新浏览器,很容易被缓存与连接复用掩盖问题;--resolve 才能逐台机器验证。据 curl 官方文档,--resolve 优先于 DNS 解析且不写入系统缓存。

第三路:浏览器与自动化扫描。用无痕窗口分别访问 https://app.example.com 与 https://foo.example.com,点锁标志查看「证书路径」是否为三级链。再跑一次 testssl.sh 3.2(开源脚本,需 bash 4+ 与 openssl):

# 只看链、SAN、到期与协议,评分仅作参考
./testssl.sh --quiet --server-defaults --protocols app.example.com
# 关注输出中的 Chain of trust、Cert expiration、DNS *.example.com 三行

多节点必须逐台验。集群里只更新一台是高频事故,对每个后端 IP 单独执行:

# 逐台比对:SAN 与到期日必须完全一致
for ip in 192.0.2.10 192.0.2.11 192.0.2.12; do
  echo "== $ip"; echo | openssl s_client -connect $ip:443 
    -servername app.example.com 2>/dev/null 
  | openssl x509 -noout -dates -fingerprint -sha256
done
# 与变更单中的 SHA-256 指纹逐字比对,避免旧证书仍在生效

Kubernetes 场景核对 Secret 挂载与更新时间,Ingress 引用的名字必须与 Secret 一致:

kubectl describe ingress app-ingress | grep -A2 TLS   # 确认 secretName: wildcard-tls
kubectl describe secret wildcard-tls | grep -E 'tls.crt|tls.key'  # 无输出说明键名错误
kubectl get secret wildcard-tls -o jsonpath='{.data.tls.crt}' | base64 -d | openssl x509 -noout -dates

三路全部满足「SAN 含通配符 + Verify return code 0 + 指纹与变更单一致」时,才算这次通配符证书真正上线生效;任一节点指纹不同,就回到 CSR 校验与 PFX 导入环节重新核对私钥与证书是否配对。

安装通配符证书后还要做哪些收尾?私钥管控、监控与回滚

证书装完、浏览器绿锁出现,就可以收工了吗? 不行。通配符证书覆盖 *.example.com 下所有子域,一张私钥泄露就等于全部子域失守,因此上线后的收尾工作主要围绕“私钥可追溯、到期可预警、故障可回滚”这三件事。

wildcard.key 应该怎么放、怎么校验? 原则是“一个受控节点一份私钥、权限 600、永不入 Git”。安装时直接用 install 固定属主与权限,并立刻记录哈希写入变更单,后续轮换或多节点部署时用同一命令比对,能第一时间发现私钥版本漂移:

# 1) 收敛权限:仅 root 可读,属主 root:root(默认 644 是常见误配)
install -m 600 -o root -g root wildcard.key /etc/nginx/ssl/wildcard.key

# 2) 记录私钥指纹,写入变更单;轮换后与旧值比对
sha256sum /etc/nginx/ssl/wildcard.key | tee -a /root/cert-audit/wildcard.key.sha256
# 输出示例:3f9a1c...b7e2  /etc/nginx/ssl/wildcard.key

# 3) 兜底防误提交:gitignore + 提交前钩子扫描 PEM 头
printf '*.keyn*.pfxn*.p12n' >> .gitignore
git secrets --add --literal '-----BEGIN PRIVATE KEY-----'
git secrets --add --literal '-----BEGIN RSA PRIVATE KEY-----'

多节点场景(如 Nginx 集群 + IIS 边缘)建议把 sha256sum 输出纳入配置管理校验,节点间哈希不一致即告警——这是“证书装错节点”类事故最便宜的检测手段。

怎么在证书到期前收到告警? 最轻量的方式是 openssl x509 -checkend(OpenSSL 1.1.1/3.x 均支持):-checkend 后接秒数,若证书在窗口内过期则退出码为 1,否则为 0,可直接用于 cron 或 CI 卡点:

# 2592000 秒 = 30 天;返回 1 表示即将到期
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem 
  || echo "WARN: 通配符证书 30 天内到期"

规模化监控推荐 Prometheus blackbox_exporter(0.25.0 起稳定提供 probe_ssl_earliest_cert_expiry 指标,值为 Unix 时间戳)。配置与两级阈值如下:

# blackbox.yml —— 只关心到期时间,可跳过链校验
modules:
  https_cert:
    prober: http
    timeout: 5s
    http:
      tls_config:
        insecure_skip_verify: true
# 告警规则:30 天预警,7 天升级为 P1
- alert: WildcardCertExpiring30d
  expr: probe_ssl_earliest_cert_expiry - time() < 30 * 86400
  for: 1h
- alert: WildcardCertExpiring7d
  expr: probe_ssl_earliest_cert_expiry - time() < 7 * 86400
  for: 10m

Let’s Encrypt 续期后还需要手工重新安装吗? 不需要,但要确认 --reloadcmd 真的执行了。据 Let’s Encrypt 文档,其证书有效期 90 天,官方建议在剩余 30 天前完成续期;acme.sh 3.0.8 可用 --install-cert 把续期结果直接写入指定路径并热加载,避免“续了但没生效”:

acme.sh --install-cert -d example.com -d '*.example.com' 
  --key-file       /etc/nginx/ssl/wildcard.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      'systemctl reload nginx'   # 关键:续期后自动生效

证书装坏了怎么快速回滚? 前提是保留上一版 fullchain 与私钥 7~30 天(跨过至少一个续期周期)。回滚前先备份当前文件,再按平台替换:

平台 回滚操作 校验命令
Nginx 用备份覆盖 fullchain.pem 与 wildcard.key nginx -t && systemctl reload nginx
IIS 站点绑定中重选旧证书(按指纹) certutil -store My
Kubernetes 恢复上一版 kubernetes.io/tls Secret kubectl rollout restart deploy/ingress
# 回滚前留档,便于二次排查
cp -a /etc/nginx/ssl/fullchain.pem /etc/nginx/ssl/backup/fullchain.$(date +%F).pem

变更记录里必须写哪些字段? 至少包含序列号、SHA-256 指纹、安装节点、生效时间与验证输出,一条命令即可采集,粘贴进变更模板即可满足审计与交接:

openssl x509 -noout -serial -fingerprint -sha256 -subject -issuer -dates 
  -in /etc/nginx/ssl/fullchain.pem
# serial=0A1B2C...
# SHA256 Fingerprint=5D:3E:...:9F

最后把通配符证书 how to install 的 6 步检查表(CSR 校验 → 签发链拼接 → PFX 导入 → 私钥落盘 600 → 到期监控 → 回滚备份)固化进变更模板;证书序列号与指纹是审计时唯一能证明“装的是哪张证书”的证据,缺失这一项,事后追责只能靠猜。

正确安装要同时满足三点:证书 SAN 含 *.example.com,服务加载的是包含中间链的 fullchain,私钥与证书 modulus 一致。安装后用 openssl s_client 检查 Verify return code 为 0,再对每台后端 IP 复测。

单域名证书只匹配一个 FQDN,通配符证书可匹配同一级子域,但不匹配 foo.bar.example.com。安装流程相似,区别在于通配符私钥影响面更大,需要更严格的私钥权限、分发记录和回滚窗口。

这表示私钥与证书不匹配。先执行 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in wildcard.key | openssl md5,两个哈希不一致就换回对应私钥,不要继续重载服务。

先确认 PFX 导出时包含私钥,再在 certlm.msc 中检查证书链和增强型密钥用法是否含服务器身份验证。若仍无效,删除临时绑定,重新导入带完整中间链的 PFX 并重启站点。

部分 Ingress Controller 不会在 Secret 更新后自动重载证书。可重启控制器 Pod 或执行 kubectl rollout restart deploy/,再用 openssl s_client 对入口 IP 复测,确认新指纹已生效。

通常是服务只发送了站点证书,没有发送中间证书。用 cat cert.pem chain.pem > fullchain.pem 重新合并,Nginx 指向 fullchain.pem,IIS 重新导入带链 PFX,然后用 openssl s_client -showcerts 确认返回至少两张证书。


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

内容审核

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