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:
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
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 比对确认私钥与证书配对。