HTTPS 通配符证书申请与部署实战:防劫持并兼容 iOS/微信小程序
问题背景与根因:为什么通配符 HTTPS 仍会被劫持
很多站长把“申请 HTTPS 通配符证书”理解为一次性解决域名劫持,实际并非如此。HTTPS 解决的是传输层加密与服务器身份认证:浏览器、iOS App、微信小程序在 TLS 握手时校验证书链、域名匹配、有效期和吊销状态。通配符证书只解决“同一主域名下多个子域名共用一个证书”的部署问题,例如 *.example.com 可覆盖 api.example.com、m.example.com,但不覆盖 example.com 本身,也不覆盖 a.b.example.com。若 DNS 被污染、域名解析被恶意指向、服务器被入侵替换私钥,HTTPS 仍可能被中间人攻击或出现证书告警。原文“拍下域名即可、10 分钟颁发”的说法已不适合作为操作依据:目前公共 CA 签发证书最长有效期不得超过 398 天,Let’s Encrypt 证书有效期为 90 天,且通配符证书必须通过 DNS-01 验证域名控制权。iOS ATS 与微信小程序还要求 TLS 1.2 及以上、受信任 CA、完整证书链和 SNI 正确返回。根因通常集中在四类:证书链缺中间证书、域名覆盖范围写错、DNS 验证记录未生效、服务器仍启用旧协议或弱套件。理解这些边界后,再按后文步骤申请、部署和验证,才能真正降低劫持与兼容性风险。
申请前准备:域名、CSR、私钥与验证方式
先确认证书覆盖范围。若站点为 example.com、www.example.com、api.example.com,建议申请包含 example.com 与 *.example.com 的证书;只申请 *.example.com 时,example.com 不在 SAN 中,访问主域会报证书名称不匹配。通配符只匹配一级子域,*.example.com 不匹配 a.b.example.com。准备一台可执行 OpenSSL 的 Linux 主机,生成 2048 位或 3072 位私钥与 CSR:
mkdir -p /etc/ssl/private/example && cd /etc/ssl/private/example
openssl genrsa -out example.com.key 2048
openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=*.example.com' -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
若使用 ACME 自动签发,可跳过手工 CSR,由 acme.sh 或 certbot 生成密钥。通配符证书必须使用 DNS-01:在 DNS 服务商添加 _acme-challenge.example.com 的 TXT 记录,值由 ACME 客户端输出;等待 TTL 生效后用 dig 验证:
dig +short TXT _acme-challenge.example.com
dig +short TXT _acme-challenge.example.com @8.8.8.8
注意:私钥权限设为 600,CSR 与私钥不要上传到公开仓库;证书申请时填写的域名必须与 CSR/SAN 一致。若使用国内云厂商 DNS,API 密钥只授予 DNS 解析权限,避免泄露主账号 AK/SK。验证通过后再签发,不能仅凭“拍下域名”跳过所有权验证。
完整实操:从 ACME 验证到证书签发
推荐用 acme.sh 管理通配符证书,以阿里云 DNS 为例,先安装并配置环境变量(其他 DNS 服务商替换 dns_ali 为 dns_dgon、dns_cf 等):
curl https://get.acme.sh | sh -s email=admin@example.com
export Ali_Key='你的AccessKeyId'
export Ali_Secret='你的AccessKeySecret'
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength 2048
签发成功后安装到 Nginx 目录,并设置 reload 命令,后续续期自动生效:
mkdir -p /etc/nginx/ssl/example.com
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com/example.com.key --fullchain-file /etc/nginx/ssl/example.com/fullchain.pem --reloadcmd 'nginx -t && systemctl reload nginx'
~/.acme.sh/acme.sh --list
若用 certbot,通配符同样走 DNS 插件,例如 Cloudflare:
certbot certonly --dns-cloudflare --dns-cloudflare-credentials /root/.secrets/cloudflare.ini -d example.com -d '*.example.com' --agree-tos -m admin@example.com
关键参数:–dns 指定验证插件,-d 可重复,通配符必须加单引号防止 shell 展开;–keylength 2048 兼容性最好;–server letsencrypt 明确使用 Let’s Encrypt。公共 CA 证书最长 398 天,Let’s Encrypt 为 90 天,不要相信“一次签发多年有效”。DNS TXT 记录未生效时会出现 DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com,先检查记录名和权威 DNS,再重试。
Nginx 配置示例:通配符证书、HTTP 跳转与完整链
以下配置同时覆盖主域和一级子域,HTTP 强制跳转 HTTPS,并启用 TLS 1.2/1.3。证书文件必须是 fullchain.pem,否则 iOS 与微信小程序可能因缺中间证书报错:
server {
listen 80;
server_name example.com *.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com *.example.com;
ssl_certificate /etc/nginx/ssl/example.com/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com/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;
add_header Strict-Transport-Security max-age=31536000;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}
执行 nginx -t 检查语法,再 systemctl reload nginx。若使用 Apache,对应指令为 SSLCertificateFile fullchain.pem、SSLCertificateKeyFile example.com.key,并确认 LoadModule ssl_module 已启用。不要只配置 ssl_certificate 为域名证书而遗漏中间证书;不要开启 TLSv1.0/1.1;HSTS 首次上线建议先用 max-age=300 观察,确认所有子域均支持 HTTPS 后再提升到一年。配置中的 server_name 必须与证书 SAN 匹配,否则会出现证书名称不匹配告警。
iOS 与微信小程序兼容要点:ATS、TLS 版本与证书链
iOS App 默认受 ATS 约束,要求 HTTPS 使用 TLS 1.2 及以上、前向保密套件、SHA-256 及以上签名算法,并且证书由系统信任的 CA 签发。自签证书、内部 CA、缺中间证书、使用 IP 地址访问都会触发 NSURLErrorDomain -1202 或“此服务器的证书无效”。微信小程序要求请求域名已配置为合法域名,必须使用 HTTPS,证书在有效期内且证书链完整;开发者工具可临时勾选“不校验合法域名”,真机不会绕过校验。排查时先看证书链:
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2
curl -I https://api.example.com/health
输出中 Verify return code 应为 0 (ok),证书链应包含服务器证书和中间 CA。若返回 unable to get local issuer certificate,说明服务器未发送中间证书或客户端 CA 库过旧。iOS 对通配符证书本身没有额外限制,但证书 SAN 必须精确匹配请求域名;微信小程序后台配置的 request 合法域名不能带路径、不能使用 IP、不能使用非标准端口。若使用 CDN,请确认 CDN 回源和边缘节点都部署了 fullchain,且未开启“强制 HTTP/2 到源站”导致旧客户端握手失败。TLS 1.3 与 TLS 1.2 并存即可,不要为了兼容极旧 Android 而降级到 TLS 1.0。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- Wildcard 通配符 SSL 证书安装部署续费申请
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
通配符、单域名与多域名证书对比
选择证书类型时,核心看域名结构和运维成本,而不是只看价格。下表按常见场景对比:
| 类型 | 覆盖范围 | 验证方式 | 适用场景 | 续期与风险 |
|---|---|---|---|---|
| 单域名证书 | 仅一个精确域名,如 api.example.com | HTTP-01 或 DNS-01 | 单一接口、测试环境 | 新增子域需重新签发 |
| 通配符证书 | *.example.com,覆盖一级子域;不含主域和二级子域 | 必须 DNS-01 | 多个一级子域统一部署 | 私钥泄露影响全部子域,需严管权限 |
| 多域名 SAN 证书 | 可列多个精确域名或通配符,如 example.com、*.example.com、*.api.example.com | 按 CA 要求验证每个域名 | 主域+多级子域混合 | SAN 越多管理越复杂 |
| Let’s Encrypt | 支持通配符与多域名 | DNS-01/HTTP-01 | 自动化、成本敏感 | 有效期 90 天,必须自动续期 |
| 商业 CA | 支持 OV/EV 等类型 | 组织验证+域名验证 | 对外品牌、合规场景 | 最长有效期不超过 398 天 |
如果只有 www 和 api 两个子域,单域名或多域名证书更易审计;如果子域数量多且频繁增减,通配符证书能减少配置变更。注意通配符证书不能覆盖 example.com 主域,也不能覆盖 a.b.example.com;需要时把 example.com 和 *.api.example.com 加入 SAN。无论哪种证书,都应启用自动续期和到期监控,避免 90 天证书过期造成小程序请求失败。
常见错误排查:真实报错与处理命令
报错一:浏览器出现 NET::ERR_CERT_COMMON_NAME_INVALID。说明访问域名不在证书 SAN 中,或通配符层级不匹配。执行 openssl x509 -in fullchain.pem -noout -text | grep -A1 ‘Subject Alternative Name’ 查看 SAN,确认是否包含当前域名。报错二:curl: (60) SSL certificate problem: unable to get local issuer certificate。服务器只发送了域名证书,未发送中间 CA。把 CA 提供的中间证书与域名证书按顺序合并为 fullchain.pem,Nginx 的 ssl_certificate 指向 fullchain.pem。报错三:nginx: SSL_CTX_use_PrivateKey() 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 example.com.key | openssl md5 比对,两个 MD5 必须一致。报错四:iOS 返回 NSURLErrorDomain Code=-1202。检查证书是否受信任、是否缺中间证书、是否使用自签证书。报错五:微信小程序 request:fail ssl handshake error。用 openssl s_client -connect 域名:443 -servername 域名 -tls1_2 检查握手,确认 TLS 1.2 可用、证书链完整、域名已加入小程序合法域名。报错六:ACME 返回 DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com。检查 TXT 记录名是否多了域名后缀,等待 TTL 后用 dig @8.8.8.8 验证。处理顺序是:先看 SAN,再看链,再看私钥匹配,最后看协议与客户端配置。
效果验证:证书链、协议、HSTS 与自动续期
部署后不要只看浏览器绿锁,按下面命令逐项验证:
curl -I https://example.com
curl -I http://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts
openssl s_client -connect example.com:443 -servername example.com -tls1_2
openssl x509 -in /etc/nginx/ssl/example.com/fullchain.pem -noout -subject -issuer -dates
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt /etc/nginx/ssl/example.com/fullchain.pem
预期结果:HTTP 返回 301 到 HTTPS;openssl s_client 输出 Verify return code: 0 (ok);证书 notAfter 未过期;SAN 包含 example.com 与 *.example.com;TLS 1.2 握手成功。若使用 HSTS,响应头应包含 strict-transport-security。自动续期方面,acme.sh 默认安装 cron,执行 crontab -l | grep acme.sh 检查;certbot 执行 certbot renew –dry-run 做演练。续期后必须 reload Nginx,否则进程仍加载旧证书。建议增加到期监控:用 openssl s_client 2>/dev/null | openssl x509 -noout -enddate 提取到期时间,剩余 30 天告警。最后用微信开发者工具和 iOS 真机各请求一次接口,确认没有证书告警和握手失败。
常见问题
通配符证书能覆盖主域名 example.com 吗?
不能。*.example.com 只覆盖一级子域,主域需要单独加入 SAN,例如同时申请 example.com 和 *.example.com。
申请通配符证书为什么必须做 DNS 验证?
CA 通过 DNS-01 在 _acme-challenge.example.com 写入 TXT 记录来验证域名控制权,这是通配符证书的强制要求,HTTP-01 不能用于通配符。
证书最长有效期是多久?
公共 CA 签发的 SSL/TLS 证书最长有效期为 398 天;Let’s Encrypt 证书有效期为 90 天,必须配置自动续期。
微信小程序提示 ssl handshake error 怎么处理?
先用 openssl s_client -connect 域名:443 -servername 域名 -tls1_2 检查握手,确认 TLS 1.2 可用、证书链完整、域名已加入小程序合法域名,且未使用自签证书。
iOS 报 -1202 是证书问题吗?
通常是。检查证书是否由受信任 CA 签发、是否缺中间证书、是否使用 IP 访问或自签证书,并确认 ATS 未强制要求不支持的套件。
通配符证书私钥泄露有什么风险?
所有匹配 *.example.com 的子域都可能被冒充,应立即吊销证书、重新生成密钥并签发新证书,同时排查服务器入侵与备份泄露。