COMODO/Sectigo 泛域名证书实战:PositiveSSL Wildcard 申请、Nginx 配置与 398 天续费排查
一、问题背景:泛解析站点的 HTTPS 为什么会失败
典型场景:example.com 主域用一张单域名证书一直正常,业务扩张后启用 *.example.com 泛解析,api.example.com、m.example.com、img.example.com 全部走 HTTPS,随即出现三类故障:浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID;微信小程序或 uni-app 真机报 request:fail ssl hand shake error;Android 10 报 java.security.cert.CertPathValidatorException: Trust anchor for certification path not found,而 Android 7 却正常。
根因只有三条:
- 覆盖范围错配:DV 单域名证书只保护一个 FQDN;泛域名 *.example.com 只覆盖一级子域,既不覆盖 example.com 本身,也不覆盖 a.b.example.com。
- 证书链不完整:Nginx 的 ssl_certificate 只指向服务器证书,缺中间证书。桌面 Chrome 有 AIA Fetching 会自动补链,Android、Java 客户端和部分小程序内核不会,直接握手失败。
- 协议过时:RFC 8996 已正式弃用 TLS 1.0/1.1,小程序与主流 CDN 强制 TLS 1.2 以上,仍停留在 TLS 1.0 的旧配置必然握手失败。
先用一条命令定位:
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null
只看两处:verify return code 是否为 0;输出里证书是否只有一张(缺中间证书时通常只有一张)。若返回 unable to get local issuer certificate,基本可判定链不完整。
二、选型、398 天有效期与 CSR 准备
COMODO 的 CA 业务已于 2018 年并入 Sectigo,PositiveSSL Wildcard(泛域名 DV)仍以双品牌售卖:只验证域名管理权,泛域名必须走 DNS TXT 验证,签发通常 10 分钟到 2 小时,价格远低于 OV。
有效期是采购环节最容易踩坑的地方:按 CA/B Forum 规定,2020-09-01 起所有公开信任证书单张最长 398 天;Let’s Encrypt 免费证书固定 90 天。后续还将压缩到 200 天(2026-03)、100 天(2027-03)、47 天(2029-03),所以「买三年」实际是三年内分批发 3 张 398 天证书,必须提前设计换发流程。
生成私钥与 CSR(RSA 2048 兼容性最好,ECDSA P-256 握手更省资源,二选一):
openssl genrsa -out wildcard.example.com.key 2048
chmod 600 wildcard.example.com.key
openssl req -new -sha256 -key wildcard.example.com.key
-out wildcard.example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=*.example.com'
提交前自检:
openssl req -in wildcard.example.com.csr -noout -text | head -20
确认 Signature Algorithm 为 sha256WithRSAEncryption、CN 为 *.example.com。CSR 只含公钥,可安全提交给 CA 或代购方;私钥永远不要上传到任何在线工具,也不要交给服务商代持。
三、域名验证与证书签发(可直接执行)
泛域名证书只能走 DNS 验证。CA 会给出形如 _dnsauth.example.com 的 TXT 记录名和值,添加后用两条命令交叉核对:
dig +short TXT _dnsauth.example.com
dig @8.8.8.8 +short TXT _dnsauth.example.com
两条输出必须完全一致(含引号内的值)。建议 TTL 设 600 秒以内,改动后等 5-10 分钟再点验证,否则 CA 抓到旧缓存会直接失败,连续失败 3 次可能触发重新排队。
单域名场景可用 HTTP 文件验证:把 CA 提供的 .txt 放到站点根目录的 .well-known/pki-validation/ 下,然后执行:
curl -I http://example.com/.well-known/pki-validation/xxxx.txt
必须返回 200。返回 301/302 多半是强制 HTTPS 跳转;返回 403 常见于 WAF 拦截 .well-known 路径;返回 200 但内容是首页,说明伪静态规则把该文件重写了。签发后下载的压缩包一般含三部分:服务器证书 example.com.crt、中间证书 intermediate.crt(或 ca-bundle)、根证书 root.crt(不要配到服务端)。用下面命令确认关键字段:
openssl x509 -in example.com.crt -noout -subject -issuer -dates
subject 应含 CN=*.example.com,notAfter 距今不超过 398 天。
四、证书链合并与 Nginx / Apache 配置示例
fullchain 的拼接顺序是硬性要求:服务器证书在前,中间证书在后(多张时由下往上),根证书不要拼进去。拼错顺序时桌面 Chrome 可能仍能通过,Android 会直接握手失败。合并并验证:
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 才算链完整。Nginx 配置要点:server_name 必须同时写主域与泛域名,否则主域会命中默认 server 返回错证书;OCSP Stapling 依赖 ssl_trusted_certificate 指向完整链才生效。
server {
listen 443 ssl;
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-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/fullchain.crt;
add_header Strict-Transport-Security 'max-age=300' always;
}
Apache 对应三行:SSLCertificateFile 指向服务器证书、SSLCertificateKeyFile 指向私钥、SSLCertificateChainFile 指向中间证书,协议用 SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1。HSTS 首次上线先给 300 秒观察,确认所有子域都有证书后再改 31536000,切勿一上来就加 includeSubDomains 与 preload——某个子域没证书会导致浏览器直接拒绝访问且无法回退。改完执行 nginx -t && nginx -s reload。
五、证书类型对比表
| 方案 | 覆盖范围 | 验证方式 | 签发时长 | 单张有效期 | 适用场景 |
|---|---|---|---|---|---|
| DV 单域名 PositiveSSL | 1 个 FQDN | DNS 或 HTTP | 10 分钟 | 398 天 | 单站点、博客 |
| DV 泛域名 PositiveSSL Wildcard | *.example.com(仅一级子域,不含主域) | 仅 DNS TXT | 10 分钟-2 小时 | 398 天 | 多子域、SaaS、微服务 |
| 多域名 SAN | 最多 100 个指定 FQDN | DNS 或 HTTP | 1-24 小时 | 398 天 | 域名后缀不统一 |
| OV 泛域名 | *.example.com + 组织信息 | DNS + 企业资质 | 1-3 工作日 | 398 天 | 金融、政企、招投标 |
| Let’s Encrypt | 单域名或多域名 SAN | HTTP-01 / DNS-01 | 1 分钟 | 90 天 | 可自动化、成本敏感 |
选型结论:一级子域数量 ≥3 且后缀统一,泛域名证书最划算;需要保护 example.com 主域本身时,可在同一张证书里追加 SAN,或给主域单独签一张单域名证书做 301。Let’s Encrypt 虽然免费且有泛域名(DNS-01),但 90 天有效期必须配 acme.sh 自动续期,否则运维成本反而更高;商业 DV 泛域名证书的优势在于签发稳定、支持多年期分批发证、可开发票。
六、常见错误排查(真实报错对照)
- NET::ERR_CERT_COMMON_NAME_INVALID:证书 SAN 不含当前域名。检查是否把 *.example.com 用在了 example.com 或 a.b.example.com 上。修复:主域加入 SAN,或拆分配置。
- curl: (60) SSL certificate problem: unable to get local issuer certificate:链缺中间证书。用 openssl verify -untrusted 复现,按第四节拼 fullchain。
- curl: (60) certificate has expired:服务端仍加载旧证书,reload 未执行或失败(旧 worker 未退出)。执行 nginx -t 后 reload,再核对 s_client 输出的 notAfter。
- 小程序 request:fail ssl hand shake error:多为只开了 TLS 1.0/1.1,或使用了小程序内核不支持的弱套件。用 openssl s_client -tls1_2 复测,服务端至少开放 TLS 1.2 且支持 AES-GCM。
- Android: Trust anchor for certification path not found:缺中间证书,或根证书交叉链过期(DST Root CA X3 于 2021-09-30 到期、AddTrust External CA R1 于 2020-05-30 到期)。换用新根链并确认设备系统时间正确。
- nginx: [emerg] cannot load certificate PEM_read_bio_X509_AUX() failed:fullchain.crt 混入了私钥,或文件其实是 .pfx 二进制,需先 openssl pkcs12 -in x.pfx -nodes 转出 PEM。
排查顺序固定为:证书链 → 域名覆盖 → 协议版本 → 系统时间,四步能覆盖 95% 的握手失败。
七、续费、自动续期与到期监控
398 天上限意味着任何「买三年」都要分三次换发,必须建立到期监控而不是靠人记。查本地证书剩余时间:
openssl x509 -in fullchain.crt -noout -enddate
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates
批量检查多个子域:
for h in api.example.com m.example.com img.example.com; do
echo | openssl s_client -connect $h:443 -servername $h 2>/dev/null | openssl x509 -noout -enddate
done
Let’s Encrypt 场景用 acme.sh 自动续期并 reload:
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength 2048
acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.crt
--reloadcmd 'nginx -t && nginx -s reload'
商业 DV 泛域名证书也可通过 DNS-01 流程做自动化替换,但要注意:换发后必须同步更新 ssl_trusted_certificate 指向的链文件,否则 OCSP Stapling 会静默失效。建议把「到期前 30 天告警」写进监控系统,脚本返回值非 0 即报警,不要依赖日历提醒。
八、效果验证清单
配置完成后按下面四步验收,任何一步不通过都不要上线。
# 1. 握手与链
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null | grep -E 'Verify return code|Protocol|Cipher'
# 2. 泛子域逐个验证
for h in api m img; do curl -sSI https://$h.example.com | head -1; done
# 3. 模拟小程序内核强制 TLS 1.2
openssl s_client -connect example.com:443 -tls1_2 </dev/null | grep Protocol
# 4. 在线评级
curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done' | head -c 400
期望结果:Verify return code: 0 (ok);Protocol 为 TLSv1.2 或 TLSv1.3;所有子域返回 200 或 301;SSL Labs 评级 A 及以上。移动端务必真机过一遍:微信开发者工具勾选「不校验合法域名」能跑通不代表真机通过,要用体验版在 Android 与 iOS 各测一次,并确认小程序后台「服务器域名」里配置的是 https 且不带端口。
最后确认 HSTS 与 OCSP Stapling 真正生效:
curl -sI https://example.com | grep -i strict-transport-security
openssl s_client -connect example.com:443 -status </dev/null | grep -A2 'OCSP Response'
前者应回显 max-age,后者应显示 successful 而非 no response。
常见问题
不能。*.example.com 只匹配一级子域,example.com 和 a.b.example.com 都不在覆盖范围内。解决办法是签发时把 example.com 追加进 SAN,或单独给主域签一张单域名证书并做 301 跳转。
可以。COMODO 的 CA 业务 2018 年已并入 Sectigo,PositiveSSL 系列仍在售,根证书与中间证书由 Sectigo 签发,浏览器和移动端信任情况不受影响,采购时认准双品牌即可。
目前公开信任证书单张最长 398 天,自 2020-09-01 起执行;Let’s Encrypt 固定 90 天。后续将逐步缩短至 200 天、100 天、47 天,因此多年期订单实际是分批签发、分批换发。
电脑浏览器会通过 AIA Fetching 自动下载中间证书补全链,Android、Java 客户端和部分小程序内核不会。服务端必须配置 fullchain(服务器证书加中间证书),根证书不要拼进去。
CA/B Forum 规定泛域名证书必须通过 DNS TXT 记录验证。HTTP 文件验证只能证明某一个具体子域的控制权,无法证明对整片子域的通配管理权,因此签发前要确保拥有 DNS 解析权限。
需要 reload。先执行 nginx -t 校验配置,再 nginx -s reload 让 worker 重新加载证书文件;只替换文件不 reload,旧进程仍返回旧证书,客户端会报 certificate has expired。