泛域名证书续期又失败了?用 DNS-01 加 CNAME 委托把验证从主域名里挪出去
泛域名证书只能走 DNS-01 验证,直接改主域名 TXT 记录既危险又难自动化。本文讲清用 CNAME 委托把 _acme-challenge 指向独立验证区的做法、配置步骤和常见小坑。
本文目录

泛域名证书(*.example.com)有个绕不开的硬约束:Let's Encrypt 只接受 DNS-01 挑战。HTTP-01 和 TLS-ALPN-01 都不支持签发通配符证书,这是 CA 的既定策略,不是工具限制。于是很多人第一次申请泛域名证书时的现场都差不多:手动去 DNS 控制台加一条 _acme-challenge TXT 记录,签下来了;六十天后自动续期,失败——因为没人会定时去手点控制台。
更糟的是那种"半自动化"方案:把主域名的 NS 或 DNS API 密钥直接给签发机器,让它自己去改 _acme-challenge.example.com。能跑,但这台机器等于拿到了整个域的生杀大权——万一机器被入侵,攻击者可以把任意记录指走。这正是 CNAME 委托要解决的事。
委托的原理:把验证权从主域剥离
ACME 的 DNS-01 验证会解析 _acme-challenge.example.com 的 TXT 记录。RFC 8555 明确规定验证过程跟随 CNAME。这意味着你可以在主域里只放一条静态记录:
_acme-challenge.example.com. CNAME _acme-challenge.acme-dns.example.org.
然后让 ACME 客户端往 acme-dns.example.org 这个独立区域(可以挂在另一套 DNS、另一个服务商,甚至专门跑一个 acme-dns 服务)写 TXT。主域从此只有这一条一次性配置的 CNAME,主域的 API 密钥再也不需要出现在签发机器上。就算验证区的密钥泄露,攻击者能做的也只是替你应答挑战,动不了你的 A 记录和 MX 记录。
对多证书场景,可以给不同域指向同一验证区的不同子记录,客户端按 CNAME 链找到落点写入即可。
操作路径
- 在独立 DNS 区域(或新的 DNS 服务商账号)里建好验证用的子域,例如
acme-dns.example.org,确认其 NS 已正确委派。 - 在主域 DNS 里添加上面那条 CNAME。只加一次,之后不动。
- 给 ACME 客户端配置验证区的 API 凭据(而不是主域的凭据),指定 DNS-01 插件。
- 先用
--dry-run或 staging 环境跑一遍签发,确认 TXT 写入、传播、验证全链路通了,再切正式环境。staging 环境不会消耗正式速率限制,适合反复试。 - 确认续期定时任务(systemd timer 或 cron)存在且会执行续期后的部署钩子。
一个容易踩的坑:TXT 记录写入后到 Let's Encrypt 查询之间需要 DNS 传播时间。多数插件有默认等待,但跨区域解析或权威服务器响应慢时可能不够。如果续期间歇性失败而日志显示 TXT 值对不上,优先怀疑传播延迟,把等待时间调大再观察。
另一个坑:主域里如果存在 _acme-challenge 的旧 TXT 记录或错误的 CNAME 冲突,验证会拿错值。dig _acme-challenge.example.com TXT 和 dig +trace 是最直接的排查手段,先看解析链是不是你预期的样子,再去翻客户端日志。

在 CertbotX 中实践
上面这套流程在 CertbotX 里可以直接落地:配置 DNS-01 时选择 CNAME 委托模式,把验证指向独立区域,主域只保留静态 CNAME;之后由 ACME 自动签发并在到期前自动重新签发,不需要人工介入控制台。签发完成后,证书可以按配置自动部署到 Agent、EdgeOne 或其他 CDN 节点,每次续期和部署都会留下记录,方便事后审计某台机器上跑的到底是哪一版证书——半夜被"证书还有 3 天过期"的告警吵醒时,这类记录比记忆可靠得多。
边界情况
- CNAME 委托只转移了"应答挑战"的能力,不意味着可以放松验证区凭据的保管。拿到它的人理论上可以为你名下的域申请证书。
- 某些 DNS 服务商对 CNAME 目标区域的解析速度有差异,跨服务商委托时先用 staging 环境验证整条链。
- 如果证书要覆盖裸域加泛域名(
example.com和*.example.com),两者都要各自完成一次 DNS-01 挑战,CNAME 记录需要分别存在——一个是_acme-challenge.example.com,泛域名用的其实也是同一条,但签两份标识时要应答两次不同的 TXT 值,客户端会顺序处理,不用额外配置,知道有这回事即可。
延伸阅读: