通配符 SSL 证书申请、Nginx 安装与 iOS/微信小程序 HTTPS 防劫持实战
问题背景与根因:通配符 HTTPS 为何仍报错或被劫持
很多站点以为买了通配符 SSL 证书就自动防劫持,实际证书只解决身份认证和传输加密。通配符 *.example.com 只覆盖一级子域名,不覆盖 example.com,也不覆盖 a.b.example.com;如果 SAN 没写根域,访问 https://example.com 会报 NET::ERR_CERT_COMMON_NAME_INVALID。公共可信 TLS 证书最长有效期目前为 398 天,Let’s Encrypt 为 90 天,过期、链不完整、TLS 1.0/1.1 被禁用都会造成 iOS 微信小程序 request:fail ssl hand shake error。防劫持还需强制 HTTPS、HSTS、完整中间证书、CAA 限制签发、CT 监控。检查命令:openssl x509 -noout -text -in fullchain.pem | grep -E ‘Subject:|DNS:|Not After’;openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null。根因通常是证书域名不匹配、证书链缺中间 CA、服务器仍开 HTTP、SNI 未配置、客户端时间错误。证书申请必须验证域名所有权,不是只给域名就能签发;ACME 接口在境外时受网络影响,DNS-01 可降低对 HTTP 端口的依赖。验证通过后通常几分钟到数十分钟颁发,受 DNS 缓存、CA 队列影响,不应承诺固定 10 分钟。理解这些边界后,再按 DNS-01 申请、Nginx 安装、微信后台配置、验证四步走。
申请前准备:域名所有权、CSR 与私钥边界
准备一个可管理 DNS 的域名,例如 example.com,并确认你要覆盖的是一级子域。通配符证书建议 SAN 同时写 DNS:*.example.com 和 DNS:example.com。私钥必须在自己的服务器生成,CSR 只包含公钥和主题信息,不要把私钥发给任何人。OpenSSL 1.1.1+ 可直接加 SAN:
openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key
openssl req -new -sha256 -key example.com.key -subj '/CN=*.example.com' -addext 'subjectAltName=DNS:*.example.com,DNS:example.com' -out example.com.csr
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
openssl pkey -in example.com.key -pubout -outform PEM | sha256sum
openssl req -in example.com.csr -pubkey -noout | sha256sum
两条 sha256sum 应一致,证明私钥与 CSR 匹配。若用商业 CA,提交 CSR 后按 CA 要求做 DNS TXT 或 HTTP 文件验证;DNS TXT 记录名通常为 _acme-challenge.example.com 或 CA 指定主机记录,TTL 建议 60 秒。验证前用 dig 检查:dig +short TXT _acme-challenge.example.com @8.8.8.8。注意:通配符不能覆盖二级子域;若业务有 api.dev.example.com,需要单独加入 SAN 或申请对应通配符。证书最长有效期 398 天,Let’s Encrypt 90 天,必须把续期自动化纳入准备清单。私钥权限 600,Nginx 运行用户需可读时用组权限,不要 chmod 777。CSR 中的 CN 只作兼容,现代客户端看 SAN。准备 CAA 记录可限制哪些 CA 能为域名签发,降低误签发风险。
完整实操:DNS-01 申请通配符证书(acme.sh/Let’s Encrypt)
以 Cloudflare DNS 为例,用 acme.sh 的 DNS-01 自动添加 TXT 记录。DNS-01 不要求 80 端口开放,适合国内服务器和微信小程序域名。安装并申请:
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
export CF_Token='你的Cloudflare_API_Token'
~/.acme.sh/acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --server letsencrypt
~/.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 --list
如果使用阿里云 DNS,安装 acme.sh 后 export Ali_Key 和 Ali_Secret,参数改为 –dns dns_ali;腾讯云 DNSPod 用 DP_Id、DP_Key 和 –dns dns_dp。首次申请会写 _acme-challenge.example.com 的 TXT 记录,等待 DNS 传播后 CA 校验。Let’s Encrypt 证书有效期 90 天,acme.sh 默认 cron 自动续期;用 crontab -l | grep acme.sh 检查。不要手动复制 renew 后的文件,–install-cert 会建立续期后自动部署。商业 CA 的通配符证书同样需要 DNS 验证,颁发时间受人工审核和接口影响,通常验证通过后几分钟到数十分钟,不应承诺固定 10 分钟。申请成功后检查 fullchain 是否包含服务器证书和中间 CA:grep -c ‘BEGIN CERTIFICATE’ /etc/nginx/ssl/example.com.fullchain.pem,通常应大于等于 2。只有叶子证书会导致 Android 旧版本、iOS 微信 WebView 报证书链不完整。不要用 –insecure 绕过校验。DNS API Token 只给最小权限,申请后删除临时 TXT 记录由 acme.sh 自动完成。
安装配置示例:Nginx 强制 HTTPS 与 TLS 加固
Nginx 配置必须同时监听根域和通配符子域,80 端口 301 到 HTTPS,443 使用 fullchain 和私钥。示例:
server {
listen 80;
server_name example.com *.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
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_stapling on;
ssl_stapling_verify on;
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; }
}
检查并重载:nginx -t && systemctl reload nginx。TLS 1.2/1.3 是 iOS ATS 和微信小程序的底线;不要启用 SSLv3、TLS 1.0、TLS 1.1。ssl_ciphers 保留 ECDHE 前向保密套件,RSA 证书和 ECDSA 证书都可兼容。OCSP Stapling 需要 resolver 和完整链,验证:openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -i ‘OCSP Response Status’。HSTS 的 includeSubDomains 要确认所有子域都能 HTTPS,否则会把未支持 HTTPS 的子域锁死;首次上线可先用 max-age=300 观察。若使用 Apache,对应指令是 SSLCertificateFile fullchain、SSLCertificateKeyFile 私钥、SSLProtocol -all +TLSv1.2 +TLSv1.3、Header always set Strict-Transport-Security。配置 CAA 记录可限制签发:在 DNS 添加 CAA 0 issue letsencrypt.org,值按服务商要求加引号。完成后不要只测首页,还要测 API 子域和微信 request 域名。
微信小程序与 iOS 兼容配置要点
微信小程序要求 request 合法域名使用 HTTPS,证书由受信任 CA 签发,TLS 1.2 及以上,证书链完整,域名不能是 IP,且不能带非标准端口(默认 443)。iOS 的 ATS 也要求 TLS 1.2+ 和前向保密套件,自签名证书会触发 NSURLErrorServerCertificateUntrusted。先在微信公众平台开发管理-开发设置-服务器域名中配置 request 合法域名,例如 https://api.example.com,不能填通配符。小程序真机调试时关闭“不校验合法域名”只能用于开发,上线必须校验证书。常见报错 request:fail ssl hand shake error 多数不是证书没买,而是链不完整、TLS 版本过低、SNI 未返回正确证书或系统时间错误。验证命令:
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 -showcerts </dev/null
curl -v --tlsv1.2 https://api.example.com/health
echo | openssl s_client -connect api.example.com:443 -servername api.example.com -status 2>/dev/null | grep -E 'Protocol|Cipher|Verify return code'
Verify return code 必须为 0。iOS 微信内置浏览器还会校验证书有效期和 SAN,通配符 *.example.com 不能用于 example.com 根域,除非 SAN 显式包含。若小程序请求域名是 api.example.com,证书 SAN 必须匹配;若用 *.example.com 则匹配一级 api,但不匹配 api.dev.example.com。国内服务器还需完成 ICP 备案,否则微信侧可能拦截。建议 API 域名单独证书或纳入 SAN,开启 HSTS 后确认微信 WebView 不加载 HTTP 资源,否则混合内容会被拦截。对 iOS 低版本,避免仅启用 TLS 1.3,保留 TLS 1.2。证书最长 398 天、Let’s Encrypt 90 天,到期前 30 天检查续期。真机测试用微信开发者工具真机调试和 iOS Safari 各访问一次。
通配符、多域名与 DV/OV 证书对比表
选型不要只看价格。通配符适合同一主域下大量一级子域,多域名 SAN 适合品牌域名和根域混合,单域名适合独立 API。DV 只验证域名控制权,签发快;OV 验证组织身份,适合对外展示主体;EV 不再让浏览器显示绿色地址栏,但证书主题含组织信息。公共可信 TLS 证书最长有效期 398 天,Let’s Encrypt 90 天,任何声称多年不用换证的公共证书都不符合基线要求。对比如下:
| 维度 | 通配符证书 | 多域名 SAN | 单域名 |
|---|---|---|---|
| 覆盖范围 | *.example.com 一级子域,根域需另加 SAN | 列出的多个域名 | 一个域名 |
| 新增子域 | 无需重签,直接使用 | 需重签或换证 | 需重签 |
| 私钥风险 | 泄露影响全部一级子域 | 按 SAN 范围影响 | 影响单站 |
| 验证方式 | DNS-01 为主 | HTTP-01 或 DNS-01 | HTTP-01 或 DNS-01 |
| 有效期 | 最长 398 天;LE 90 天 | 同左 | 同左 |
| 适用场景 | 多子域 SaaS、小程序 API 集群 | 多品牌、多根域 | 单站点 |
再对比 DV/OV:DV 适合大多数小程序 API 和内部业务,自动化程度高;OV 需要营业执照和组织验证,适合金融、政企门户;EV 不再显示绿色地址栏,不应作为唯一卖点。Let’s Encrypt 免费 90 天,适合自动化;商业 DV 通配符通常 1 年但受 398 天上限约束,实际以 CA 签发为准。若子域跨团队管理,建议按业务拆证书,避免一个私钥泄露导致全部子域被冒充。CAA 记录可限制 CA:CAA 0 issue letsencrypt.org。证书透明日志 CT 可监控异常签发。防劫持组合是:完整链 + TLS 1.2/1.3 + HSTS + 强制跳转 + CAA + 到期监控。不要用通配符覆盖根域而不加 SAN,这是小程序报错的高频原因。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
常见错误排查:真实报错与修复命令
按报错定位比反复重签有效。1)curl: (60) SSL certificate problem: unable to get local issuer certificate:服务器只发了叶子证书,Nginx 的 ssl_certificate 应指向 fullchain.pem,不是 cert.pem;用 openssl s_client -showcerts 看返回证书数量。2)nginx: [emerg] cannot load certificate … PEM lib:文件格式错误或路径不对,file 和 openssl x509 -in 文件 -noout -subject 检查。3)NET::ERR_CERT_COMMON_NAME_INVALID:SAN 不匹配,通配符不覆盖根域和二级子域,openssl x509 -noout -ext subjectAltName -in fullchain.pem。4)微信 request:fail ssl hand shake error:TLS 版本、SNI、链或域名未加入合法域名;用 openssl s_client -servername 域名 -tls1_2 测。5)iOS NSURLErrorServerCertificateUntrusted:自签名或链缺失,ATS 要求可信 CA。6)error:0A000086:SSL routines::certificate verify failed:客户端 CA 存储旧或中间证书缺失。7)nginx: [warn] no ssl_stapling_responder:缺 resolver 或 CA 不支持 OCSP。修复命令:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E 'depth|verify'
openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt /etc/nginx/ssl/example.com.fullchain.pem
nginx -t
curl -Iv https://example.com 2>&1 | grep -E 'SSL certificate|subject|issuer|expire'
若证书与私钥不匹配,用 openssl pkey -in key -pubout 与 openssl x509 -in fullchain -pubkey -noout 对比。若 DNS 验证失败,dig TXT _acme-challenge.example.com 检查是否有多条 TXT 冲突。若续期后仍旧证书,检查 reloadcmd 是否执行、Nginx 是否有多 worker 未重载。若 HSTS 导致子域无法访问,先降 max-age 并确保所有子域有证书。排查时先看服务端 s_client,再看客户端,不要先删证书。
效果验证:从 openssl 到微信开发者工具
验证分四层:证书链、协议套件、HTTP 行为、客户端。服务端命令:
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 -tls1_2 2>/dev/null | grep -E 'Protocol|Cipher|Verify return code'
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -i 'OCSP Response Status'
curl -I http://example.com
curl -I https://example.com
curl -sI https://example.com | grep -i strict-transport-security
期望:Verify return code 为 0;Protocol 为 TLSv1.2 或 TLSv1.3;HTTP 返回 301 到 https;HSTS 头存在;OCSP Response Status 为 successful。再用 SSL Labs 或 testssl.sh 跑评级,testssl.sh –fast https://example.com。微信侧:公众平台配置 request 合法域名后,用微信开发者工具真机调试请求 https://api.example.com/health,关闭“不校验合法域名”再测一次;iOS 真机用 Safari 和微信各打开一次。小程序报错 request:fail 时看开发者工具 Network 的 SSL 详情,确认 SAN、有效期、链。浏览器打开 https://example.com 查看锁标,点击证书看颁发者和有效期。监控方面用 openssl 定时检查到期时间:openssl x509 -checkend 2592000 -noout -in fullchain.pem,返回 0 表示 30 天内不过期。Let’s Encrypt 90 天证书建议 30 天前续期,公共证书最长 398 天也要设到期告警。最后验证 CAA 和 CT:dig CAA example.com,crt.sh 查询域名日志。全部通过再上线。
常见问题
以下问题来自通配符证书申请、Nginx 安装和 iOS 微信小程序联调中最常见的卡点。回答以当前公共 TLS 证书规则为准:公共可信证书最长有效期 398 天,Let’s Encrypt 为 90 天,申请必须验证域名所有权。遇到报错时先保留现场,用 openssl s_client 和 nginx -t 取证,再判断是证书、链、协议还是客户端配置问题。
通配符证书能覆盖根域 example.com 吗?
默认不覆盖。*.example.com 只匹配一级子域,根域必须在 SAN 中显式写入 DNS:example.com,否则浏览器和微信小程序会报证书名称不匹配。申请时用 -d example.com -d ‘*.example.com’ 同时签发,安装后检查 subjectAltName 是否包含两者。
申请证书只提供域名就可以吗?
不可以。必须验证域名所有权,常见方式是 DNS TXT 或 HTTP 文件。DNS-01 可自动添加 _acme-challenge 记录,验证通过后通常几分钟到数十分钟颁发,受 DNS 缓存和 CA 队列影响。ACME 接口在境外时可能受网络影响,拍前联系客服不如先确认 DNS API 权限和验证方式。
Let’s Encrypt 证书有效期是多久?
90 天。公共可信 TLS 证书最长有效期目前为 398 天。应使用 acme.sh 或 certbot 自动续期,并配置续期后 reload Nginx。用 openssl x509 -checkend 2592000 -noout -in fullchain.pem 做 30 天到期检查,返回非 0 就要立即续期。
微信小程序为什么提示 ssl hand shake error?
常见原因是证书链不完整、TLS 低于 1.2、SNI 返回错误证书、域名未加入 request 合法域名或系统时间错误。用 openssl s_client -servername 域名 -tls1_2 检查 Verify return code 是否为 0,并确认 ssl_certificate 指向 fullchain.pem 而不是单张叶子证书。
iOS 微信能使用自签名证书吗?
不能用于正式小程序。iOS ATS 和微信都要求受信任 CA 签发的证书,TLS 1.2 及以上,且证书链完整。自签名会触发 NSURLErrorServerCertificateUntrusted,开发阶段可临时绕过,上线必须换受信任证书并配置合法域名。
如何防止证书被错误签发或劫持?
使用完整链、强制 HTTPS、HSTS、CAA 限制 CA、CT 日志监控、私钥权限 600 和到期告警。通配符私钥泄露影响大,建议按业务拆分证书并限制 DNS API Token 权限。CAA 可写 CAA 0 issue letsencrypt.org,并定期用 crt.sh 检查证书透明日志。