Comodo(Sectigo)通配符 SSL 证书申请与 Nginx 部署:覆盖 iOS 小程序 HTTPS 配置
问题背景与根因:Comodo 品牌变更、证书有效期与通配符边界
原文中的 Comodo SSL 证书现在需要先纠正一个关键事实:Comodo CA 已于 2018 年更名为 Sectigo,Comodo SSL 作为旧品牌仍可能出现在部分经销商页面,但新签发证书的 CA、CRL/OCSP 与兼容链通常由 Sectigo 提供。申请时不要只看商品名,要看证书类型是否为 DV Wildcard、是否包含完整中间链、是否支持所需 SAN。另一个容易过时的是有效期:公开可信 TLS 证书在 2020-09-01 至 2026-03-14 最长 398 天,自 2026-03-15 起按 CA/B Forum SC-081 降为最长 200 天;Let’s Encrypt 默认仍是 90 天。因此续期监控应设为到期前 30 至 45 天,自动化场景建议按生命周期三分之二续期。
通配符证书的边界必须明确:*.example.com 只覆盖 api.example.com、wap.example.com 这类一级子域,不覆盖 my.q.example.com,也不自动覆盖根域 example.com。如果根域和三级子域都要用,应在 CSR 的 SAN 中加入 example.com,或为三级域单独申请 *.q.example.com。iOS 小程序和微信小程序常见失败根因不是证书本身,而是证书链缺中间证书、域名不在 SAN、TLS 版本低于 1.2、服务器时间错误、DNS 验证未生效、CAA 记录限制签发,或微信后台合法域名未配置。微信小程序要求 HTTPS、TLS 1.2 及以上、证书有效且链完整,不能使用 IP 或 localhost,生产域名通常还需完成备案。
申请前准备:证书选型、DNS 权限与 CSR 生成
先确认覆盖范围:若只保护 *.example.com 下所有一级子域,选 DV 通配符;若还要保护 example.com,在 SAN 中加根域;若要保护 *.a.example.com,单独申请 *.a.example.com。DV 验证常见方式包括 DNS TXT/CNAME、HTTP/HTTPS 文件、管理员邮箱,通配符订单以 CA 实际支持为准,最稳定的是 DNS 验证。准备一台可管理 DNS 的机器,生成 2048 位或 4096 位 RSA 私钥,私钥权限设为 600,CSR 中 CN 与 SAN 都写通配符。
umask 077
cat > openssl-wildcard.cnf <<'EOF'
[req]
default_bits = 2048
prompt = no
default_md = sha256
distinguished_name = dn
req_extensions = req_ext
[dn]
C = CN
ST = Zhejiang
L = Hangzhou
O = Example Co Ltd
CN = *.example.com
[req_ext]
subjectAltName = @alt_names
[alt_names]
DNS.1 = *.example.com
DNS.2 = example.com
EOF
openssl req -new -newkey rsa:2048 -nodes -keyout wildcard.example.com.key -out wildcard.example.com.csr -config openssl-wildcard.cnf
chmod 600 wildcard.example.com.key
openssl req -in wildcard.example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
检查输出中必须出现 DNS:*.example.com,若根域也要用则出现 DNS:example.com。不要把私钥上传到不可信渠道,CSR 可以提交给 CA,私钥必须留在服务器或密钥管理系统。若使用 Sectigo/Comodo 经销商,提交 CSR 后选择域名验证,记录订单号与验证邮箱,避免验证邮件进入垃圾箱。
完整申请实操:提交 CSR、DNS 验证与证书下载
在 CA 或经销商后台下单时选择 DV Wildcard,粘贴 CSR,验证方式选 DNS。CA 会给出类似 _dnsauth.example.com 的 TXT 或 CNAME 记录,具体主机记录以订单页为准。到 DNS 服务商添加记录,TTL 设 300 或 600 秒,不要先删旧记录。用公共 DNS 与权威 DNS 分别查询,确认返回值与 CA 要求完全一致,包括大小写和结尾点。
dig +short TXT _dnsauth.example.com
dig +short CNAME _dnsauth.example.com
dig @8.8.8.8 +short TXT _dnsauth.example.com
dig @1.1.1.1 +short TXT _dnsauth.example.com
dig +short CAA example.com
若 CAA 查询返回 0 issue ...,确认允许当前 CA 签发;若 CAA 限制过严,先修正 CAA 再重试。验证通过后下载证书包,通常包含服务器证书、中间证书和根证书。部署时把服务器证书与中间证书合并为 fullchain,不要把根证书混入 leaf,也不要在 Nginx 中只配置 leaf。
cat wildcard.example.com.crt intermediate.crt > fullchain.crt
openssl verify -CAfile root.crt -untrusted intermediate.crt wildcard.example.com.crt
openssl x509 -in wildcard.example.com.crt -noout -subject -issuer -dates -ext subjectAltName
输出应显示 Verify return code: 0 (ok) 类似的成功结果,SAN 含 *.example.com,Not Before/Not After 覆盖当前时间。若 verify 失败,优先检查中间证书是否选错、根证书是否过期、证书链顺序是否颠倒。
Nginx 配置示例:完整证书链、TLS 1.2/1.3 与 HSTS
将 fullchain.crt、私钥和中间链放到 /etc/nginx/ssl/,私钥权限 600。下面配置同时监听根域和一级子域,HTTP 强制跳转 HTTPS,启用 TLS 1.2/1.3,配置会话缓存与 HSTS。HSTS 必须在所有子域都可 HTTPS 后再开,首次上线可先不加 includeSubDomains,观察稳定后再扩展。
server {
listen 80;
server_name example.com *.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on;
server_name example.com *.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt;
ssl_certificate_key /etc/nginx/ssl/wildcard.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_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.crt;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000' always;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
}
}
执行 nginx -t 检查语法,再 systemctl reload nginx。若 Nginx 版本低于 1.25.1,http2 on; 可能不识别,可改为 listen 443 ssl http2;。OCSP stapling 失败时先确认 chain.crt 是中间链且 DNS 解析正常;stapling 不是小程序必需项,排障时可临时关闭。
iOS 小程序与微信后台配置:ATS、合法域名与真机联调
微信小程序后台进入开发管理、开发设置、服务器域名,把接口域名加入 request 合法域名,例如 https://api.example.com。域名必须是 HTTPS,不能填 IP 或 localhost,建议使用 443 端口,域名需完成 ICP 备案;上传、下载、WebSocket 分别配置对应合法域名。iOS 侧 ATS 要求 TLS 1.2 及以上、SHA-256 签名、SAN 匹配、完整证书链,不建议在自有 App 中用 NSAllowsArbitraryLoads 全局关闭 ATS;小程序由微信容器校验,开发者工具可临时关闭域名校验,但真机不会绕过。
- HTTPS配置 · SSL证书安装服务(各种服务器)
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
wx.request({
url: 'https://api.example.com/health',
method: 'GET',
success(res) { console.log(res.statusCode, res.data); },
fail(err) { console.error(err); }
});
联调顺序:先在电脑用 curl 验证证书链和 TLS,再在微信开发者工具关闭缓存测试,最后用 iOS 真机打开体验版。真机失败而工具正常时,重点查合法域名是否配置、证书是否被系统信任、是否缺中间证书、TLS 是否低于 1.2、手机时间是否准确、域名是否被 CAA 或 DNS 污染影响。iOS 上可用 Safari 直接打开接口健康检查地址,若 Safari 报证书错误,微信侧一定不会通过。
对比表格:Comodo/Sectigo 通配符、Let’s Encrypt 与单域名 DV
| 项目 | Comodo/Sectigo DV 通配符 | Let’s Encrypt 通配符 | 单域名 DV |
|---|---|---|---|
| 覆盖范围 | *.example.com 一级子域,根域需加 SAN |
*.example.com 一级子域,根域需另加 SAN |
仅一个具体 FQDN |
| 验证方式 | DNS TXT/CNAME、HTTP/HTTPS 文件、邮箱等,以订单为准 | ACME DNS-01,通配符必须 DNS 验证 | HTTP-01、DNS-01 或邮箱 |
| 有效期 | 新签发最长 200 天,2026-03-15 前为 398 天 | 默认 90 天 | 新签发最长 200 天 |
| 自动化 | API 或经销商工具,需自行续期 | certbot/acme.sh 全自动 | 可 ACME 自动 |
| 小程序适用性 | 适合多子域统一部署,兼容性好 | 适合有 DNS API 的自动化团队 | 适合单接口域名 |
选型建议:子域多、需要商业支持与固定品牌链,选 Sectigo/Comodo 通配符;有 DNS API、能接受 90 天高频续期,选 Let’s Encrypt 通配符;只有一个接口域名,单域名 DV 成本最低。无论哪种,iOS 小程序最终看的是 SAN、链完整、TLS 版本和域名合法性,不是商品页品牌名。
常见错误排查:真实报错与修复命令
curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。把 leaf 与 intermediate 合并为 fullchain,Nginx 的ssl_certificate指向 fullchain,再用openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null检查链。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 wildcard.example.com.crt | openssl md5与openssl rsa -noout -modulus -in wildcard.example.com.key | openssl md5,两值必须一致。NET::ERR_CERT_COMMON_NAME_INVALID或 iOSNSURLErrorDomain -1202:域名不在 SAN。通配符只覆盖一级,my.q.example.com需单独 SAN 或*.q.example.com。x509: certificate has expired or is not yet valid:服务器时间错误或证书过期。执行date -u校时,并用openssl x509 -in fullchain.crt -noout -dates核对。curl: (35) error:1409442E:SSL routines:ssl3_read_bytes:tlsv1 alert protocol version:客户端或服务端仍用 TLS 1.0/1.1。服务端启用 TLS 1.2/1.3,客户端升级系统或 HTTP 库。CAA record for example.com prevents issuance:CAA 限制签发。用dig +short CAA example.com查看,按 CA 要求增加 issue 记录后重试。- DNS 验证一直失败:用
dig @8.8.8.8 +short TXT _dnsauth.example.com与权威 NS 对比,检查记录名、TTL、缓存和多余引号;不要在验证期间删除旧记录。
效果验证:命令行、SSL Labs 与 iOS 真机
先做服务端验证:curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://api.example.com/health,输出第二项为 0 表示证书校验通过。再用 OpenSSL 看链和协议:openssl s_client -connect api.example.com:443 -servername api.example.com -verify_return_error </dev/null,应看到 Verify return code: 0 (ok)、TLSv1.2 或 TLSv1.3、证书链 2 至 3 张。检查证书 SAN 与时间:openssl x509 -in fullchain.crt -noout -subject -issuer -dates -ext subjectAltName。
curl -I https://api.example.com --tlsv1.2
curl -I https://api.example.com --tlsv1.3
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null
nscurl --ats-diagnostics https://api.example.com
浏览器与第三方检测:用 SSL Labs 或国内证书检测工具查看链是否完整、是否支持 TLS 1.2/1.3、是否被评为 A 级;若出现链不完整,优先修 fullchain。iOS 真机用微信体验版请求接口,观察是否返回 200;再用 Safari 打开同一 URL,确认无证书警告。最后检查微信后台合法域名是否与请求域名完全一致,包括子域和端口。HSTS 上线后不要随意回退 HTTP,否则用户会被浏览器强制跳转。
常见问题
Comodo 证书现在还能申请吗?
可以理解为旧品牌名。Comodo CA 已更名 Sectigo,很多经销商页面仍写 Comodo SSL,但新证书通常由 Sectigo 体系签发。购买时确认证书类型、SAN、链文件和有效期即可,不必纠结商品名。
通配符能否覆盖 a.b.example.com?
不能。*.example.com 只覆盖一级子域,如 api.example.com;a.b.example.com 需要单独加入 SAN,或申请 *.b.example.com。根域 example.com 也不自动覆盖。
为什么微信开发者工具正常,iOS 真机失败?
开发者工具可关闭合法域名校验,真机走微信和 iOS ATS 的严格校验。重点查合法域名配置、证书链是否完整、TLS 是否 1.2 以上、域名是否备案、手机时间是否准确,以及 SAN 是否匹配请求域名。
证书最长有效期到底是 398 天还是 200 天?
2026-03-15 起,公开可信 TLS 证书最长有效期为 200 天;此前为 398 天。Let’s Encrypt 默认仍为 90 天。历史证书在到期前仍有效,但新签发和续期要按新规设置监控。
通配符必须用 DNS 验证吗?
商业 CA 的通配符订单以订单页支持为准,最常见、最稳定的是 DNS TXT/CNAME;ACME 体系下 Let’s Encrypt 通配符必须使用 DNS-01。HTTP 文件验证更适合具体主机名。
能否用 IP 地址申请并配置到小程序?
公开可信 DV 证书通常不支持 IP 地址,微信小程序合法域名也不能填 IP 或 localhost。应使用已备案域名并配置 HTTPS,证书 SAN 必须包含该域名。