通配符SSL证书与HTTPS泛解析实战:DNS-01签发、Nginx配置、小程序/APP排错
问题背景与根因:通配符证书、HTTPS泛解析为何仍频繁失败
微信小程序、APP、H5、API回调普遍强制HTTPS,浏览器对自签证书、证书链不完整、混合内容直接拦截。通配符证书(Wildcard SSL)用一张证书覆盖 example.com 与 *.example.com 的一级子域,适合多租户、灰度环境、批量二级域名和统一网关。这也是CA证书配置安装服务与SSL证书安装服务中最常见的交付项。真正的根因通常不是“没买证书”,而是四类问题:DNS-01验证未生效、只部署叶子证书未带中间CA、Nginx server_name/SNI与证书SAN不一致、安全组未放行443。原文“默认一年证书”已过时:截至2026年5月,公共信任TLS证书自2026-03-15起单张最长200天,此前为398天;Let’s Encrypt仍为90天,必须自动续期。EV证书也不再在主流浏览器地址栏显示公司名。小程序后台合法域名必须填写具体域名并完成备案,不能填 *.example.com,但证书本身可用通配符覆盖 api.example.com。多级子域 a.b.example.com 不在 *.example.com 覆盖范围,需要 *.b.example.com 或加入SAN。先做体检:
dig +short TXT _acme-challenge.example.com
curl -I http://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
若 curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate,优先检查 fullchain;若 443 报 Connection timed out,先查安全组和监听;若 SAN 只有 example.com 没有 *.example.com,说明签发参数漏了通配符。下面按签发、配置、小程序/APP、排错、验证展开。
证书类型与选型:单域名、多域名、通配符及DV/OV/EV对比
选型先看覆盖范围,再看验证等级。单域名只保护一个FQDN;多域名SAN可在一张证书里放多个不同域名;通配符只覆盖同一级子域。DV只验证域名控制权,几分钟可签发;OV验证企业身份,通常1-5个工作日;EV审核更严,但Chrome 77后已移除地址栏公司名展示,不再适合以“绿色公司名”为卖点。有效期方面,公共CA当前单张最长200天(2026-03-15起),Let’s Encrypt为90天,自动续期是硬要求。表格如下:
| 类型 | 覆盖范围 | 验证方式 | 典型有效期 | 适用场景 | 注意 |
|---|---|---|---|---|---|
| 单域名DV | api.example.com | HTTP-01或DNS-01 | 90天或最长200天 | 单接口、单站点 | 换子域需重签 |
| 多域名SAN DV | a.example.com、b.example.net | DNS-01/HTTP-01 | 90天或最长200天 | 多业务域名 | 注意SAN数量上限 |
| 通配符DV | example.com、*.example.com | 必须DNS-01 | Let’s Encrypt 90天;商业CA最长200天 | 多租户、批量二级域名、小程序/APP网关 | 不覆盖a.b.example.com |
| OV | 按订单SAN | 企业资料+域名 | 最长200天 | 企业门户、合规采购 | 审核1-5个工作日 |
| EV | 按订单SAN | 严格企业审核 | 最长200天 | 金融、电商合规场景 | 主流浏览器不再显示公司名 |
个人博客、测试环境、小程序API用DV通配符即可;企业官网若采购要求OV再选OV;不要为“地址栏公司名”买EV。通配符证书建议同时把根域 example.com 加入SAN,否则 https://example.com 可能不匹配。若业务有 a.b.example.com,申请 *.b.example.com 或购买多域名证书。小程序合法域名仍需逐个子域配置,证书通配符只解决握手层。
完整实操:用DNS-01签发通配符证书并自动续期
通配符证书必须走DNS-01,HTTP-01无法签发 *.example.com。前置条件:域名DNS可改TXT、服务器已安装Nginx、安全组放行80/443、时间同步正常。以下以 acme.sh + 阿里云DNS API 为例,其他DNS服务商替换 dns_ali 与环境变量。命令可直接执行:
sudo apt update && sudo apt install -y curl openssl nginx
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
export Ali_Key='你的AccessKeyId'
export Ali_Secret='你的AccessKeySecret'
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength 2048
sudo mkdir -p /etc/nginx/ssl
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem --reloadcmd 'systemctl reload nginx'
~/.acme.sh/acme.sh --cron
若不用API,可手动加TXT:先执行 ~/.acme.sh/acme.sh –issue –dns -d example.com -d ‘*.example.com’ –yes-I-know-dns-manual-mode-enough-go-ahead-please,按提示在 _acme-challenge.example.com 添加两条TXT并保留并存,再用 dig +short TXT _acme-challenge.example.com 确认,然后执行 –renew 同参数。证书签发后检查SAN:openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -subject -dates -ext subjectAltName,应看到 DNS:example.com 与 DNS:*.example.com。acme.sh安装时会写入cron,每日执行 –cron;Let’s Encrypt 90天,通常在到期前30天续期,商业CA最长200天也不要手工一年。若用certbot:certbot certonly –manual –preferred-challenges dns -d example.com -d ‘*.example.com’,按提示加TXT。续期后必须 reload Nginx,否则旧证书仍在内存。
Nginx配置示例:HTTP 301、TLS 1.2/1.3、HSTS与泛解析server_name
证书文件必须使用 fullchain(叶子+中间CA),私钥权限600。Nginx 1.25.1+推荐 http2 on,旧版本用 listen 443 ssl http2。示例同时处理根域和一级子域,HTTP强制301到HTTPS:
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;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
add_header Strict-Transport-Security 'max-age=31536000' always;
location / { proxy_pass http://127.0.0.1:8080; }
}
执行 nginx -t && systemctl reload nginx。server_name *.example.com 只匹配一级子域,不匹配 a.b.example.com,与证书边界一致;多级业务要单独加 *.b.example.com 的server块和证书。安全组和云防火墙都要放行443,否则本机 curl 127.0.0.1 正常、外网仍超时。HSTS首次上线建议先用 max-age=300 测试,确认全站HTTPS后再加到一年;若还有HTTP资源,HSTS会放大故障。证书私钥不要放在Web根目录,chmod 600,属主root。若使用ECDSA证书,ssl_ciphers要包含ECDSA套件;RSA证书则保留RSA套件。小程序和APP只需访问443,不建议用非标端口规避备案或防火墙。
小程序、APP与API场景:证书链、TLS版本和合法域名配置
微信小程序 request 合法域名必须是HTTPS、具体域名,不能使用IP或localhost,后台不能填 *.example.com;证书可用通配符覆盖 api.example.com。TLS要求1.2及以上,证书链必须完整,自签证书会报 request:fail ssl hand shake error。Android 7+默认只信任系统CA,iOS ATS要求TLS 1.2+,APP做证书固定(pinning)时要在发版时预留新旧证书双固定,否则换证即全量故障。上线前用命令核对SAN、链和TLS版本:
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
curl -v https://api.example.com/health 2>&1 | grep -E 'SSL connection|TLSv|subject|issuer'
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_1 </dev/null
最后一条应握手失败,表示TLS 1.1已禁用;若成功,检查 ssl_protocols 是否仍包含旧协议。小程序后台把 https://api.example.com 填入request合法域名,完成ICP备案,优先使用443;证书更换不需要改合法域名,但必须确认新证书SAN包含该域名。APP侧若使用OkHttp,默认校验证书链和主机名;报 javax.net.ssl.SSLHandshakeException 时先抓 openssl 输出,确认是否缺中间CA、SNI不匹配、证书过期或系统时间错误。API网关、CDN回源也要部署fullchain,否则客户端到CDN正常、CDN回源失败。证书到期监控至少提前30天告警,Let’s Encrypt 90天周期建议保留自动续期日志。
常见错误排查:真实报错、根因与修复命令
先看报错归属:curl/openssl报错是链或协议问题,Nginx [emerg] 是配置/文件问题,小程序 request:fail 多为链、TLS、域名备案或合法域名未配。下表按真实报错定位:
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
| 真实报错 | 根因 | 处理 |
|---|---|---|
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 只部署叶子证书,缺中间CA | 改用 fullchain.pem,openssl s_client -showcerts 检查链 |
| nginx: [emerg] SSL_CTX_use_certificate_chain_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) | 证书与私钥不匹配 | openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 比对 |
| NET::ERR_CERT_COMMON_NAME_INVALID | 访问域名不在SAN,或通配符层级不匹配 | 检查 subjectAltName,a.b.example.com 需单独证书 |
| request:fail ssl hand shake error | 小程序侧TLS/链/域名问题 | 确认TLS1.2+、fullchain、备案、合法域名具体子域 |
| DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com – check that a DNS record exists for this domain | TXT未添加或未生效 | dig +short TXT _acme-challenge.example.com,等待TTL后重试 |
| too many failed authorizations recently | 短时间验证失败过多触发限流 | 停止重试,修正DNS/防火墙后等待限流窗口 |
| curl: (7) Failed to connect to example.com port 443: Connection timed out | 安全组/防火墙未放行443或Nginx未监听 | ss -lntp | grep 443;检查云安全组和ufw/firewalld |
证书与私钥比对命令:openssl x509 -noout -modulus -in /etc/nginx/ssl/example.com.fullchain.pem | openssl md5;openssl rsa -noout -modulus -in /etc/nginx/ssl/example.com.key | openssl md5,两者应一致。若Nginx报 cannot load certificate,先看路径权限和SELinux。若续期成功但浏览器仍旧证书,执行 systemctl reload nginx 并检查CDN是否缓存证书。排查顺序固定为:DNS TXT→证书SAN→fullchain→私钥匹配→443监听→安全组→TLS版本→小程序后台配置。
效果验证:证书SAN、链、有效期、TLS版本与301跳转
配置完成后不要只看浏览器绿锁。用以下命令做上线验收:
curl -I http://example.com
curl -I https://example.com
curl -I https://api.example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -E 'Protocol|Cipher|Verify return code'
openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -checkend 2592000
ss -lntp | grep ':443'
期望结果:HTTP返回301且Location为https://example.com/…;HTTPS返回200;SAN包含 DNS:example.com、DNS:*.example.com;Verify return code为0;Protocol为TLSv1.2或TLSv1.3;checkend 2592000 输出证书未过期(30天内不过期)。若 Verify return code 非0,按第6节查链。再用 nmap –script ssl-enum-ciphers -p 443 example.com 检查是否仍开放TLS1.0/1.1。监控项:证书到期时间、acme.sh续期日志、Nginx reload结果、443端口探测。Let’s Encrypt 90天周期下,建议每天跑 ~/.acme.sh/acme.sh –cron,并把 –reloadcmd 写成 systemctl reload nginx;商业CA最长200天也要提前30天续期。最后在小程序开发者工具和真机各请求一次API,确认没有 request:fail;APP用旧版本和新版本各测一次证书固定。
常见问题
以下问题覆盖通配符证书、小程序、续期和排错高频点。上线前建议固定执行 openssl x509 -checkend 2592000 与 acme.sh –cron,避免证书过期和链缺失。
通配符证书能覆盖 a.b.example.com 吗?
不能。*.example.com 只覆盖一级子域,如 api.example.com;a.b.example.com 属于二级子域,需要单独申请 *.b.example.com 或把该域名加入多域名SAN。Nginx 的 server_name *.example.com 同样只匹配一级,不要误以为证书和配置能自动覆盖多级。
微信小程序后台能填 *.example.com 吗?
不能。小程序服务器域名要填具体域名,如 https://api.example.com,并完成ICP备案;证书可以用通配符证书覆盖这个具体子域。小程序侧还要求TLS 1.2+、证书链完整、不能自签,后台合法域名不能用IP或localhost。
Let’s Encrypt通配符证书有效期多久?
90天。公共信任TLS证书自2026-03-15起单张最长200天,此前为398天,原文“默认一年”已过时。acme.sh会写入cron每日执行 –cron,通常在到期前30天续期;续期后必须reload Nginx,否则进程仍使用旧证书。
已经有HTTP 301,为什么小程序仍握手失败?
301只解决HTTP跳转,握手失败要查TLS版本、fullchain中间CA、SNI与SAN、443安全组、证书是否过期、域名备案和合法域名配置。用 openssl s_client -connect api.example.com:443 -servername api.example.com 看 Verify return code 和 Protocol。
OV/EV证书比DV更适合小程序吗?
小程序主要校验证书链和HTTPS,DV足够。OV审核企业身份,EV审核更严,但Chrome 77后主流浏览器已不再在地址栏显示EV公司名;没有采购合规要求时,不必为EV溢价。
证书更新后APP仍报SSLHandshakeException怎么办?
先确认新证书SAN包含APP访问域名、fullchain完整、私钥匹配、TLS1.2+;再查APP是否做证书固定(pinning)且未预留新证书、CDN是否仍回旧证书、Android系统时间是否错误。用 openssl s_client 复测,并让旧版本和新版本各跑一次握手。