Sectigo(原 Comodo)SSL 证书申请与 Nginx/Apache 部署实战:兼容 iOS ATS 与微信小程序
一、问题背景与根因:小程序与 iOS 为什么只认“合格”的 HTTPS
微信小程序的网络能力(wx.request、wx.uploadFile、wx.downloadFile)只允许 https://,且必须由公共受信任 CA 签发,自签名证书、私有 CA、过期证书一律拒绝。开发者工具里“不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书”的勾选只对模拟器生效,真机预览和线上版本走的是同一套校验。iOS 侧还有一层 ATS(App Transport Security):要求 TLS 1.2 及以上、启用前向保密的 ECDHE 套件、签名算法 SHA-256 及以上、RSA 密钥不少于 2048 位或 ECC 不少于 256 位。
所以“浏览器能打开”不等于“小程序能用”。线上故障几乎都落在这五类根因:①证书链不完整,服务器只下发了站点证书、漏发中间证书(PC 浏览器会自动补链,iOS/Android 不会);②域名不匹配,证书 SAN 里只有 example.com,而代码请求的是 www.example.com;③协议或套件过旧,服务端还开着 TLS 1.0/1.1 或 RC4/3DES;④证书过期;⑤自签名证书或不被系统信任的 CA。
对应的真实报错:小程序真机 request:fail ssl handshake error;iOS 原生 App NSURLErrorDomain Code=-1200(协议不达标)与 Code=-1202(证书不受信任);Android 7.0 以上 java.security.cert.CertPathValidatorException: Trust anchor for certification path not found。
先跑两条命令,判断是链问题还是域名问题:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://www.example.com
第二条输出 200 0 才算通过;ssl_verify_result 非 0 即证书校验失败。第一条要重点看 subjectAltName 是否同时包含根域与 www。
另外纠正原文一个已过时的事实:Comodo CA 已于 2018 年被 Sectigo 收购,“Comodo SSL 证书”现在实际以 Sectigo 品牌售卖,安装包里常见的中间证书文件名为 SectigoRSADomainValidationSecureServerCA.crt。按旧关键词找教程时,把 Comodo 换成 Sectigo 即可。
二、证书选型:单域名、多域名 SAN 与通配符的边界
原文的 300 元/年、150 元/条/年、800 元/年属于多年前的渠道报价,已不能直接引用,请以 CA 或代理商当期报价为准;但选型逻辑没变,关键是搞清楚 SAN 字段到底覆盖哪些主机名。
| 类型 | 覆盖范围 | 典型 SAN 写法 | 能否覆盖三级域名 | 适用场景 |
|---|---|---|---|---|
| 单域名 DV | 1 个主机名,多数 CA 免费附带 www 变体(共 2 条 SAN) | DNS:example.com, DNS:www.example.com | 否 | 官网、单一 API 入口 |
| 多域名 SAN DV | 一张证书写 N 条主机名,可跨主域 | DNS:example.com, DNS:www.example.com, DNS:wap.example.com, DNS:api.other.com | 可以,逐条列出 | 多业务线共用同一入口 |
| 通配符 DV | *.example.com,只匹配一级子域 | DNS:*.example.com(需根域再追加 DNS:example.com) | 否,api.ccc.example.com 不匹配 | 子域数量多、频繁新增 |
三个高频坑:通配符证书不自动包含根域 example.com,必须额外加一条 SAN,否则 curl 报 no alternative certificate subject name matches;单域名证书要同时覆盖 a.com 与 www.a.com,下单时必须把两条都写进 CSR 的 SAN,只写 CN 无效(现代浏览器只看 SAN);通配符只吃一级,api.ccc.example.com 这种三级必须单独签或写进多域名 SAN。
有效期规则也要更新:CA/Browser Forum 规定公开信任 TLS 证书单张最长 398 天(2020-09-01 起生效),2026-03-15 起分阶段缩短到 200 天,续期会更频繁,务必上自动化。Let’s Encrypt 免费证书固定 90 天,走 ACME 自动续签。签发速度上 DV 只验证域名控制权,通常 5~30 分钟;OV/EV 需企业资质,1~3 个工作日,而小程序与 iOS ATS 并不要求 OV。
拿到证书后核对 SAN:
openssl x509 -in example.com.crt -noout -text | grep -A1 'Subject Alternative Name'
| 方案 | 单张有效期 | 续期方式 | 小程序/iOS 兼容 | 适合 |
|---|---|---|---|---|
| Sectigo DV(原 Comodo) | ≤398 天 | 手动/API | 是 | 商业站点,需要发票与 SLA |
| Let’s Encrypt | 90 天 | ACME 全自动 | 是(链完整即可) | 个人站、容器化环境 |
| 自签名 | 自定义 | — | 否 | 仅内网测试 |
三、实操第一步:生成私钥与 CSR
CSR 只包含公钥与主体信息,不包含私钥;私钥必须留在自己服务器上,绝不能提交给 CA 或代理商。下面命令直接在目标服务器执行,密钥文件权限设 600。
RSA 2048 方案(兼容性最好,老旧 Android 与部分嵌入式客户端也能握手):
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co., Ltd./CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
chmod 600 example.com.key
openssl req -in example.com.csr -noout -subject -verify
-addext 需要 OpenSSL 1.1.1 及以上;若系统自带 1.0.2,请升级或用 CA 后台手工填写 SAN。ECDSA P-256 方案(握手更快、证书更小,iOS 与新版微信内核均支持):
openssl ecparam -name prime256v1 -genkey -noout -out example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj "/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
核对 CSR 里的 SAN 是否正确,避免签出来才发现漏域名:
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
注意事项:CN 最长 64 字符,别把多个域名塞进 CN;-nodes 表示不加密私钥,仅用于无人值守的自动加载场景,若加了密码则 Nginx 每次 reload 都会提示输入;同一张证书不要重复生成多份私钥,续期时应复用原私钥以保证 pinning 与缓存策略稳定;私钥丢失只能重签,没有找回途径,建议离线备份一份并记录指纹 openssl pkey -pubout -in example.com.key | openssl md5。
如果使用 certbot 或 acme.sh 自动化,这一步可跳过,工具会自动生成私钥与 CSR,证书落盘在 /etc/letsencrypt/live/example.com/,其中 fullchain.pem 即下文要用的完整链。
四、实操第二步:完成域名控制权验证
DV 证书只验证“你能否控制这个域名”,三种方式任选其一。推荐 DNS 验证,因为它不受站点防火墙、CDN 回源策略影响,也不会因为 301 跳转失败。
DNS CNAME 验证:CA 会给出形如 _d7f3a1b2.example.com CNAME d7f3a1b2.dc-validator.com 的记录,添加后必须用公共 DNS 交叉验证,别只看本地缓存:
dig +short CNAME _d7f3a1b2.example.com @8.8.8.8
dig +short CNAME _d7f3a1b2.example.com @223.5.5.5
常见失败原因是:记录名多写了根域(填成了 _d7f3a1b2.example.com.example.com)、该子域被 CDN 的“加速”开关接管导致 CNAME 被改写、TTL 设成 3600 以上导致 CA 轮询超时。建议 TTL 设 600 以内,验证通过后再改回。
HTTP 文件验证:把 CA 给的 d7f3a1b2.txt 放到站点根目录的 /.well-known/pki-validation/ 下,必须能直接返回 200,部分 CA 的爬虫不跟随 301/302:
mkdir -p /var/www/html/.well-known/pki-validation
curl -I http://example.com/.well-known/pki-validation/d7f3a1b2.txt
要求状态码 200、Content-Type 为 text/plain、文件内容与 CA 给的完全一致(不要多一个空行或 BOM)。失败常见于 Nginx 的 location ~ /.ht 类规则误拦、WAF 把爬虫 UA 当攻击、以及全站强制 HTTPS 跳转。
邮箱验证:CA 会向 whois 注册邮箱或 admin@example.com、administrator@、webmaster@、hostmaster@、postmaster@ 发确认信。原文“仅支持 admin@ 域名邮箱”的说法不准确,但确实要注意两点:域名开启了 whois 隐私保护会收不到信;企业邮箱把 CA 邮件判为垃圾邮件时,验证会一直挂着。
验证失败的典型报错是 The Certificate Authority failed to verify the domain control 或 DNS record not found,先按上面的 dig / curl 自查,再联系 CA 重试,不要反复提交(部分 CA 有频率限制)。
五、实操第三步:合并证书链并部署到 Nginx / Apache
CA 一般下发两个文件:站点证书 example.com.crt 与中间证书 SectigoRSADomainValidationSecureServerCA.crt。服务器必须把“站点证书 + 中间证书”拼成一个 fullchain 下发,顺序不能反,且绝不能把根证书拼进去(会让部分客户端判定链过长而失败)。
cat example.com.crt SectigoRSADomainValidationSecureServerCA.crt > fullchain.crt
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted SectigoRSADomainValidationSecureServerCA.crt example.com.crt
输出 example.com.crt: OK 才算链正确。Nginx 侧只引用 fullchain:
ssl_certificate /etc/nginx/ssl/fullchain.crt;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
Apache 2.4.8 以上推荐把链合并进 SSLCertificateFile;老版本则单独指定:
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/ca-bundle.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
改完先做语法检查再平滑重载,避免直接 restart 造成连接中断:
nginx -t && systemctl reload nginx
apachectl configtest && systemctl reload httpd
部署后立刻回看链是否真的完整,输出里必须出现 Verify return code: 0 (ok):
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -E 'depth=|Verify return code'
若 depth=0 后直接跳到 verify 而没有 depth=1,说明中间证书没发出去;若出现 verify error:num=21:unable to verify the first certificate,同上,仍是缺链问题。
六、配置示例:一次通过 iOS ATS 与小程序校验的完整参数
ATS 与小程序内核的共同硬要求:TLS 1.2 及以上、ECDHE 前向保密、SHA-256 以上签名、无 RC4/3DES/EXPORT 套件、证书链完整。下面这份 Nginx 配置是经过验证的最小可用集(Nginx 1.25.1 以上用 http2 on;,旧版改为 listen 443 ssl http2;)。
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt;
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: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;
ssl_trusted_certificate /etc/nginx/ssl/chain.crt;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}
几个容易踩的细节:ssl_stapling 依赖 ssl_trusted_certificate 指向完整链文件,缺失会让 OCSP 装订静默失效;HSTS 不要一上来就加 preload,回滚成本极高;ssl_prefer_server_ciphers off 在 TLS 1.3 下更利于客户端选择现代套件。若同时配置了 ECDSA 与 RSA 两张证书,可用 ssl_certificate 写多行分别指向,Nginx 会按客户端能力自动选择。
小程序侧还需在“微信公众平台 → 开发 → 开发设置 → 服务器域名”里把 https://api.example.com 加入 request 合法域名,要求域名已备案、只支持 443 端口、不能填 IP、不能带路径。iOS 原生 App 若仍报 ATS 错误,请检查服务端是否误开了 ssl_dhparam 却用了 1024 位参数,ATS 要求 DH 不少于 2048 位。
七、常见错误排查:真实报错与修复命令
1)curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。把站点证书与中间证书按顺序拼成 fullchain 并在 Nginx/Apache 中引用,Node.js 客户端还需显式设置 ca: fs.readFileSync('chain.crt')。
2)curl: (60) SSL: no alternative certificate subject name matches target host name 'www.example.com':SAN 不含该主机名。重新签发并把 www 与根域都写进 SAN,或让 www 走 301 跳转到根域(但小程序请求的域名必须与证书一致,跳转不能解决校验失败)。
3)小程序真机 request:fail ssl handshake error:依次排查 TLS 版本是否只开了 1.0/1.1、链是否完整、是否用了自签名、同一 IP 上多站点是否漏配 SNI。用 openssl s_client -tls1_1 验证旧协议已关闭,用 -showcerts 验证链深度。
4)iOS NSURLErrorDomain Code=-1200:ATS 协议不达标,通常是服务端仍支持 TLS 1.0 或缺少 ECDHE 套件,按第六节配置即可。Code=-1202 则是证书不受信任,多为缺链或自签名。
5)NET::ERR_CERT_DATE_INVALID:证书过期或服务器/客户端系统时间偏差。398 天有效期下极易忘记续期,建议用 openssl x509 -enddate -noout -in fullchain.crt 加监控告警,提前 30 天续签。
6)SSL_ERROR_NO_CYPHER_OVERLAP:套件无交集,常见于只部署了 ECDSA 证书却遇到只支持 RSA 的旧客户端,或把 ssl_ciphers 收得过窄。保留 ECDHE-RSA-AES128-GCM-SHA256 作为兜底。
7)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 example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两行 md5 必须一致;ECDSA 证书改用 openssl pkey -pubout -in example.com.key | openssl md5 与 openssl x509 -pubkey -noout -in example.com.crt | openssl md5 比对。
八、效果验证:五条命令确认证书真正生效
部署完成后不要只看浏览器绿锁,按下面五步逐层验证,覆盖 DNS、链路、协议、HTTP 与应用层。
① 证书主体、SAN 与有效期:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
② 链完整性,必须看到 Verify return code: 0 (ok):
echo | openssl s_client -connect example.com:443 -servername example.com -verify_return_error 2>&1 | grep -E 'depth=|Verify return code'
③ 协议与套件枚举,确认 TLS 1.0/1.1 已关闭、无 RC4/3DES:
nmap --script ssl-enum-ciphers -p 443 example.com
openssl s_client -connect example.com:443 -tls1_1 </dev/null
④ HTTP 层校验结果,ssl_verify_result 必须为 0:
curl -sSI https://example.com | head -5
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://www.example.com
⑤ 应用层:微信开发者工具关闭“不校验合法域名”后重新编译,用真机预览跑一次 wx.request;iOS App 用 Xcode 真机运行;再用 SSL Labs 或 testssl.sh https://example.com 复核评级,目标是 A 及以上、无 WARN。
自动化巡检可写成脚本挂到监控:证书剩余天数少于 30 天告警,链校验非 0 立即告警。这样 398 天(未来缩短至 200 天)的有效期就不会变成线上事故。
常见问题
Comodo 证书现在还能买到吗?
Comodo CA 已于 2018 年被 Sectigo 收购,现在以 Sectigo 品牌售卖,PositiveSSL、EssentialSSL 等产品线仍在。购买渠道变了,但证书链中间 CA 名称、兼容性与部署方式完全一致,旧教程里出现的 Comodo 字样按 Sectigo 理解即可。
证书最长能用多久?会不会影响小程序?
公开信任的 TLS 证书单张最长 398 天(CA/Browser Forum 自 2020-09-01 起执行),2026-03-15 起分阶段缩短至 200 天;Let’s Encrypt 固定 90 天。有效期长短不影响小程序兼容性,只影响续期频率,建议用 certbot 或 acme.sh 做自动续签并配置到期告警。
单域名证书能不能同时覆盖 a.com 和 www.a.com?
可以,但必须在申请时把两条主机名都写进 CSR 的 SAN(DNS:a.com,DNS:www.a.com),只写 CN 无效。若只签了一条,请求另一条会报 no alternative certificate subject name matches target host name。
通配符证书能覆盖 api.ccc.a.com 这样的三级域名吗?
不能。*.a.com 只匹配一级子域,api.ccc.a.com 需要单独签发,或在下单时作为 SAN 追加到多域名证书中。另外通配符不自动包含根域 a.com,需要额外加一条 SAN。
浏览器能正常访问,为什么小程序仍报 ssl handshake error?
小程序内核的校验比桌面浏览器严格得多:要求完整证书链、TLS 1.2 以上、SNI 正确、无自签名。用 openssl s_client -showcerts 看链深度是否为 1 以上,用 -tls1_1 确认旧协议已关闭,再检查同一 IP 多站点是否漏配 SNI。
免费的 Let’s Encrypt 证书能用于小程序和 iOS 吗?
可以。只要证书未过期、链完整、域名已完成备案并加入小程序的 request 合法域名,就能通过校验。注意 90 天有效期必须自动化续期,且续期后要 reload Nginx 才会加载新证书。