通配符证书如何安装(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)。
- 核对文件清单并做私钥匹配。先用 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
- 合并完整证书链。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 里缺中间证书(常见是只放了叶证书),补中间证书而非换根证书
- 备份旧证书并记录指纹。把 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
- 按目标平台导入。三个平台的落点与生效方式差异很大,务必对号入座:
| 平台 | 放置/导入位置 | 关键配置 | 生效命令 |
|---|---|---|---|
| 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
- 重载服务并看日志。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 已换、证书未加载”。
- 留好回滚路径。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 加全部中间证书(根证书不必发)。拼接后重载并验证数量:
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。