通配符证书 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 结论。
- 证书内容是否覆盖目标主机名
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。 - 信任链是否完整
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 不含该主机名 - 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. - 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 秒复测。 - 浏览器与 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)。 - 监控归档,避免“当天通过、明天过期”
# 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。