通配符 SSL 证书实战:HTTPS 泛解析、小程序与 APP 证书配置指南
一、问题背景与根因:泛解析不等于证书泛解析
很多站点把 DNS 泛解析 *.example.com 指向同一台服务器后,就认为 HTTPS 已经覆盖所有子域,实际并非如此。DNS 泛解析解决的是“域名解析到哪台机器”,SSL/TLS 证书解决的是“浏览器或客户端是否信任当前域名”。证书的匹配范围由 SAN 决定:*.example.com 只匹配一层子域,如 www.example.com、api.example.com,不匹配裸域 example.com,也不匹配 a.b.example.com。微信小程序、APP 后端、H5 下载页强制 HTTPS 后,常见故障集中在证书链不完整、TLS 版本过低、443 安全组未开放、HTTP 未 301 到 HTTPS,以及把“通配符”误当成“无限层级”。当前公共信任 TLS 证书有效期也要按新规理解:2020-09 至 2026-03-14 上限为 398 天,2026-03-15 起新签发公共信任 TLS 证书上限缩短为 200 天;Let’s Encrypt 仍为 90 天。不要再宣传“默认一年”。排查时先执行 curl -I http://example.com 看是否 301,再执行 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看证书链和 SAN。小程序还要求 HTTPS、TLS 1.2 及以上、已备案域名,不能使用 IP 或 localhost;APP 侧 iOS ATS 与 Android 7+ 系统 CA 信任也要求证书链完整。根因通常不是“证书没买”,而是域名覆盖、验证方式、证书链和协议配置四件事没有对齐。
二、申请前准备:域名、DNS、CSR 与验证方式
申请前先确认三件事:域名管理权限、服务器环境、验证方式。通配符证书必须使用 DNS-01 验证,因为 CA 需要验证你对 *.example.com 的控制权,典型记录名为 _acme-challenge.example.com,类型 TXT。单域名证书可用 HTTP-01,但 80 端口必须可达且不能强制跳转导致验证文件被 301。准备 CSR 时可自己生成私钥,私钥不要上传给任何人:openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/O=Example/CN=*.example.com'。检查 CSR:openssl req -in example.com.csr -noout -subject -text | grep -A1 'Subject Alternative Name'。DNS 验证前用 dig TXT _acme-challenge.example.com +short 或 nslookup -type=TXT _acme-challenge.example.com 确认传播。服务器侧要记录操作系统和 Web 软件版本,例如 nginx -v、httpd -v、java -version;云主机安全组放行 80 和 443,firewall-cmd --add-service=https --permanent && firewall-cmd --reload 或 ufw allow 443/tcp。小程序和 APP 使用的域名建议完成备案,并提前在微信公众平台配置 request 合法域名。商业证书还要准备组织信息做 OV/EV 审核;DV 只验证域名控制权,几分钟可签发。把域名、TXT 记录、CSR、私钥、fullchain 证书分目录保存,后续配置和续期都依赖这套文件。
三、完整实操:用 Certbot 签发通配符证书并自动续期
以 Let’s Encrypt 为例,手动 DNS-01 可先验证流程:certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com。终端会给出 TXT 值,到 DNS 服务商添加 _acme-challenge.example.com,等待生效后用 dig TXT _acme-challenge.example.com +short 核对,再回车继续。成功后证书在 /etc/letsencrypt/live/example.com/fullchain.pem,私钥在 /etc/letsencrypt/live/example.com/privkey.pem。手动模式不适合长期自动续期,生产环境应使用 DNS API 插件,例如 Cloudflare:先写 /root/.secrets/cloudflare.ini,内容为 dns_cloudflare_api_token = 你的Token,执行 chmod 600 /root/.secrets/cloudflare.ini,再运行 certbot certonly --dns-cloudflare --dns-cloudflare-credentials /root/.secrets/cloudflare.ini -d '*.example.com' -d example.com。续期测试必须执行 certbot renew --dry-run;生产可用 systemctl list-timers | grep certbot 检查定时器,或写 cron:0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'。商业证书流程是提交 CSR、完成 DNS TXT 或文件验证、CA 审核后下载 fullchain。注意有效期:Let’s Encrypt 为 90 天;公共信任 TLS 证书 2026-03-15 起最长 200 天,历史 398 天上限已不适用于新签发。续期后必须 reload Web 服务,否则仍在用旧证书。
四、配置示例:Nginx、Apache、Tomcat、IIS 与 HTTP 301
Nginx 最小可用配置如下:server { listen 80; server_name example.com *.example.com; return 301 https://$host$request_uri; },HTTPS 段写 listen 443 ssl http2; ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers HIGH:!aNULL:!MD5; add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;,执行 nginx -t && systemctl reload nginx。Apache 在 443 VirtualHost 中设置 SSLEngine on、SSLCertificateFile /path/fullchain.pem、SSLCertificateKeyFile /path/privkey.pem,80 段用 Redirect permanent / https://example.com/。Tomcat 先把 PEM 转 PKCS12:openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -out example.p12 -name tomcat,再在 server.xml 配置 Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true' keystoreFile='/path/example.p12' keystoreType='PKCS12' keystorePass='你的密码'。IIS 导入包含私钥的 PFX,站点绑定 443 并勾选 SNI,HTTP 绑定保留 80 做 301。关键点:Nginx 必须用 fullchain 而不是只配站点证书;Tomcat 的别名和密码要一致;IIS 的 PFX 要包含中间证书;所有 80 跳转不要影响 ACME HTTP-01 验证。配置完成后先在本机 curl -k -I https://127.0.0.1 -H 'Host: example.com' 排除后端问题,再走公网验证。
五、证书类型与选型对比表:DV、OV、EV 与单域名、多域名、通配符
选型先看覆盖范围,再看验证等级。通配符证书适合 SaaS 多子域、小程序 API 网关、APP 下载站;但 *.example.com 不覆盖 example.com,申请时用 -d example.com -d '*.example.com' 同时加入 SAN。多级子域 a.b.example.com 需要单独证书或 *.b.example.com。DV 只验证域名控制权,适合个人站、小程序、APP 后端和测试环境;OV 验证企业身份,适合企业门户;EV 曾用于浏览器地址栏显示公司名,现代浏览器已取消 EV 绿色公司名展示,更多用于合规和证书详情。有效期不要写“一年”:2026-03-15 起公共信任 TLS 证书上限 200 天,2020-2026 曾为 398 天,Let’s Encrypt 90 天。表格如下:
| 维度 | DV | OV | EV |
|---|---|---|---|
| 验证内容 | 域名控制权 DNS/HTTP | 组织信息+域名 | 组织信息+扩展验证 |
| 签发时间 | 分钟级 | 1-5 工作日 | 3-7 工作日 |
| 浏览器展示 | 锁标 | 锁标 | 现代浏览器不显示公司名 |
| 适用场景 | 小程序/APP/个人站 | 企业门户 | 金融/电商强合规 |
| 有效期 | LE 90 天;公共信任证书≤200 天 | 同上 | 同上 |
覆盖类型对比:单域名只保护一个 FQDN;多域名 SAN 可放多个不同域名;通配符保护一层子域。小程序和 APP 的 HTTPS 后端用 DV 足够,不必为“小程序证书”购买所谓专用证书;关键是证书链、TLS 1.2+、域名备案和后台合法域名配置。OV/EV 不是技术必需,而是身份合规需求。
六、常见错误排查:真实报错与修复
第一类报错是私钥不匹配:nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。用 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5 比对,两个 MD5 必须一致。第二类是缺中间证书:curl: (60) SSL certificate problem: unable to get local issuer certificate,Nginx 的 ssl_certificate 要指向 fullchain.pem,而不是只含叶子证书的 cert.pem。第三类是域名不匹配:浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,检查 openssl x509 -in fullchain.pem -noout -ext subjectAltName,确认裸域和多级子域是否在 SAN 中。第四类是协议不兼容:SSL_ERROR_NO_CYPHER_OVERLAP 或 sslv3 alert handshake failure,启用 TLSv1.2 TLSv1.3,不要只开 TLSv1.0/1.1。第五类是 ACME 验证失败:DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com 说明 TXT 记录名或值错误,用 dig TXT _acme-challenge.example.com +short 复核;HTTP-01 出现 403 要检查 80 端口、安全组和 301 跳转。第六类是小程序报 request:fail url not in domain list,需在微信后台配置 HTTPS 合法域名,不能使用 IP、localhost 或未备案域名。第七类是 443 不通,curl: (7) Failed to connect 时检查 ss -lntp | grep ':443' 和云安全组。逐项排除即可定位。
七、效果验证:curl、openssl、浏览器与小程序/APP 联调
配置完成后按层验证。第一层 HTTP 跳转:curl -I http://example.com 应返回 301 Moved Permanently 且 Location 为 https://example.com/。第二层 HTTPS 状态:curl -I https://example.com 返回 200;curl -v https://example.com 查看证书链和 TLS 版本。第三层证书链:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,输出中应看到 Verify return code: 0 (ok),并包含中间证书。第四层 SAN 与有效期:openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -subject -dates -ext subjectAltName,确认 DNS:example.com, DNS:*.example.com 和到期时间。第五层通配符边界:curl -I https://api.example.com 应成功,curl -I https://a.b.example.com 应失败,这是预期,不是配置错误。第六层协议:curl --tlsv1.2 -I https://example.com 应成功,openssl s_client -tls1_1 -connect example.com:443 应失败。第七层端口与安全组:ss -lntp | grep ':443'、nmap -p 443 example.com。小程序开发者工具可临时勾选“不校验合法域名”调试,但真机必须使用已配置的 HTTPS 合法域名;APP 用 OkHttp 或 NSURLSession 请求同一接口,iOS 检查 ATS,Android 7+ 检查系统 CA。最后用 certbot renew --dry-run 和 systemctl reload nginx 验证续期链路。
常见问题
通配符证书能覆盖 example.com 和 a.b.example.com 吗?
不能。*.example.com 只匹配一层子域,如 www.example.com;裸域 example.com 需要额外加入 SAN,多级 a.b.example.com 需要单独证书或 *.b.example.com。申请时用 -d example.com -d '*.example.com' 可同时覆盖裸域和一层子域。
小程序必须购买通配符证书吗?
不必须。微信小程序要求 HTTPS、TLS 1.2 及以上、已备案域名,不能使用 IP 或 localhost,并在后台配置 request 合法域名;DV 单域名或多域名证书即可满足,关键是证书链完整、443 可达和域名匹配。
证书有效期到底多久?
不要再写“一年”。2026-03-15 起新签发公共信任 TLS 证书最长 200 天;2020-09 至 2026-03-14 曾为 398 天;Let’s Encrypt 为 90 天。商业证书按 CA 实际签发有效期为准,建议开启自动续期并配置 reload。
DNS 泛解析已开,为什么还报证书错误?
DNS 泛解析只负责解析,证书泛解析由 SAN 决定。检查证书是否包含 *.example.com、是否漏了裸域、是否访问了多级子域,以及 Nginx 是否使用 fullchain.pem;缺中间证书会报 unable to get local issuer certificate。
HTTP 301 后小程序仍失败怎么办?
小程序直接访问 HTTPS,301 不能替代证书链。检查 fullchain、TLS 1.2+、443 安全组、域名备案和微信后台合法域名;用 openssl s_client -connect example.com:443 -servername example.com 看 Verify return code 是否为 0。
OV 或 EV 证书是否必要?
小程序、APP 后端和普通企业站用 DV 足够;OV/EV 主要用于企业身份审核和合规场景。现代浏览器已不再在地址栏展示 EV 公司名,EV 不等于“更安全的技术加密”,TLS 强度取决于协议、套件和证书链配置。