密码学与证书 / 系统课时

_acme-challenge 记录是什么

_acme-challenge 记录是什么

使用 DNS-01 申请证书时,真正被 ACME 服务检查的不是网站页面,而是一条名为 _acme-challenge 的 DNS TXT 记录。本节会把记录名称、TXT 值的来源、查询过程和常见边界讲清楚,并用 dig 验证记录是否已经对公网生效。

学习目标

  • 解释 _acme-challenge TXT 记录在 DNS-01 验证中的作用
  • 根据待验证域名判断应创建哪条 TXT 记录
  • 使用 DNS 查询确认验证记录已正确发布

_acme-challenge 是验证入口

DNS-01 的核心逻辑是:申请者必须能修改目标域名的权威 DNS。ACME 服务给客户端一个 challenge token,客户端基于该 token 和 ACME 账户密钥计算出验证值,再把它发布为 TXT 记录。CA 随后从公网 DNS 查询这个值,匹配成功才继续签发证书。

例如要验证 example.com,通常查询:

bash
dig TXT _acme-challenge.example.com +short

预期输出

text
"<TOKEN>"

<TOKEN> 表示实际 TXT 内容,每次挑战都可能不同。这里的命令只负责查询,不会创建或修改 DNS 记录;如果返回为空,需要先检查记录是否已经添加到实际负责该域名的权威 DNS。

DNS-01 中 _acme-challenge TXT 记录的生成与查询链路

记录名怎样从域名得到

规则可以理解为在待验证名称前加 _acme-challenge.。验证 www.example.com 时,记录名是 _acme-challenge.www.example.com;验证 api.example.com 时,则是 _acme-challenge.api.example.com。

通配符是一个重要例外。申请 *.example.com 时,验证对象按 ACME 规则落到基础域名,因此使用 _acme-challenge.example.com,而不是 _acme-challenge.*.example.com。这也是自动化脚本不能简单把证书中的字符串原样拼到 _acme-challenge. 后面的原因。

TXT 值不是随便填写的字符串

DNS 控制台里填写的 TXT 值来自当前 ACME challenge。它不是域名、邮箱或证书公钥,也不应该长期写死。一次验证结束后,旧值通常可以移除;下一次续期时客户端会得到新的 challenge,并发布新的 TXT 值。

如果同时为多个订单或多个授权做验证,同一个 _acme-challenge 名称短时间内可能存在多个 TXT 值。DNS 本身允许同名多值记录,因此不要在自动化过程中无条件删除仍被其他验证使用的值。

为什么“已经添加”仍可能验证失败

最常见原因是 CA 看到的 DNS 结果还没有更新。管理后台显示保存成功,只代表提供商已经接受变更,不等于所有权威服务器和递归缓存都已经返回新值。验证前应从公网查询,而不是只看控制台。

还要确认记录加在正确的 DNS 区域。如果域名的 NS 已经委派给另一家 DNS 服务商,在旧平台新增 TXT 不会影响真实查询结果。对于使用 CNAME 委派 _acme-challenge 的场景,还要检查别名最终指向的位置是否确实发布了 challenge TXT。

把 _acme-challenge 理解为“CA 可从公网查询的临时所有权证明”最准确:客户端负责生成证明,DNS 负责公开证明,CA 负责查询并核对证明。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

_acme-challenge 记录是什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通