跳到主要内容
ssl证书按装

COMODO/Sectigo 泛域名证书实战:PositiveSSL Wildcard 申请、Nginx 配置与 398 天续费排查

COMODO/Sectigo 泛域名证书实战:PositiveSSL Wildcard 申请、Nginx 配置与 398 天续费排查 — 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。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。