跳到主要内容
HTTPS小程序证书

HTTPS 全站部署实战:一次通过 Apple ATS 检测与微信小程序校验(Nginx/Apache/IIS)

HTTPS 全站部署实战:一次通过 Apple ATS 检测与微信小程序校验(Nginx/Apache/IIS) — 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 证书同样全部通过。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。