跳到主要内容
错误排查

通配符证书失败原因全解析:从 CSR SAN 规则到 DNS-01 校验的 6 类报错定位(2025)

通配符证书失败原因 — 通配符证书失败原因全解析:从 CSR SAN 规则到 DNS-01 校验的 6 类报错定位(2025)
核心结论

通配符证书失败原因八成不在证书本身:`*.example.com` 按 RFC 6125 §6.4.3 只覆盖一级子域,不覆盖 `example.com` 主域、也不覆盖 `a.b.example.com`,且公共 CA 的通配符订单只能走 DNS-01 验证。 定位顺序固定为:证书 SAN → CSR 生成 → TXT/CNAME 委派 → CAA → ACME 错误体 → 证书链,用 `openssl x509 -noout -ext subjectAltName` 和 `dig +short TXT _acme-challenge.example.com @8.8.8.8` 两条命令就能排除一半问题。 Let's Encrypt 限制:每个注册域 7 天 50 张证书、重复证书每周 5 张、每账号每主机名每小时 5 次验证失败,超限后报 `too many failed authorizations recently`,调试请加 `--server letsencrypt --staging`。 只部署 `cert.pem` 不带中间证书,会在 Java 8、Android 7 以下报 `PKIX path building failed` 与 `unable to get local issuer certificate`,必须用 leaf→intermediate 顺序的 fullchain。 验证生效用 `openssl s_client -connect example.com:443 -servername a.example.com -showcerts`,看到 `Verify return code: 0 (ok)` 且 SAN 列表包含目标域名才算通过。

一、通配符证书失败原因:先分清「签发失败」还是「匹配失败

遇到「通配符证书失败」时,先别急着改配置——第一步是判断它属于哪一类:是 CA 根本没有签发证书(签发失败),还是证书已经签发但浏览器或客户端拒绝连接(匹配失败)。这两类问题的定位路径完全不同,混在一起排查只会浪费时间。下面三条命令可以在 30 秒内完成分流:

# 1) 看证书里实际生效的 SAN 列表:决定"能不能匹配",与签发无关
openssl x509 -in fullchain.pem -noout -ext subjectAltName
# 输出示例:X509v3 Subject Alternative Name:
#     DNS:*.example.com, DNS:example.com

# 2) 从服务端实际取回证书链,统计返回了几张证书(只返回 1 张=缺中间证书)
openssl s_client -connect www.example.com:443 -servername www.example.com 
  -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"

# 3) 绕过递归缓存,直接问权威 NS,比对多台 NS 的 TXT 是否一致
dig +short TXT _acme-challenge.example.com @ns1.example.com
dig +short TXT _acme-challenge.example.com @ns2.example.com

据 RFC 6125 §6.4.3,通配符只能出现在最左侧标签,且只替换一个标签。因此 *.example.com 匹配 www.example.com,但不匹配 example.com 本身,也不匹配 a.b.example.com。大量所谓的通配符证书失败原因,本质是访问了不在覆盖范围内的域名,表现为 curl 报 no alternative certificate subject name matches 或浏览器 NET::ERR_CERT_COMMON_NAME_INVALID。修法是签发时同时带上裸域:-d example.com -d '*.example.com'。

典型报错 根因类别 一句话定位
no alternative certificate subject name matches 匹配范围 域名不在 SAN 覆盖内(最左标签/多级子域)
urn:ietf:params:acme:error:malformed 验证方式 用 HTTP-01 或 TLS-ALPN-01 申请 *.example.com
rejectedIdentifier 公共后缀 提交了 *.com、*.co.uk、*.gov.cn
CAA record for example.com prevents issuance CAA 阻断 现存 CAA 未授权当前 CA
Incorrect TXT record DNS 一致性 多验证节点查到的 TXT 值不同
verify error:num=20:unable to get local issuer certificate 证书链 只部署 cert.pem,未拼接中间证书

验证方式是最容易被忽略的一条。据 Let’s Encrypt 文档,通配符证书自 2018-03-13 起支持,但仅接受 DNS-01 挑战;纯内网、没有公网可解析 DNS 的域名必然失败。正确调用如下(certbot 2.x,--preferred-challenges 默认值为 http-01,必须显式改成 dns):

certbot certonly --manual --preferred-challenges dns 
  -d '*.example.com' -d example.com
# 验证期间把 _acme-challenge 的 TTL 临时设为 60–300 秒,默认 3600 会让旧值滞留
# CAA 检查:按 RFC 8659 §3 沿标签向上查找,父域记录同样生效
dig +short CAA example.com; dig +short CAA com

公共后缀限制不是配置问题:CA/Browser Forum Baseline Requirements 与 RFC 8659 均禁止为公共后缀签发通配符,改任何参数都无效。而证书链缺失常被误判成「通配符证书不被信任」——Java 8u301 以下、Android 7 以下及部分 IoT 客户端不做中间证书补全,握手失败即报 num=20。用 cat cert.pem chain.pem > fullchain.pem 生成完整链,再跑上面第 2 条命令确认返回数为 2 或更多。

二、6 步定位流程:从 CSR 到证书链逐层排除

证书签发失败时,报错信息往往只给出最后一层现象(“Challenge failed”“Invalid response”),真正的原因可能在 CSR、DNS 或 CAA 任一层。下面这套 6 步流程按“证据链由内到外”排序:先确认证书内容本身,再回溯 CSR,最后才查 DNS 与 CA 侧限制,可以避免在错误的方向上反复重签而触发速率限制。

  1. 第 1 步:核对证书里实际写了什么(SAN 而非 CN)

    # fullchain.pem 第一段是叶证书,只查这一段
    openssl x509 -in fullchain.pem -noout -text | grep -A2 "Subject Alternative Name"
    # 正确输出应同时含通配符与裸域,缺一不可:
    #   DNS:*.example.com, DNS:example.com
    

    只把 *.example.com 写进 CN 是 2017 年前的做法。据 CA/Browser Forum Baseline Requirements 7.1.4.2.1,SAN 为必填扩展;Chrome 58+、Firefox 48+ 已完全忽略 CN。若 grep 无输出,说明证书根本没有 SAN 扩展,浏览器会直接抛 ERR_CERT_COMMON_NAME_INVALID。

  2. 第 2 步:回溯 CSR 生成阶段,确认扩展是否真的写进去了

    openssl req -in example.csr -noout -text | grep -A1 "Requested Extensions"
    # 输出为空 = CSR 里没有 SAN,CA 不可能凭空补上通配符
    

    这是通配符证书失败原因里最隐蔽的一类:命令看似成功,CSR 却是“裸”的。根因通常在 OpenSSL 版本——-addext 参数自 OpenSSL 1.1.1 才引入(见 OpenSSL 官方 req(1) 手册),而 CentOS 7 自带的 1.0.2k 不支持,必须把扩展写进配置文件。

    OpenSSL 版本 支持 -addext 典型发行版 建议写法
    1.0.2k 否 CentOS 7 / RHEL 7 写入 openssl.cnf 的 [v3_req]
    1.1.1 及以上 是 Ubuntu 18.04+、Debian 10+ 命令行 -addext 即可
    3.0 / 3.2 是 Ubuntu 22.04+、RHEL 9 同上,默认安全级别提高至 2
    # CentOS 7 + OpenSSL 1.0.2k:/etc/pki/tls/openssl.cnf
    [req]
    req_extensions = v3_req          # 关键行:把扩展挂到 CSR 上,漏写则 SAN 丢失
    [v3_req]
    subjectAltName = @alt_names
    [alt_names]
    DNS.1 = example.com              # 裸域
    DNS.2 = *.example.com            # 通配符
    
    openssl req -new -newkey rsa:2048 -nodes -keyout example.key 
      -out example.csr -config /etc/pki/tls/openssl.cnf -subj "/CN=*.example.com"
    
  3. 第 3 步:DNS-01 记录三方比对

    dig +short TXT _acme-challenge.example.com @8.8.8.8
    dig +short TXT _acme-challenge.example.com @1.1.1.1
    dig +short TXT _acme-challenge.example.com @ns1.example.com   # 你的权威 NS
    

    三次结果必须逐字符一致。按 RFC 8555 §8.4,校验值是对 key authorization 做 SHA-256 后的 43 字符 base64url(含 - 和 _,无 = 填充),dig 输出会带双引号,引号内的 43 字符才是有效值。任一处不同或出现 ;; connection timed out,说明记录未传播完成,CA 端会报 urn:ietf:params:acme:error:dns。

  4. 第 4 步:检查 CNAME 委派链是否断裂

    dig +short CNAME _acme-challenge.example.com
    # 例:_acme-challenge.example.com.acc.cmcdns.net.   (CDN 自动委派)
    dig +short TXT _acme-challenge.example.com.acc.cmcdns.net
    

    使用 CDN 托管 DNS 时,_acme-challenge 常被 CNAME 委派到厂商域名。委派目标被删除、套餐过期或记录 TTL 已失效,表现为 status: NXDOMAIN,而你的权威区里 看起来 一切正常——这是通配符证书失败原因中最容易被误判为“CA 抽风”的一种。

  5. 第 5 步:CAA 与 ACME 错误体

    dig +short CAA example.com
    dig +short CAA www.example.com    # 主域与子域要分别查,CAA 会向上继承
    # 空输出 = 无 CAA 记录;有记录则必须包含:
    #   0 issue "letsencrypt.org"   与   0 issuewild "letsencrypt.org"
    

    据 RFC 8659(CAA,取代 RFC 6844),签发通配符证书时 CA 会同时校验 issue 与 issuewild;只写了 issue 而缺 issuewild 时,单域证书能签、通配符必失败。抓完整错误体:

    acme.sh --issue -d example.com -d '*.example.com' --dns dns_cf --debug 2
    certbot certonly -d example.com -d '*.example.com' --manual -vvv
    
    错误 type 含义 优先排查
    ...acme:error:dns 记录查不到或超时 第 3、4 步
    ...acme:error:unauthorized TXT 值不匹配 多值冲突、引号残留
    ...acme:error:caa CAA 拒绝签发 issuewild 缺失
    ...acme:error:rateLimited 触发速率限制 第 6 步
  6. 第 6 步:速率限制与证书链完整性

    据 Let’s Encrypt 官方 Rate Limits 文档(2025 年现行值):每注册域 7 天 50 张证书、完全重复的证书每周 5 张、每账号每主机名每小时 5 次失败验证。通配符 + 裸域一次签发算 1 张(同一证书含两个 SAN),但反复失败会先耗尽“失败验证”额度。

    openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
      | grep -E "Verify return code|BEGIN CERTIFICATE"
    # 期望:BEGIN CERTIFICATE 出现 ≥2 次(叶证书 + 中间证书)
    #       Verify return code: 0 (ok)
    # 只出现 1 次 = 漏发中间证书,Android 与部分 Java 客户端会报 chain incomplete
    

三、可复现的配置与命令示例(OpenSSL 3.0 / acme.sh 3.0.7 / Nginx 1.24)

把前面几节的规则落到可复现的命令上,最快的方式是用 OpenSSL 先造一份”确定性正确”的 CSR,再交给 acme.sh。以下示例在 OpenSSL 3.0.13、acme.sh 3.0.7、Nginx 1.24.0 上实测通过。据 OpenSSL 官方手册 req(1),-addext 自 1.1.1 起提供,用于直接追加 X.509v3 扩展,免去改配置文件。

# OpenSSL 3.0.13 实测:生成含通配符 SAN 的 CSR
# 注意 *.example.com 必须用单引号包住,否则由 shell 先展开
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.key -out example.csr 
  -subj "/CN=*.example.com" 
  -addext "subjectAltName=DNS:*.example.com,DNS:example.com"

# 校验:必须同时看到两条 SAN,缺一条即视为失败
openssl req -in example.csr -noout -text | grep -A1 "Subject Alternative Name"
# 期望输出:X509v3 Subject Alternative Name:
#              DNS:*.example.com, DNS:example.com

不加引号的后果分两种 shell:zsh 默认开启 nomatch,直接报 zsh: no matches found: *.example.com;bash 在关闭 nullglob 时保留字面量,但若当前目录恰好存在匹配文件,会静默替换成文件名,命令仍返回 0,CSR 里却写进了 DNS:example.com 之类的错误值——这正是”CSR 看着生成了、签发却报 SAN 不匹配”的常见来源。

OpenSSL 1.0.2 及更早版本没有 -addext,只能走配置文件。[v3_req] 段必须显式引用 @alt_names,且执行时用 -extensions v3_req 指定,否则 SAN 不会被写进 CSR:

# openssl.cnf 片段
[ v3_req ]
basicConstraints = CA:FALSE
subjectAltName   = @alt_names

[ alt_names ]
DNS.1 = *.example.com
DNS.2 = example.com

# 生成(-extensions 不可省)
openssl req -new -key example.key -out example.csr 
  -config openssl.cnf -extensions v3_req
CSR 生成方式 最低版本 是否需要改配置 典型失败点
-addext "subjectAltName=..." OpenSSL 1.1.1 否 通配符未加引号被 shell 展开
openssl.cnf + -extensions v3_req 全版本 是 漏写 -extensions,CSR 无 SAN
仅 -subj "/CN=*.example.com" 全版本 否 CN 已被现代 CA 忽略,必然签发失败

据 Let’s Encrypt 文档,通配符证书只支持 DNS-01 校验,HTTP-01 无法验证 *.example.com。acme.sh 3.0.x 默认 CA 已改为 ZeroSSL,要走 Let’s Encrypt 必须显式指定 --server letsencrypt:

# 阿里云 DNS API 自动签发(Ali_Key/Ali_Secret 为 RAM 子账号 AK)
export Ali_Key="LTAI5t****" Ali_Secret="****"
acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' 
  --keylength ec-256 
  --server letsencrypt 
  --staging          # 调试期必加:走 LE staging 端点,不计入生产速率限制

# 去掉 --staging 重跑即为生产证书;速率上限见 LE "Failed Validation" 5 次/账号/主机名/小时
# 手动 DNS 模式:acme.sh 打印 TXT 记录后暂停等待
acme.sh --issue --dns 
  -d example.com -d '*.example.com' 
  --yes-I-know-dns-manual-mode-enough-go-ahead-please 
  --dnssleep 120    # 默认 120 秒;权威 DNS 慢或 TTL 高时提到 300

# 验证通过后删除 _acme-challenge TXT 记录
# 多副本残留会让下一次签发的校验值冲突,是二次签发失败的主因

Nginx 1.24 侧要注意一处语义差异:据 Nginx 官方文档 server_name 说明,*.example.com 可匹配多级标签,a.b.example.com 也命中;而证书的 *.example.com 按 RFC 6125 只覆盖一个标签,a.b.example.com 会报 NET::ERR_CERT_COMMON_NAME_INVALID。切勿用 Nginx 的匹配行为反推证书覆盖范围。

server {
    listen 443 ssl;
    server_name example.com *.example.com;

    ssl_certificate           /etc/nginx/ssl/fullchain.pem;  # 叶子+中间证书
    ssl_certificate_key       /etc/nginx/ssl/example.key;    # ec-256 私钥
    ssl_trusted_certificate   /etc/nginx/ssl/chain.pem;      # 仅供 OCSP stapling 校验链
    ssl_stapling on;
    ssl_stapling_verify on;
}

最后别漏 CAA。据 RFC 8659,CA 会沿域名向上查找 CAA 记录,一旦存在 issue 属性却未授权当前 CA,签发会直接拒绝(LE 报错形如 CAA record for example.com prevents issuance):

; 需要同时授权多家时写多条 issue,属性值用双引号
example.com.  300 IN CAA 0 issue "letsencrypt.org"
example.com.  300 IN CAA 0 issue "digicert.com"
example.com.  300 IN CAA 0 iodef "mailto:ops@example.com"  ; 拒绝时接收通知

# 自查
dig +short CAA example.com

四、方案选型对比:DV 通配符、多域名 SAN、OV 通配符怎么选

一张证书到底能覆盖多少域名?先把四种方案摆在同一张表里。下表价格为 2025 年国内市场常见区间(含经销商加价),仅作预算参考,实际以 CA 报价为准;免费档以 Let’s Encrypt 为准,据其官方文档,单张证书默认最多 100 个 SAN 条目。

方案 覆盖范围 单张域名数 验证方式 年费区间 典型场景
DV 通配符 *.example.com + example.com 1 个主域,不限子域 仅 DNS-01 免费(Let’s Encrypt)/ ¥300–1500 子域数量多且频繁新增
多域名 SAN(UCC) 逐条列出的 FQDN 5–100 个 HTTP-01 / DNS-01 ¥600–3000 域名分散在多个主域
OV 通配符 同 DV 通配符 1 个主域 DNS-01 + 企业资质核验 ¥2500–6000 对外展示企业身份
私有 CA 通配符 内网任意域 不限 无需公网验证 0(自建成本) .internal / 测试环境

新增一个子域,两种方案差多少?通配符证书新增 pay.example.com 无需重新签发,只改 Nginx 配置即可生效:

# /etc/nginx/conf.d/example.conf
server {
    listen 443 ssl;
    # 通配符一行覆盖所有一级子域,新增子域只改这里,证书不动
    server_name *.example.com example.com;
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
}

而多域名 SAN 每加一个域名都要重签并重新走一次校验,域名超过 10 个后,运维成本(重签窗口、验证失败重试、监控告警)明显高于通配符。注意通配符只匹配一级标签:据 CA/Browser Forum Baseline Requirements 与 RFC 6125,*.example.com 匹配 a.example.com,不匹配 a.b.example.com——多级子域要么再加一条 SAN,要么用 *.b.example.com 单独一张。

为什么裸域访问总报错?无论 DV 还是 OV 通配符,*.example.com 都不含 example.com。下单时要么在 SAN 里加主域,要么单独买一张单域名证书,否则用户直接访问裸域会拿到 NET::ERR_CERT_COMMON_NAME_INVALID。Certbot 的正确写法是两个 -d 都写,且通配符必须加引号防 shell 展开:

# 一张证书同时覆盖裸域与所有一级子域;--cert-name 默认取第一个 -d,显式命名便于续期脚本引用
certbot certonly --dns-cloudflare 
  --dns-cloudflare-credentials ~/.secrets/cloudflare.ini 
  -d example.com -d '*.example.com' 
  --cert-name example.com

OV 通配符贵在哪里?贵在时间而不是密钥:需要营业执照、电话回访或 DNS 备案核验,签发周期通常 1–5 个工作日,续期仍需重新核验企业信息。若只是内部系统或测试环境,DV 通配符 + 自动化续期(certbot renew --deploy-hook "systemctl reload nginx")更划算。

内网能不能凑合申请公共 CA?不能。.local、.internal、.lan 属 ICANN 保留或无法公开验证的域名,公共 CA 一律拒绝,Let’s Encrypt 返回的典型报错是 Cannot issue for "*.internal": Domain name does not end with a valid public suffix (TLD)。正确做法是用 step-ca 0.27 或 Vault PKI 自建私有 CA,再把根证书通过 GPO / MDM 推入客户端信任库:

# step-ca 0.27+:签发内网通配符,--san 显式带上主域,--not-after 默认 24h,内网建议显式放宽
step ca certificate "*.internal.example" wildcard.crt wildcard.key 
  --ca-url https://ca.internal:9000 
  --root /etc/step/ca.crt 
  --san "*.internal.example" --san "internal.example" 
  --not-after 720h

五、6 类真实报错与对应处理

把 ACME 客户端日志里的 Detail: 一行复制出来搜索,基本能定位到下面 6 类之一。先看一张速查表,再逐个说处理方式(限值数据来自 Let’s Encrypt 官方 Rate Limits 文档,2025 年仍有效)。

报错关键词 根因 一线定位命令
NXDOMAIN looking up TXT 记录没建 / 建错 zone / CNAME 目标已删 dig +short TXT _acme-challenge.example.com @你的权威NS
Incorrect TXT record found 旧值残留或多副本并存 dig +short TXT _acme-challenge.example.com @8.8.8.8
too many failed authorizations 触发失败次数 / 证书数量限流 查日志时间戳,等 1 小时
CAA record prevents issuance 缺 issue / issuewild,或父域禁止 dig +short CAA example.com
COMMON_NAME_INVALID / 无匹配 SAN 域名不在 SAN 内,通配符不跨级 openssl x509 -noout -text
num=20 / PKIX path building failed 只发 leaf,缺中间证书 openssl s_client -showcerts

1. NXDOMAIN looking up TXT:Detail: DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com 意味着权威服务器明确回答”这条不存在”。常见于把记录建在了 www.example.com 之类的子 zone 下,或 CNAME 委派的目标记录被删。必须直接问权威 NS,绕过递归缓存:

# 先查该域权威 NS,再向它发问,避免本地/公共 DNS 缓存误导
dig +short NS example.com
dig +short TXT _acme-challenge.example.com @ns1.example.com
# 若使用 CNAME 委派(RFC 8555 §8.4 允许),确认链路终点存在
dig +short CNAME _acme-challenge.example.com

2. Incorrect TXT record “xxxxx” found:记录存在但值不对,多为旧值残留或多副本并存(同一名字下两条 TXT,ACME 只认其中一条)。删掉历史值只留当前一次,等 TTL 过期再验;建议签发前把 _acme-challenge 的 TTL 设为 300 秒。别连续重试——每失败一次都计入限流。

3. too many failed authorizations recently:触发 Let’s Encrypt 的 每账号每主机名每小时 5 次失败上限,或 每注册域 7 天 50 张证书上限。等 1 小时后重试,并先在测试环境跑通:

# certbot:--dry-run 走 staging,不消耗生产配额
certbot certonly --dns-cloudflare -d example.com -d '*.example.com' --dry-run

# acme.sh:显式切 staging 目录
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' 
  --server letsencrypt --staging

4. CAA record for example.com prevents issuance:CAA 按 RFC 8659 逐级向上查找,只有父域(如 com)不存在记录才会停在当前域,所以只改子域记录不一定生效。通配符另有规则:若域内存在 issuewild,CA 只看 issuewild,issue 不再对通配符生效。

dig +short CAA example.com @8.8.8.8
# 需要补的记录(300 为 TTL,按需调整)
# example.com. 300 IN CAA 0 issue "letsencrypt.org"
# example.com. 300 IN CAA 0 issuewild "letsencrypt.org"

5. 证书域名不匹配:浏览器 NET::ERR_CERT_COMMON_NAME_INVALID、Firefox SSL_ERROR_BAD_CERT_DOMAIN、curl (60) SSL: no alternative certificate subject name matches target hostname 'a.b.example.com' 指向同一件事——域名不在 SAN 内。通配符只覆盖最左一级标签,且不覆盖裸域,正确做法是同时申请两条:-d example.com -d '*.example.com';a.b.example.com 必须单独签发。

6. 证书链不完整:verify error:num=20:unable to get local issuer certificate 与 Java 的 sun.security.validator.ValidatorException: PKIX path building failed 都是服务端只发了 leaf。按 leaf→intermediate 顺序拼成 fullchain 部署,Nginx 用 ssl_certificate fullchain.pem;,Tomcat 需把中间证书导入 keystore。

# 确认服务端实际下发的链(-showcerts 应至少两张)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'
# 拼接顺序不能反:leaf 在前,中间证书在后
cat cert.pem chain.pem > fullchain.pem

六、效果验证:怎么确认通配符证书真的生效了

握手通了就等于生效了吗?先看 OpenSSL 怎么说。

很多人只在本机浏览器点开绿锁就收工,结果线上 Java 客户端报 PKIX path building failed。根本原因是浏览器会自动补链,而 JVM、curl、Python requests 不会。第一步必须做服务端握手验证,且 -servername 不能省——省掉它测到的是该 IP 上的默认虚拟主机证书,跟你的通配符证书毫无关系:

# -servername 显式发送 SNI;-showcerts 打印完整证书链;</dev/null 防止交互挂起
openssl s_client -connect example.com:443 -servername a.example.com -showcerts </dev/null

# 合格输出(OpenSSL 3.0.x)应同时满足两点:
# 1) Verify return code: 0 (ok)
# 2) Certificate chain 下至少 3 段(叶子 + 中间 + 根),即返回 2 张以上证书
#  0 s:CN=*.example.com
#  1 i:C=US, O=Let's Encrypt, CN=R11
#  2 i:C=US, O=Internet Security Research Group, CN=ISRG Root X1

若看到 Verify return code: 21 (unable to verify the first certificate),说明 Nginx 的 ssl_certificate 指向了 cert.pem 而不是 fullchain.pem——据 Let’s Encrypt 官方文档,fullchain.pem 才是”叶子证书 + 中间证书”的拼接文件,这是通配符证书失败原因里最高频的部署侧问题。

SAN 到底覆盖哪些域名,别凭印象。直接导出扩展字段逐条核对:

openssl x509 -noout -ext subjectAltName -in /etc/nginx/ssl/example.com/fullchain.pem
# X509v3 Subject Alternative Name:
#     DNS:*.example.com, DNS:example.com

注意 *.example.com 只匹配一级标签:a.example.com 匹配,a.b.example.com 不匹配,裸域 example.com 也必须单独列出(依据 RFC 9525 §6.2,通配符仅允许出现在最左标签)。把裸域、www、每个二级子域逐个跑一遍上面的命令确认,而不是拿主域名代表全部。

怎么在真实客户端里复现?用 --resolve 绕过 DNS 直接打目标 IP,一次同时验证 SNI 与证书匹配:

# 把 a.example.com 强制解析到 203.0.113.10,跳过本机 DNS 与 CDN 干扰
curl -svI https://a.example.com --resolve a.example.com:443:203.0.113.10 2>&1 
  | grep -E "subject:|issuer:|SSL certificate verify"
# Java 侧(JDK 8u301 / 11+ 通用),确认链被信任
java -Djavax.net.debug=ssl:handshake -jar app.jar 2>&1 
  | grep -E "Found trusted certificate|subject:|Exception"

输出里出现 Found trusted certificate 才算 JVM 认链;只有 Certificate chain length: 1 就是缺中间证书。

第三方扫描:一次看清链、DNS 名与 OCSP。

# testssl.sh 3.2,--fast 跳过慢速密码套件枚举
./testssl.sh --fast --severity HIGH https://a.example.com
# 重点看三段:certificate_chain / DNS names / OCSP stapling

# SSL Labs 评级(publish=off 不公开,避免泄露内部域名)
curl "https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off"

到期与自动续期怎么盯?

# 返回 0 = 30 天内仍有效;返回 1 = 30 天内到期,需立即处理
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/example.com/cert.pem; echo $?

# acme.sh 续期后自动重载,避免"证书换了但进程还在用旧证书"
acme.sh --install-cert -d example.com -d '*.example.com' 
  --key-file       /etc/nginx/ssl/example.com/key.pem 
  --fullchain-file /etc/nginx/ssl/example.com/fullchain.pem 
  --reloadcmd      "systemctl reload nginx"

# crontab:每天 02:17 检查一次(acme.sh 自带 60 天阈值判断,未到期不做任何事)
17 2 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

旧客户端要不要单独测?要,通配符证书在老旧设备上失败往往不是域名问题而是算法与链问题:

客户端环境 典型限制 失败现象 处置建议
Java 8u301 默认信任库不含 ISRG Root X1 交叉签名路径 PKIX path building failed 下发 fullchain 含中间证书,或导入根证书
Android 7.0 对纯 ECDSA 证书支持不完整 SSLHandshakeException 保留 RSA 2048 备用证书
Windows 7 SP1 未打补丁 不支持 SHA-1 之后部分链校验、无 SNI 回退 证书名不匹配警告 确认签名算法为 SHA-256 + RSA 2048

以上六步全部通过,才能判定”证书已生效”;任何一步缺失,排查通配符证书失败原因时就容易把部署问题误判成 CA 签发问题。

Q:能不能一次签下 *.*.example.com,覆盖任意层级的子域?

不能,而且不是 CA 的”策略偏好”,是硬性禁止。据 CA/Browser Forum Baseline Requirements 第 3.2.2.6 节(Wildcard Domain Names),通配符只能整体占据最左侧标签,因此 *.*.example.com、a.*.example.com 这类部分通配符一律不予签发。用 Let’s Encrypt 提交时典型报错为 Cannot issue for "*.*.example.com": Domain name contains an invalid wildcard(Boulder 服务端原文)。可行路径只有三种:

方案 公共 CA 可签 覆盖范围 主要代价
*.*.example.com 否 — 违反 BR,无解
*.a.example.com 逐级签 是 单个二级域下的任意三级名 每多一层就多一张证书、一套续期任务
具体域名写入 SAN 是 精确名单 受 SAN 数量限制

通配符可与普通域名混用,例如一张证书同时含 *.example.com 与 example.com。据 Let’s Encrypt 官方 Limits 文档,单张证书 SAN 上限为 100 条(默认值,含通配符条目),超出需拆分成多张证书。签发前先确认 CSR 里的 SAN 拼写:

# 查看 CSR 中的 SAN 列表(OpenSSL 1.1.1+ / 3.x 通用)
openssl req -in wildcard.csr -noout -text | sed -n '/Subject Alternative Name/,+1p'
# 期望输出示例:DNS:*.a.example.com, DNS:a.example.com

Q:中文域名 *.例子.中国 为什么总是报 invalid character?

因为 IDN 在证书和 DNS 中一律按 A-label(punycode)校验,U-label 中文形式只存在于用户界面。CSR 的 SAN 与 _acme-challenge 的 TXT 记录名都必须写成 *.xn--fsqu00a.xn--fiqs8s。直接用 UTF-8 提交,ACME 服务端返回 Domain name contains an invalid character。转换用 libidn2 的 idn2(Debian/Ubuntu:apt install idn2):

idn2 例子.中国                      # 正向:xn--fsqu00a.xn--fiqs8s
idn2 -d xn--fsqu00a.xn--fiqs8s      # 反向还原,便于核对 TXT 记录名

# Python 等价写法(pip install idna,遵循 IDNA2008)
python3 -c "import idna; print(idna.encode('例子.中国').decode())"

注意不要用 Python 内置的 str.encode("idna")——那是 IDNA2003,对 ß、零宽连接符等字符的结果与 ACME 采用的 IDNA2008 不一致,会出现”本地转换正常、CA 侧仍报错”的错位。

Q:内网域名 *.internal 能找公共 CA 签吗?

不能。.local 由 RFC 6762 保留给 mDNS,.internal 由 ICANN 于 2024 年 7 月董事会决议保留给私有网络使用,两者都不在公共根区中,DNS-01 的 TXT 记录无处可查,HTTP-01 也无法从公网回连。只能自建 CA 签发:

# 1) 生成私钥与 CSR,CN 与 SAN 同时写通配符(-addext 需 OpenSSL 1.1.1+)
openssl req -new -newkey rsa:2048 -nodes -keyout wild.internal.key 
  -out wild.internal.csr -subj "/CN=*.internal" -addext "subjectAltName=DNS:*.internal"

# 2) 用私有 CA 签发,san.ext 内容:subjectAltName=DNS:*.internal,DNS:internal
printf 'subjectAltName=DNS:*.internal,DNS:internaln' > san.ext
openssl x509 -req -in wild.internal.csr -CA ca.crt -CAkey ca.key 
  -CAcreateserial -days 397 -extfile san.ext -out wild.internal.crt

签出来只是第一步:客户端必须把 ca.crt 装进系统或 JVM 信任库,否则访问时仍然报不受信任——curl 的原文是 curl: (60) SSL certificate problem: unable to get local issuer certificate。

Q:有效期缩短对通配符有豁免吗?

没有。按 CA/B Forum SC-081 的生效时间表,公共 TLS 证书最长有效期将从 398 天降至 2026-03-15 起的 200 天、2027-03-15 起的 100 天,2028 年起进一步收紧到 47 天,通配符证书同等适用。这意味着续期脚本必须全自动,DNS API 凭据要绑定服务账号长期持有,不能挂在某个人的个人账号下——人一离职,通配符证书的续期就断在 DNS-01 这一步。

Q:测试环境能复用生产的 *.example.com 吗?

技术上可行,风险上不可接受:一张通配符私钥泄露,影响面就是全部子域,且测试机的安全基线通常低于生产。正确做法是给测试单独签发 *.test.example.com,生产私钥落到部署机并收紧权限:

chmod 600 /etc/ssl/private/example.com.key
ls -l /etc/ssl/private/example.com.key
# -rw------- 1 root root ... example.com.key(默认 644 必须改掉)

不能。按 RFC 6125 §6.4.3,通配符只替换最左一个标签,`*.example.com` 覆盖 `www.example.com`、`pay.example.com`,但不覆盖 `a.b.example.com`,也不覆盖 `example.com` 本身。需要多级覆盖时,只能为 `*.b.example.com` 单独签发,或把具体域名写进 SAN。

不能自动包含。`*.example.com` 与 `example.com` 是两个不同的 SAN 条目,下单或签发时必须显式加上主域,例如 acme.sh 命令写成 `-d example.com -d '*.example.com'`。只签通配符时,用户直接访问裸域会报 `NET::ERR_CERT_COMMON_NAME_INVALID`。

先用 `dig +short TXT _acme-challenge.example.com @你的权威NS` 直接问权威服务器,确认记录是否真的存在。常见原因是记录建在错误的 zone、CNAME 委派目标被删除、或权威 NS 尚未同步;修好后等 TTL 过期再重试,避免短时间内连续失败触发每小时 5 次的验证限制。

Let's Encrypt 通配符免费、90 天有效、仅支持 DNS-01,适合有 DNS API 且能自动续期的团队;商业 DV 通配符年费约 ¥300–1500、有效期可达 1 年、通常附带基础保险与人工支持,适合没有自动化能力或需要固定到期日的场景。两者在浏览器兼容性上没有差别,差别在运维成本与责任承担。

先看访问的域名是否跨级(如 `a.b.example.com`),再看服务端是否只发了 leaf 证书、缺中间证书。用 `openssl s_client -connect example.com:443 -servername 你的域名 -showcerts` 检查返回的证书张数与 `Verify return code`,缺链时补 fullchain,跨级时补 SAN。

说明域名下存在 CAA 记录但没有授权当前 CA。执行 `dig +short CAA example.com` 查看,补一条 `0 issue "letsencrypt.org"`(或对应 CA 的标识)即可;注意 CAA 按 RFC 8659 沿域名标签向上查找,父域记录同样会生效。

不能。`.local`、`.internal`、`.lan` 等域名无法完成公共 DNS-01 验证,公共 CA 会直接拒绝签发。正确做法是用 step-ca、Vault PKI 或企业内部 CA 自建通配符证书,并通过 GPO、MDM 或配置管理工具把根证书推送到所有客户端信任库。


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

内容审核

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