通配符 SSL 证书实战:泛域名 HTTPS 签发、Nginx/Apache 配置与劫持防护
问题背景与根因:子域一多,证书清单先崩
当一个站点从 example.com 扩展到 www、api、m、static、admin 等几十个子域时,运维最先撑不住的地方往往是证书清单,服务器反而还能应付。根因有三条:其一,TLS 证书是“主机名绑定”的,浏览器在握手阶段只比对证书 Subject Alternative Name(SAN)里有没有当前访问的主机名,多一个子域就要多一个名字;其二,公共信任的 TLS 证书有效期被 CA/Browser Forum 限制在最长 398 天,Let’s Encrypt 更是只有 90 天,证书数量与续期次数成正比;其三,HTTP 明文流量在链路任意一跳都可能被注入广告,或被运营商劫持到博彩页面,只有全站 HTTPS 才能从协议层堵死这条路。
算一笔账:30 个子域各自签发 90 天证书,一年需要完成约 120 次签发与部署动作,任何一次遗漏都会在凌晨触发 NET::ERR_CERT_DATE_INVALID,用户看到的是整页红色警告。换成一张 *.example.com 通配符证书后,续期任务从 30 个缩减为 1 个,配置模板从 30 份缩减为 1 份,这才是“防劫持”和“不宕机”真正的分界线。
代价也要提前说清楚:通配符证书的私钥一旦泄露,攻击者可以对任意子域做中间人攻击,影响面是整站而非单点。因此私钥必须设置 chmod 600、优先使用 ECDSA P-256、签发机与部署机分离,并配合 CAA 记录与 Certificate Transparency 日志监控,任何一张未授权的证书签发都能第一时间发现。
通配符证书的覆盖边界:三条必须记住的匹配规则
通配符并不意味着“无限子域”。RFC 6125 与 CA/Browser Forum 基线要求规定,*.example.com 中的 * 只能匹配一个标签(label),且不能匹配空标签。三条必须记住的规则:
*.example.com匹配www.example.com、api.example.com、a1.example.com;*.example.com不匹配裸域example.com,也不匹配a.b.example.com;- 通配符不支持 EV 证书(EV 规范明确禁止),也无法覆盖公共后缀,
*.com、*.co.uk一律被 CA 拒绝。
所以生产环境的正确做法是把“通配符 + 裸域”写进同一张证书的 SAN:
subjectAltName = DNS:*.example.com, DNS:example.com
如果还有二级子域(如 cdn.static.example.com),要么再加一条 *.static.example.com,要么把它写成具体名字,不要指望一层通配符穿透两层。另外注意通配符证书同样受 SAN 数量上限约束,主流 CA 单张证书一般允许 100 个名字,多域名通配符(*.example.com + *.example.net)也走这套规则。
验证一张证书到底覆盖了谁,不要靠肉眼,直接读 SAN:
openssl x509 -in example.com.fullchain.pem -noout -text
| grep -A1 "Subject Alternative Name"
输出里没有 DNS:example.com,就说明裸域一定报错,这是通配符证书最高频的翻车点。
实操一:生成私钥与 CSR(命令可直接执行)
CSR(Certificate Signing Request)是向 CA 提交的公钥与身份声明,私钥永远不出本机。下面的命令可直接执行,ECDSA P-256 比 RSA 2048 握手更快、密钥更短:
mkdir -p /etc/ssl/private/example && cd /etc/ssl/private/example
# 1) 生成 ECDSA P-256 私钥
openssl ecparam -genkey -name prime256v1 -noout -out example.com.key
chmod 600 example.com.key
# 2) 生成 CSR,CN 只写一个,其余全部塞进 SAN
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology Co., Ltd./CN=*.example.com"
-addext "subjectAltName=DNS:*.example.com,DNS:example.com"
# 3) 自检:SAN 是否正确、CSR 签名是否有效
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
openssl req -in example.com.csr -noout -verify
几个容易踩的点:-nodes 只对 RSA 私钥有意义,ECDSA 用 -noout 直接输出;-addext 需要 OpenSSL 1.1.1 及以上,老版本要改用 -config 配合 [v3_req] 段;OV/EV 证书的 O、L、ST 必须与营业执照、WHOIS、公开电话黄页三者一致,否则会卡在人工审核环节,反复补件。
提交前务必确认私钥与 CSR 是一对,公钥指纹必须完全相同:
openssl pkey -in example.com.key -pubout -outform DER | openssl md5
openssl req -in example.com.csr -pubkey -noout -outform DER | openssl md5
两行输出不一致就说明文件拿错了,后面无论怎么部署都会报 key mismatch,白白浪费一轮签发。
实操二:DNS-01 验证签发通配符证书
通配符证书只能用 DNS-01 验证,因为 ACME 协议无法为 *.example.com 提供 HTTP-01 所需的确定路径。DV 通配符的完整流程是:CA 要求你在 _acme-challenge.example.com 放置一条 TXT 记录,CA 从多个解析节点回查,命中即签发,记录随后可删。
用 acme.sh 配合阿里云 DNS API 可以全自动完成(其他厂商把 dns_ali 换成 dns_dp、dns_cf 即可):
curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key="LTAI5t******"
export Ali_Secret="******"
~/.acme.sh/acme.sh --issue --dns dns_ali
-d example.com -d '*.example.com'
--keylength ec-256 --server letsencrypt
~/.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"
不想把 API 密钥交给服务器,就用 certbot 手动模式,按提示自己加 TXT:
certbot certonly --manual --preferred-challenges dns
-d '*.example.com' -d example.com --cert-name wildcard-example
加完记录别急着回车,先确认解析已经生效:dig +short TXT _acme-challenge.example.com @8.8.8.8 与 @223.5.5.5 都要能看到那串 base64。TTL 建议设 60 秒。同一域名同时签 example.com 和 *.example.com 时会出现两条同名 TXT,必须并存而不是覆盖,否则第二次校验必然失败。最后检查 CAA 是否放行了签发 CA:dig +short CAA example.com,没有记录则默认允许。
续期无需人工介入:acme.sh 安装时会写入 cron(crontab -l | grep acme 可查),默认在到期前 30 天自动续;certbot 用 --deploy-hook 挂上重载命令即可。
配置示例:Nginx 与 Apache 落地 + 防劫持三件套
拿到 fullchain(叶子证书 + 中间证书)后,Nginx 侧的关键是 server_name 同时写裸域和通配符,并把协议版本压到 TLS 1.2/1.3:
server {
listen 443 ssl;
http2 on; # nginx 1.25.1+ 写法,旧版用 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-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;
}
server {
listen 80;
server_name example.com *.example.com;
return 301 https://$host$request_uri;
}
Apache 2.4 的对应写法:
<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 -SSLv3 -TLSv1 -TLSv1.1
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
注意 ssl_trusted_certificate 要指向中间证书 chain.pem,而不是 fullchain.pem,否则 OCSP stapling 会静默失效。防劫持三件套:80 端口 301 强制跳转、HSTS 让浏览器后续直连 HTTPS、OCSP stapling 减少握手外联。但要清楚 includeSubDomains 意味着所有子域必须已支持 HTTPS,否则会被浏览器硬拦;preload 提交后极难撤回,务必等全站子域验证完毕再上。
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
对比表格:DV/OV/EV 与单域名/多域名/通配符
先修正一个流传很广的过时说法:所谓 EV 证书的“绿栅/绿色地址栏”已经不存在了。Chrome 77、Firefox 70 之后浏览器不再为 EV 显示公司名,EV 与 DV/OV 在地址栏里都是同一个锁标识,差别只剩证书详情里的组织字段与合规审计价值。
| 类型 | 验证内容 | 典型签发时长 | 浏览器表现 | 支持通配符 | 适用场景 |
|---|---|---|---|---|---|
| DV 域名验证 | 域名控制权(DNS TXT / HTTP 文件 / 管理员邮箱) | 10 分钟内 | 锁标识 | 支持 | 内部系统、API、CDN |
| OV 组织验证 | 营业执照、地址、电话回拨,与 WHOIS/公开库比对 | 1–3 个工作日 | 锁标识,证书详情含组织名 | 支持 | 官网、SaaS、政企 |
| EV 扩展验证 | 严格组织核验 + 第三方数据库交叉验证 | 3–7 个工作日 | 锁标识(不再显示绿色地址栏) | 不支持 | 金融、强合规行业 |
再看覆盖范围,这是选型时最容易出错的地方:
| 证书 SAN 配置 | example.com | www.example.com | a.b.example.com |
|---|---|---|---|
| DNS:example.com | ✅ | ❌ | ❌ |
| DNS:www.example.com | ❌ | ✅ | ❌ |
| DNS:*.example.com | ❌ | ✅ | ❌ |
| DNS:example.com, DNS:*.example.com | ✅ | ✅ | ❌ |
| 多域名:逐个列名 | 按列出情况 | 按列出情况 | 按列出情况 |
选型结论:内部系统、API 网关、CDN 回源这类“只要求加密、不要求身份展示”的场景,DV 通配符 + 自动续期性价比最高;对外官网、涉及支付或等保合规的,选 OV 通配符;EV 现在只用于少数强合规行业,且不能使用通配符,必须逐个域名列 SAN。无论选哪种,有效期上限都是 398 天,Let’s Encrypt 固定 90 天,任何宣称“多年期证书”的说法都是过时信息。
常见错误排查(含真实报错)
1. curl: (60) SSL: no alternative certificate subject name matches target host name 'example.com'
证书只有 *.example.com,裸域不在 SAN 里。重签时补上 -d example.com,同时检查 Nginx server_name 是否写了裸域。
2. nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines::key values mismatch)
证书与私钥不配对,多半是续期后只换了 fullchain 没换 key,或误拷了旧私钥。用第 3 节的公钥 md5 对比法确认。
3. curl: (60) SSL certificate problem: unable to get local issuer certificate
只部署了叶子证书,缺中间证书。必须用 fullchain.pem,或手工拼接:cat example.com.crt chain.pem > fullchain.pem。
4. certbot 报 Wildcard domains are not supported: *.example.com
用了 --webroot 或 --nginx 插件。通配符只能走 DNS-01,改用 --manual --preferred-challenges dns 或 DNS 插件。
5. acme.sh 报 _acme-challenge.example.com:Verify error:DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com
TXT 没写进去或尚未传播。先用 dig +short TXT _acme-challenge.example.com @8.8.8.8 复核;用 API 模式时检查 AccessKey 是否只有只读权限、是否漏了 AliyunDNSFullAccess 策略。
6. urn:ietf:params:acme:error:caa: CAA record for example.com prevents issuance
域名存在 CAA 记录但没授权当前 CA。补一条 example.com. 300 IN CAA 0 issue "letsencrypt.org"。
7. 浏览器 NET::ERR_CERT_DATE_INVALID
续期失败或服务器时间漂移。先 date -u 对时,再 openssl x509 -noout -dates -in fullchain.pem 看真实有效期。
效果验证:五条命令形成闭环
部署完不要只看浏览器有没有锁。用下面几条命令做闭环验证,任何一条不符合预期都说明配置没真正生效:
# 1) 看服务端实际下发的证书链、SAN 与有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2) 逐个验证子域(通配符最容易在这里翻车)
for h in example.com www.example.com api.example.com; do
echo -n "$h -> "; curl -sS -o /dev/null -w "%{http_code} verify=%{ssl_verify_result}n" https://$h
done
# 3) 检查 OCSP stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null
| grep -i "OCSP Response Status"
# 4) 到期监控(剩余不足 30 天返回非 0,可直接塞进 Zabbix/Prometheus)
openssl x509 -in example.com.fullchain.pem -noout -checkend 2592000
# 5) HSTS 与 CAA
curl -sI https://example.com | grep -i strict-transport-security
dig +short CAA example.com
期望结果:三个子域全部 verify=0;SAN 同时包含 example.com 与 *.example.com;OCSP 返回 successful;HSTS 头存在且 max-age 不小于 31536000。再跑一次 testssl.sh --severity MEDIUM https://example.com 或 nmap --script ssl-enum-ciphers -p 443 example.com,确认没有 TLS 1.0/1.1、没有 RC4/3DES、没有 SSLv3。最后在 SSL Labs 拿到 A 及以上评级,并确认 Chain issues 为 0,即证书链完整、无多余中间证书。
把第 4 条命令做成每分钟一次的探针,配合 acme.sh --cron 的日志(~/.acme.sh/acme.sh.log)一起看,就能在证书真正过期前 30 天收到告警,而不是等用户投诉。
常见问题
通配符证书能保护 example.com 裸域本身吗?
不能。*.example.com 中的星号只能匹配一个非空标签,裸域没有任何标签可匹配。解决办法是把 example.com 和 *.example.com 一起写进同一张证书的 SAN,签发时同时传 -d example.com -d '*.example.com'。
一张通配符证书能保护 a.b.example.com 这类二级子域吗?
不能。通配符只作用于星号所在的那一层。要覆盖 a.b.example.com,需要单独申请 *.b.example.com,或把该具体主机名直接写进 SAN。多层级站点的常见做法是按业务线拆成多张通配符证书。
Let’s Encrypt 的通配符证书有效期是多久?会过期吗?
固定 90 天,不提供更长有效期。acme.sh 默认在到期前 30 天自动续期,certbot 的 systemd timer 每天检查两次。只要 cron 或 timer 正常,证书不会过期;建议额外部署到期监控命令 openssl x509 -checkend 2592000 作为双保险。
通配符证书的私钥泄露了怎么办?
影响面是全部子域,处置要快:立即向 CA 申请吊销(Let’s Encrypt 可用 acme.sh --revoke -d example.com --ecc),重新生成一对新密钥并重签证书,全量替换部署,同时在 CT 日志监控里排查是否已有攻击者签发的同域名证书。日常预防靠私钥 600 权限、ECDSA P-256、签发机与部署机分离、CAA 记录锁定签发 CA。
一张通配符证书能同时放多个不同域名吗?
可以,这属于“多域名 + 通配符”的组合证书,例如 SAN 里同时放 *.example.com、example.com、*.example.net。受 SAN 数量上限约束,主流 CA 单张证书一般允许 100 个名字,超出需要拆分成多张证书。注意通配符证书不能是 EV 类型。
为什么买了 EV 证书,浏览器却不显示公司名和绿色地址栏?
因为浏览器厂商已经取消了这一展示。Chrome 77、Firefox 70 之后地址栏统一只显示锁标识,EV 的组织信息只能在证书详情里查看。如果供应商仍以“绿栅证书”为卖点宣传,说明资料已经过时;现在选 EV 的理由是合规审计与组织身份可追溯,而不是视觉效果。