跳到主要内容
Comodo SSL证书

通配符 SSL 证书(Wildcard)实战指南:签发、配置与子域名 HTTPS 防劫持

通配符 SSL 证书(Wildcard)实战指南:签发、配置与子域名 HTTPS 防劫持 — 通配符 SSL 证书(Wildcard)实战指南:签发、配置与子域名 HTTPS 防劫持

一、问题背景与根因:子域名一多,HTTPS 就开始报错

典型场景:主站 example.com 已上 HTTPS,业务扩张后陆续出现 api、m、admin、static、pay 等 20 多个子域名。运维按“一个域名一张证书”采购,新子域上线时忘记配证书,用户立刻看到“您的连接不是私密连接”;更糟的是未加密的子域被 DNS 劫持,页面被注入广告或恶意 JS。三个根因:

  • 证书覆盖范围与域名清单强绑定:单域名/多域名证书只对 SAN 列表里的 FQDN 有效,新增子域必须重新签发、重新部署、重新 reload,任何一次遗漏就是一次线上事故。
  • 浏览器把 HTTP 明确标记为不安全:Chrome/Edge 对 http:// 表单页显示“不安全”,混合内容会被直接拦截;未加密的子域是中间人注入最省力的入口。
  • 通配符证书(Wildcard)用一张证书覆盖 *.example.com,所有一级子域共用同一对密钥与同一份证书,新增子域零签发成本,把“漏配”的概率压到最低。

先做一次体检,看现有子域证书是否真的匹配(返回码 0 才是校验通过):

for h in www api m admin; do echo | openssl s_client -connect $h.example.com:443 -servername $h.example.com 2>/dev/null | grep 'Verify return code'; done

顺带纠正三个流传很广的说法:其一,“买 3 年就不用管”已不成立,公有 TLS 证书最长有效期 398 天(CA/Browser Forum 自 2020 年 9 月起强制),必须做自动化续期;其二,“最高 256-bit 加密”指的是 TLS 握手协商出的对称加密套件(如 AES-256-GCM)或 ECC P-256 曲线,与证书本身的“强度”没有直接关系,DV 通配符证书的密码学强度取决于私钥长度与签名算法;其三,DV 证书宣传的“$1000 保障”是 CA 的保修条款,赔付条件苛刻(需证明 CA 过失并产生实际损失),不能当作安全兜底。真正的兜底是私钥保管、HSTS 与 CAA。

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

Wildcard 证书的 SAN 里写的是 *.example.com,星号只匹配一级标签。很多团队以为它能“无限层级”,结果在 a.b.example.com 上翻车。先看规则表:

证书 SAN 配置 能匹配 不能匹配
*.example.com www.example.com、api.example.com example.com(裸域)、a.b.example.com(二级)
*.example.com + example.com 裸域 + 全部一级子域 a.b.example.com
*.a.example.com x.a.example.com a.example.com、y.b.a.example.com

所以签发时务必同时带上裸域(-d example.com -d ‘*.example.com’),否则用户直接访问 https://example.com 会报 NET::ERR_CERT_COMMON_NAME_INVALID。核对现有证书覆盖范围:

openssl x509 -in /etc/nginx/ssl/example.com.pem -noout -text | grep -A1 'Subject Alternative Name'

其余边界同样要记牢:1)验证方式只能是 DNS-01,因为签发机构需要确认你控制整个域,HTTP-01 无法证明这一点,用 HTTP-01 申请通配符会被 ACME 服务器直接拒绝;2)不保护内网域名与 IP,公有 CA 不会为 .local、.internal、无点主机名或私网 IP 签发证书,内网请用 step-ca、mkcert 或企业自建 CA 并下发根证书;3)中文域名需转 Punycode(xn-- 前缀)后再写进 SAN;4)通配符证书没有 EV 版本,OV 通配符也只有部分 CA 提供,绝大多数低价通配符都是 DV——只验证域名控制权,不验证企业身份;5)所有子域共用同一私钥,一台边缘节点泄露等于全域泄露,必须限制私钥文件权限(chmod 600、属主 root)并考虑按环境拆分子域。

三、完整实操:acme.sh 与 certbot 签发通配符证书

免费路线首选 Let’s Encrypt(有效期 90 天,全自动续期),商业 CA 的 DV 通配符通常 10 分钟到数小时签发(取决于 DNS 记录生效速度)。下面两条路线都走 DNS-01。

路线 A:acme.sh + 阿里云 DNS API(推荐生产使用)

curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
export Ali_Key='LTAI5txxxxxxxx'
export Ali_Secret='xxxxxxxxxxxxxxxx'
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256

注意 -d ‘*.example.com’ 的单引号不能省,否则星号会被 shell 当作通配符展开成当前目录的文件名,报 can not find domain。–keylength ec-256 生成 ECDSA P-256 私钥,比 RSA 2048 握手更快、体积更小;若客户端极老(Android 6 以下、Windows XP),改用 –keylength 2048。

~/.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.pem --reloadcmd 'systemctl reload nginx'

–install-cert 会把证书复制到目标路径并注册续期后的 reload 动作,这一步不做,续期成功但 Nginx 仍用旧证书。

路线 B:certbot(DNS 插件自动化)

certbot certonly --dns-cloudflare --dns-cloudflare-credentials /root/.secrets/cf.ini -d example.com -d '*.example.com' --agree-tos -m ops@example.com --preferred-challenges dns

没有插件时用 –manual –preferred-challenges dns 手动模式,certbot 会提示你添加两条 TXT 记录(裸域与泛域各一条,值不同),先验证再回车:

dig +short TXT _acme-challenge.example.com @8.8.8.8

手动模式无法自动续期,仅用于验证流程;生产必须换成 DNS 插件或 acme.sh 的 dnsapi。凭据文件务必 chmod 600,切勿提交进 Git。测试阶段加 –staging,避免触发 Let’s Encrypt 的重复签发限流。

四、配置示例:Nginx 与 Apache 启用通配符证书

Nginx 侧的关键点:server_name 里的通配符可以匹配多级(*.example.com 能命中 a.b.example.com),但证书不行,这是最容易误判的坑——配置命中不等于证书校验通过。

server {
    listen 443 ssl;
    http2 on;
    server_name example.com *.example.com;
    ssl_certificate     /etc/nginx/ssl/example.com.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_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    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; }

说明:ssl_certificate 必须指向 fullchain(叶子证书 + 中间证书),只放叶子证书会得到 ERR_CERT_AUTHORITY_INVALID;ssl_trusted_certificate 用于 OCSP stapling 校验,指向中间证书 chain.pem。Strict-Transport-Security 加了 includeSubDomains 后,所有子域都必须支持 HTTPS,否则会被浏览器硬拦,上线前确认没有遗留的 HTTP-only 子域。nginx 1.25.1 以下版本把 http2 on; 换成 listen 443 ssl http2;。

<VirtualHost *:443>
  ServerName example.com
  ServerAlias *.example.com
  SSLEngine on
  SSLCertificateFile /etc/httpd/ssl/example.com.pem
  SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
  SSLProtocol -all +TLSv1.2 +TLSv1.3
  Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

Apache 2.4.8 及以上把中间证书写进 SSLCertificateFile(即 fullchain),不再需要 SSLCertificateChainFile;老版本才需要单独指定。多个子域要指向不同后端时,为每个子域写独立 server 块,共用同一对 ssl_certificate 与 ssl_certificate_key 即可,不必重复购买证书。

五、证书有效期与自动续期策略

必须纠正的过时认知:公有 TLS 证书最长有效期早已不是 2 年。CA/Browser Forum 从 2020-09-01 起强制 398 天上限,且按 SC-081 决议将继续分阶段缩短——2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天(以 CA 正式公告为准)。也就是说“买 3 年证书省事”在技术上不可行:CA 只是分次签发,运维仍要按期部署。

证书类型 单张最长有效期 建议续期触发点 续期方式
公有 CA 通配符(商业 DV/OV) 398 天(未来缩短至 200/100/47 天) 到期前 30 天 CA 控制台重签 + 手动部署
Let’s Encrypt 通配符 90 天 到期前 30 天(acme.sh 默认 60 天) acme.sh / certbot 自动
内网自建 CA 自定(建议 ≤ 397 天) 到期前 30 天 脚本 + 配置管理工具

检查自动续期是否真的在跑:

crontab -l | grep acme
systemctl list-timers | grep certbot
~/.acme.sh/acme.sh --list
certbot renew --dry-run

acme.sh 安装时会写入一条每日执行的 cron,续期成功后自动调用 –install-cert 注册的 reloadcmd;certbot 由 certbot.timer 驱动,renew 只对剩余有效期不足 30 天的证书动作。三个常见疏漏:1)DNS API 凭据过期,续期时报 InvalidAccessKeyId.NotFound,需定期轮换并更新环境变量;2)reloadcmd 写成 systemctl restart nginx,虽然生效但会中断连接,应改用 reload;3)监控只看进程不看证书,建议对 443 端口做黑盒探测,证书剩余天数少于 20 天即告警。

六、选型对比:通配符、多域名 SAN 与单域名

维度 单域名 DV 多域名 SAN(UCC) 通配符 Wildcard(DV)
覆盖范围 1 个 FQDN 默认 5 个,可扩展到 100+ 无限个一级子域 + 裸域(需显式加)
新增子域 必须重签 必须重签(加 SAN) 无需重签,DNS 解析即可
验证方式 HTTP-01 / DNS-01 HTTP-01 / DNS-01 仅 DNS-01
跨主域(example.com + example.net) 不支持 支持 不支持,需另签或合并 SAN
多级子域(a.b.example.com) 支持(单独签) 支持 不支持
私钥风险面 单域 多域共用 全域共用,泄露影响最大
典型成本 最低(可用免费 LE) 中等,按 SAN 数量加价 高于单域名,远低于逐个购买
适用场景 单站点、测试环境 跨主域、少量异构域名 SaaS 多租户、子域数量超过 5 且同属一级域

选型经验值:子域数量稳定在 5 个以内、且域名分散在不同主域时,多域名 SAN 更划算,因为它能跨主域;子域数量多、按租户或环境动态生成(tenant1.example.com、tenant2.example.com)时,通配符几乎是唯一可持续的方案。混合策略也很常见:一张通配符 *.example.com 兜住业务子域,再用一张 SAN 证书覆盖 example.net、example.cn 等其它主域。注意 DV 通配符无法在证书详情里展示企业名称,若业务需要展示组织身份,只能选 OV 通配符(部分 CA 提供),EV 通配符在公开信任体系中并不存在。

七、常见错误排查(含真实报错)

下面这些报错几乎覆盖了通配符证书 90% 的线上问题,按报错原文检索即可。

报错信息 根因 修复
curl: (60) SSL: no alternative certificate subject name matches target host name ‘a.b.example.com’ 通配符只匹配一级,多级子域不在 SAN 内 单独签发 *.b.example.com,或把该域名加入 SAN
NET::ERR_CERT_COMMON_NAME_INVALID(访问裸域时) 签发时漏了 -d example.com 重签并同时带裸域与泛域
nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 证书与私钥不配对(续期后只换了其中一个) 比对公钥指纹后重新 install-cert
DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com TXT 记录未生效、写错主机名或 DNS 未同步 dig 校验权威与公共 DNS 一致后再重试
too many certificates (5) already issued for this exact set of domains in the last 168h 反复调试触发 Let’s Encrypt 限流 改用 –staging 调试,等待 7 天或换账户

证书与私钥是否配对,用公钥指纹比对最快(ECDSA 与 RSA 通用):

openssl x509 -in example.com.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

两个 md5 必须一致。另一个高频问题是浏览器报 ERR_CERT_AUTHORITY_INVALID:说明只部署了叶子证书、没带中间证书,检查证书链段数应不少于 2:

grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com.pem
openssl verify -untrusted /etc/nginx/ssl/chain.pem -CAfile /etc/ssl/certs/ca-certificates.crt /etc/nginx/ssl/example.com.pem

若报 urn:ietf:params:acme:error:unauthorized 且提示 Invalid response from http://example.com/.well-known/acme-challenge/xxx,说明你在用 HTTP-01 申请通配符,必须换成 DNS-01。改完配置先执行 nginx -t 再 systemctl reload nginx,直接 reload 一个语法错误的配置会导致旧进程继续跑、新配置不生效,排查时极易误判。

八、效果验证:从命令行到 SSL Labs

部署完不要只看浏览器绿锁,按下面四层验证。

1)证书内容与链

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

2)握手校验结果(Verify return code: 0 (ok) 才算通过)

echo | openssl s_client -connect api.example.com:443 -servername api.example.com 2>/dev/null | grep -E 'Verify return code|subject='

3)HTTP 层实测,ssl_verify_result 为 0 表示客户端校验通过,同时确认 HSTS 头已下发:

curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://api.example.com
curl -sSI https://example.com | grep -i strict-transport-security

4)协议与评分:用 testssl.sh 或 Qualys SSL Labs 跑一次,目标 A/A+,重点看是否仍支持 TLS 1.0/1.1、是否启用 OCSP stapling、是否配置了前向保密套件。另外建议查一次证书透明度日志,确认没有别人给你的域名误签证书:

curl -s 'https://crt.sh/?q=%25.example.com&output=json' | jq -r '.[].name_value' | sort -u

防劫持不止于证书:给主域配置 CAA 记录,把可签发 CA 限定为你在用的那几家,能显著降低误签风险——example.com. CAA 0 issue ‘letsencrypt.org’。若要彻底防降级,再叠加 HSTS preload(提交后不可撤回,务必确认全部子域已支持 HTTPS)与 DNSSEC。验证通过后把上述命令固化成拨测脚本,每 5 分钟检查一次证书剩余天数与校验返回码,才是真正的防劫持闭环。

常见问题

一张通配符证书真的能覆盖无限子域名吗?

覆盖数量无限,但层级有限:*.example.com 只匹配一级子域(www、api、m),不匹配裸域 example.com,也不匹配 a.b.example.com。要让裸域也可用,签发时必须同时提交 -d example.com -d ‘*.example.com’。另外所有子域共用同一私钥,一旦某台边缘节点泄露,全域都受影响,建议按环境拆分并严格限制私钥权限。

通配符证书可以用 HTTP-01 验证吗?

不可以。ACME 规范要求通配符必须用 DNS-01,因为签发机构需要确认申请者控制整个域,而 HTTP-01 只能证明某个具体主机名可控。实操上就是给 _acme-challenge.example.com 添加 TXT 记录,用 dig +short TXT _acme-challenge.example.com @8.8.8.8 确认生效后再提交。

内网域名或 IP 能申请通配符证书吗?

公有 CA 一律不签发,.local、.internal、无点主机名和私网 IP 都无法通过验证,这也是很多产品页标注“内部域名不支持”的原因。内网场景请自建 CA(step-ca、mkcert、企业 AD CS),把根证书通过组策略或 MDM 下发到终端,并注意自签证书不受浏览器公开信任。

买了三年期通配符证书,是不是三年不用管?

不是。公有 TLS 证书最长有效期 398 天,且按 CA/Browser Forum SC-081 将逐步缩短到 200 天、100 天、47 天,CA 只能分次签发,你仍要按期部署。Let’s Encrypt 更是只有 90 天。正确做法是把续期与 reload 全自动化,并对证书剩余天数做监控告警。

通配符证书和多域名 SAN 证书怎么选?

子域数量超过 5 个、且都属于同一主域时选通配符,新增子域零成本;需要跨主域(example.com + example.net)时选 SAN,因为一张通配符不能跨主域。两者可以混用:通配符兜住业务子域,SAN 证书覆盖其它主域,避免为每个域名单独维护一套续期流程。

上了通配符证书就能防域名劫持吗?

证书解决的是传输加密与身份校验,能防内容篡改和中间人注入,但防不了 DNS 层面的解析劫持。完整方案是 TLS + HSTS(含 includeSubDomains)+ CAA 记录限定可签发 CA + DNSSEC,再配合证书透明度日志监控异常签发。

内容审核

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