Sectigo(原 Comodo)单域名 SSL 证书实战:小程序与 App 全兼容 HTTPS 部署、配置与排错指南
一、问题背景与根因:HTTPS 已是小程序与 App 的硬门槛
2019 年以后,HTTPS 从加分项变成硬门槛:微信小程序要求 wx.request、wx.downloadFile、wx.uploadFile 的域名必须是 HTTPS,且服务端必须支持 TLS 1.2 及以上(TLS 1.0/1.1 已被微信、Chrome 84+、iOS ATS 判定为不合规);iOS 的 ATS(App Transport Security)默认拒绝明文 HTTP;Android 9(API 28)起 cleartextTrafficPermitted 默认为 false。也就是说,一个 http://example.com/api 的接口,在小程序和 App 里会直接失败,而不是“降级可用”。
运营商劫持、公共 Wi-Fi 注入广告脚本、CDN 回源被中间人插入 JS,根因都是链路明文——TCP 之上没有 TLS 记录层,任何一跳都能改写响应体。部署 DV(Domain Validation)证书后,浏览器到服务器之间建立 TLS 隧道,加密强度由协商出的 TLS 版本与密码套件决定,而不是旧文里说的“40/128/256 位自适应”:现代服务端在 TLS 1.2/1.3 下协商的是 AES-128-GCM、AES-256-GCM 或 ChaCha20-Poly1305,40 位 RC4 早已被所有主流客户端禁用。
同时必须纠正几个过时事实:Comodo 品牌已并入 Sectigo(2018 年收购、2020 年统一品牌),现在签发的是 Sectigo DV/OV/EV;自 2020 年 9 月 1 日起,公共 CA 签发的 SSL/TLS 证书最长有效期 398 天,Let’s Encrypt 仍为 90 天,所以“一次买多年不用管”的思路已经不成立,必须做自动续期;SHA-1 签名证书已全面停止签发与信任;EV 证书自 Chrome 77(2019 年)起不再在地址栏显示绿色公司名,“买 EV 就能显示公司名”的说法已失效。DV 证书的价值回归本质:加密传输 + 域名身份绑定,不含单位名称,成本低、签发快,小程序、App 分发、企业邮箱、内部系统都够用;它防不住钓鱼站,那是 OV/EV 与业务风控的职责。
二、申请前的准备:域名规划、私钥与 CSR
证书与域名绑定,与 IP、服务器数量无关:域名解析指向哪台机器,证书就装在哪台机器上,换 IP 无需重签。但域名结构必须提前规划,否则会买到“覆盖不全”的证书。规则是:单域名证书只保护一个 FQDN,example.com 与 www.example.com 是两个不同域名,需要买双域名(SAN)或通配符;通配符 *.example.com 只覆盖一级子域(www、api、m),不覆盖 example.com 本身,也不覆盖 a.b.example.com。实际项目建议一次申请 example.com + www.example.com,避免 301 跳转后出现证书告警。
在服务器上生成私钥与 CSR(2048 位 RSA,兼容性最好,OpenSSL 1.1.1+ 支持 -addext):
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl genrsa -out example.com.key 2048
openssl req -new -key example.com.key -sha256 -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
chmod 600 example.com.key && chown root:root example.com.key
最后一条 grep 必须能看到 DNS:example.com, DNS:www.example.com 两行,否则说明 SAN 没写进去,签出来的证书在访问 www 时会报 NET::ERR_CERT_COMMON_NAME_INVALID。老版本 OpenSSL(1.0.2,如 CentOS 7 自带)不支持 -addext,需要写一个 openssl.cnf,在 [v3_req] 段加 subjectAltName=@alt_names 再用 -extensions v3_req 生成。
若追求握手性能与更小的证书包体,可以额外生成 ECDSA P-256 私钥:openssl ecparam -genkey -name prime256v1 -out example.com.ec.key。但 Windows 7、Android 4.x 与部分老 Java 客户端对 ECDSA 支持不完整,正确做法是 RSA 与 ECDSA 双证书并存(Nginx 里写两条 ssl_certificate),由客户端按套件自动选择,而不是单用 ECDSA。密钥长度 4096 位并不比 2048 位“更安全”,只是握手更慢,2048 位在 2030 年前足够。
三、域名验证与签发:DNS-01 与 HTTP-01 实操
Sectigo DV 只验证域名控制权,两种方式:DNS 验证(加 TXT/CNAME 记录)和 HTTP 验证(网站根目录放验证文件)。DNS 验证不依赖网站是否已经上线,适合“先上证书后开服”的小程序后端;HTTP 验证要求 80 端口可达且不能跳转。
DNS 验证:CA 会给出类似 _d1234567890.example.com TXT '1a2b3c4d5e...' 的记录,添加后用两个解析器交叉确认,都返回一致内容再点验证:
dig +short TXT _d1234567890.example.com @8.8.8.8
dig +short TXT _d1234567890.example.com @223.5.5.5
HTTP 验证(文件验证):
mkdir -p /var/www/html/.well-known/pki-validation
echo '1a2b3c4d5e...' > /var/www/html/.well-known/pki-validation/ABCD1234.txt
curl -s -o /dev/null -w '%{http_code}n' http://example.com/.well-known/pki-validation/ABCD1234.txt
返回必须是 200,内容与 CA 给的一字不差,且不能 301 跳到 HTTPS(部分 CA 校验器不跟随跳转)。验证通过后 DV 证书通常 3 分钟到 2 小时内签发,邮件会收到 .crt、ca-bundle、fullchain 等文件。
如果需要批量管理与自动续期,用 acme.sh 更省事(以阿里云 DNS 为例,90 天自动续期,也可作为商业 DV 的备用链路):
curl https://get.acme.sh | sh -s email=admin@example.com
export Ali_Key='LTAIxxxxxxxx'; export Ali_Secret='xxxxxxxx'
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d www.example.com --keylength ec-256
~/.acme.sh/acme.sh --install-cert -d example.com --ecc --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem --reloadcmd 'nginx -t && systemctl reload nginx'
关键点:部署必须用 fullchain(站点证书 + 中间证书),只装证书本体是最常见的“Chrome 正常、Android/Java/小程序报错”根因。中间证书缺失时,桌面浏览器可能靠 AIA 自动补链而“看起来正常”,但移动端和 curl 会直接失败。
四、Nginx / Apache 配置示例:TLS 1.2+1.3、HSTS、OCSP Stapling
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/example.com.fullchain.pem;
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/example.com.chain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options nosniff always;
location / { proxy_pass http://127.0.0.1:8080; }
}
说明:ssl_trusted_certificate 指向纯中间证书链(不含站点证书),OCSP Stapling 才生效;ssl_session_tickets off 是为了前向安全,代价是部分客户端复用率下降;HSTS 的 max-age 首次上线建议先设 300 秒验证无误后再调成 31536000,否则配错会导致整站长时间无法用 HTTP 访问。
Apache 2.4.8 及以上版本不再需要 SSLCertificateChainFile,直接把 fullchain 写进 SSLCertificateFile:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
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
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
改完先 nginx -t 或 apachectl configtest,再 systemctl reload nginx,不要直接 restart——reload 是平滑加载,不会断开在线连接。
五、选型对比:类型、覆盖范围与密钥算法
买之前先明确三件事:验证级别(DV/OV/EV)、域名覆盖(单域名/SAN/通配符)、密钥算法(RSA/ECDSA)。下表把常见选项一次说清(有效期为公共 CA 上限,2020-09-01 起执行):
| 证书类型 | 验证内容 | 签发时长 | 浏览器表现 | 有效期上限 | 小程序/App |
|---|---|---|---|---|---|
| DV 单域名(Sectigo 原 Comodo) | 仅域名控制权 | 3 分钟–2 小时 | 地址栏锁标志,证书详情只有域名 | 398 天 | 支持 |
| OV | 企业工商信息 + 域名 | 1–3 工作日 | 锁标志,详情含单位名称 | 398 天 | 支持 |
| EV | 严格组织核验 | 1–5 工作日 | 锁标志(Chrome 77+ 不再显示公司名) | 398 天 | 支持 |
| 通配符 DV | 域名控制权 | 3 分钟–2 小时 | 锁标志 | 398 天 | 支持,仅一级子域 |
| Let’s Encrypt DV | 域名控制权 | 秒级 | 锁标志 | 90 天 | 支持 |
域名覆盖是最容易踩坑的一项:
| 证书形态 | 覆盖 | 不覆盖 |
|---|---|---|
| 单域名 | example.com | www.example.com、m.example.com |
| 双域名 SAN | example.com、www.example.com | api.example.com |
| 通配符 *.example.com | www / api / m.example.com | example.com、a.b.example.com |
| 通配符 + 主域 | *.example.com、example.com | a.b.example.com |
密钥与签名算法:
| 方案 | 握手性能 | 兼容性 | 建议 |
|---|---|---|---|
| RSA 2048 + SHA-256 | 基准 | 全平台,含 Android 4.x、Windows 7 | 默认选择 |
| RSA 4096 | 慢 3–5 倍 | 同上 | 无必要,徒增延迟 |
| ECDSA P-256 | 快、包体小 | 老 Android / 老 Java 可能不支持 | 与 RSA 双证书并存 |
| SHA-1 签名 | — | 已全部停止签发与信任 | 不可用 |
结论:面向小程序、App 分发、企业邮箱、内部后台的站点,DV 单域名或双域名 + RSA 2048 + SHA-256 是性价比最高的组合;只有对外展示品牌、需要证书详情出现企业名称时才考虑 OV;EV 现在的实际差异只剩“证书详情里的组织信息核验更严格”,地址栏表现与 DV 完全一致。
六、常见错误排查:从 curl 60 到小程序 handshake error
报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate——缺中间证书。把 ssl_certificate 指向 fullchain,并用 echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c 'BEGIN CERTIFICATE' 确认返回 2 张及以上。
报错 2:NET::ERR_CERT_COMMON_NAME_INVALID——访问的域名不在证书 SAN 里。用 openssl x509 -in fullchain.pem -noout -ext subjectAltName 核对,缺名字只能重签,不能靠配置补救。
报错 3:NET::ERR_CERT_DATE_INVALID——证书过期或服务器时间偏差。先 date -u 与 timedatectl status 看时间,再看 openssl x509 -in fullchain.pem -noout -dates。
报错 4:小程序 request:fail ssl hand shake error——三个高频原因:只开了 TLS 1.0/1.1、证书链不完整、域名未在后台配置。分别用 curl -v https://api.example.com、openssl s_client -connect api.example.com:443 -tls1_2 </dev/null、检查「开发管理 → 服务器域名」定位。
报错 5:Android 5/6 java.security.cert.CertPathValidatorException: Trust anchor for certification path not found——同样是链不完整;注意 Android 7.0 起 App 默认不信任用户手动安装的 CA,自签证书装到手机上不能算验证通过。
报错 6:nginx: [emerg] cannot load certificate "/etc/nginx/ssl/example.com.pem": PEM_read_bio_X509_AUX() failed——文件是 DER 格式或 fullchain 拼接顺序错(中间证书在前)。用 openssl x509 -in example.com.pem -noout -subject 验证,DER 需 openssl x509 -inform DER -in a.crt -out a.pem 转换。
报错 7:sslv3 alert handshake failure 或 SSL_ERROR_NO_CYPHER_OVERLAP——客户端只支持已被禁用的套件,或服务端只开 TLS 1.3 而客户端是 Android 4.x。用 nmap --script ssl-enum-ciphers -p 443 example.com 枚举实际支持的协议与套件。
报错 8:nginx: [warn] "ssl_stapling" ignored, issuer certificate not found——ssl_trusted_certificate 路径写错,或文件里混进了站点证书。该文件只放中间证书链。
七、效果验证:证书链、协议版本与小程序后台
部署完必须做四层验证,缺一层都可能上线后才发现问题。第一层,证书主体、签发者与有效期:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
第二层,协议与套件协商(应输出 TLSv1.2 或 TLSv1.3,且不含 RC4/3DES):
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -E 'Protocol|Cipher'
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep 'Protocol'
第三层,证书链完整性与跳转(Verify return code 为 0 才算链可验证,20/21 表示缺中间证书或链错):
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | grep 'Verify return code'
curl -sSI https://example.com | head -n 1
curl -sSI http://example.com | head -n 1
第四层,真实客户端:在微信开发者工具里请求一次,看 Network 面板是否为 HTTPS、状态码 200;小程序后台「开发管理 → 开发设置 → 服务器域名」中把 https://api.example.com 加入 request 合法域名(每月修改次数有限,别乱试);iOS 真机与 Android 真机各跑一遍,Android 建议覆盖 5.0、7.1、10 以上三档。最后用 SSL Labs 打分兜底:
curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done' | head -c 300
目标是 A 及以上、无 Chain issues 警告、无 TLS 1.0/1.1 支持项。若同时提供 API 与 H5,建议对 API 域名单独跑一遍,避免只测了主站。
八、生命周期管理:398 天续期、监控与吊销
398 天上限意味着每年至少换一次证书,多站点、多通配符时手工维护必然漏。最低成本的方案是一个到期巡检脚本 + cron:
cat > /usr/local/bin/cert-expire.sh <<'EOF'
#!/bin/bash
DOMAINS='example.com www.example.com api.example.com'
WARN=30
now=$(date +%s)
for d in $DOMAINS; do
end=$(echo | openssl s_client -connect ${d}:443 -servername $d 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
[ -z "$end" ] && { echo "FAIL $d 握手失败"; continue; }
left=$(( ($(date -d "$end" +%s) - now) / 86400 ))
[ "$left" -lt "$WARN" ] && echo "WARN $d 剩余 ${left} 天(到期 $end)"
done
EOF
chmod +x /usr/local/bin/cert-expire.sh
echo '0 8 * * * /usr/local/bin/cert-expire.sh >> /var/log/cert-expire.log 2>&1' | crontab -
续期时注意三点:一是私钥复用,商业 CA 重签通常可以直接用原 CSR,省去改配置;二是先 reload 后验证,reload 完立刻跑第七节的 openssl 命令,确认序列号已变(openssl x509 -in fullchain.pem -noout -serial);三是证书透明度日志,新证书签发后几分钟内会出现在 CT 日志,可用 curl -s 'https://crt.sh/?q=example.com&output=json' | jq '.[0] | {name_value, not_after}' 检查,出现非自己申请的记录说明私钥或账号可能泄露,应立即吊销重签。
吊销走 CA 控制台的 Revoke 流程,吊销后 OCSP 生效通常需要几分钟到数小时,期间客户端可能仍能握手成功。另外通配符证书一旦泄露,影响面覆盖全部子域,建议把对外 API、支付回调等敏感子域单独用一张证书,缩小爆炸半径。
常见问题
单域名证书能同时覆盖 example.com 和 www.example.com 吗?
不能。它们是两个独立的 FQDN。解决方式有三种:申请双域名 SAN 证书(推荐,一张证书两个名字)、申请通配符 *.example.com 再单独补一张 example.com、或把其中一方 301 跳转到另一方并保证跳转目标在证书 SAN 里。注意通配符不覆盖主域本身,也不覆盖 a.b.example.com 这种二级子域。
小程序要求服务器域名必须备案吗?证书和备案是什么关系?
证书本身与备案无关,任何有域名管理权限的个人或企业都能申请 DV 证书,境外服务器也能签能装。但微信小程序后台配置「服务器域名」时,域名需完成 ICP 备案(国内主体),这是平台合规要求,不是 CA 要求。换句话说:证书解决加密与身份绑定,备案解决接入合规,两者互不替代。
买 EV 证书还能在浏览器地址栏显示公司名称吗?
不能。Chrome 77(2019 年 9 月)起移除了 EV 指示器的绿色公司名,Firefox、Edge、Safari 也已跟进,现在 DV/OV/EV 在地址栏都只显示锁标志。EV 的剩余价值是证书详情中的组织信息经过更严格核验,以及部分招投标、金融合规场景的书面要求。
证书到期前怎么做到零人工续期?
两条路:一是用 acme.sh 或 certbot 申请 90 天证书,配置 --install-cert 与 --reloadcmd 后由 cron 自动续期(acme.sh 默认每天检查一次);二是购买商业 DV/OV 证书时选支持 API 自动重签的 CA,把签发结果写入配置管理(Ansible/Vault),再由巡检脚本兜底告警。无论哪条路,都要保留第八节的到期巡检脚本作为最后一道防线。
换了服务器 IP 或迁到 CDN,证书需要重新签发吗?
不需要。证书与域名绑定,与 IP 无关,把原证书和私钥部署到新机器或上传到 CDN 证书管理即可。唯一要注意的是私钥传输安全(用 scp 或密钥管理服务,别走聊天工具),以及 CDN 回源是否也启用 HTTPS——只加密用户到 CDN 这一段、回源仍走 HTTP,等于链路后半段依旧可被劫持。
Android 低版本提示“证书不受信任”是什么原因?
绝大多数是证书链不完整:服务端只下发了站点证书,没带中间证书。桌面浏览器会通过 AIA 扩展自动下载中间证书,Android 4.x/5.x 与老版本 Java 不会,于是报 CertPathValidatorException: Trust anchor for certification path not found。修复方法是把 ssl_certificate/SSLCertificateFile 指向 fullchain(站点证书在前、中间证书在后),再用 openssl s_client -showcerts 确认返回两张以上证书。