HTTPS 全站部署实战:一次通过 Apple ATS 检测与微信小程序校验(Nginx/Apache/IIS)
一、问题背景与根因:ATS 与小程序到底卡在哪一步
Apple 从 iOS 9 引入 App Transport Security(ATS),并从 2017 年 1 月起要求 App Store 上架应用默认使用 HTTPS。ATS 的核心在于一组硬性约束,而非仅仅要求“有证书就行”:TLS 版本 ≥ 1.2、必须支持前向保密(ECDHE)、叶子证书签名算法为 SHA-256 及以上、RSA 密钥 ≥ 2048 位或 ECC 曲线 ≥ P-256。任何一条不满足,App 端就会收到 NSURLErrorDomain -1022(The resource could not be loaded because the App Transport Security policy requires the use of a secure connection)。
微信小程序的要求同样刚性:wx.request 只允许 https,域名必须完成 ICP 备案、不能使用 IP、必须是 443 端口、TLS ≥ 1.2,并且证书链必须完整下发。线上最典型的故障是“iOS 正常、Android 报错”,根因基本都是服务器只下发了叶子证书,没有下发中间证书;Android 的信任库不会自动补链,iOS 却会尝试 AIA 拉取。
搜索权重方面,Google 自 2014 年起把 HTTPS 作为排名信号,百度也在 2015 年公开表示对 HTTPS 站点优先对待,但这些都属于“加分项”,真正拖后腿的是三类根因:① 混合内容——页面是 HTTPS,图片/JS/CSS 仍走 http,浏览器判定为不安全;② 证书链不完整或未配置 SNI,导致多站点共用 IP 时返回错误证书;③ 仍在启用 TLS 1.0/1.1 或使用 RSA 密钥交换套件,使 ATS 与小程序的 TLS 1.2 握手直接失败。下面按“生成 → 部署 → 配置 → 排错 → 验证”的顺序给出可直接执行的方案。
二、证书选型与有效期红线:398 天、90 天与 47 天时间表
选型只需回答三个问题:验证级别(DV/OV/EV)、覆盖域名数量(单域名/通配符/多域名 SAN)、密钥算法(RSA 2048/4096 或 ECC P-256)。对绝大多数站点,DV + ECC P-256 是性价比最高的组合:握手更快、可启用 TLS 1.3 的 ECDSA 套件、价格最低,且完全满足 ATS 与小程序要求。
有效期是最容易过时的一点:自 2020 年 9 月 1 日起,所有公开信任 CA 签发的 SSL/TLS 证书最长有效期不得超过 398 天(Apple、Chrome、Firefox 共同执行)。市面上所谓“买 3 年证书”,实际是 3 年内分多次签发,你仍然需要大约每 13 个月更换一次。Let’s Encrypt 免费证书有效期为 90 天,官方建议在剩余 30 天时自动续期。CA/Browser Forum 已通过分阶段缩短方案:公有证书最长有效期将在 2026 年 3 月降至 200 天、2027 年 3 月降至 100 天、2029 年 3 月降至 47 天——手工换证书已不可持续,必须上 ACME 自动化。
# Let's Encrypt + certbot 一键签发并自动改写 Nginx 配置
certbot --nginx -d example.com -d www.example.com --agree-tos -m ops@example.com --redirect
# 演练续期(不真正写入磁盘),用于验证定时任务是否可用
certbot renew --dry-run
# 确认 systemd timer 已生效
systemctl list-timers | grep certbot
另外两点容易踩坑:其一,EV 证书早已不再在主流浏览器地址栏显示绿色公司名,为“绿条”买 EV 已无意义,OV/EV 的价值在于组织身份核验与合规审计;其二,OCSP 与 CRL 的可用性会影响首屏握手耗时,建议开启 OCSP Stapling,避免客户端回源查询 CA。
三、实操第一步:生成私钥与 CSR(命令可直接执行)
无论最终用哪家 CA,第一步都是本地生成私钥与 CSR。私钥必须留在服务器上,绝不外发;CSR 只包含公钥与主体信息。下面同时给出 RSA 与 ECC 两种写法,二选一即可(ECC 需 CA 支持,主流 CA 均已支持)。
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
# 方案 A:RSA 2048(兼容性最好,ATS 最低要求)
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
# 方案 B:ECC P-256(握手更快,推荐)
openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key
# 生成 CSR:CN 必须与主域名一致,多域名写进 SAN
openssl req -new -sha256 -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com'
# 校验 CSR 内容,重点看 Public Key Algorithm 与 Signature Algorithm
openssl req -in example.com.csr -noout -text | head -20
如果证书需要覆盖多个域名,CSR 阶段就要把 SAN 写全,否则签发出来的证书不含该域名,浏览器会报 NET::ERR_CERT_COMMON_NAME_INVALID。现代 CA 通常允许在提交订单时另行填写 SAN,但校验 CSR 仍然必要:
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
证书签发下来后,务必先做两件事:一是核对私钥与证书是否配对(不配对会导致 Nginx 启动直接失败),二是确认 fullchain.pem 里是“叶子证书 + 中间证书”的完整链,且叶子证书排在最前。
# RSA 证书与私钥匹配校验:两个 md5 必须一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECC 证书的等价写法
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
# 数一数链里有几张证书,正常应 ≥ 2
grep -c 'BEGIN CERTIFICATE' fullchain.pem
四、Nginx 配置示例:TLS 1.2/1.3 + HSTS + OCSP Stapling
下面是经过 ATS 与小程序验证的最小可用配置。要点:ssl_certificate 指向含中间证书的 fullchain;只开 TLS 1.2 与 1.3;套件全部为 ECDHE(前向保密);关闭 session tickets;开启 OCSP Stapling 并指定 ssl_trusted_certificate;HTTP 强制 301 到 HTTPS。
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1 及以上写法;旧版用 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 叶子 + 中间证书
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 仅中间证书,用于 OCSP 校验
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_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 119.29.29.29 valid=300s;
resolver_timeout 5s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options 'nosniff' always;
location / {
root /var/www/example;
index index.html;
}
}
注意 ssl_prefer_server_ciphers off 是刻意设置的:现代客户端优先选择自己偏好的 AEAD 套件,服务端强制排序反而降低性能。修改后先 nginx -t 检查语法,再 nginx -s reload 平滑生效,不会断开存量连接。
nginx -t && nginx -s reload
若站点还没准备好在全站启用 HSTS,请先用 max-age=300 小步试跑,确认所有子域都已支持 HTTPS 后再改成 31536000 并考虑提交 preload 列表——HSTS 一旦下发,浏览器在 max-age 内不允许用户点击“继续访问”。
五、Apache 与 IIS 配置示例(含 ATS 必需项)
Apache httpd 2.4.8 及以上版本可以把中间证书直接拼进 SSLCertificateFile,此时无需再写 SSLCertificateChainFile;老版本必须单独指定。协议用 -all +TLSv1.2 +TLSv1.3 的白名单写法,避免残留 SSLv3/TLSv1.0。
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache < 2.4.8 需要单独指定中间证书
# SSLCertificateChainFile /etc/httpd/ssl/chain.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLUseStapling on
SSLStaplingCache 'shmcb:/var/run/ocsp(128000)'
Header always set Strict-Transport-Security 'max-age=31536000; includeSubDomains'
</VirtualHost>
IIS 的流程不同:证书以 PFX 形式导入,绑定 443 时必须勾选 SNI(多站点共用 IP 时不勾选会把默认站点证书返回给所有域名,这是“小程序报错但浏览器正常”的高频原因)。协议与套件需要改注册表,推荐用 IISCrypto 工具操作:勾选 TLS 1.2、TLS 1.3(Windows Server 2022 及以上),取消 SSL 2.0/3.0、TLS 1.0/1.1,取消 3DES 与 RC4。改完必须重启服务器,仅重启 IIS 不生效。
# 导入 PFX(需输入导出时设置的密码)
Import-PfxCertificate -FilePath C:certexample.pfx `
-CertStoreLocation Cert:LocalMachineMy `
-Password (ConvertTo-SecureString -String 'YourPfxPassword' -AsPlainText -Force)
# 检查已安装证书的指纹与有效期
Get-ChildItem Cert:LocalMachineMy | Format-Table Subject, NotAfter, Thumbprint
六、对比表格:服务器配置项、ATS 要求、证书类型
下表把三台主流服务器的同类配置项对齐,迁移或排错时可直接按行比对,避免漏项。
| 配置项 | Nginx | Apache httpd | IIS |
|---|---|---|---|
| 证书文件 | ssl_certificate(叶子+中间合并) | SSLCertificateFile(2.4.8+ 可合并) | PFX 导入到“本地计算机个人” |
| 私钥 | ssl_certificate_key | SSLCertificateKeyFile | 与证书同在 PFX 中 |
| 协议控制 | ssl_protocols TLSv1.2 TLSv1.3 | SSLProtocol -all +TLSv1.2 +TLSv1.3 | 注册表 / IISCrypto,需重启 |
| 套件控制 | ssl_ciphers | SSLCipherSuite | 注册表 Ciphers 项 |
| SNI | 默认按 server_name 匹配 | 默认启用 | 绑定 443 时需手工勾选 |
| HSTS | add_header Strict-Transport-Security | Header always set | web.config 或出站规则 |
| OCSP Stapling | ssl_stapling on | SSLUseStapling on | 不原生支持 |
ATS 的合规项与常见不达标写法对照如下,这也是 nscurl --ats-diagnostics 逐项打分时依据的规则:
| ATS 要求 | 合规值 | 常见不达标写法 |
|---|---|---|
| TLS 版本 | ≥ TLS 1.2 | 只开 TLS 1.0 / 1.1 |
| 密钥交换 | ECDHE(前向保密) | RSA 密钥交换、DHE-1024 |
| 证书签名算法 | SHA-256 及以上 | SHA-1 |
| RSA 密钥长度 | ≥ 2048 位 | 1024 位 |
| ECC 曲线 | ≥ P-256 | P-192 |
| 证书链 | 下发完整中间证书 | 只发叶子证书 |
| 证书类型 | 典型价格 | 签发时长 | 适用场景 |
|---|---|---|---|
| DV 单域名 | 免费(Let’s Encrypt)~数百元/年 | 分钟级 | 博客、API、测试环境 |
| DV 通配符 | 免费(DNS-01)~千元/年 | 分钟级 | 多子域统一管理 |
| OV | 千元级/年 | 1–3 工作日 | 企业站、小程序后端 |
| EV | 数千元/年 | 3–7 工作日 | 金融、需合规审计 |
七、常见错误排查:真实报错与对应修法
1)Nginx 启动失败:私钥与证书不匹配。报错为 nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。原因是换了证书没换私钥,或 fullchain 顺序写反。用第三节的 modulus/pubkey md5 比对定位,确保叶子证书在第一段。
2)curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate。服务端缺中间证书。把 CA 提供的 chain 内容追加到 fullchain.pem 末尾,用 grep -c 'BEGIN CERTIFICATE' fullchain.pem 确认数量 ≥ 2,reload 后复测。
3)curl 报 curl: (35) error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure。协议或套件不匹配:客户端只支持 TLS 1.0,而服务端只开 1.2/1.3;或客户端为老旧 Java 6/7 只支持 RSA 密钥交换套件。排查时用 openssl s_client -connect example.com:443 -servername example.com -tls1_1 反向确认是否真的禁用了旧协议。
4)微信小程序报 request:fail ssl hand shake error。按顺序查四件事:域名是否已备案并在小程序后台“服务器域名”里配置;是否使用 443 端口;证书链是否完整(Android 尤其敏感);TLS 是否 ≥ 1.2。多数案例是第 3 条。
5)iOS 报 NSURLErrorDomain -1022。ATS 拦截,通常是服务端仍支持 TLS 1.0 优先协商,或使用了非前向保密套件。强制 ssl_protocols TLSv1.2 TLSv1.3 并移除 RSA 密钥交换套件即可。
6)Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID。证书 SAN 不含当前访问域名,典型是 www.example.com 用了只签 example.com 的单域名证书。重新签发并补齐 SAN。
7)Nginx 日志出现 nginx: [warn] "ssl_stapling" ignored, issuer certificate not found。缺少 ssl_trusted_certificate 指向的中间证书文件,补上 chain.pem 并配置可用的 resolver。
8)浏览器控制台 Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure resource 'http://cdn.example.com/a.js'。属于页面资源引用问题,不是证书问题。把资源地址改成协议相对或直接写 https,并在 CSP 中加 upgrade-insecure-requests。
八、效果验证:openssl、nscurl 与真机回归
部署完成后必须做分层验证,只靠浏览器地址栏的小锁是不够的——它既不检查证书链完整性,也不检查协议版本。
# 1. 查看叶子证书的主体、颁发者与有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 数证书链数量,正常应 ≥ 2(叶子 + 中间)
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
# 3. 验证旧协议已禁用:TLS 1.1 应握手失败
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 4. 验证 HSTS 头是否下发
curl -sI https://example.com | grep -i strict-transport-security
# 5. ATS 逐项诊断(macOS 自带,输出每一项的 PASS/FAIL)
nscurl --ats-diagnostics --verbose https://example.com
# 6. 枚举服务端支持的协议与套件
nmap --script ssl-enum-ciphers -p 443 example.com
验证判据:第 1 条输出的 notAfter 与当前时间之差应小于 398 天;第 2 条结果必须 ≥ 2;第 3 条应输出 alert handshake failure 或 no protocols available;第 4 条应看到 max-age=31536000;第 5 条中所有以 ATS 开头的测试项都应为 PASS。
最后是业务侧回归:用 iOS 真机跑一遍核心接口,用微信开发者工具“真机调试”发起一次 wx.request,并在小程序后台确认域名已加入“request 合法域名”。上线后可在 SSL Labs 复测,目标等级 A 及以上;若出现“Chain issues: Incomplete”,回到第 2 条修链。证书到期前 30 天设置监控告警,openssl x509 -checkend 2592000 -noout -in fullchain.pem 返回非 0 时即触发续期。
常见问题
SSL 证书最长有效期到底是多久?
自 2020 年 9 月 1 日起签发的公开信任证书,最长有效期为 398 天;Let’s Encrypt 免费证书为 90 天,建议剩余 30 天时自动续期。CA/Browser Forum 已通过分阶段缩短方案,2026 年 3 月起降至 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天,因此必须使用 ACME 自动化续期。
为什么 iOS 访问正常,Android 和微信小程序却报 ssl hand shake error?
九成是证书链不完整:服务器只下发了叶子证书,没有下发中间证书。iOS 会尝试通过证书里的 AIA 地址自动补链,Android 与小程序不会。把 CA 提供的中间证书追加到 fullchain.pem 并 reload 即可。少数情况是域名未备案或未在小程序后台配置合法域名。
通配符证书能覆盖几级域名?
只能覆盖一级。*.example.com 覆盖 a.example.com、b.example.com,但不覆盖 example.com 本身,也不覆盖 a.b.example.com。需要主域与泛域名同时可用时,应签发“主域名 + 通配符”的组合证书。
全站上了 HTTPS 后,80 端口还需要保留吗?
需要。80 端口承担两件事:把 http 请求 301 跳到 https,以及 Let’s Encrypt http-01 验证。只有在全站启用 HSTS 且已提交 preload 列表、确认无任何 http 依赖后,才可以考虑关闭 80 端口。
更换证书后需要重启 Nginx 吗?
不需要重启,执行 nginx -t && nginx -s reload 平滑生效,不会断开存量连接。注意 reload 后旧 worker 进程仍在处理已有长连接,新连接才会使用新证书;若发现证书没变,等待旧连接自然结束或确认 reload 命令确实执行成功。
Let’s Encrypt 免费证书能通过 Apple ATS 检测和微信小程序校验吗?
可以。ATS 与小程序校验的是协议版本、套件、签名算法和证书链完整性,与证书是否付费无关。只要 TLS ≥ 1.2、使用 ECDHE 套件、SHA-256 签名、链完整、域名已备案,DV 证书同样全部通过。