跳到主要内容
Comodo SSL证书

Sectigo 通配符 SSL 证书实战:CSR 生成、域名验证、Nginx/Apache/IIS 部署与排错全流程

Sectigo 通配符 SSL 证书实战:CSR 生成、域名验证、Nginx/Apache/IIS 部署与排错全流程 — Sectigo 通配符 SSL 证书实战:CSR 生成、域名验证、Nginx/Apache/IIS 部署与排错全流程

问题背景:子域名膨胀后,单域名证书为什么撑不住

业务一旦铺开,www.example.com、api.example.com、pay.example.com、m.example.com、static.example.com 很快就会从 3 个变成 30 个。用单域名证书意味着:每新增一个子域,就要重新生成 CSR、重新走一遍 DCV(Domain Control Validation,域名控制权验证)、重新签发、重新部署、重新安排续期。证书管理成本随子域数量线性增长,而运维人力不会。

根因在于浏览器的主机名校验逻辑:客户端把 SNI 中的域名拿去比对证书 SAN(subjectAltName)列表,匹配不上就直接中断握手。单域名证书的 SAN 里只有一个 FQDN,无法覆盖兄弟节点。而通配符证书(Wildcard Certificate)在 SAN 中写入 *.example.com,按 RFC 6125 的通配规则一次性覆盖同一层级下的所有子域——一张证书、一份私钥、一条续期任务,就能把整个二级域名体系收拢起来。

另一个常被忽略的变量是有效期。自 2020 年 9 月 1 日起,CA/Browser Forum 规定公有 TLS 证书最长有效期 398 天,Sectigo 全系通配符证书同样受此约束;Let’s Encrypt 的免费证书则是 90 天。也就是说「买一张用三年」的时代早已结束,任何方案都必须把自动化续期与到期监控算进去,否则 398 天后的凌晨依然会全站飘红。

本文以 Sectigo 通配符证书(DV/OV)为例,从 CSR 生成、域名验证、Nginx/Apache/IIS 三端部署,到线上真实报错排查与到期监控,给出一套命令可直接执行的完整流程。文中所有参数均适用于当前 Sectigo 通配符产品线,也适用于同类商业 CA。

通配符证书的匹配规则与能力边界

通配符不是「万能符」,先把边界说清楚,能省掉大量返工。

规则一:只匹配一级。*.example.com 匹配 www.example.com、api.example.com,但不匹配 a.b.example.com。多级子域需要 *.b.example.com 另开一张证书。

规则二:不含裸域。*.example.com 不匹配 example.com。这是最高频的翻车点——用户直接输入主域名访问,浏览器立刻报 NET::ERR_CERT_COMMON_NAME_INVALID。解决方式有两种:下单时付费追加 example.com 作为额外 SAN(部分 Sectigo 通配符产品支持),或单独购买一张单域名证书,在 Nginx 中配置双 ssl_certificate(SNI 多证书)。

规则三:大小写不敏感,但不处理 IDN。国际化域名必须先转 Punycode,例如 中文.example.com 要写成 xn--fiq228c.example.com,否则签发出来的证书照样不匹配。

规则四:EV 证书不支持通配符。这是 CA/B Forum 的硬性规定,任何声称「EV 通配符」的商品都不合规。需要绿色地址栏式的高保证级别时,只能对逐个域名签发 EV。

规则五:DV 与 OV 的差别在验证深度,不在加密强度。两者密钥长度、加密算法、浏览器兼容性完全一致(RSA 2048/4096 或 ECC P-256,SHA-256 签名)。DV 只验证域名控制权,10 分钟到 2 小时签发;OV 需要核验企业营业执照、电话回访,1~3 个工作日。选择依据是「证书详情里是否需要显示企业名称」,而不是「哪个更安全」。

实操一:生成私钥与 CSR(含校验命令)

私钥必须在自己的服务器上生成,绝不能让 CA 或代理商代生成后通过聊天工具传给你。下面这条命令一次产出 2048 位 RSA 私钥和对应 CSR:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key 
  -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co., Ltd./OU=IT/CN=*.example.com"

chmod 600 example.com.key
chmod 644 example.com.csr

关键参数:-nodes 表示私钥不加密(否则 Nginx 每次 reload 都要输密码,无法开机自启);-newkey rsa:2048 同时生成密钥;CN 必须严格写成 *.example.com,星号只能出现在最左侧,写 www.*.com 或 *.*.example.com 会被 CA 直接驳回。

提交前务必自查 CSR 内容,避免填错公司名导致重签:

openssl req -in example.com.csr -noout -text | grep -E "Subject:|Public-Key"

正常输出应为 Subject: C = CN, ST = Zhejiang, ..., CN = *.example.com 与 Public-Key: (2048 bit)。

证书下发后,第一件事是验证证书与私钥是否配对,不匹配会在 Nginx 启动时炸掉:

openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

两条命令输出的 MD5 值必须完全一致。若使用 ECC 证书,改用 openssl ec -noout -text -in example.com.key 比对公钥点。

另外请确认证书 SAN 里确实带星号:openssl x509 -in example.com.crt -noout -ext subjectAltName,输出应包含 DNS:*.example.com。如果只看到 DNS:example.com,说明代理商下错单,立即要求重签。

实操二:完成域名验证(DCV)

Sectigo 支持三种 DCV 方式,任选其一即可,推荐 DNS 方式——它不依赖服务器是否已上线,也不会被 WAF 拦截。

方式 A:DNS CNAME/TXT 验证(推荐)。在 CA 后台选择 DNS 验证后,会拿到形如 _dnsauth.example.com 的主机记录和一段随机 token。以阿里云/腾讯云 DNS 为例:

# 记录类型  主机记录        记录值
# CNAME     _dnsauth        xxxxxxxx.dcv.sectigo.com.

# 生效性检查(必须等到能解析出结果)
dig +short CNAME _dnsauth.example.com @8.8.8.8
dig +short TXT   _dnsauth.example.com @1.1.1.1

TXT 记录的值通常带引号,注意不要把引号一起填进记录值里。TTL 建议临时改为 60 秒,验证通过后再调回。

方式 B:HTTP 文件验证。把 CA 提供的 xxxx.txt 放到站点根目录下的固定路径:

mkdir -p /var/www/html/.well-known/pki-validation
cp xxxx.txt /var/www/html/.well-known/pki-validation/

# 必须返回 200 且内容与文件完全一致
curl -i http://example.com/.well-known/pki-validation/xxxx.txt

注意:通配符证书的 HTTP 验证必须用裸域或任意一个子域路径均可,但 CA 会从公网回源,80 端口不能被防火墙挡住,也不能 301 跳转到 HTTPS 后丢路径。

方式 C:邮箱验证。向 admin@、administrator@、webmaster@、postmaster@、hostmaster@ 五个固定别名之一发送确认邮件。若企业邮箱未开通这些别名,此方式不可用。

还有一个容易被忽略的前置条件:CAA 记录。如果域名配过 CAA 且未授权 Sectigo,签发会被直接拒绝。先查一遍:

dig +short CAA example.com
# 若已有记录,需包含 sectigo.com、usertrust.com、comodoca.com 之一
# 示例:example.com. CAA 0 issue "sectigo.com"

实操三:Nginx / Apache / IIS 部署配置

Nginx:证书链文件(fullchain)必须是「服务器证书在前、中间证书在后」的顺序,顺序反了会导致部分安卓机与 Java 客户端握手失败。

cat example.com.crt example.com.ca-bundle > example.com.fullchain.pem

server {
    listen 443 ssl http2;
    server_name example.com *.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-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/example.com.ca-bundle;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}

server {
    listen 80;
    server_name example.com *.example.com;
    return 301 https://$host$request_uri;
}

注意 server_name 里必须同时写 example.com 和 *.example.com——Nginx 的通配符不覆盖裸域。改完执行 nginx -t && nginx -s reload。

Apache(2.4.8+):可直接把 fullchain 写进 SSLCertificateFile,无需单独的 ChainFile。

<VirtualHost *:443>
    ServerName example.com
    ServerAlias *.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 HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

IIS:先转成 PFX,再通过 certlm.msc 导入「个人」存储,最后在站点绑定中勾选 SNI。

openssl pkcs12 -export -out example.com.pfx 
  -inkey example.com.key -in example.com.crt 
  -certfile example.com.ca-bundle

# 导入后确认绑定
netsh http show sslcert | findstr /i "example.com"

Windows 环境下请用 certutil -dump 检查证书是否被 CRLF 污染,换行符异常会让 IIS 提示「找不到与此证书匹配的私钥」。

选型对比:通配符、单域名与免费证书怎么选

下表按当前(398 天上限、Let’s Encrypt 90 天)规则整理,可直接用于采购决策:

产品 验证类型 覆盖范围 签发时长 有效期 适用场景
Sectigo PositiveSSL Wildcard DV *.example.com(不含裸域) 10 分钟~2 小时 398 天 内部系统、测试环境、多子域站点
Sectigo EssentialSSL Wildcard DV *.example.com,含站点信任标识 10 分钟~2 小时 398 天 中小型 SaaS、会员后台
Sectigo OV Wildcard OV(企业核验) *.example.com 1~3 个工作日 398 天 对外支付、企业官网,需展示企业名称
Sectigo EV EV(扩展验证) 不支持通配符,逐个域名 3~5 个工作日 398 天 金融、政务类单域名
Let’s Encrypt Wildcard DV(强制 DNS-01) *.example.com 1~3 分钟 90 天 自动化程度高、成本敏感、无商业支持需求
单域名 DV DV 单个 FQDN 10 分钟 398 天 子域数量 ≤ 2

经验法则:子域超过 3 个就上通配符,管理成本立刻收敛;需要展示企业身份就选 OV,DV 证书详情里只有域名,没有公司名;纯内网或 CI 环境可以全量走 Let’s Encrypt + DNS-01,但必须把 90 天续期完全自动化,否则故障率远高于省下的钱。

兼容性方面,Sectigo 根证书(USERTrust RSA / AAA Certificate Services)已预置于主流信任库,覆盖 Chrome、Firefox、Safari、Edge、360 浏览器,以及 Android/iOS 系统信任链,满足苹果 ATS(App Transport Security)对 TLS 1.2+ 与前向保密套件的要求,也满足微信小程序「必须使用受信任 CA 证书」的硬性规定。

常见错误排查:真实报错与修复命令

1. curl: (60) SSL certificate problem: unable to get local issuer certificate
缺中间证书。用 openssl s_client -connect example.com:443 -showcerts </dev/null 看返回几条证书,只有 1 条就是没配链。修复:把 ca-bundle 拼到服务器证书后面,或 Apache 加 SSLCertificateChainFile。

2. nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0B084088:x509 certificate routines:X509_load_cert_crl_file_ex)
证书文件格式非法,九成是从 Windows 复制时带了 CRLF 或 BOM,或文件里混入了邮件正文。修复:sed -i 's/r$//' example.com.fullchain.pem,并用 openssl x509 -in example.com.fullchain.pem -noout -subject 验证能否解析。

3. nginx: [emerg] cannot load certificate key ... key values mismatch
证书与私钥不配对,用前文的 -modulus | md5 双命令比对即可定位。常见于续期时只替换了 crt 忘了换 key。

4. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID
用 *.example.com 的证书访问了裸域 https://example.com。修复:追加裸域 SAN,或在 Nginx 中为裸域单独配一张证书并启用 SNI。

5. ERR_CERT_DATE_INVALID
证书过期,或服务器系统时间偏差过大(容器常见)。先 date -u 校准 NTP,再 openssl x509 -in example.com.crt -noout -dates 核对 notAfter。

6. Sectigo 邮件通知 DCV failed / The Certificate Authority has failed to verify
三类原因:DNS 记录尚未传播(用 dig @8.8.8.8 复查)、CAA 记录未授权、或 HTTP 验证路径被 301 跳转吞掉。逐项排除后再点重试,不要盲目重复提交,多次失败会触发风控。

7. 微信小程序 request:fail ssl handshake error / Go 报 x509: certificate signed by unknown authority
前者多为证书链不全或仅支持 TLS 1.0/1.1;后者是客户端未拿到中间证书。统一解法:服务端提供完整链、启用 TLS 1.2+、禁用 RC4/3DES。

效果验证与到期监控

部署完不要只看浏览器小锁,用命令行逐项验收。第一条命令一次性打印主题、签发者、有效期与 SAN:

openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

预期输出中 subject=CN = *.example.com、issuer=C = GB, O = Sectigo Limited, CN = Sectigo RSA Domain Validation Secure Server CA,且 notAfter 距今不超过 398 天。再验证链完整性(返回 Verify return code: 0 (ok)):

openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | grep "Verify return code"

# 检查协商到的协议版本与套件
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | grep -E "Protocol|Cipher"

到期监控建议做成定时任务,-checkend 参数在剩余秒数不足时返回非 0,非常适合接告警:

#!/bin/bash
DOMAIN="www.example.com"
if ! openssl s_client -connect ${DOMAIN}:443 -servername ${DOMAIN} </dev/null 2>/dev/null 
   | openssl x509 -noout -checkend 2592000 >/dev/null; then
  echo "[CRITICAL] ${DOMAIN} 证书将在 30 天内过期" | mail -s "SSL 告警" ops@example.com
fi

更完整的做法是接入 Prometheus 的 ssl_exporter,采集 ssl_cert_not_after 指标,在 Grafana 上按剩余天数排序,把 398 天的证书在剩余 45 天时进入工单流程。最后跑一次 Qualys SSL Labs 评级,目标 A 及以上,重点看是否支持 TLS 1.3、是否开启 HSTS、是否泄漏协议版本。注意:商业证书续期时 CSR 可复用(私钥不变),但更安全的实践是每次续期都换新私钥并重签 CSR。

常见问题

通配符证书能保护 example.com 主域名吗?

默认不能。*.example.com 只匹配一级子域,裸域 example.com 需要额外处理:下单时付费追加裸域作为 SAN(部分 Sectigo 通配符产品支持),或单独购买一张单域名证书,在 Nginx/Apache 中用 SNI 配置双证书。只配一张通配符证书就上线,用户直接访问主域名必然报 NET::ERR_CERT_COMMON_NAME_INVALID。

一张通配符证书能覆盖多少个子域名?有数量限制吗?

同一层级下没有数量限制,www、api、pay、m 等任意多个二级子域都由同一张证书覆盖。限制在于层级和域名本身:不能跨到 a.b.example.com,也不能跨到 example.net。另外通配符私钥一旦泄漏,所有子域同时受影响,因此私钥权限必须设为 600,并禁止提交到 Git 仓库。

通配符证书支持多级子域名,比如 a.b.example.com 吗?

不支持。RFC 6125 规定通配符只匹配最左一个标签,*.example.com 无法匹配 a.b.example.com。若确实存在多级结构,需要为 *.b.example.com 单独签发一张证书,或在同一张证书里以 SAN 形式逐个列出具体域名(部分产品支持多 SAN 扩展)。

证书最长有效期是多久?为什么从 825 天缩短到 398 天?

当前公有 TLS 证书最长有效期 398 天,这是 CA/Browser Forum 自 2020 年 9 月 1 日起强制执行的规则,目的是缩短私钥泄漏与配置错误的暴露窗口。Sectigo 全系商业证书均受此约束,Let’s Encrypt 免费证书更短,为 90 天。因此无论买哪种证书,都必须建立到期提醒与自动化续期机制,把「剩余 30 天告警」写进监控。

证书链不全有什么后果?如何快速判断?

桌面浏览器通常会自动补全中间证书,所以本机测试一切正常;但 Android 旧版本、Java 客户端、微信小程序、Go/Python 的 HTTP 客户端不会补全,会直接报 unable to get local issuer certificate 或 x509: certificate signed by unknown authority。快速判断方法:openssl s_client -connect 域名:443 -showcerts 只返回 1 条证书即说明链缺失,需要把 CA 提供的 ca-bundle 与服务器证书按「服务器证书在前、中间证书在后」的顺序拼接成 fullchain。

微信小程序和苹果 ATS 对证书有什么额外要求?

两者都要求服务端使用受信任 CA 签发的证书、提供完整证书链、并支持 TLS 1.2 及以上版本,同时禁用 RC4、3DES 等弱套件。Sectigo 通配符证书满足上述要求,但部署时必须确保 ssl_protocols 包含 TLSv1.2/1.3,且 fullchain 顺序正确。若小程序仍报 ssl handshake error,优先检查证书链与协议版本,而不是更换证书品牌。

内容审核

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