Comodo Essential SSL 实战:单域名 DV 证书部署、iOS IPA 在线安装与小程序 HTTPS 配置
一、问题背景:IPA 在线安装与小程序为什么卡在证书上
原文宣称“完美兼容 iOS 任何版本、在线安装 ipa”,其真正的技术含义是:iOS 通过 itms-services 协议安装 IPA 时,会由系统独立的安装进程去校验下载地址的 HTTPS 证书链。根证书缺失、中间证书没下发、域名不匹配、证书过期,任何一环出问题,都会表现为安装弹窗一闪而过或提示“无法安装 App”。同理,微信小程序的 wx.request 强制 HTTPS,且要求 TLS 1.2 及以上、证书由受信任 CA 签发,自签名证书会被直接拒绝。
根因通常不是“没有加密”,而是“加密了但对方不信任”。常见四类:自签名证书;只部署了叶证书、漏掉中间证书;Common Name 与访问域名不一致(现代浏览器只认 SAN 扩展);仍使用已被淘汰的 SHA-1 签名。另外,自 2020 年 9 月起 CA/B 论坛规定公有 TLS 证书最长有效期 398 天,原文“一年期”需按 398 天理解,Let’s Encrypt 则固定 90 天。
# 四类典型报错
curl: (60) SSL certificate problem: unable to get local issuer certificate
Chrome: NET::ERR_CERT_AUTHORITY_INVALID
iOS: 无法安装“XXX”,请稍后重试
小程序: request:fail ssl hand shake error
彻底解决只需一条完整且受信任的证书链:叶证书 + 中间证书 + 受信任根证书,签名算法 SHA-256。
二、证书选型:Comodo Essential SSL 的现状与关键参数
Comodo CA 已于 2018 年更名为 Sectigo,市面上“Comodo Essential SSL”现在多以 Sectigo Essential SSL / PositiveSSL 名义签发,链到 USERTrust RSA 或 Sectigo Public Server Authentication Root R46,iOS、Android、Chrome、Firefox、Safari 均内置信任。
- 验证级别:DV(域名验证),只校验域名控制权,通常 5–15 分钟签发;
- 覆盖范围:单域名 example.com,部分产品可免费追加 www 作为 SAN,下单前确认;
- 签名算法:SHA-256;SHA-1 已被主流浏览器全面拒绝;
- 密钥与加密:RSA 2048/4096 或 ECDSA P-256,所谓“256 位加密”指握手协商出的 AES-256-GCM 对称加密,不是证书密钥长度;
- 有效期:受 CA/B 规则限制最长 398 天,到期必须重签;
- 重签与绑定:DV 证书有效期内可免费重签,不绑定服务器和 IP,原文这点是正确的;
- 共享 IP:虚拟主机普遍支持 SNI,共享 IP 也能装证书,原文“共享 IP 一般不支持”已过时。
个人站、测试环境或小程序后端,Let’s Encrypt(90 天,certbot 自动续期)完全够用;需要 398 天少运维、或客户指定商业 CA 品牌时,再选 Sectigo 单域名 DV。
三、实操:生成私钥与 CSR 并提交签发
推荐在服务器本地生成密钥对,只把 CSR 交给 CA,私钥永不出服务器。
# 1. 生成 2048 位 RSA 私钥 + 带 SAN 的 CSR(一条命令)
openssl req -new -newkey rsa:2048 -nodes
-keyout /etc/ssl/private/example.com.key
-out /etc/ssl/csr/example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 2. 校验 CSR 中的 SAN 是否包含全部域名
openssl req -in /etc/ssl/csr/example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
# 3. 校验私钥与 CSR 配对(两条 md5 输出必须一致)
openssl rsa -noout -modulus -in /etc/ssl/private/example.com.key | openssl md5
openssl req -noout -modulus -in /etc/ssl/csr/example.com.csr | openssl md5
chmod 600 /etc/ssl/private/example.com.key
提交 CSR 后完成域名验证(DNS TXT 或 HTTP 文件)。你会拿到 example.com.crt(叶证书)与 intermediate.crt(中间证书),务必拼接并验证:
cat example.com.crt intermediate.crt > fullchain.crt
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK
若用 Let’s Encrypt 可跳过手工流程:certbot --nginx -d example.com -d www.example.com,再用 certbot renew --dry-run 验证自动续期。
四、Nginx 配置示例:TLS 1.2/1.3、HSTS 与 OCSP Stapling
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/ssl/certs/fullchain.crt; # 必须含中间证书
ssl_certificate_key /etc/ssl/private/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_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/ssl/certs/fullchain.crt;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}
要点:ssl_certificate 必须指向 fullchain,只配叶证书就会出现 unable to get local issuer certificate;ssl_protocols 不要保留 TLSv1/TLSv1.1,iOS ATS 与小程序都要求 TLS 1.2+;HSTS 首次上线先用 max-age=300 试跑,确认全站 HTTPS 后再调大。改完执行 nginx -t && nginx -s reload。
五、iOS IPA 在线安装:itms-services 与 plist 配置
iOS 7.1 之后 OTA 安装必须走 HTTPS,且 manifest.plist 与 ipa 都要能被 Safari 直接访问,MIME 类型必须正确。
location /ipa/ {
default_type application/octet-stream;
}
location = /ipa/manifest.plist {
default_type application/x-plist;
}
manifest.plist 最小示例:
<?xml version='1.0' encoding='UTF-8'?>
<plist version='1.0'><dict>
<key>items</key><array><dict>
<key>assets</key><array>
<dict><key>kind</key><string>software-package</string>
<key>url</key><string>https://app.example.com/ipa/app.ipa</string></dict>
</array>
<key>metadata</key><dict>
<key>bundle-identifier</key><string>com.example.app</string>
<key>bundle-version</key><string>1.0.0</string>
<key>title</key><string>Example</string>
</dict>
</dict></array>
</dict></plist>
安装页放链接:<a href='itms-services://?action=download-manifest&url=https://app.example.com/ipa/manifest.plist'>安装</a>。三个坑:plist 的 MIME 必须是 application/x-plist,否则提示“无法安装”;manifest 里的 url 必须是完整 https 地址;ipa 必须用企业证书或含设备 UDID 的 Ad Hoc 描述文件签名,否则证书再正确也装不上。
六、证书方案对比:Let’s Encrypt、Sectigo DV、OV 与自签名
| 方案 | 验证方式 | 有效期 | iOS/小程序信任 | 适用场景 |
|---|---|---|---|---|
| 自签名证书 | 无 | 自定 | 否 | 仅内网测试 |
| Let’s Encrypt DV | 域名 / DNS | 90 天,可自动续期 | 是 | 个人站、API、测试环境 |
| Sectigo(原 Comodo)Essential SSL | DV | 最长 398 天 | 是 | 单域名官网、小程序后端 |
| OV 单域名 | 域名 + 企业资料 | 最长 398 天 | 是 | 需展示企业身份 |
| DV 通配符 | DNS | 最长 398 天 | 是 | app.、api. 等多子域 |
选型建议:只有 1 个域名且能接受自动续期,选 Let’s Encrypt;要 398 天少运维、或客户指定商业品牌,选 Sectigo DV;有 app.example.com、api.example.com 多个子域,直接上通配符,比逐张单域名更省事。EV 证书的绿色地址栏已被主流浏览器取消,不必为“显示公司名”多付费。
七、常见错误排查:从真实报错到修复命令
| 报错 / 现象 | 根因 | 修复动作 |
|---|---|---|
curl: (60) unable to get local issuer certificate |
未下发中间证书 | ssl_certificate 改配 fullchain.crt |
NET::ERR_CERT_COMMON_NAME_INVALID |
SAN 不含当前域名 | 重签 CSR,-addext 补齐 SAN |
NET::ERR_CERT_DATE_INVALID |
证书过期或服务器时间错误 | 校时 + 续签,检查 -dates |
SSL_CTX_use_PrivateKey: key values mismatch |
私钥与证书不配对 | 比对 modulus md5 后重新部署 |
| iOS 提示“无法安装 App” | plist MIME 错误或 ipa 未含 UDID | 改 application/x-plist,重签 ipa |
小程序 request:fail ssl hand shake error |
仍开放 TLS 1.0/1.1 或证书链不全 | 只留 TLSv1.2/1.3,配 fullchain |
# 一次性定位:看服务端下发的证书链与校验结果
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code'
# Verify return code: 0 (ok) 才算链路完整
排查顺序固定为:链 → 域名 → 时间 → 协议版本。先用上面两条命令确认服务端行为,再查 Nginx error.log 中的 SSL_CTX_use_PrivateKey 与 no shared cipher 关键字,比反复重装证书快得多。
八、效果验证:五条命令确认证书真的生效
# 1. 查看有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -subject -ext subjectAltName
# 2. 确认 HTTP 已 301 到 HTTPS,且 HSTS 已下发
curl -sI http://example.com | head -n 5
curl -sI https://example.com | grep -i strict-transport-security
# 3. 确认 TLS 1.1 已被拒绝
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 4. 证书 30 天内是否过期(返回 0 表示仍安全)
openssl x509 -checkend 2592000 -noout -in fullchain.crt
接着用 SSL Labs(ssllabs.com/ssltest)跑分级,目标 A 以上;iOS 真机用 Safari 打开安装页实测一次完整安装;小程序在开发者工具“详情 → 本地设置”关闭“不校验合法域名”后请求真实接口。三项都通过,才算证书真正落地,而不只是 Nginx 里多了一行配置。
常见问题
Comodo Essential SSL 还能买吗?和 Sectigo 是什么关系?
能买,但品牌已更名。Comodo CA 于 2018 年更名为 Sectigo,原 Essential SSL 产品线现在以 Sectigo Essential SSL / PositiveSSL 名义签发,根证书为 USERTrust 或 Sectigo,iOS、Android、Chrome、Firefox、Safari 均预置信任,功能与旧名一致。
证书有效期到底是一年还是 398 天?
公有 TLS 证书自 2020 年 9 月起最长 398 天,商业 CA 普遍按 398 天签发,不再有“买一年用一年”的说法;Let’s Encrypt 固定 90 天。因此必须配置到期监控或自动续期,否则会在某天突然全线报错。
共享 IP 的虚拟主机能装 SSL 证书吗?
能。SNI 扩展已全面普及,一台共享 IP 上可承载多个不同域名的证书,浏览器与 iOS、小程序均支持。只有极老的客户端(如 IE8 on XP)不支持 SNI,如今可忽略。
证书配好了,IPA 还是装不上怎么办?
先看 plist 的 MIME 是否为 application/x-plist,再确认 manifest 中 ipa 的 url 是完整 https 地址;最后检查 ipa 签名类型——企业证书需在“设置 → 通用 → VPN 与设备管理”中信任,Ad Hoc 则必须把设备 UDID 加入描述文件。
小程序必须用商业证书吗?Let’s Encrypt 可以吗?
可以。微信只要求证书由受信任 CA 签发、域名已备案、TLS 1.2 及以上,Let’s Encrypt 完全符合。关键在于自动续期要稳定,避免 90 天到期后小程序接口集体报 ssl hand shake error。
“256 位加密”指的是什么?
指 TLS 握手协商出的对称加密算法强度,如 AES-256-GCM,与证书密钥长度无关。证书侧常见的是 RSA 2048/4096 位或 ECDSA P-256,签名算法为 SHA-256,这三者共同决定安全性与兼容性。