跳到主要内容
基础知识

通配符证书 configuration 配置审计:Caddy、Traefik 与 K8s 的 8 项 SNI 基线(2025)

通配符证书 configuration — 通配符证书 configuration 配置审计:Caddy、Traefik 与 K8s 的 8 项 SNI 基线(2025)
核心结论

通配符证书 configuration 的关键不是上传证书,而是让每个子域的 SNI 都命中同一张包含 `*.example.com` 的证书;据 RFC 6125 第 6.4.3 节,`*.example.com` 只匹配一级标签,`a.b.example.com` 与裸域 `example.com` 需额外 SAN。 实操上先用 `openssl x509 -noout -ext subjectAltName` 核对 SAN,再在 Caddy 2.8 写 `tls /path/fullchain.pem /path/wildcard.key`,Traefik 3.1 配 `defaultCertificate`,ingress-nginx 1.10 用同命名空间 Secret。 验证必须带 SNI:`openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts`,看到 `Verify return code: 0 (ok)` 且 `subjectAltName` 含 `*.example.com` 才算生效。 常见报错 `no alternative certificate subject name matches target host name` 多来自多级子域或裸域漏配;`certificate signed by unknown authority` 多来自 fullchain 只放了叶子证书。 通配符证书 configuration 要纳入 CI:用 `openssl x509 -checkend 2592000` 做 30 天到期门禁,用 SHA256 指纹比对多节点证书,避免手工上传后的配置漂移。

为什么通配符证书 configuration 经常「证书没错、域名却报错」?

问:证书明明签下来了,浏览器却报 NET::ERR_CERT_COMMON_NAME_INVALID,问题出在哪?

因为「通配符证书 configuration」从来不是一次上传动作,而是三件事的组合:证书选择(哪张证书被选中)、SNI 路由(按 ClientHello 里的 server_name 选证书)、证书链(是否下发中间证书)。只把 PEM 传到负载均衡却不建 SNI 映射、不设默认证书,握手就会落到另一张证书上。据 OpenSSL 文档,服务端在未收到 SNI 或未匹配时使用默认上下文,这个行为不会报错,只会「安静地给错证书」。

# 适用 curl 7.6x+;-v 会打印实际协商到的证书主体
# 若 subject 是 *.other.com 或 default.invalid,说明 SNI 未命中
curl -vI https://api.example.com 2>&1 | grep -E 'subject:|issuer:|start date|expire date|SSL certificate'

# 典型失败输出(curl 7.88 / OpenSSL 3.0)
# curl: (60) SSL: no alternative certificate subject name matches target hostname 'a.b.example.com'

问:*.example.com 到底能覆盖多少个子域?

据 RFC 6125 第 6.4.3 节,通配符只匹配一个标签,且不匹配裸域。所以通配符证书 configuration 的第一步是盘点域名层级,而不是先改 Web 服务器。

主机名 *.example.com 是否匹配 正确做法
api.example.com 匹配 无需额外 SAN
a.b.example.com 不匹配(跨两级) 加 *.b.example.com 或具体名
example.com 不匹配(裸域) SAN 中显式写入 example.com

问:通配符能不能走 HTTP-01 自动续期?

不能。据 Let’s Encrypt 文档,通配符证书必须使用 DNS-01 验证。2025 年常见组合是 acme.sh 3.0.8 配 --dns dns_cf,或 certbot 2.11 配 --manual --preferred-challenges dns;签发后有效期仍为 90 天,续期靠 DNS API 凭据。

# acme.sh 3.0.8+;-d 同时给裸域与通配符,才能覆盖 example.com
# 注意:acme.sh 3.x 默认 CA 已改为 ZeroSSL,走 Let's Encrypt 需显式指定 --server
export CF_Token="你的 Cloudflare API Token"   # dns_cf 读取此环境变量
acme.sh --issue --server letsencrypt 
  --dns dns_cf -d example.com -d '*.example.com' 
  --keylength ec-256          # 默认值即 ec-256,可改 2048 走 RSA
acme.sh --install-cert -d example.com --key-file /etc/ssl/priv.key 
  --fullchain-file /etc/ssl/fullchain.pem --reloadcmd "systemctl reload caddy"

问:边缘正常、回源报错,怎么快速定位?

多环境高频问题是双层 TLS 终止:CDN 或云 LB 已终止 TLS,Ingress 又配了 spec.tls,结果上游走 HTTP、边缘证书过期未同步。用 -servername 分别连边缘 IP 与回源 IP,比对指纹即可判断两张证书是否同源。

# 适用 OpenSSL 1.1.1 / 3.x;省略 -servername 则发送空 SNI,可测默认证书
openssl s_client -connect 203.0.113.10:443 -servername api.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -fingerprint -sha256
openssl s_client -connect 10.0.0.12:443    -servername api.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -fingerprint -sha256

把审计目标写成可检查项,比「证书已上传」更接近真实可用状态:SAN 是否同时含 *.example.com 与 example.com;SNI 是否命中预期证书;fullchain 是否含中间证书(Mozilla Server Side TLS 要求完整链);私钥权限是否 600;剩余有效期是否大于 30 天。这五项在 Caddy、Traefik 与 K8s Ingress 上的落点不同,正是下一节 8 项 SNI 基线要逐条对齐的原因。

通配符证书 configuration 的 9 步落地清单

把通配符证书从”签下来”变成”可审计”,关键是把 9 个动作固化成顺序可复现的清单。每一步都留下可验证的输出,才不会在上线后才发现某个子域不在覆盖范围内。

  1. 先盘域名,别急着写 CSR。用现有流量日志或 DNS 区文件导出主机名,抽取子域前缀去重:
# 从实际访问域名列表抽取最左侧标签,识别哪些是一级子域、哪些是多级
printf '%sn' api.example.com www.example.com admin.example.com a.b.example.com 
  | awk -F. '{print $1}' | sort -u
# 输出:a  admin  api  b  www —— 出现 "a" 说明存在多级子域,通配符覆盖不到
  1. 再定 SAN。据 RFC 6125 §6.4.3,通配符只匹配最左一个标签,*.example.com 不覆盖 a.b.example.com,也通常不覆盖裸域。CSR 的扩展段必须同时写入两者:
# openssl.cnf 片段:通配符 + 裸域,缺一不可
[req]
req_extensions = v3_req
[v3_req]
subjectAltName = DNS:*.example.com,DNS:example.com
# 校验生成结果,应看到 2 条 DNS 记录
openssl req -new -key wildcard.key -config openssl.cnf -out wildcard.csr
openssl req -in wildcard.csr -noout -text | grep -A1 'Subject Alternative Name'
  1. 选 DNS-01 签发。据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 验证,HTTP-01 一律失败。acme.sh 3.0.8 与 certbot 2.11 的等价命令:
# acme.sh 3.0.8:Cloudflare API Token 走环境变量 CF_Token
acme.sh --issue --dns dns_cf -d '*.example.com' -d example.com --keylength ec-256
# certbot 2.11:手动 DNS 模式,需在 _acme-challenge 下添加 TXT 记录
certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com
# 产物默认落在 ~/.acme.sh/*.example.com_ecc/ 与 /etc/letsencrypt/live/example.com/
  1. 确定唯一 TLS 终止层。边缘 LB 终止时,Ingress 到上游降级为 HTTP 或改用 mTLS,避免同一张私钥散落在多层。多终止层是”某节点还加载旧证书”的首要成因。
  1. 按最小权限部署文件。私钥 600、目录 700;fullchain.pem 至少含叶子证书与中间证书:
install -d -m 700 /etc/ssl/wildcard
install -m 600 wildcard.key  /etc/ssl/wildcard/wildcard.key
install -m 644 fullchain.pem /etc/ssl/wildcard/fullchain.pem
# 常见结果为 2(叶子+中间)或 3(含交叉签名根);结果为 1 说明漏了中间证书
grep -c 'BEGIN CERTIFICATE' /etc/ssl/wildcard/fullchain.pem
  1. 配置 SNI 选证。三种常见入口的落点不同,但都必须显式指向同一张通配符证书,而不是依赖隐式默认证书:
# Caddy 2.8:站点地址写通配符 + 裸域,显式 tls 指定文件而非自动签发
*.example.com, example.com {
    tls /etc/ssl/wildcard/fullchain.pem /etc/ssl/wildcard/wildcard.key
    reverse_proxy 10.0.0.10:8080
}

# Traefik 3.1 dynamic.yml:file provider 的默认证书,兜住未匹配的 SNI
tls:
  stores:
    default:
      defaultCertificate:
        certFile: /certs/fullchain.pem
        keyFile: /certs/wildcard.key
# ingress-nginx 1.10:tls.hosts 列实际子域,secret 必须与 Ingress 同命名空间
spec:
  tls:
  - hosts: ["api.example.com", "www.example.com"]
    secretName: wildcard-example-tls
入口 选证位置 未匹配 SNI 时 重载方式
Caddy 2.8 站点地址 + tls 指令 握手失败(无默认证书) caddy reload 手动
Traefik 3.1 tls.stores.default.defaultCertificate 回落到 defaultCertificate file provider 监听文件变更
ingress-nginx 1.10 Ingress tls.hosts + Secret 回落到 --default-ssl-certificate(默认空) controller 自动重载
  1. 重载。Caddy 执行 caddy reload --config /etc/caddy/Caddyfile;Traefik 的 file provider 默认轮询文件变化,无需重启;ingress-nginx 由 controller 监听 Secret 变更自动下发。
  1. 带 SNI 的验证。不带 -servername 会拿到默认证书,验证结论无效:
openssl s_client -connect api.example.com:443 -servername api.example.com 
  -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
  1. 把通配符证书 configuration 写进 CI 门禁。发布前检查有效期余量,发布后比对多节点指纹,防止部分节点仍加载旧证书:
# 剩余有效期不足 30 天(2592000 秒)即阻断;未过期返回 0,过期返回非 0
openssl s_client -connect "$HOST:443" -servername "$HOST" /dev/null 
  | openssl x509 -noout -checkend 2592000 || exit 1

# 各节点 SHA-256 指纹必须一致,不一致说明有节点没热加载
for h in node1 node2 node3; do
  openssl s_client -connect "$h:443" -servername "$HOST" /dev/null 
    | openssl x509 -noout -fingerprint -sha256
done | sort -u | wc -l   # 期望输出 1

把第 1–2 步的域名清单和第 9 步的指纹结果一起存档,这份通配符证书 configuration 就同时具备了可复现性和可审计性——下次续期或扩容节点时,直接重跑清单即可定位偏差发生在哪一层。

通配符证书 configuration 示例:Caddy 2.8、Traefik 3.1 与 ingress-nginx 1.10

很多人第一次把通配符证书塞进反向代理时都会问同一句话:“证书路径写对了,为什么浏览器还是报 NET::ERR_CERT_AUTHORITY_INVALID 或者落到了自签证书?”答案通常不在证书本身,而在 通配符证书 configuration 的三处细节:文件顺序、默认证书回落、以及 SNI 主机名是否被显式列出。下面按 Caddy 2.8.4 → Traefik 3.1 → ingress-nginx 1.10.1 的顺序给出可直接复制的片段。

Caddy 2.8.4 的 Caddyfile 怎么写?用 tls 指令后跟两个路径,证书链在前、私钥在后:

# Caddy 2.8.4 Caddyfile
*.example.com, example.com {
    # 顺序固定:fullchain 在前,私钥在后
    tls /etc/ssl/wildcard/fullchain.pem /etc/ssl/wildcard/wildcard.key

    # 按 Host 头精确路由,避免通配符站点吞掉所有子域
    @api host api.example.com
    handle @api {
        reverse_proxy 10.0.1.10:8080
    }

    respond 404
}

顺序写反不会给出友好提示,Go 的 crypto/tls 会直接抛 tls: failed to find any PEM data in certificate input,Caddy 启动阶段即退出。Caddy 官方文档也明确 tls <cert_file> <key_file> 的参数顺序。

Traefik 3.1 如何让未匹配的 SNI 不回落自签证书?必须显式配置 defaultCertificate,否则仅靠 ACME 的 tls.domains 时,未知 SNI 会拿到 Traefik 内置的自签证书:

# dynamic.yml — Traefik 3.1
tls:
  certificates:
    - certFile: /certs/fullchain.pem
      keyFile: /certs/wildcard.key
  stores:
    default:
      # 关键行:没有它,未匹配 SNI 回落到 Traefik 自签证书
      defaultCertificate:
        certFile: /certs/fullchain.pem
        keyFile: /certs/wildcard.key

ingress-nginx 1.10.1 的 Secret 怎么建?先落 Secret,再让 Ingress 引用;Secret 必须与 Ingress 同 namespace:

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

# 确认存在且类型为 kubernetes.io/tls
kubectl get secret -n prod wildcard-example-tls
spec:
  tls:
    - hosts:            # 必须逐条列出,通配符不自动展开
        - api.example.com
        - admin.example.com
      secretName: wildcard-example-tls

若希望所有未声明 TLS 的 Ingress 共用一张证书,可用控制器启动参数 --default-ssl-certificate=prod/wildcard-example-tls(1.10.x 默认未开启)。

CSR 阶段就把 SAN 写全了吗?OpenSSL 3.0.13 下用配置文件生成,CN 已不被现代校验依赖(见 RFC 6125 与 CA/B Forum 基线要求),SAN 才是权威来源:

# wildcard.cnf
[req]
distinguished_name = dn
req_extensions     = v3_req
prompt             = no

[dn]
CN = *.example.com

[v3_req]
subjectAltName = DNS:*.example.com,DNS:example.com
keyUsage = digitalSignature,keyEncipherment
extendedKeyUsage = serverAuth
openssl req -new -newkey rsa:2048 -nodes 
  -keyout wildcard.key -out wildcard.csr -config wildcard.cnf

据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 挑战签发,HTTP-01 无法验证 *。

上线后怎么验证?两条命令固定下来:

openssl s_client -connect api.example.com:443 -servername api.example.com 
  -showcerts </dev/null 2>/dev/null | openssl x509 -noout -checkhost api.example.com
# 期望:Hostname api.example.com does match certificate

curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://api.example.com
# 期望:200 0(0 = X509_V_OK)
维度 Caddy 2.8.4 Traefik 3.1 ingress-nginx 1.10.1
证书注入字段 tls <cert> <key> tls.certificates[] spec.tls[].secretName
未匹配 SNI 行为 站点块内首个证书 需 defaultCertificate,否则自签 需 --default-ssl-certificate,否则 fake certificate
配置热更新 caddy reload 文件监听自动生效 Secret 变更后异步重载

通配符证书 configuration 放在哪一层?参数对比与选型表

通配符证书 configuration 到底该写在哪一层,取决于”谁终止 TLS、谁决定 SNI 与证书的映射”。换句话说,证书放错层不会立刻报错,但会让热更新链路断掉:边缘改完了、容器里还是旧证书,或者未匹配的 SNI 悄悄回落到自签证书。先看四种常见落点的差异:

方案 证书选择方式 通配符支持 热更新 适用场景 注意点
Caddy 2.8 Caddyfile 显式 tls 文件 支持 caddy reload 边缘反向代理、单机多域名 文件顺序证书链在前
Traefik 3.1 dynamic YAML 的 defaultCertificate 支持 file provider 监听 动态服务发现、容器平台 未匹配 SNI 会回落默认证书
ingress-nginx 1.10 Secret + Ingress tls.hosts 支持 controller 自动重载 Kubernetes 集群 Secret 必须同命名空间
云 LB 控制台上传证书 支持 控制台或 API 更新 合规、托管边缘 注意证书链和回源协议

两个可直接抄的落点示例,注意注释里标注了审计要点:

# Caddy 2.8 Caddyfile —— 通配符只能走 DNS-01;fullchain 中叶子证书必须在最前
*.example.com {
    tls /etc/certs/wildcard.fullchain.pem /etc/certs/wildcard.key
    header Strict-Transport-Security "max-age=300"   # 首次上线用 300 秒观察
}

# Traefik 3.1 dynamic.yml(file provider 默认 watch=true,改动即生效)
tls:
  stores:
    default:
      defaultCertificate:            # 未匹配 SNI 时回落到此证书,缺失则用自签默认证书
        certFile: /certs/wildcard.fullchain.pem
        keyFile: /certs/wildcard.key

参数基线按 Mozilla SSL Configuration Generator 的 intermediate 档:启用 TLS 1.2 与 TLS 1.3,禁用 TLS 1.0/1.1;HSTS 用 max-age=31536000; includeSubDomains,但首次上线先设 max-age=300 观察,避免子域未全量 HTTPS 时被锁死。ingress-nginx 1.10 的 ssl-protocols 默认已是 TLSv1.2 TLSv1.3,审计时重点看是否被 ConfigMap 覆盖。上线后务必验证 SNI 命中,而不是只看浏览器:

# 指定 SNI 取证书,确认返回的是通配符证书而非默认自签证书
openssl s_client -connect 203.0.113.10:443 -servername app.example.com /dev/null 
  | openssl x509 -noout -subject -issuer -dates

成本与时间:Let’s Encrypt 通配符 0 元、90 天有效,DNS-01 自动签发通常 1–5 分钟完成;手工加 TXT 记录需等生效 1–10 分钟。商业 OV 通配符常见 800–3000 元/年,企业 CA 通配符常见 3000–10000 元/年,换来更长有效期与责任赔付。

怎么选?单集群 Kubernetes 优先 ingress-nginx 1.10,证书配置入口统一在 Secret;边缘多域名与静态站点用 Caddy 2.8,Caddyfile 可读性好、reload 无中断;后端服务发现频繁变化用 Traefik 3.1;已有云 LB 且合规要求高时,把通配符证书 configuration 放在云 LB,但要用 API 把证书指纹同步到 CMDB,否则续期后审计表会失真。无论哪层,都建议在变更后用上面那条 openssl s_client 抓一次实际链,据 Let’s Encrypt 文档,通配符证书仅支持 DNS-01 验证,这条约束决定了你的自动化脚本必须能改 DNS。

通配符证书 configuration 常见错误与真实报错

把 8 项 SNI 基线落成 CI 检查后,通配符证书 configuration 的失败几乎全部收敛到这六类报错。先看总览,再逐条给命令。

报错关键字 根因 一条命令定位
no alternative certificate subject name matches 多级子域超出 *.example.com 覆盖 openssl s_client -servername ... | openssl x509 -noout -ext subjectAltName
valid for *.example.com, not example.com 裸域未进 SAN openssl x509 -in fullchain.pem -noout -ext subjectAltName
PEM_read_bio_X509_AUX() failed 私钥当证书 / fullchain 为空 head -1 fullchain.pem
certificate signed by unknown authority 中间证书缺失 openssl verify -untrusted intermediate.pem fullchain.pem
non-existent certificate(Traefik 3.1) dynamic 配置未加载或路径不存在 docker exec traefik ls -l /certs
secret "..." not found(ingress-nginx 1.10) Secret 跨命名空间或类型错误 kubectl get secret -n prod ... -o yaml

为什么 a.b.example.com 匹配不上 *.example.com? 据 RFC 6125 §6.4.3,通配符只能占据最左侧一个标签,不能跨层。先用服务端视角确认实际下发的 SAN:

# 复现报错:curl: (60) SSL: no alternative certificate subject name matches target host name 'a.b.example.com'
curl -sv https://a.b.example.com/ 2>&1 | grep -i 'subjectAltName|alternative'

# 查看服务端真实下发的 SAN(必须带 -servername,否则拿到默认证书)
openssl s_client -connect a.b.example.com:443 -servername a.b.example.com /dev/null 
  | openssl x509 -noout -ext subjectAltName
# 只出现 DNS:*.example.com 即为根因;修复:单独签发 *.b.example.com,或把 a.b.example.com 加进 SAN

裸域为什么也报 not example.com? 通配符不包含裸域。Let’s Encrypt 文档明确允许在同一张证书的 SAN 中同时写入 example.com 与 *.example.com(同一订单、DNS-01 校验):

openssl x509 -in fullchain.pem -noout -ext subjectAltName
# 期望:DNS:example.com, DNS:*.example.com —— 缺前者时 curl 访问 https://example.com 必然失败

PEM 报错怎么 30 秒判定? nginx 的 [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line:Expecting: TRUSTED CERTIFICATE) 十有八九是 ssl_certificate 指向了私钥,或 fullchain.pem 为空文件(常见于 certbot 续期失败后残留)。

head -1 fullchain.pem   # 必须是 -----BEGIN CERTIFICATE-----
head -1 wildcard.key    # 必须是 -----BEGIN PRIVATE KEY----- 或 -----BEGIN RSA PRIVATE KEY-----
grep -c 'BEGIN CERTIFICATE' fullchain.pem   # 正常为 2(叶子 + 中间证书),为 1 说明链不完整

链不完整怎么验证并补?

openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted intermediate.pem fullchain.pem
# 期望输出 fullchain.pem: OK;报 unable to get local issuer certificate 时:
cat intermediate.pem >> fullchain.pem   # 顺序不可颠倒:叶子在前,中间证书在后

Traefik 3.1 说找不到证书? 多数是 dynamic.yml 未通过 providers.file 挂载,或 certFile 在容器内路径不存在,也可能是 defaultCertificate 拼写/层级错误(应位于 tls.stores.default.defaultCertificate)。

docker exec traefik traefik version    # 确认 3.1.x
docker exec traefik ls -l /certs       # 与 dynamic.yml 中 certFile/keyFile 路径逐字比对
docker exec traefik cat /etc/traefik/dynamic.yml | grep -A4 defaultCertificate

ingress-nginx 报 Secret not found? Ingress 与 Secret 必须同命名空间,且 Secret 的 type 必须是 kubernetes.io/tls;用 kubectl create secret generic 建的 Opaque Secret 会被忽略。

kubectl get secret -n prod wildcard-example-tls -o yaml | grep -E 'type:|tls.(crt|key):'
# type 非 kubernetes.io/tls 或缺少 tls.crt/tls.key 即根因,重建:
kubectl create secret tls wildcard-example-tls -n prod 
  --cert=fullchain.pem --key=wildcard.key --dry-run=client -o yaml | kubectl apply -f -

这些报错都指向同一个审计动作:先确认“SAN 集合 ⊇ 实际访问的主机名集合”,再确认“证书链完整”,最后确认“配置加载器真的读到了文件”。据 OpenSSL 文档,openssl verify 的 -untrusted 只提供中间证书而不改变信任锚,因此它比浏览器报错更适合放进流水线做前置校验。

如何验证通配符证书 configuration 已生效?

能打开网页不等于通配符证书 configuration 生效:浏览器缓存、CDN 边缘节点、甚至 DNS 轮询都可能让你只验证到”某一台机器上恰好正确的那份证书”。按下面六层逐级下探,任何一层失败都说明部署面与配置面不一致。

第一层:证书内容本身。据 RFC 6066,不带 SNI 的握手会落到服务端默认虚拟主机,验证到的可能是完全无关的证书——所以 -servername 不是可选项。

# 取叶子证书,解析主体、签发者、有效期与 SAN(OpenSSL 1.1.1 / 3.x 通用)
openssl s_client -connect api.example.com:443 
  -servername api.example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望输出示例:
# subject=CN = *.example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notAfter=Oct  9 12:00:00 2025 GMT
# X509v3 Subject Alternative Name:
#     DNS:*.example.com, DNS:example.com

# 剩余有效期是否超过 30 天:退出码 0 表示"30 天内不会过期"
openssl s_client -connect api.example.com:443 -servername api.example.com 
  </dev/null 2>/dev/null | openssl x509 -noout -checkend 2592000

第二层:链完整性与主机名匹配。只部署 cert.pem 而漏掉中间证书,是 Let’s Encrypt 场景最高频的事故;据 Let’s Encrypt 文档,其交叉签名链一旦变化,未带中间证书的节点会立刻报 unable to get local issuer certificate。通配符匹配遵循 RFC 9525:*.example.com 只覆盖一级标签,a.b.example.com 不匹配。

openssl s_client -connect api.example.com:443 -servername api.example.com 
  </dev/null 2>/dev/null | grep 'Verify return code'
# 期望:Verify return code: 0 (ok)

openssl x509 -in fullchain.pem -noout -checkhost api.example.com
# 期望:Hostname api.example.com does match certificate(只校验文件中的第一张证书)

# OpenSSL 3.0.x 更直观的写法;需配合 -verify_return_error 才会在失败时返回非 0
openssl s_client -connect api.example.com:443 -servername api.example.com 
  -verify_hostname api.example.com -verify_return_error </dev/null
# 输出含:Verified peername: api.example.com

第三层:HTTP 层结果。ssl_verify_result 的 0 即 OpenSSL 的 X509_V_OK;用 --resolve 直连单台节点,可绕开 DNS 轮询对故障节点的掩盖。

curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://api.example.com
# 期望:200 0

curl -vI https://api.example.com --resolve api.example.com:443:203.0.113.10 2>&1 
  | grep -E 'subject:|issuer:|SSL certificate verify'

第四层:多节点一致性(漂移检测)。通配符证书 configuration 在滚动发布时最容易被漏掉——新 Pod 挂载了新 Secret,老节点仍用旧证书,握手都”成功”,指纹却不同。

dig +short api.example.com | sort -u | while read ip; do
  printf '%-16s ' "$ip"
  openssl s_client -connect "$ip:443" -servername api.example.com </dev/null 2>/dev/null 
    | openssl x509 -noout -fingerprint -sha256 | tr -d 'n'; echo
done
# 所有行 SHA256 Fingerprint 必须完全一致

# Kubernetes 侧对照 Secret 中的实际内容(Ingress 的 tls.secretName 指向它)
kubectl get secret wildcard-tls -o jsonpath='{.data.tls.crt}' 
  | base64 -d | openssl x509 -noout -dates -ext subjectAltName
层级 判定命令关键点 期望输出 失败通常意味着
证书内容 -ext subjectAltName 含 DNS:*.example.com 与 DNS:example.com 签错域名或用自签证书
链与主机名 grep 'Verify return code' 0 (ok) 缺中间证书 / 主机名不匹配
HTTP 结果 %{ssl_verify_result} 200 0 过期、域名不符、被中间设备替换
多节点 -fingerprint -sha256 全部 IP 指纹一致 灰度节点未 reload,配置漂移
协议与扩展 testssl.sh --fast TLS 1.2/1.3、OCSP stapling、HSTS 旧模板残留 TLS 1.0/1.1
续期联动 -checkend 2592000 退出码 0 reload hook 静默失败

第五层:协议与扩展。证书正确不代表配置合规,用 testssl.sh 复核 TLS 版本、OCSP stapling 与 HSTS,与 Mozilla SSL Configuration Generator 的 intermediate 基线对照。

testssl.sh --sni api.example.com --fast https://api.example.com:443
# 关注项:TLS 1.2/1.3 是否启用、OCSP stapling 是否 offered、HSTS 头、证书链顺序

第六层:续期联动验证。证书换上了但进程没重载,是最隐蔽的一类故障。acme.sh 3.0.8 用 --reloadcmd、certbot 2.11 用 --deploy-hook 把重载绑定到续期事件;再用定时任务兜底。

# acme.sh 3.0.8+:续期成功后自动重载 Caddy
acme.sh --issue -d example.com -d '*.example.com' --dns dns_cf 
  --reloadcmd 'caddy reload --config /etc/caddy/Caddyfile'

# certbot 2.11+:hook 脚本放在 renewal-hooks 目录,所有证书续期后触发
certbot certonly --dns-cloudflare -d example.com -d '*.example.com' 
  --deploy-hook 'systemctl reload caddy'

# 兜底:每日 02:00 检查剩余有效期,失败即告警
# crontab -e -> 0 2 * * * /usr/local/bin/cert-check.sh
cat >/usr/local/bin/cert-check.sh <<'EOF'
#!/bin/sh
openssl s_client -connect api.example.com:443 -servername api.example.com 
  </dev/null 2>/dev/null | openssl x509 -noout -checkend 2592000 
  || curl -sS -X POST "$ALERT_WEBHOOK" -d 'text=通配符证书30天内过期或握手失败'
EOF
chmod +x /usr/local/bin/cert-check.sh

补充一个 Caddy 与 Traefik 的差异点:Caddy 2.x 可用 curl -s localhost:2019/certificates/ 从 admin API 直接读取内存中已加载的证书列表,省去逐节点握手;Traefik 则需查 /api/rawdata 中 router 的 tls.certResolver 字段确认通配符证书 configuration 是否真的绑定到了该入口点——两者都以”运行时状态”而非”磁盘文件”为准,这正是上述六层验证的共同前提。

不能。据 RFC 6125 第 6.4.3 节,通配符只匹配一个标签,`*.example.com` 可匹配 `api.example.com`,不匹配 `a.b.example.com`。需要为 `*.b.example.com` 单独签发,或把 `a.b.example.com` 加入 SAN。

在 SAN 中同时加入 `DNS:*.example.com` 与 `DNS:example.com`。Let's Encrypt 支持同一张证书同时包含两者,签发时用 `-d '*.example.com' -d example.com`,部署后用 `openssl x509 -noout -ext subjectAltName` 核对。

不能。Let's Encrypt 文档要求通配符证书使用 DNS-01 验证,因为 HTTP-01 无法证明对整级子域的控制权。acme.sh 3.0.8 可用 `–dns dns_cf`,certbot 2.11 可用 `–manual –preferred-challenges dns`。

子域多且都在同一级时,通配符证书 configuration 更省事,一张 `*.example.com` 覆盖 `api`、`admin`、`www`;跨多个主域或需要精确列出域名时,多域名 SAN 证书更合适。价格上 Let's Encrypt 通配符 0 元,商业 OV 通配符常见 800-3000 元/年。

先确认访问域名是否多级或裸域,再用 `openssl s_client -servername` 看实际返回的 SAN。若是多级子域,补签 `*.b.example.com` 或加入 SAN;若是裸域,补 `example.com`;若 SAN 正确但仍报错,检查 SNI 是否被默认证书覆盖。

把续期和重载绑在一起:acme.sh 3.0.8 用 `–reloadcmd 'caddy reload –config /etc/caddy/Caddyfile'`,certbot 2.11 用 `–deploy-hook` 更新 Secret 后由 ingress-nginx controller 重载。监控上用 `openssl x509 -checkend 2592000` 做 30 天窗口告警。


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

内容审核

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