跳到主要内容
Comodo SSL证书

Comodo(Sectigo)通配符 SSL 证书申请、Nginx 部署与微信小程序 HTTPS 配置实战

Comodo(Sectigo)通配符 SSL 证书申请、Nginx 部署与微信小程序 HTTPS 配置实战 — Comodo(Sectigo)通配符 SSL 证书申请、Nginx 部署与微信小程序 HTTPS 配置实战

问题背景与根因:Comodo 已更名 Sectigo,通配符并非“无限层级”

很多旧教程仍写“Comodo SSL 证书申请”,但 Comodo 的 CA 业务在 2018 年已拆分并并入 Sectigo,现在下单页面、发票和证书管理后台通常显示 Sectigo,部分旧交叉链仍可能出现 COMODO CA 字样。品牌变化不影响已签发证书的信任,但会影响你找客服、下载链文件和配置 OCSP。真正导致小程序或 iOS 访问失败的,往往不是品牌,而是三个硬条件:域名覆盖、证书链完整、TLS 版本达标。

泛域名(通配符)证书 *.example.com 只匹配一级子域,例如 api.example.com、wap.example.com、m.example.com 可用;my.q.example.com 这种三级子域不匹配,必须单独加 SAN 或再申请一张证书。微信小程序 wx.request 要求 HTTPS,域名需完成 ICP 备案,服务端至少支持 TLS 1.2;iOS ATS 还要求 SHA-256 签名、足够强度的密钥交换,并限制证书有效期。公共信任 TLS 证书单张有效期在 2020-09 后最长 398 天;CA/B Forum SC-081 已规定自 2026-03-15 起降至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。Let’s Encrypt 目前仍是 90 天,适合自动化续期,但不提供 OV 组织信息。

快速判断根因:openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 看返回链是否包含中间证书;openssl x509 -in fullchain.pem -noout -text | grep DNS 看 SAN 是否覆盖实际域名;curl -I https://api.example.com 看是否被重定向到 HTTP 或返回证书错误。先定位是“域名不匹配”还是“链不全”,再决定重签、补链还是改 TLS 配置。

申请前准备:确认域名层级、备案与 CSR 参数

下单前先列出所有要用的主机名,按“一级子域 / 多级子域 / 根域”分类。通配符只解决一级子域,根域 example.com 默认不在 *.example.com 内;如果小程序请求根域 API,必须购买带根域 SAN 的证书,或下单时在 SAN 中追加 example.com。同时确认域名已完成 ICP 备案,解析记录不要使用 CNAME 到未备案域名,否则微信侧校验仍可能失败。

推荐在 Linux 服务器生成私钥和 CSR,私钥不要上传给任何“代申请”平台:

openssl genrsa -out example.com.key 2048
openssl req -new -sha256 -key example.com.key -out example.com.csr -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/OU=IT/CN=*.example.com"
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

如果使用 OpenSSL 1.1.1 及以上,并且需要根域和通配符同时覆盖,可加 -addext "subjectAltName=DNS:*.example.com,DNS:example.com"。RSA 密钥建议 2048 位以上,签名算法用 SHA-256;ECC P-256 也可用,但要在 CA 下单页确认支持。CSR 里的 CN 填 *.example.com,不要填 api.example.com,否则部分 CA 会按单域名签发。生成后核对 modulus,确保私钥与 CSR 匹配:openssl req -noout -modulus -in example.com.csr | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5 输出一致。

准备验证材料:DNS 验证需能修改 _dnsauth.example.com 的 TXT 记录;文件验证需能写入 /.well-known/pki-validation/;邮箱验证需使用 admin@example.com、administrator@example.com、hostmaster@example.com、webmaster@example.com 等 CA 认可地址。若域名有 CAA 记录,先确认允许 Sectigo 签发,否则验证会直接被拒绝。

域名验证实操:DNS TXT、HTTP 文件与邮箱验证

Sectigo 通配符 DV 通常优先用 DNS 验证,因为一次 TXT 记录可覆盖 *.example.com,且不依赖 80 端口。后台会给出类似 _dnsauth.example.com 的主机名和一段 TXT 值,添加后检查:

dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _dnsauth.example.com @1.1.1.1
dig +trace TXT _dnsauth.example.com

如果使用 HTTP 文件验证,把 CA 给的文件放到站点根目录的 /.well-known/pki-validation/ 下,Nginx 要确保该路径不被伪静态、登录鉴权或 301 跳转拦截:

location ^~ /.well-known/pki-validation/ {
    root /var/www/html;
    default_type text/plain;
    try_files $uri =404;
}

验证文件必须返回 200,内容与 CA 提供的一致,不能返回 HTML 404 页。用 curl -I http://example.com/.well-known/pki-validation/xxx.txt 和 curl http://example.com/.well-known/pki-validation/xxx.txt 检查状态码与正文。若站点强制 HTTPS,也要保证该路径在 443 上可访问,且证书本身不能依赖待签发证书,否则会形成死循环。

邮箱验证适合能收信的管理员,但通配符证书对邮箱验证支持不如 DNS 稳定,且容易因邮箱转发、SPF 丢弃而超时。无论哪种方式,先查 CAA:dig +short CAA example.com。若返回 0 issue "letsencrypt.org" 而没有 Sectigo,需要追加 0 issue "sectigo.com",否则 CA 会报 CAA record forbids issuance。验证失败常见原因还包括 DNS TTL 未生效、CDN 缓存了旧 TXT、文件被 WAF 拦截返回 403。

签发后整理证书链:fullchain 与私钥权限

CA 签发后下载的压缩包通常包含域名证书、中间证书和私钥。不要把 .crt 直接当完整链用;浏览器和 iOS 需要“叶子证书 + 中间证书”。拼接顺序必须是叶子在前、中间在后:

cat example.com.crt ca-bundle.crt > fullchain.pem
openssl verify -CAfile ca-bundle.crt example.com.crt
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'

如果下载到的是 .cer 或 DER 格式,先转换:openssl x509 -in cert.cer -inform DER -out cert.pem -outform PEM。检查私钥与证书是否匹配:openssl x509 -noout -modulus -in example.com.crt | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5 的哈希必须一致。权限设置为 chmod 600 example.com.key,属主为运行 Nginx/Apache 的 root 或专用账户,不要把私钥放在 Web 根目录。

关于根证书:服务器 ssl_certificate 通常只放叶子证书和中间证书,根证书由客户端信任库提供。把根证书也拼进 fullchain 一般不会导致浏览器报错,但会增加握手体积,部分旧客户端可能重复校验。若用 openssl s_client -showcerts 看到链中只有一张证书,说明中间证书缺失,iOS 和小程序很容易报 SSL handshake failed。证书有效期也要核对:openssl x509 -in fullchain.pem -noout -enddate,避免使用超过平台限制的旧证书。

Nginx 与 Apache 配置示例:通配符证书部署到 api/wap 子域

Nginx 中把通配符证书用于多个一级子域,关键是 server_name 写全,证书路径指向 fullchain,私钥单独文件,并只启用 TLS 1.2/1.3:

server {
    listen 443 ssl http2;
    server_name api.example.com wap.example.com;
    ssl_certificate /etc/nginx/ssl/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-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    add_header Strict-Transport-Security "max-age=31536000" always;
    location / { proxy_pass http://127.0.0.1:8080; }
}

Apache 对应配置:SSLEngine on、SSLCertificateFile /etc/httpd/ssl/fullchain.pem、SSLCertificateKeyFile /etc/httpd/ssl/example.com.key、SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1。修改后先测试再重载:nginx -t && systemctl reload nginx,Apache 用 apachectl configtest && systemctl reload httpd。如果根域 example.com 也要 HTTPS,不能只靠 *.example.com,需要额外 server_name 和含根域 SAN 的证书,否则会报 NET::ERR_CERT_COMMON_NAME_INVALID。

多子域共用一张通配符证书时,注意 SNI:旧客户端不支持 SNI 时会拿到默认站点证书。建议为每个业务子域保留独立 server 块,至少把 443 默认站点配置为有效证书。开启 HSTS 前确认全站 HTTPS 已稳定,否则 max-age=31536000 会让回退 HTTP 变得困难。若使用 CDN,证书要上传到 CDN 的证书管理,而不是只装在源站;小程序访问的是 CDN 域名时,源站证书再正确也无法通过边缘节点校验。

方案对比:Sectigo 通配符 DV、单域名 DV、OV 与 Let’s Encrypt

选择证书不要只看价格,先看覆盖范围、验证方式和有效期。下表以常见公共信任 TLS 证书为例,实际以 CA 下单页和签发结果为准:

项目 Sectigo/Comodo 通配符 DV 单域名 DV OV 通配符 Let’s Encrypt
覆盖范围 *.example.com 一级子域 一个完整主机名 *.example.com 一级子域 单域名或通配符(需 DNS-01)
验证方式 DNS TXT / HTTP 文件 / 邮箱 DNS / HTTP / 邮箱 企业资料 + 电话/邮件核验 HTTP-01 或 DNS-01
有效期 398 天(2026-03-15 前)/200 天(之后) 同上 同上 90 天
签发速度 几分钟到数小时 几分钟 1-3 个工作日 分钟级
小程序适用 适合多子域 API 适合单接口域名 适合需要展示企业身份 适合可自动化运维

如果小程序只有 api.example.com 一个域名,单域名 DV 更便宜;如果同时有 api、wap、m 多个一级子域,通配符 DV 管理成本最低。OV 通配符会增加企业营业执照、电话核验流程,证书主题里带组织信息,但不会自动让小程序审核通过,微信侧仍看备案、HTTPS 和内容合规。Let’s Encrypt 免费且支持 ACME 自动续期,但 90 天有效期要求你有可靠的定时任务和监控;一旦续期失败,小程序会在证书过期当天全部请求失败。预算有限且运维成熟时,Let’s Encrypt + DNS-01 是通配符场景的高性价比方案。

常见错误排查:从 NET::ERR_CERT_COMMON_NAME_INVALID 到小程序 handshake error

先看浏览器/客户端真实报错,再对症处理。以下是高频错误与修复命令:

  • NET::ERR_CERT_COMMON_NAME_INVALID:访问域名不在 SAN 中。通配符只覆盖一级,my.q.example.com 会失败。检查:openssl x509 -in fullchain.pem -noout -text | grep DNS,必要时重签带 SAN 的证书。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:缺少中间证书。用 cat example.com.crt ca-bundle.crt > fullchain.pem 重新拼接,Nginx 指向 fullchain。
  • nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed:证书格式错误或文件内容不是 PEM。用 openssl x509 -in cert.cer -inform DER -out cert.pem -outform PEM 转换,并确认文件头是 -----BEGIN CERTIFICATE-----。
  • iOS 小程序 request:fail ssl handshake error:常见于只开 TLS 1.0/1.1、链不全、证书有效期超过平台限制、使用了不被信任的自签证书。用 openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null 验证 TLS 1.2 握手。
  • 403 或验证文件返回 HTML:/.well-known/pki-validation/ 被伪静态、鉴权或 WAF 拦截。把该 location 放在 rewrite 规则之前,并关闭对该路径的登录校验。
  • CAA record forbids issuance:CAA 不允许当前 CA。执行 dig +short CAA example.com,追加 0 issue "sectigo.com" 后等待 TTL 生效。

排查顺序建议:先用 openssl s_client 看链,再用 curl -v 看 SNI 和 TLS 版本,最后看服务端 nginx -t 与错误日志 tail -f /var/log/nginx/error.log。不要只重启服务,很多问题重启后依旧存在。

效果验证:openssl、curl、SSL Labs 与小程序真机

配置完成后至少做四层验证。第一层看证书主题、签发者和有效期:

openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null
openssl s_client -connect api.example.com:443 -servername api.example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
echo | openssl s_client -connect api.example.com:443 -servername api.example.com 2>/dev/null | openssl x509 -noout -enddate

第二层验证 TLS 版本和 HTTP 状态:curl -I https://api.example.com/health、curl -v https://api.example.com --tlsv1.2 --tls-max 1.2。如果 curl 成功但小程序失败,重点查微信后台的 request 合法域名是否配置为 https://api.example.com,域名是否备案,是否使用了非 443 端口或 IP 地址。第三层用 SSL Labs 或 testssl.sh 检查链、协议、加密套件,目标至少 A 级,避免 TLS 1.0/1.1 和 RC4、3DES。第四层在 iOS 真机关闭“开发工具不校验域名”后测试,开发者工具里的“不校验合法域名”只用于本地调试,不能作为上线依据。

小程序代码可写一个最小请求:wx.request({url:'https://api.example.com/health', success:console.log, fail:console.error})。若返回 request:fail,在真机上抓包或看 errMsg;服务端同时观察 access.log 是否收到请求。若请求根本没到服务端,问题在域名解析、备案或微信白名单;若到了服务端但 TLS 握手失败,问题在证书链或协议版本。最后设置证书到期监控,至少在到期前 30 天告警,避免 90 天或 200 天证书静默过期。

常见问题

Comodo 证书现在还能买吗?

Comodo 的 CA 业务已并入 Sectigo,现在购买页面多显示 Sectigo,旧证书链里可能仍出现 COMODO CA 字样。已签发证书在有效期内继续受信任,新申请按 Sectigo 流程走即可。

通配符证书能覆盖 a.b.example.com 吗?

不能。*.example.com 只匹配一级子域,如 api.example.com;a.b.example.com 属于二级子域,需要单独加 SAN 或另购证书。

通配符证书能同时用于根域 example.com 吗?

默认不包含根域。下单时需在 SAN 中追加 example.com,或购买同时含根域和通配符的多域名证书;否则访问根域会报证书名称不匹配。

小程序提示证书无效,优先查什么?

先查域名是否在证书 SAN 中,再查链是否完整(是否使用 fullchain),然后查 TLS 是否至少 1.2、证书有效期是否超过平台限制、域名是否完成 ICP 备案、微信后台 request 合法域名是否配置正确。

证书有效期到底是多少天?

公共信任 TLS 证书在 2020-09 后最长 398 天;CA/B Forum SC-081 规定 2026-03-15 起降至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。Let’s Encrypt 目前仍为 90 天。实际以 CA 签发结果为准。

需要把根证书放进 fullchain.pem 吗?

通常不需要。服务器链放“叶子证书 + 中间证书”即可,根证书由客户端信任库提供。把根证书拼进去一般不影响现代浏览器,但会增加握手体积,建议用 openssl s_client -showcerts 验证链完整即可。

内容审核

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