通配符 SSL 证书实战:泛解析 HTTPS 部署、小程序/APP 证书配置与报错排查
一、问题背景与根因:*.example.com 为什么覆盖不到 example.com
把站点从 HTTP 升级到 HTTPS 时,最常见的需求描述是「我有一堆子域名,帮我配一张通配符证书」。但在实际部署中,超过一半的失败并非证书没有签下来,而是证书的覆盖范围与访问域名对不上。要理解这个问题,必须回到 RFC 6125 以及 CA/Browser Forum Baseline Requirements 对通配符匹配的定义。
根因可以拆成三条:
- 通配符只匹配一个 label,且必须位于最左侧。*.example.com 可以匹配 api.example.com、m.example.com、www.example.com,但不匹配裸域 example.com,也不匹配 a.b.example.com 这类二级前缀。如果证书的 SAN 里只写了 *.example.com,浏览器访问 example.com 时会直接报证书名称不匹配。
- DNS 泛解析与证书 SAN 是两个独立配置。在 DNS 里加一条 *.example.com 的 A 记录,只解决了「域名解析到 IP」;证书 SAN 才决定「TLS 握手是否被客户端接受」。两者缺一不可,而且泛解析同样不覆盖裸域,需要额外单独加一条 example.com 的 A 记录。
- 客户端侧的额外约束。微信小程序要求 HTTPS、TLS 1.2 及以上,且必须由受信任 CA 签发、证书链完整;Android 7.0 起默认不信任用户手动安装的 CA;iOS ATS 要求 SHA-256 签名、RSA 密钥不少于 2048 位。这些约束在桌面浏览器里可能被忽略,但在小程序和原生 APP 里会直接导致请求失败。
对应的典型报错:
curl: (60) SSL: no alternative certificate subject name matches target host name 'example.com'
curl: (60) SSL certificate problem: unable to get local issuer certificate
微信小程序:request:fail ssl handshake error
Android:javax.net.ssl.SSLHandshakeException: Trust anchor for certification path not found.
所以正确的做法是:一张证书的 SAN 同时包含 *.example.com 与 example.com;如果业务存在三级域名(例如 api.cc.example.com),要么把它单独写进 SAN,要么为 cc.example.com 再签一张通配符证书。结论很明确:通配符不是整个域名的万能钥匙,它只解决「一级子域批量覆盖」这一个问题。
二、证书选型与 398 天有效期新规
确定覆盖范围之后,下一步是选类型。市面上的证书按验证强度分为 DV / OV / EV,按覆盖范围分为单域名、多域名(SAN)、通配符、多域名通配符。对绝大多数站点而言,DV 通配符 + 自动续期已经完全够用,OV/EV 的价值主要体现在企业身份背书与合规审计要求上。
必须特别提醒的是有效期规则已经变了。CA/Browser Forum 自 2020 年 9 月 1 日起规定公开信任 TLS 证书的有效期上限为 398 天;此后通过的 SC-081 决议进一步压缩:2026 年 3 月 15 日起上限 200 天,2027 年 3 月 15 日起 100 天,2029 年 3 月 15 日起 47 天。也就是说「一次买三年、装一次管三年」的做法早已不成立,证书必须按周期续签。Let’s Encrypt 签发的证书有效期固定为 90 天,通配符证书同样是 90 天,必须依靠自动化续期,手工续期在 90 天周期下必然出事故。
| 证书类型 | 覆盖范围 | 验证方式 | 典型签发时长 | 适用场景 |
|---|---|---|---|---|
| DV 单域名 | 1 个主机名(www 或裸域二选一) | DNS TXT / HTTP 文件 | 10 分钟内 | 个人站、测试环境 |
| DV 通配符 | *.example.com 全部一级子域 | DNS TXT | 10 分钟 – 1 小时 | 多子域 SaaS、小程序后端 |
| DV 多域名 SAN | 最多 100 个指定主机名 | 逐域名验证 | 1 小时内 | 域名少但跨主域 |
| OV 单域名 / 通配符 | 同上 + 组织信息写入证书 | 工商核验 + 电话回呼 | 1-2 个工作日 | 企业官网、招投标 |
| EV | 同上 + 严格身份核验 | 第三方数据库 / 律师函 | 1-3 个工作日 | 金融、强合规场景 |
| 多域名通配符 | *.a.com + *.b.com + … | 逐主域 DNS 验证 | 1-3 个工作日 | 集团多品牌 |
三个容易踩坑的选型要点:单域名证书只覆盖一个主机名,www.example.com 与 example.com 属于两个不同主机名,必须靠 SAN 或通配符解决;OV/EV 的电话回呼可以使用工商登记、DUNS 或信用公示系统里留存的座机;EV 证书在主流浏览器中自 2019 年起已不再展示绿色地址栏,不要再把它当作「让地址栏变绿」的卖点。
三、完整实操:OpenSSL 生成 CSR,acme.sh 自动签发
路径 A:商业 CA 或自建 CA,手工生成 CSR。先准备私钥,RSA 2048 兼容性最好,ECDSA P-256 体积更小、握手更快,现代客户端均支持:
mkdir -p /etc/ssl/example && cd /etc/ssl/example
openssl genrsa -out example.com.key 2048
# 或使用 ECDSA
openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key
接着写一份带 SAN 的配置文件 example.cnf,注意 CN 只填一个,真正的覆盖范围靠 subjectAltName:
[req]
default_bits = 2048
default_md = sha256
prompt = no
distinguished_name = dn
req_extensions = v3_req
[dn]
C = CN
O = Example Technology Co., Ltd.
CN = *.example.com
[v3_req]
basicConstraints = CA:FALSE
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = @alt_names
[alt_names]
DNS.1 = *.example.com
DNS.2 = example.com
生成并自检 CSR,提交给 CA 之前务必确认 SAN 已正确写入:
openssl req -new -key example.com.key -out example.com.csr -config example.cnf
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
# 期望输出:DNS:*.example.com, DNS:example.com
openssl req -in example.com.csr -noout -verify -key example.com.key
路径 B:Let’s Encrypt + acme.sh。通配符只能走 DNS-01 验证,HTTP-01 无法签发通配符:
curl https://get.acme.sh | sh -s email=admin@example.com
export Ali_Key='LTAI********'
export Ali_Secret='********'
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256
签发成功后把证书安装到固定路径,并让 acme.sh 在续期后自动 reload:
~/.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 输出的内容是「站点证书 + 中间证书」,正好可以直接填给 ssl_certificate;如果只填站点证书,Android 与小程序端会报证书链验证失败。最后用 crontab -l | grep acme 确认定时任务已写入,acme.sh 默认每天检查一次到期时间。
四、Nginx 与宝塔面板的 HTTPS 配置示例
一份可直接使用的 Nginx 配置,重点在 server_name 必须同时写裸域与通配符,以及证书链与协议版本:
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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;
add_header Strict-Transport-Security 'max-age=31536000' always;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}
几个容易出错的细节:server_name 里的 *.example.com 不会匹配裸域,必须显式写上 example.com;http2 on; 是 Nginx 1.25.1 引入的新写法,老版本需写成 listen 443 ssl http2;;ssl_trusted_certificate 只放中间证书链,用于 OCSP stapling,不要和 fullchain 混用;HSTS 加 includeSubDomains 之前要确认所有子域都已上 HTTPS,否则会把未加密的子域锁死一年。
宝塔面板部署:证书实际落盘路径为 /www/server/panel/vhost/cert/站点名/fullchain.pem 与 privkey.pem。在「网站 → 设置 → SSL → 其他证书」中,证书一栏粘贴 fullchain.pem 的全部内容(站点证书在前、中间证书在后),私钥一栏粘贴 key 全文,保存后面板会自动 reload。若面板显示「证书已到期」但实际未到期,通常是面板缓存或站点目录里残留了旧证书,删除后重新粘贴即可。宝塔的续期任务位于 /www/server/cron/,不要把 acme.sh 的 crontab 与面板任务重复配置,否则会出现两套证书互相覆盖。
五、通配符、多域名、多域名通配符的运维对比
从技术上讲,能覆盖需求的最小方案就是最优方案;但从运维角度,证书的维护成本主要来自「新增域名是否要重签」和「私钥暴露面有多大」。下面这张表按运维视角对比四种常见做法:
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- HTTPS配置 · SSL证书安装服务(各种服务器)
| 方案 | 覆盖范围 | 新增子域是否重签 | 私钥暴露面 | 续期维护成本 | 综合成本 |
|---|---|---|---|---|---|
| 单域名证书 × N | 精确到主机名 | 需要 | 每域一把,隔离性好 | 高,N 份到期监控 | 单张低、总量高 |
| 通配符 *.example.com | 全部一级子域 | 不需要 | 全子域共用一把,风险集中 | 低,一张证书一个任务 | 中 |
| 多域名 SAN | 固定列表,通常 ≤100 | 需要 | 一把覆盖全部主机名 | 中,需维护 SAN 列表 | 中 |
| 多域名通配符 | *.a.com + *.b.com | 不需要 | 最大,跨品牌共用 | 低 | 高 |
选择通配符就意味着接受私钥风险集中:一张 *.example.com 的私钥泄露,攻击者可以为任意一级子域搭建钓鱼站而不触发证书告警。对应的加固措施是:私钥文件权限固定为 600、属主为运行 Nginx 的用户;私钥不进 Git 仓库、不进 CI 变量明文;生产、预发、测试环境分别签发独立证书,不要一张证书全公司复制;有条件时使用 KMS 或证书托管服务做私钥隔离。
另一个常被忽略的场景是内部服务间通信。很多团队把公网通配符证书直接铺到内网几百台机器上,一旦其中一台被攻破,公网域名即失守。正确做法是内网使用内部 CA(例如 step-ca、Vault PKI、cfssl)签发 24 小时到 7 天的短周期证书,公网通配符只用于对外入口。
最后是一个成本估算参考:如果子域数量在 3 个以内,单域名或 SAN 证书更划算且风险更小;超过 5 个且持续新增,通配符的运维收益会迅速超过其成本;跨多个主域时,优先考虑多域名通配符而不是给每个主域单独建一套续期流水线。
六、常见错误排查(含真实报错)
下面这张表覆盖了 90% 以上的现场问题,报错文本可以直接对照搜索:
| 报错信息 | 根因 | 修复动作 |
|---|---|---|
| curl: (60) unable to get local issuer certificate | 只下发了站点证书,中间证书缺失 | ssl_certificate 改指向 fullchain.pem |
| curl: (60) no alternative certificate subject name matches target host name | SAN 不含当前访问的域名(常见于裸域) | 重签,SAN 加入 example.com |
| nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:no start line) | 证书文件为空、放成了私钥、或含多余字符 | 确认文件以 BEGIN CERTIFICATE 开头 |
| nginx: [emerg] cannot load certificate key … key values mismatch | 证书与私钥不是同一对 | 对比 modulus,见下方命令 |
| ERR_CERT_DATE_INVALID | 证书过期或服务器系统时间错误 | date -u 检查时间,启用 NTP |
| SSL_ERROR_NO_CYPHER_OVERLAP | 客户端仅支持 TLS 1.0/1.1,服务端已禁用 | 升级客户端或临时放开协议(不推荐) |
| NET::ERR_CERT_COMMON_NAME_INVALID | 用 A 域名证书访问 B 域名,或 SNI 未命中 | 核对 server_name 与证书 SAN |
核对私钥与证书是否匹配的标准命令,两行输出的 MD5 必须完全一致:
openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
小程序报 request:fail ssl handshake error 时,排查顺序固定为三步:先确认证书链完整,用 openssl s_client 看输出里是否包含两级以上证书;再确认服务端没有强制只允许 TLS 1.3 而客户端 SDK 版本过低;最后确认域名是否在小程序后台的服务器域名白名单里,且没有使用 IP 直连。三者任一不满足都会抛出同一个笼统的握手失败。
还有一类隐蔽问题:CDN 或负载均衡层已更新证书,但源站仍是旧证书,浏览器拿到的是 CDN 节点的证书、源站回源时校验失败。排查时用 curl -vI https://api.example.com 分别对 CDN 域名和源站 IP 各跑一次,对比 subject 与 expire date 即可定位。
七、效果验证:部署完成后必须跑的检查项
证书装好不等于部署完成,下面几条命令建议写进上线检查清单:
# 1. 查看证书主体、签发者、有效期与 SAN 列表
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2. 验证证书链是否完整,输出 0 表示链验证通过
openssl s_client -connect example.com:443 -servername example.com -verify_return_error 2>/dev/null; echo exit=$?
# 3. 检查剩余有效期,少于 30 天返回非 0
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 2592000
# 4. 批量验证各子域是否命中同一张证书
for h in www api m static; do printf '%s ' $h; curl -s -o /dev/null -w '%{http_code} verify=%{ssl_verify_result}n' https://$h.example.com; done
第 2 条命令是关键:很多「浏览器能打开但 APP 打不开」的故障,本质就是链不完整,而桌面 Chrome 会自动补链(AIA Fetching),移动端不会。ssl_verify_result 为 0 表示校验通过,非 0 时可对照 OpenSSL 的 verify error 码定位。
接着做三件事:一是把域名丢进 SSL Labs 或国内 myssl.com 跑一次评级,目标是 A 及以上,同时确认没有 TLS 1.0/1.1、没有 RC4、没有 1024 位 RSA;二是做一次续期演练,执行 ~/.acme.sh/acme.sh –cron –force,观察是否自动续签并 reload 成功,演练完再执行 nginx -t 确认配置未被破坏;三是配置到期监控,用 openssl x509 -checkend 配合 Zabbix/Prometheus 的 textfile collector,在到期前 30 天、7 天、1 天各告警一次。
最后别忘了回归业务侧:微信小程序后台重新保存一次服务器域名(触发校验)、APP 端做一次冷启动请求、支付回调地址用 curl 模拟回调一次。证书问题往往在部署当天不暴露,而是在 90 天后的某个凌晨集中爆发,自动化续期 + 到期告警是唯一可靠的解法。
常见问题
不能。按 RFC 6125,*.example.com 只匹配一个 label,api.example.com 可以,api.cc.example.com 不行。若有三级域名需求,需把具体主机名写入 SAN,或为 cc.example.com 单独签发一张通配符证书。
固定 90 天,且只能通过 DNS-01 验证签发,HTTP-01 不支持通配符。推荐用 acme.sh 配置 DNS API(如 dns_ali、dns_cf)自动续期,它会写入 crontab 每天检查,续期后自动 reload Nginx。
技术上可以,但私钥暴露面会随机器数量线性放大,任一节点被攻破即等于全部子域失守。建议生产、预发、测试分别签发独立证书,内网服务改用内部 CA 签发的短周期证书。
公开信任证书自 2020 年 9 月起上限为 398 天;按 CA/B Forum SC-081 决议,2026 年 3 月 15 日起缩短为 200 天,2027 年 3 月 15 日起 100 天,2029 年起 47 天。必须依赖自动化续期。
按三步走:用 openssl s_client 确认证书链完整(含中间证书);确认服务端支持 TLS 1.2 且未强制仅 TLS 1.3;确认域名已加入小程序后台服务器域名白名单且未用 IP 直连。
多数是 CDN 或负载均衡层未同步更新,或 Nginx 未 reload。先执行 nginx -t 再 nginx -s reload,然后分别对 CDN 域名和源站 IP 跑 curl -vI,对比 subject 与到期时间即可定位是哪一层没更新。