通配符 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,再配合证书透明度日志监控异常签发。