跳到主要内容
基础知识

通配符证书 checker 怎么用?8 个命令与 6 类报错排查实录

通配符证书 checker — 通配符证书 checker 怎么用?8 个命令与 6 类报错排查实录
核心结论

1)通配符证书 checker 的核心判定是:目标主机名必须与证书 SAN 中的 *.example.com 做单层最左标签匹配,且 openssl s_client -verify_hostname 返回 Verify return code: 0 (ok) 才算通过。2)*.example.com 不匹配 example.com 和 a.b.example.com;据 RFC 6125 第 6.4.3 节,通配符只能位于最左标签,CA/B Forum 还禁止 *.com、*.co.uk 这类公共后缀。3)本地快速检查用 OpenSSL 3.0.13:openssl x509 -in fullchain.pem -noout -checkhost api.example.com;在线复核用 testssl.sh 3.2 --certs,单次约 30-120 秒。4)Let's Encrypt 通配符必须走 DNS-01,certbot 2.11.0 用 --preferred-challenges dns,证书 90 天有效,建议剩余 30 天续期;DV 通配符公开报价约 ¥600-1500/年,OV 约 ¥1800-9000/年。

这是通配符证书 checker 报错里最容易被误判成”证书配错了”的一类。先给结论:主机名不匹配多数时候不是通配符没生效,而是你验证的名字本身不在证书的 SAN 列表里,或者你连的根本不是那台该返回该证书的服务器。据 RFC 6125 第 6.4.3 节,通配符只能出现在最左侧标签,且只替换一个标签:*.example.com 匹配 api.example.com、www.example.com,不匹配 example.com(根域必须单独写进 SAN),也不匹配 a.b.example.com。RFC 6125 第 6.4.4 节同时把 CN 标记为已弃用,现代校验以 SAN 为准:OpenSSL 1.1.0+ 的 X509_check_host 在证书存在 SAN 时默认忽略 CN,所以”CN 写了 *.example.com 应该够”是过时经验。

第一步:证书里到底有哪些名字?

# -ext 需 OpenSSL 1.1.1+;更老的版本改用 -text 并搜索 X509v3 Subject Alternative Name
openssl x509 -in fullchain.pem -noout -ext subjectAltName
# 期望输出(OpenSSL 3.0.13):DNS:*.example.com, DNS:example.com
# 只有 DNS:*.example.com 说明根域没覆盖,checker 判 example.com 不匹配是正确的

第二步:确认你握到的是边缘证书,而不是回源证书或默认虚拟主机。SNI 未传时 Nginx/Apache 会返回默认 server 块的证书,这是 openssl s_client 最经典的假阳性。必须显式带 -servername(OpenSSL 1.1.0+ 另有 -verify_hostname 做本地匹配校验):

openssl s_client -connect api.example.com:443 
  -servername api.example.com 
  -verify_hostname api.example.com 
  -verify_return_error </dev/null
# Verify return code: 0 (ok) 才算通配符匹配通过
# 62 才是 hostname mismatch;10/20 与通配符无关

第三步:先看返回码,再谈通配符。有效期与链问题会伪装成主机名错误,四类返回码含义完全不同:

返回码 含义 真实原因(与通配符无关)
0 ok 匹配通过
10 certificate has expired 容器挂载了旧的 fullchain.pem,重启未生效
20 unable to get local issuer certificate 缺中间证书,fullchain 只放了 leaf
62 hostname mismatch 名字不在 SAN,或跨了标签层级

第四步:公共后缀直接判不合规。据 CA/Browser Forum TLS Baseline Requirements,CA 不得为公共后缀(com、co.uk、github.io 等)签发通配符证书;Let’s Encrypt 文档也明确不接受 *.co.uk 这类申请。checker 若在证书里看到此类通配符,应直接报”不合规”而非”不匹配”。

其他高频误判来源:CDN/负载均衡的边缘证书与回源证书不一致;Kubernetes Ingress 的 tls.secretName 仍指向旧 Secret(改证书后需重新 apply 并等待控制器同步);多副本容器只有部分实例更新了证书文件。

通配符证书 checker 的完整实操步骤:从取证书到签发验证(8 步)

通配符证书 checker 报错里,真正“证书错了”的比例远低于“取错了证书”。CDN 边缘节点未带 SNI 时返回的是默认站点证书,源站与边缘证书版本不一致时又会拿到回滚的旧证书——8 步顺序的本质是:先锁定你正在检查的那一张证书,再谈匹配与链。下面每步都给完整命令与通过判据,可直接粘贴执行。

步骤 1:确认 DNS 解析落到边缘 IP。解析未生效时后续全部无意义,且容易误判为证书问题。

# 直接问公共 DNS,绕过本机缓存与 /etc/hosts
dig +short api.example.com @8.8.8.8
# 预期:返回边缘 IP(如 104.18.x.x);空输出 = 解析未生效或 NXDOMAIN
# 若返回的是 CNAME 链,加 +short 只显示末端 A 记录,需用 dig api.example.com @8.8.8.8 查看完整链

步骤 2:带 SNI 抓取服务器实际下发的证书。OpenSSL 3.0.13 的 s_client 默认使用系统信任库,必要时显式加 -CAfile /etc/ssl/certs/ca-certificates.crt(Debian/Ubuntu 路径;RHEL 系为 /etc/pki/tls/certs/ca-bundle.crt)。

openssl s_client -connect api.example.com:443 -servername api.example.com 
  -showcerts </dev/null > server.pem 2>/dev/null
# -servername 不可省:省略后多数 CDN 返回默认站点证书,checker 会误报 hostname mismatch
# server.pem 含整条证书链,第一段是叶证书

步骤 3:拆出 SAN 与有效期。据 CA/Browser Forum Baseline Requirements,公有证书单次有效期上限为 398 天,因此 notAfter 过近即为续期失败信号。

openssl x509 -in server.pem -noout -subject -issuer -dates -ext subjectAltName
# 预期:notBefore/notAfter 覆盖当前时间;SAN 含 DNS:*.example.com
# 若还要覆盖根域,必须额外含 DNS:example.com —— 通配符不匹配零级标签

步骤 4:用 -checkhost 做一次本地匹配判定。该选项自 OpenSSL 1.1.1 起提供,3.0.x 行为一致,按 RFC 6125(现由 RFC 9525 更新)的规则执行通配符匹配,即 *.example.com 只匹配一级标签,不匹配 a.b.example.com。

openssl x509 -in server.pem -noout -checkhost api.example.com
# 预期:Certificate will match

步骤 5:验证证书链是否完整。Let’s Encrypt 文档明确要求部署 fullchain.pem(叶证书 + R3/R10 中间证书),只下发叶证书是最常见的线上故障。

openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem server.pem
# 预期:server.pem: OK
# 缺中间证书时报:error 20 at 0 depth lookup: unable to get local issuer certificate

步骤 6:核对私钥匹配并查看 OCSP stapling。私钥不匹配在部署新证书时高发,表现为握手期 SSL_CTX_use_PrivateKey: key values mismatch。

openssl x509 -noout -pubkey -in server.pem | openssl sha256
openssl pkey -pubout -in privkey.pem | openssl sha256
# 两行哈希必须完全一致

openssl s_client -connect api.example.com:443 -servername api.example.com -status 
  </dev/null 2>/dev/null | grep -A1 'OCSP Response Status'
# 预期:OCSP Response Status: successful (0x0)
# 输出 "no response sent" 说明服务端未启用 stapling(非致命,但会影响吊销状态可见性)

步骤 7:用 curl 做端到端验证。ssl_verify_result 为 0 才表示链与主机名校验全部通过;curl 8.5.0 的 --cert-status 默认关闭,需要验证 OCSP stapling 时必须显式加。

curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://api.example.com
# 通过判据:200 0;出现 60/62 等错误码说明证书链或主机名不匹配

curl -sS --cert-status -o /dev/null -w '%{http_code}n' https://api.example.com
# 失败报:SSL certificate status: revoked 或 unable to get certificate status

步骤 8:签发或续期后,在边缘节点复跑步骤 3–7。通配符只能走 DNS-01 校验,Let’s Encrypt 与 certbot 文档均说明其不支持 HTTP-01 通配符签发。

# certbot 2.11.0
certbot certonly --manual --preferred-challenges dns 
  -d '*.example.com' -d example.com
# 按提示在 _acme-challenge.example.com 添加 TXT 记录,TTL 建议 300 秒
# 签发完成后 1–10 分钟内复跑步骤 3–7,确认边缘未回滚到旧证书
步骤 关键命令 通过判据 典型失败信号
1 DNS dig +short 返回边缘 IP 空输出 / 源站 IP
2 取证书 s_client -servername 拿到叶证书 + 链 默认站点证书
3 SAN/有效期 x509 -ext subjectAltName 含 *.example.com 且在有效期内 缺根域 SAN、notAfter 已过
4 主机名 x509 -checkhost Certificate will match does NOT match
5 链 openssl verify server.pem: OK error 20 unable to get local issuer
6 私钥/OCSP pubkey | sha256 哈希一致、successful (0x0) key values mismatch
7 端到端 curl -w 200 0 verify_result 非 0
8 复跑 certbot certonly 边缘证书与本地一致 回滚到旧证书

通配符证书 checker 常用命令示例:OpenSSL 3.0、curl 8.5、testssl.sh 3.2 怎么跑?

同一张通配符证书,为什么浏览器显示正常,而 openssl s_client 却报 Verify return code: 62?原因往往不是证书本身,而是你用的工具只验证了其中一层。下面按”本地匹配 → 握手验证 → 端到端 → 全量扫描 → 服务端配置 → DNS 前置条件”的顺序,给出可直接复制的命令,这也是通配符证书 checker 的完整链路。

1. 本地匹配:不联网,只读文件(OpenSSL 3.0.13 实测)

# -checkhost 自 OpenSSL 1.1.1 起可用,3.0.x 行为一致;只做名称匹配,不验证链和有效期
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -checkhost www.example.com
# 命中输出:Certificate will match
# 未命中:Certificate does not match

# 批量核对:*.example.com 对 admin.example.com 也应匹配(RFC 6125 §6.4.3 只允许最左一级通配)
for h in www api admin; do
  openssl x509 -in fullchain.pem -noout -checkhost "$h.example.com"
done
# 注意:a.b.example.com 不会被 *.example.com 匹配,这是最常见的误解

2. 握手验证:把 SNI、主机名校验、CA 信任一次性跑完

openssl s_client -connect www.example.com:443 
  -servername www.example.com 
  -verify_hostname www.example.com 
  -verify_return_error 
  -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# 关键行:Verify return code: 0 (ok)
# -verify_hostname 需 OpenSSL 1.1.1+,3.0.13 同样支持;漏掉它只会校验链,不校验名字

3. curl 8.5.0 端到端

# --resolve 绕过 DNS,直接把域名钉到测试机 IP
curl -vI https://www.example.com --resolve www.example.com:443:203.0.113.10
# 期望出现:SSL certificate verify ok.

# 只取结果码:0 成功;60 = 证书链/主机名校验失败(CURLE_PEER_FAILED_VERIFICATION)
curl -sS -o /dev/null -w '%{ssl_verify_result}n' https://www.example.com
# 私有 CA 场景加 --cacert /path/ca.pem

4. testssl.sh 3.2 全量扫描

./testssl.sh --certs --protocols --server-defaults --severity HIGH 
  https://www.example.com --jsonfile result.json
# 单次约 30-120 秒;看 Certificates 段的 Subject Alternative Name / Hostname / OCSP URI
# --quiet 精简输出,--jsonfile 便于巡检归档对比

5. Nginx 1.24.0 服务端配置(OCSP stapling 默认 off,需显式打开)

server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 必须 fullchain,否则链不全
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_stapling on;              # 默认 off
    ssl_stapling_verify on;       # 默认 off,需配合 resolver
    resolver 8.8.8.8 1.1.1.1 valid=300s;
}
# 改完先 nginx -t,通过后再 systemctl reload nginx

据 Mozilla SSL Configuration Generator 的 intermediate 档位,TLS 1.2/1.3 + OCSP stapling 是当前推荐的常见组合。

6. DNS-01 记录检查(通配符证书只能走 DNS-01,据 Let’s Encrypt 文档)

dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1
# 两个权威应返回相同值;BIND 9.18 的 dig 支持 +short,可去掉部分引号格式干扰
# 传播通常 1-10 分钟,TTL 设 300 秒便于失败后快速重试
工具/版本 验证范围 典型失败信号 耗时
openssl x509 -checkhost(3.0.13) 仅 SAN 名称匹配 Certificate does not match <1 秒
openssl s_client SNI + 链 + 主机名 Verify return code: 62 / 10 1-3 秒
curl 8.5.0 真实 HTTP 路径 + 链 ssl_verify_result=60 1-5 秒
testssl.sh 3.2 协议、套件、证书、OCSP severity HIGH 条目 30-120 秒

排查顺序建议从下往上倒推:先用 dig 确认 DNS-01 记录已生效,再用 x509 -checkhost 排除名称问题,接着用 s_client 区分是链问题还是名字问题(62 多为名称不匹配,10 多为链过期或缺失中间证书),最后用 curl 复现真实访问路径。

本地脚本、在线扫描与商业证书怎么选?通配符证书 checker 方案对比表

先给结论:本地脚本和在线 checker 不是”二选一”,而是分属流水线的不同阶段——CI 门禁用返回码判断成败,发布前做全量协议扫描,线上事故再用在线评级复核。两者的关键差异在于可控性:本地 OpenSSL/curl 只依赖你机器上的 CA 信任库,不会被 CDN 的 WAF 或速率限制拦截;而 Qualys SSL Labs 这类在线服务需要从公网回连你的域名,内网域名、预发布环境、开了地域封禁的站点根本扫不到。

方案 版本/形态 主机名匹配(SAN 通配符) 证书链/自定义 CA 协议与配置深度 耗时 费用
OpenSSL s_client 3.0.13 支持,-verify_hostname 精确校验 *.example.com 覆盖范围 支持 -CAfile / -untrusted 补全中间证书 可用 -status 取 OCSP stapling;不检查 HSTS/CAA/协议禁用 <1 秒 免费
curl 8.5.0 间接校验(依赖底层 OpenSSL,失败即非 0 退出) 支持 --cacert --cert-status 强制 OCSP stapling,未 staple 直接报错 <1 秒 免费
testssl.sh 3.2 支持,--certs 打印完整 SAN 列表 支持 TLS 1.3、RC4、Heartbleed、HSTS、CAA 全覆盖 30–120 秒 免费
sslscan 2.1.3 显示 SAN 支持 协议/套件枚举为主,漏洞类检查有限 5–20 秒 免费
Qualys SSL Labs 在线 显示 SAN 与到期时间 支持 输出 A–F 评级,含 HSTS、CAA、前向保密 60–180 秒(排队时更久) 免费
DigiCert / Sectigo checker 在线 显示 SAN 与到期 支持 仅基础链与有效期,不含评级 5–30 秒 免费

把通配符证书 checker 塞进 CI 时,务必让它以退出码决定流水线成败,而不是靠人眼看输出。据 OpenSSL 官方 s_client 手册,-verify_hostname 会按 RFC 6125 规则比对 SAN 中的通配符(*.example.com 只匹配一级子域,不匹配 a.b.example.com),配合 -verify_return_error 才能把校验失败变成非 0 退出码:

# OpenSSL 3.0.13+:校验证书链与通配符主机名,失败即非 0 退出,可直接放进 CI
openssl s_client -connect api.example.com:443 
  -servername api.example.com           # SNI,多域名同 IP 时必须显式指定
  -verify_hostname api.example.com      # 按 RFC 6125 校验 *.example.com 是否覆盖该主机
  -verify_return_error                  # 关键:把校验失败升级为退出码 1
  -status                               # 顺带请求 OCSP stapling 响应
  -brief </dev/null
echo "exit=$?"                           # 0 = 链可信且主机名匹配

# curl 8.5.0:更贴近真实客户端行为,--cert-status 在服务器未 staple 时报错(退出码 91)
curl -sS -o /dev/null -w '%{http_code} verify=%{ssl_verify_result}n' 
  --cacert ./internal-ca.pem            # 私有 CA 场景替换信任库
  --cert-status                         # 强制 OCSP stapling 校验
  https://api.example.com/healthz

检查深度上要分清边界:OpenSSL 只能回答”这张证书是否匹配该主机名、链是否可信”,它不会告诉你服务器还开着 TLS 1.0,也不看 HSTS 和 CAA。发布前用 testssl.sh 3.2 补全量扫描(./testssl.sh --certs --protocols --vulnerable --headers https://api.example.com),线上事故则用 Qualys SSL Labs 复核评级,但注意它排队时可能等 1–3 分钟,不适合当门禁。

内网或私有 CA 签发的通配符证书不要上传到公共在线 checker——既泄露内部域名,也大概率因无法回连而扫描失败。改用 openssl s_client -CAfile internal-ca.pem -verify_hostname api.internal.example.com -verify_return_error。另需留意安全级别:OpenSSL 3.0 上游默认 SECLEVEL=1,而 RHEL 9、Ubuntu 22.04 等发行版在 openssl.cnf 中调到了 2,此时 1024 位 RSA 内网证书会被直接拒绝并报 ee key too small;临时用 @SECLEVEL=0 只是排障手段,生产环境应重签 2048 位以上密钥,不建议降级。

证书本身的成本也要计入选型:DV 通配符公开报价约 ¥600–1500/年,签发 5–15 分钟;OV 通配符约 ¥1800–9000/年,需营业执照核验 1–3 个工作日;Let’s Encrypt 免费但仅 90 天有效期,需自动化续期(据 Let’s Encrypt 文档,通配符必须用 DNS-01 挑战);AWS ACM 通配符免费,但只能绑定 ACM 集成的 ELB/CloudFront 等资源,无法导出私钥;Cloudflare Advanced Certificate Manager 约 US$10/月起。以上为公开渠道常见区间,最终以 CA 报价为准。

通配符证书 checker 常见错误与排查:6 条真实报错怎么处理?

通配符证书最常见的”证书没坏,但客户端不认”问题,几乎都落在 SAN 匹配、证书链、主机名校验三处。下面按真实报错逐条拆解,每条都给出可复现命令。

1. curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com'
含义是 SNI 返回的证书 SAN 里没有 api.example.com。先用 OpenSSL 打印 SAN 列表确认(OpenSSL 1.1.1+ 支持 -ext):

# 直接读取证书文件的 SAN 扩展;若输出只有 DNS:*.example.com
openssl x509 -in wildcard.pem -noout -ext subjectAltName
# 对线上端口验证实际下发的证书(-servername 必须传,否则拿到默认站点证书)
openssl s_client -connect api.example.com:443 -servername api.example.com /dev/null 
  | openssl x509 -noout -ext subjectAltName

关键规则来自 RFC 6125 §6.4.3:通配符只匹配最左一级标签。所以 *.example.com 匹配 api.example.com,不匹配 a.b.example.com,也不匹配裸域 example.com。后者必须单独写入 SAN 或另签证书——这是通配符证书 checker 报错里占比最高的一类。

2. curl: (60) SSL certificate problem: unable to get local issuer certificate
服务端只下发了叶证书,缺中间 CA。本地可复现:

# 用 chain.pem(中间证书)作为不受信任的补充链去校验叶证书
openssl verify -untrusted chain.pem server.pem
# 期望输出:server.pem: OK;若报 unable to get local issuer certificate 即确认缺链

修复:Nginx 的 ssl_certificate 必须指向 fullchain.pem(叶证书在前、中间证书在后)而非 cert.pem;Apache 2.4.8+ 起 SSLCertificateFile 可直接放合并链,无需再配 SSLCertificateChainFile(该指令在 2.4.8 起已废弃)。

3. Verify return code: 62 (hostname mismatch)
OpenSSL 3.x 中 62 即 X509_V_ERR_HOSTNAME_MISMATCH。先排除自身参数问题:-servername 与 -verify_hostname 必须是同一个 FQDN。

openssl s_client -connect 203.0.113.10:443 -servername api.example.com 
  -verify_hostname api.example.com -verify_return_error </dev/null

若直连 IP 正常、走域名异常,多为 CDN 边缘节点未绑定该域名、回落到默认证书所致。

4. nginx: [emerg] cannot load certificate "...": PEM_read_bio_X509_AUX() failed
两种成因:文件不是 PEM(如误放 DER/PKCS#12),或 nginx worker 无读权限。

openssl x509 -in /etc/nginx/ssl/wildcard.pem -noout -subject   # 能解析即格式正常
chown root:nginx /etc/nginx/ssl/wildcard.pem && chmod 640 /etc/nginx/ssl/wildcard.pem
restorecon -Rv /etc/nginx/ssl   # SELinux  enforcing 环境必做,否则仍被拒

5. certbot: Failed authorization procedure ... urn:ietf:params:acme:error:unauthorized
DNS-01 的 TXT 未生效或值不符。注意 *.example.com 的挑战记录仍写在 _acme-challenge.example.com,且据 Let’s Encrypt 文档,ACME 服务器会从多个网络位置发起查询,因此不建议依赖单点缓存。

dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1   # 对比两家,确认传播一致

建议 TTL 设 300 秒,等待传播后再重试。

6. NET::ERR_CERT_COMMON_NAME_INVALID / No subject alternative DNS name matching api.example.com found
Chrome 自 58 起、Java 自 JDK 8u181 起均只认 SAN,忽略 CN。Java 侧排查:

keytool -printcert -sslserver api.example.com:443 | grep -A3 "SubjectAlternativeName"

JDK 8u181+ 对通配符同样只匹配一级标签,根域需单独列 SAN。下表汇总定位思路:

报错特征 根因 验证命令
no alternative certificate subject name matches SAN 层级不匹配 openssl x509 -ext subjectAltName
unable to get local issuer certificate 缺中间证书 openssl verify -untrusted
Verify return code: 62 主机名/SNI 不一致或 CDN 兜底证书 s_client -verify_hostname
PEM_read_bio_X509_AUX() failed 格式或权限/SELinux openssl x509 -noout -subject
acme:error:unauthorized TXT 未生效/写错层级 dig +short TXT

如何确认通配符证书 checker 结果生效?6 个验证动作与预期输出

跑完通配符证书 checker 看到“通过”就收工,是最常见的漏检。checker 大多只解析证书本身,而“生效”要同时覆盖证书内容、信任链、HTTP 端到端、OCSP stapling、浏览器 UI 和长期监控六层。下面每条都给可直接复制的命令与预期输出,用它们反向校验 checker 结论。

  1. 证书内容是否覆盖目标主机名
    openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null 
      | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
    # 预期:subject=CN = *.example.com
    #       X509v3 Subject Alternative Name:
    #           DNS:*.example.com, DNS:example.com
    #       notAfter 需晚于当前 UTC 时间 30 天以上

    注意 -servername(SNI)不能省:据 OpenSSL 文档,不发送 SNI 时服务端会返回默认虚拟主机的证书,这恰是“checker 说 OK、线上却报错”的根因。通配符只匹配一级标签,*.example.com 不覆盖 a.b.example.com。

  2. 信任链是否完整
    openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null 
      | grep 'Verify return code'
    # 预期:Verify return code: 0 (ok)
    
    openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
      -untrusted chain.pem server.pem
    # 预期:server.pem: OK

    非 0 时按下表定位(依据 OpenSSL verify 手册的 X509_V_ERR 定义):

    错误码 含义 排查动作
    10 certificate has expired 核对 notAfter 与服务器 UTC 时间
    20 unable to get local issuer certificate 中间证书未随服务端下发,补 fullchain.pem
    62 hostname mismatch SNI 缺失或 SAN 不含该主机名
  3. HTTP 端到端验证
    curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result} %{time_total}n' https://www.example.com
    # 预期:200 0 0.2xx  (time_total 通常 < 0.5 秒)
    curl -vI https://www.example.com 2>&1 | grep -i 'SSL certificate verify'
    # 预期:SSL certificate verify ok.
  4. OCSP stapling 是否真的在生效
    openssl s_client -connect www.example.com:443 -servername www.example.com -status </dev/null 2>/dev/null 
      | grep -A1 'OCSP Response Status'
    # 预期:OCSP Response Status: successful (0x0)

    Nginx 1.24.0 中 ssl_stapling 默认 off,需显式开启并配置 DNS 解析器:ssl_stapling on; ssl_stapling_verify on; resolver 8.8.8.8 valid=300s;。首次请求常返回 no response sent,间隔 10–30 秒复测。

  5. 浏览器与 DevTools:Chrome 124+ 打开 DevTools → Security,应显示 Certificate – valid and trusted,展开后 SAN 含目标域名。若提示 not secure,对比 Issued to / Issued by,并用 date -u 核对系统时间是否与 NTP 同步(偏差超过 5 分钟会触发 NET::ERR_CERT_DATE_INVALID)。
  6. 监控归档,避免“当天通过、明天过期”
    # testssl.sh 3.2,每日 02:00 存档
    0 2 * * * /opt/testssl/testssl.sh --jsonfile /var/log/ssl/www.json --quiet https://www.example.com
    
    # Prometheus blackbox_exporter 0.25.0 告警规则
    - alert: WildcardCertExpiringSoon
      expr: probe_ssl_earliest_cert_expiry - time() < 30*24*3600
    - alert: SSLProbeFailing
      expr: probe_success == 0
      for: 5m

六层中任一层缺失,通配符证书 checker 的绿色结论都只是“证书文件没问题”,而非“线上握手没问题”。续期后至少重跑第 1、2、4 项,因为换发证书常伴随中间链变更与 staple 缓存失效。

用 DNS-01 签发通配符证书时,checker 还要检查哪些点?

会多查三件事:挑战类型是否真的走 DNS-01、TXT 值在多个公共解析器上是否一致可见、域名的 CAA 记录是否放行目标 CA。原因是通配符证书的授权模型和单域名证书不同:据 Let’s Encrypt 文档《Challenge Types》,*.example.com 与 example.com 视为两个独立标识符,通配符只能通过 DNS-01 验证,HTTP-01 无法完成。所以一个合格的通配符证书 checker 第一步不是看证书,而是看”DNS 挑战有没有被正确布置”。

先看三类客户端怎么强制走 DNS-01,版本与参数都需对齐:

# certbot 2.11.0(Debian/Ubuntu 包名 python3-certbot;旧版 1.x 也支持同名参数)
certbot certonly --manual --preferred-challenges dns 
  -d '*.example.com' -d example.com
# 说明:--preferred-challenges dns 强制 DNS-01;--manual 需人工添加 TXT,
# 生产环境建议换 --dns-cloudflare 等插件实现自动续期

# acme.sh 3.0.8(安装:curl https://get.acme.sh | sh -s email=you@example.com)
export CF_Token="你的 Cloudflare API Token"   # 需 Zone.DNS 编辑权限
acme.sh --issue --dns dns_cf -d '*.example.com' -d example.com

# lego 4.17.0
CF_DNS_API_TOKEN="你的 Token" lego --email you@example.com 
  --dns cloudflare -d '*.example.com' -d example.com run

第二步核对 TXT。ACME 客户端生成的 TXT 值(base64url 编码的 key authorization 摘要)固定落在 _acme-challenge.example.com,且不带通配符前缀。必须用两个解析器交叉验证,因为单解析器缓存会骗人:

dig +short TXT _acme-challenge.example.com @1.1.1.1
dig +short TXT _acme-challenge.example.com @8.8.8.8
# 两条输出应完全一致;若 Cloudflare 与 Google 结果不同,说明仍在传播中
# 常见传播 1-10 分钟;把该 TXT 的 TTL 设为 300 秒可显著加快回滚与重签

第三步是 CAA 预检,这一步最容易被通配符证书 checker 忽略,却直接决定签发成败。RFC 8659 规定 CA 必须检查 CAA;若域名只写了商业 CA 的 issue 属性,Let’s Encrypt 会拒绝签发并返回 urn:ietf:params:acme:error:caa:

dig +short CAA example.com
# 期望包含:0 issue "letsencrypt.org"
# 若输出 0 issue "sectigo.com" 而无 letsencrypt.org,签发必然失败
# 注意:CAA 会沿父域向上查找,example.com 的 CAA 同样约束 *.example.com

三类客户端的参数差异与默认行为对照如下,选型时可直接比对:

客户端与版本 强制 DNS-01 的参数 默认续期触发 验证失败典型报错
certbot 2.11.0 --preferred-challenges dns 剩余 30 天(90 天有效期) Incorrect TXT record found at _acme-challenge.example.com
acme.sh 3.0.8 --dns dns_cf 剩余 30 天,cron 每日检查 Error add txt for domain:_acme-challenge.example.com
lego 4.17.0 --dns cloudflare 无内置调度,需外部 cron NXDOMAIN looking up TXT for _acme-challenge.example.com

最后两点 checker 必查:根域是否同证书覆盖——只签 *.example.com 时访问 https://example.com 会报主机名不匹配(RFC 6125 通配符仅匹配一级标签),务必同时加 -d example.com;Let’s Encrypt 单证书默认最多 100 个名称,SAN 建议控制在 100 以内。续期流程是否可跑通——用 certbot renew --dry-run --deploy-hook 'systemctl reload nginx',1-2 分钟内即可暴露 DNS 插件凭据过期、hook 路径错误等隐性故障,比等到第 60 天再发现要从容得多。

把通配符证书 checker 接入巡检:cron、Zabbix 与 Prometheus 的落地参数

把一次性的手工检查变成持续巡检,关键是让”证书快过期”和”证书链断裂”这两类问题在用户感知之前就触发告警。下面按 cron、Prometheus、Zabbix 三条路径给出可直接落地的参数。

最轻量的方案:cron + OpenSSL。OpenSSL 3.0.13 在 -verify_return_error 生效时,校验失败会返回非 0 退出码,因此可以直接用 || 触发告警:

# /etc/cron.d/wildcard-ssl-check  —— 适用 OpenSSL 1.1.1+/3.x,Debian/Ubuntu 默认路径
# 每天 02:00 校验一次;失败时发邮件
0 2 * * * root /usr/bin/openssl s_client 
  -connect www.example.com:443 
  -servername www.example.com 
  -verify_hostname www.example.com 
  -verify_return_error /var/log/ssl/check.log 2>&1 
  || echo 'wildcard check failed' | mail -s 'SSL alert' ops@example.com

注意 -verify_return_error 是让握手阶段的校验错误变成致命错误的关键参数,缺省不加时 s_client 只打印错误却仍以 0 退出,这是最常见的”检查永远通过”陷阱。据 OpenSSL 官方文档,该选项自 1.1.0 起提供。

Prometheus 方案:blackbox_exporter 0.25.0。它把证书剩余有效期暴露为 probe_ssl_earliest_cert_expiry,单位为 Unix 秒:

# blackbox.yml —— blackbox_exporter 0.25.0
modules:
  http_2xx:
    prober: http
    timeout: 5s
    http:
      preferred_ip_protocol: ip4
      tls_config:
        ca_file: /etc/ssl/certs/ca-certificates.crt

# 告警规则:剩余不足 30 天(2592000 秒)即触发
- alert: WildcardCertExpiringSoon
  expr: probe_ssl_earliest_cert_expiry - time() < 2592000
  for: 10m

Zabbix 6.4 方案:内置 web.certificate.get 监控项直接返回过期时间戳,无需自定义脚本:

# 手工验证监控项是否可用(Zabbix 6.4)
zabbix_get -s 127.0.0.1 -k web.certificate.get[www.example.com,443]

# 触发器表达式(采集间隔 5m)
{host:web.certificate.get[www.example.com,443].last()} < 2592000
方案 依赖 最小采集间隔 适合场景
cron + openssl 仅 OpenSSL 分钟级(受 cron 粒度限制) 单机、少量域名
blackbox_exporter Prometheus 15s 已有 Prometheus 栈
Zabbix 6.4 Zabbix Agent/Proxy 5m(建议) 传统运维体系

两个必须处理的坑。其一,同一域名在 CDN 多边缘 IP 上可能返回不同证书,通配符证书 checker 若只测一次会漏报;用 --resolve 固定 IP 分别检查,并在告警里带上 servername、notAfter、issuer 便于定位。其二,重复告警噪音:Alertmanager 设 group_wait: 30s、repeat_interval: 4h 即可压制 5 分钟内的重复通知。变更后必跑:证书续期、Nginx reload、Kubernetes Ingress 更新或 CDN 证书上传后 5 分钟内复跑,并把 openssl x509 -checkhost 与 curl -w '%{ssl_verify_result}' 写进发布流水线,失败即阻断发布。

checker 可能只看了 CN 或缓存,浏览器按 SAN 匹配;用 openssl x509 -noout -ext subjectAltName 确认 SAN 是否包含目标 FQDN,根域 example.com 和多级子域 a.b.example.com 不会被 *.example.com 覆盖。若 SAN 正确,再查系统时间、SNI 和 CDN 回源证书。

都不行。据 RFC 6125 第 6.4.3 节,通配符只替换最左一个标签,*.example.com 匹配 a.example.com,不匹配 a.b.example.com;example.com 是零级,必须单独加入 SAN。CA/B Forum 还禁止 *.com、*.co.uk 等公共后缀通配符。

优先信本地带 -servername 和 -verify_hostname 的结果,因为它复现了真实 SNI 和信任链;在线 checker 可能从不同网络位置、不同 CA 存储、甚至 CDN 默认站点取证书。对比时固定解析 IP:curl –resolve www.example.com:443:203.0.113.10。

Let's Encrypt 的通配符证书必须用 DNS-01,HTTP-01 无法验证 *.example.com;商业 CA 通常也要求 DNS TXT 或邮箱/文件验证。DNS-01 要检查 _acme-challenge.example.com 的 TXT 记录,传播常见 1-10 分钟,TTL 建议 300 秒。

DV 通配符公开报价约 ¥600-1500/年,OV 通配符约 ¥1800-9000/年,OV 需 1-3 个工作日核验企业资料;Let's Encrypt 免费、90 天有效、必须自动化续期。面向公众的生产域名可用 Let's Encrypt + 监控,需企业实名和更高赔付条款时选 OV。

先确认目标主机名是否属于单层子域,再用 openssl x509 -noout -ext subjectAltName 看 SAN;如果 SAN 只有 *.example.com 而目标是 example.com 或 a.b.example.com,需重新签发包含对应名称的证书。若 SAN 正确,检查是否连到了默认虚拟主机,补 -servername 或修 Nginx server_name。

先确认边缘节点已 reload:nginx -t && systemctl reload nginx,Kubernetes 用 kubectl rollout restart deploy/;再用 openssl s_client -connect IP:443 -servername 域名 逐 IP 检查,CDN 控制台刷新证书需要 1-10 分钟。浏览器/Java 客户端可能缓存链,换 curl –resolve 或新会话复测。


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

内容审核

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