跳到主要内容
ssl证书按装

通配符 SSL 证书实战:泛解析 HTTPS 部署、小程序/APP 证书配置与报错排查

通配符 SSL 证书实战:泛解析 HTTPS 部署、小程序/APP 证书配置与报错排查 — 通配符 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 与面板任务重复配置,否则会出现两套证书互相覆盖。

五、通配符、多域名、多域名通配符的运维对比

从技术上讲,能覆盖需求的最小方案就是最优方案;但从运维角度,证书的维护成本主要来自「新增域名是否要重签」和「私钥暴露面有多大」。下面这张表按运维视角对比四种常见做法:

方案 覆盖范围 新增子域是否重签 私钥暴露面 续期维护成本 综合成本
单域名证书 × 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 与到期时间即可定位是哪一层没更新。

内容审核

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