跳到主要内容
ssl证书按装

CA 证书实战:单域名与通配符 SSL 证书选型、HTTPS 泛解析配置与排错

CA 证书实战:单域名与通配符 SSL 证书选型、HTTPS 泛解析配置与排错 — CA 证书实战:单域名与通配符 SSL 证书选型、HTTPS 泛解析配置与排错

问题背景与根因:DNS 泛解析不等于 HTTPS 泛解析

很多团队在 DNS 里加了 *.example.com 的 A 记录,浏览器访问 api.example.com 能解析到同一台服务器,就认为「HTTPS 泛解析」已经完成。实际上 DNS 泛解析只解决「域名指向哪里」,TLS 握手时客户端还会做一次完全独立的身份校验:服务器出示的证书 SAN(Subject Alternative Name)集合里,必须存在与请求域名匹配的条目。两者缺一不可。

域名匹配遵循 RFC 6125,有三条硬约束:

  • 只认 SAN,不认 CN。Chrome 58 之后、Firefox、Safari 以及 Go、Java 客户端都不再回退到 Common Name 字段。只写 CN 的证书在浏览器里会直接触发 NET::ERR_CERT_COMMON_NAME_INVALID。
  • 通配符只匹配最左一个标签。*.example.com 匹配 api.example.com,不匹配 a.b.example.com,也不匹配裸域 example.com。
  • 端口、路径、协议不参与匹配。证书绑定的是主机名,不是 URL。

典型故障场景:主站用单域名证书保护 www.example.com,业务上线后新增 api.example.com、m.example.com,全部解析到同一台 Nginx,但只配了一张证书。于是访问子域时报:

curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com'

根因既不是 DNS 也不是 Nginx 写错,而是证书 SAN 里没有这个域名。排查第一步永远是看证书实际覆盖了什么:

openssl s_client -connect example.com:443 -servername api.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -ext subjectAltName

输出中 X509v3 Subject Alternative Name 后面列出的才是真实生效范围。若只看到 DNS:www.example.com,api.example.com 必然失败。

第二个高频根因是证书链不完整:只部署了叶子证书,没带中间 CA。桌面浏览器有时能靠 AIA 扩展自动抓取补齐,但 Android、Java、curl、微信小程序与公众号 WebView 通常直接失败——这正是「电脑能打开、手机打不开」的常见原因。

第三个根因是层级误判:误以为 *.example.com 能覆盖 a.b.example.com,把所有多级子域塞进泛解析,客户端最终报 x509: certificate is valid for *.example.com, not a.b.example.com。多级子域必须单独签证书,或用多域名 SAN 证书逐个列出。

证书选型对比:单域名、通配符与多域名 SAN

动手之前先把三类证书的边界对齐,能省掉后面 80% 的返工。

维度 单域名证书 通配符证书 多域名 SAN 证书
覆盖范围 1 个 FQDN,如 www.example.com *.example.com,匹配任意一级子域 单张证书最多 100 个不同 FQDN
是否含裸域 仅含填写的那一个 默认不含 example.com,需额外加 SAN 可自由组合
多级子域 a.b.example.com 不支持 不支持 支持,逐个列出即可
新增子域 必须重新签发 无需改动证书 必须重新签发
可用验证方式 HTTP-01 或 DNS-01 强制 DNS-01 HTTP-01 或 DNS-01
Let’s Encrypt 支持 支持 支持(2018-03 起) 支持,单证书上限 100 个名字
有效期上限 398 天 398 天 398 天
私钥泄露影响面 单站点 整个一级域下所有子域 证书内全部域名
典型场景 官网、单后台 SaaS 多租户、泛解析、CDN 回源 多品牌、多业务线

几个必须纠正的过时认知:

398 天不是 CA 的营销限制,而是 CA/Browser Forum 的强制上限,2020-09-01 起生效。Let’s Encrypt 更严格,默认 90 天。CA/B Forum 已通过 SC-081 提案,2026-03-15 起上限降到 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。选型时把「自动续期」当成必选项而不是加分项,否则一定踩过期。

通配符证书不支持 EV 类型,需要企业实名校验的场景只能用普通 OV/EV 单域名或 SAN 证书。

通配符不能跨层级、不能跨二级域。*.example.com 管不了 *.example.net,也管不了 *.b.example.com。如果需要同时覆盖 example.com 与 *.example.com,正确做法是申请时把两个名字都写进 CSR 的 SAN。

选型建议:子域数量固定且不超过 3 个,用单域名或 SAN 证书更省心;子域随租户动态增长(每个客户一个 tenant.example.com),通配符是唯一可行解;跨多个二级域,用「通配符 + 额外 SAN」组合,一张证书同时写 *.example.com、example.com、*.example.net。

实操第一步:生成私钥与 CSR(单域名与通配符两种写法)

CSR(Certificate Signing Request)里只有公钥和签名,私钥永远不出服务器。先生成密钥:

# 推荐 ECDSA P-256:握手更快、证书体积更小
openssl ecparam -genkey -name prime256v1 -out example.com.key

# 需要兼容极老客户端时改用 RSA 2048
openssl genrsa -out example.com.key 2048

chmod 600 example.com.key

OpenSSL 1.1.1 及以上版本可以直接用 -addext 写 SAN,通配符写法:

openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology Ltd/CN=*.example.com' 
  -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'

单域名写法:

openssl req -new -key www.example.com.key -out www.example.com.csr 
  -subj '/C=CN/O=Example Technology Ltd/CN=www.example.com' 
  -addext 'subjectAltName=DNS:www.example.com'

如果服务器上的 OpenSSL 低于 1.1.1(例如 CentOS 7 自带的 1.0.2k),-addext 会报 unknown option -addext,改用配置文件:

cat > san.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = v3_req
prompt = no
[dn]
CN = *.example.com
O = Example Technology Ltd
C = CN
[v3_req]
subjectAltName = @alt
[alt]
DNS.1 = *.example.com
DNS.2 = example.com
EOF

openssl req -new -key example.com.key -out example.com.csr -config san.cnf

提交给 CA 之前先自检,确认 SAN 没有被吞掉:

openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

输出必须是 DNS:*.example.com, DNS:example.com。如果这里是空的,签发出来的证书也不会有 SAN,后面怎么配都是错。

拿到证书后务必验证私钥与证书是否配对,这是「证书装上去 Nginx 起不来」的第一大原因:

openssl x509 -in example.com.crt -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

两个 MD5 必须完全一致。另外三条实操红线:通配符只能出现在最左标签,*.*.example.com 与 www.*.example.com 都是非法写法,CA 会直接拒签;CN 字段长度上限 64 字符,现代客户端已不看它,但建议仍与主域名保持一致;私钥不要上传给任何 CA,正规 CA 只需要 CSR。

实操第二步:用 ACME 自动签发通配符证书(DNS-01 是硬门槛)

通配符证书无法用 HTTP-01 验证。原因是 HTTP-01 需要 CA 访问 http://域名/.well-known/acme-challenge/xxx 这个具体 URL,而 *.example.com 代表无限个可能不存在的子域,无法逐个校验。CA/B Forum 因此规定:通配符只能走 DNS-01,通过在 _acme-challenge.example.com 下写入指定 TXT 记录来证明域名控制权。

用 acme.sh 配阿里云 DNS(其他厂商把 dns_ali 换成 dns_cf、dns_dp、dns_huaweicloud 等):

curl https://get.acme.sh | sh -s email=ops@example.com

export Ali_Key='LTAIxxxxxxxxxxxx'
export Ali_Secret='xxxxxxxxxxxxxxxxxxxxxxxx'

~/.acme.sh/acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' --keylength ec-256

-d '*.example.com' 外面的单引号不能省。不加引号时 shell 会把 * 当通配符展开成当前目录下的文件名,命令直接变形。

用 certbot 配 Cloudflare DNS 插件:

cat > ~/.secrets/cf.ini <<'EOF'
dns_cloudflare_api_token = xxxxxxxxxxxxxxxxxxxx
EOF
chmod 600 ~/.secrets/cf.ini

certbot certonly --dns-cloudflare 
  --dns-cloudflare-credentials ~/.secrets/cf.ini 
  -d example.com -d '*.example.com' --key-type ecdsa

没有 DNS API 权限时只能手动加 TXT 记录。注意手动模式无法自动续期,仅适合临时验证:

~/.acme.sh/acme.sh --issue --dns 
  -d example.com -d '*.example.com' 
  --yes-I-know-dns-manual-mode-enough-go-ahead-please

按提示去 DNS 面板添加 TXT 记录,用 dig 确认全网生效后再执行 --renew 完成签发。签发成功后安装证书并绑定 reload 命令,acme.sh 每次续期后会自动执行:

~/.acme.sh/acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem 
  --reloadcmd      'nginx -t && nginx -s reload'

两个关键点:必须用 --fullchain-file,文件内容是叶子证书加中间证书,只装叶子会链不完整;reload 命令里先 nginx -t 再 reload,避免配置写错导致服务中断。另外如果域名配了 CAA 记录,必须包含所用 CA,否则签发会报 urn:ietf:params:acme:error:caa:

dig +short CAA example.com

配置示例:Nginx 与 Apache 承载泛解析域名

Nginx 完整配置,一张通配符证书同时服务裸域与所有一级子域:

server {
    listen 80;
    server_name example.com *.example.com;
    return 301 https://$host$request_uri;
}

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

    ssl_certificate     /etc/nginx/ssl/example.com.fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;

    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;
    resolver 223.5.5.5 1.1.1.1 valid=300s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
    }
}

逐条说明容易踩坑的地方。server_name *.example.com 只匹配一级子域,a.b.example.com 不会命中,需要额外写 *.b.example.com 或用正则 ~^.+.example.com$。Nginx 的匹配优先级是精确名优先于最左通配符,最左通配符优先于最右通配符,正则写在最后但会兜底所有未命中的请求。http2 on; 是 Nginx 1.25.1 之后的新语法,老版本要写 listen 443 ssl http2;,否则启动报 unknown directive http2。ssl_trusted_certificate 只用于 OCSP stapling 校验,必须放中间证书链,不能包含叶子证书,放错会导致 stapling 静默失效。HSTS 加 includeSubDomains 之前,确认所有子域都能上 HTTPS,否则会把用户浏览器锁死在无法访问的状态。

Apache 2.4 写法:

<VirtualHost *:443>
    ServerName example.com
    ServerAlias *.example.com
    SSLEngine on
    SSLCertificateFile    /etc/httpd/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    Protocols h2 http/1.1
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

Apache 2.4.8 之后 SSLCertificateChainFile 已废弃,中间证书直接拼进 SSLCertificateFile,顺序是叶子在前、中间在后,根证书不要放:

cat example.com.crt intermediate.crt > example.com.fullchain.pem

常见错误排查:12 个真实报错与修复

报错原文 出现位置 根因 修复
curl: (60) SSL: no alternative certificate subject name matches target host name ‘api.example.com’ curl 证书 SAN 不含该域名 重签并把 api.example.com 写进 SAN,或改用通配符
NET::ERR_CERT_COMMON_NAME_INVALID Chrome 域名不匹配,或证书只有 CN 没有 SAN 现代客户端只看 SAN,必须补 SAN
x509: certificate is valid for *.example.com, not a.b.example.com Go/Java 客户端 通配符不跨层级 单独签 *.b.example.com 或加 SAN
SSL_ERROR_BAD_CERT_DOMAIN Firefox 域名不匹配 同上
curl: (60) SSL certificate problem: unable to get local issuer certificate curl/Java/小程序 证书链不完整,缺中间证书 部署 fullchain,确认下发 2~3 张
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:…key values mismatch) Nginx 启动 私钥与证书不配对 用 pubkey md5 比对后重新配对
nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) Nginx 启动 证书是 DER/PKCS#7 格式或文件为空 转成 PEM 后重新加载
sslv3 alert handshake failure / no shared cipher 老客户端 只开 TLS1.2+,客户端只支持 TLS1.0 评估是否保留旧协议,或升级客户端
ERR_CERT_DATE_INVALID 浏览器 证书过期或服务器时间错误 续期并校准 NTP
urn:ietf:params:acme:error:unauthorized (DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com) ACME 签发 TXT 记录未生效或主机名写错 dig TXT 确认记录
urn:ietf:params:acme:error:caa ACME 签发 CAA 记录未授权该 CA 添加 issue letsencrypt.org
Problem binding to port 80: Could not bind to IPv4 or IPv6 certbot standalone 80 端口被 Nginx 占用 停服务或改用 webroot/dns 插件

展开几条最容易被误判的。「电脑能开、手机打不开」几乎都是链不完整,验证方法:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

返回 1 说明只下发了叶子证书,必须补中间证书。

key values mismatch 是私钥和证书不配对,最常见于「续期后只替换了证书没替换私钥」或「多张证书文件名搞混」。用上一节的 pubkey md5 比对法定位,不要靠肉眼。

PEM_read_bio_X509_AUX failed 说明文件不是 PEM 格式。CA 下发的可能是 .p7b 或 .der,需要转换:

openssl pkcs7 -print_certs -in cert.p7b -out cert.pem
openssl x509 -inform DER -in cert.der -out cert.pem

ACME 的 NXDOMAIN:注意 TXT 记录主机名只填 _acme-challenge(阿里云、腾讯云会自动补全域名后缀)。如果填成完整域名 _acme-challenge.example.com,最终记录会变成 _acme-challenge.example.com.example.com,验证必然失败。

效果验证:五条命令确认证书链与域名覆盖

# 1. 模拟带 SNI 的访问,看证书主体、签发者、有效期、SAN
openssl s_client -connect example.com:443 -servername api.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

# 2. 校验链是否完整,必须返回 0
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | grep 'Verify return code'

# 3. 确认服务端下发的证书张数,正常是 2~3 张
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'

# 4. 检查剩余有效期,2592000 秒 = 30 天
openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -enddate
openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -checkend 2592000 -noout 
  && echo '30 天内不会过期'

# 5. 看协商出的协议版本与套件
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | grep -E 'Protocol|Cipher'

第 2 条输出 Verify return code: 0 (ok) 才算真正通过。Verify return code: 20 (unable to get local issuer certificate) 是链不完整,10 (certificate has expired) 是过期,62 (hostname mismatch) 是域名不匹配。

用 curl 从客户端视角验证,重点看 SSL certificate verify ok:

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

批量验证泛解析下所有子域,这是上线前最值得跑的一步:

for h in www api m admin static; do
  printf '%-10s ' $h
  echo | openssl s_client -connect ${h}.example.com:443 -servername ${h}.example.com 2>/dev/null 
    | grep -q 'Verify return code: 0 (ok)' && echo OK || echo FAIL
done

深度体检用 testssl.sh,能查出协议降级、弱套件、证书透明(SCT)、OCSP stapling 是否生效:

git clone --depth 1 https://github.com/drwetter/testssl.sh.git
./testssl.sh/testssl.sh --fast https://example.com

浏览器侧打开开发者工具 → Security → View certificate,确认 Certificate is valid 且 SAN 列表包含当前域名。注意浏览器会缓存证书,验证前先强制刷新或换无痕窗口,否则可能看到旧证书的结果。

生命周期管理:398 天、90 天与自动续期监控

证书有效期规则在持续收紧。当前硬上限是 398 天(CA/Browser Forum 于 2020-09-01 起强制),Let’s Encrypt 默认 90 天。按已通过的 SC-081 提案,2026-03-15 起上限降至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。这意味着手工续期彻底不可行,必须把续期、部署、reload 全链路自动化。

acme.sh 默认在剩余 60 天时自动续期,安装时已写入 crontab,用 --list 确认:

~/.acme.sh/acme.sh --list
crontab -l | grep acme

强制续期并同时轮换私钥,密钥轮换能缩小单把私钥泄露的影响窗口:

~/.acme.sh/acme.sh --renew -d example.com --ecc --force --always-force-new-domain-key

certbot 侧确认 timer 生效,并做一次不写盘的演练:

systemctl list-timers | grep certbot
certbot renew --dry-run

再加一层独立监控,不要只信任 ACME 客户端的日志。下面脚本检查剩余天数,低于 21 天返回非零:

#!/usr/bin/env bash
HOST=example.com
END=$(echo | openssl s_client -connect ${HOST}:443 -servername ${HOST} 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
echo $HOST 剩余 $LEFT 天
[ $LEFT -lt 21 ] && exit 1

用 Prometheus blackbox_exporter 可以直接拿到 probe_ssl_earliest_cert_expiry 指标,按 (probe_ssl_earliest_cert_expiry - time()) / 86400 < 21 配告警规则,比自建脚本更省事。

还要备份两样东西:证书私钥目录(如 /etc/nginx/ssl)和 ACME 账户目录 ~/.acme.sh。后者包含 account.key,丢失后需要重新注册账户,已签发证书的续期会中断。证书泄露或私钥误提交到 Git 时立即吊销:

~/.acme.sh/acme.sh --revoke -d example.com --ecc

常见问题

默认不能。*.example.com 只匹配一级子域,不包含裸域本身。正确做法是申请时把裸域作为额外 SAN 一起提交,例如 -d example.com -d ‘*.example.com’,这样一张证书同时覆盖裸域和所有一级子域。

不能。通配符只匹配最左一个标签,a.b.example.com 属于二级子域。要么单独为 *.b.example.com 再签一张通配符证书,要么使用多域名 SAN 证书把需要的多级子域逐个列进 SAN。

HTTP-01 需要 CA 访问一个具体 URL,而 *.example.com 代表无限个可能不存在的子域,无法逐个验证。CA/B Forum 因此规定通配符只能通过 DNS-01 校验 _acme-challenge 下的 TXT 记录来证明域名控制权。

目前是 398 天,2020-09-01 起由 CA/Browser Forum 强制。Let’s Encrypt 默认 90 天。按 SC-081 提案,2026-03-15 起降至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天,必须做自动续期。

多半是证书链不完整。服务端必须下发叶子证书加中间证书(fullchain),只发叶子时桌面浏览器可能靠 AIA 补齐,而 Android、Java、微信 WebView 不会。用 openssl s_client -showcerts 确认下发张数应为 2~3 张。

技术上可以,但不建议。共用私钥会扩大泄露影响面,通配符私钥一旦泄露,整个一级域下所有子域都受影响。每张证书应独立生成密钥,并用 pubkey 的 md5 比对确认私钥与证书配对。

内容审核

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