用 DNS-01 CNAME 委托申请通配符证书:前置条件、签发步骤与验证方法
通配符证书只能走 DNS-01 验证,但把主域 DNS 交给 ACME 客户端风险大。本文演示如何用一条 CNAME 把验证委托到专用子域,完成签发、续期和结果验证。
本文目录

申请 *.example.com 通配符证书时,很多人卡在同一个地方:Let's Encrypt 只接受 DNS-01 验证,而主域的 DNS 在另一家服务商手里,API 权限又不想给得太宽。结果要么手动改 TXT 记录、每 60–90 天重复一次,要么干脆放弃通配符。
CNAME 委托就是给这个死结松绑的:把 _acme-challenge 这个子域的解析权交给一个专门用于验证的区域,主域 DNS 一行不动。
前置条件
动手前确认这几件事:
- 一个你控制的域名,以及其 DNS 控制台(只需要能加一条 CNAME 的权限)。
- 一台能运行 ACME 客户端的机器,出站可访问 ACME 服务端。
- 一个专门用于验证的 DNS 区域(可以是同一服务商下的子域 zone,也可以是独立域名),它能通过 API 自动写 TXT 记录。
为什么需要单独的验证区域?因为 ACME 客户端拿到的是这个区域的 API 凭据。如果它直接拿主域凭据,一旦凭据泄露,整个域的解析都暴露。隔离之后,泄露的影响面只剩一个仅供验证的子域——门锁坏了,至少保险柜还在。
第一步:添加委托 CNAME
在主域 DNS 中添加:
_acme-challenge.example.com. CNAME _acme-challenge.example.com.acme-zone.example.net.右侧是你在验证区域里准备接收 TXT 记录的名字。注意末尾的点和全称写法,按你 DNS 服务商的习惯调整。
用 dig 确认委托生效:

dig CNAME _acme-challenge.example.com +short应返回验证区域里的目标名。没解析到之前别往下走,后面的报错大概率都源于这里。
第二步:用 DNS-01 签发证书
以 Certbot 为例,配合对应验证区域的 DNS 插件(插件名字取决于你的服务商):
certbot certonly \
--dns-<provider> \
--dns-<provider>-credentials /etc/letsencrypt/creds.ini \
-d "*.example.com" -d example.com客户端流程是:从 _acme-challenge.example.com 顺着 CNAME 找到验证区域,在那里写入 TXT 记录,等 ACME 服务端来查。整个过程中主域的解析记录没有任何改动。
凭据文件建议权限设为 600,只放验证区域的 API token,别复用主域的全能 key。
在 CertbotX 中实践
如果手动维护插件和凭据觉得繁琐,CertbotX 已经把这条链路做成了配置项:开启 DNS-01 CNAME 委托后,填一次验证区域的 DNS 凭据,通配符证书就走 ACME 自动签发,到期前自动重新签发,不需要再守着日历续期。签发完成后可以配置自动部署到 Agent、EdgeOne 或其他 CDN 目标,每次部署都有记录可查,方便回溯"证书什么时候换的、推到哪了"这类值班时最常被问的问题。
第三步:验证结果
签发成功后做三层验证,别只看客户端输出"success"就关窗口:
本地查证书内容:

openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -subject -dates确认 SAN 里同时有 *.example.com 和 example.com(如果两个都申请了),记下 notAfter。
线上握手验证:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null \
| openssl x509 -noout -subject -issuer这验证的是服务器实际在用的证书,而不是磁盘上那份。签发成功但 Nginx 没 reload,是最常见的"明明续期了浏览器还报警"场景。
确认续期链路:
certbot renew --dry-rundry-run 会完整走一遍验证流程但不落盘。能通过,说明下次自动续期大概率没问题——CNAME 委托没断、凭据还有效。
几个容易踩的坑
- CNAME 目标写错层级。委托后 TXT 记录在验证区域的名字必须和 CNAME 右侧完全一致,多一级少一级都查不到。
- TXT 传播延迟。部分 DNS 服务商的 API 写完记录后全球可见有延迟,插件通常有 propagation 等待参数,验证偶发失败时先调大它,别急着怀疑配置。
- 换 DNS 服务商忘记迁移 CNAME。主域搬家后委托记录丢了,平时没感觉,续期那天集中爆发。把这条 CNAME 加进你的迁移检查清单。
延伸阅读: