密码学与证书 / 系统课时
手工 DNS 验证有什么问题
手工 DNS 验证有什么问题
手工 DNS-01 能签发普通域名和通配符证书,但验证过程中必须有人把 Certbot 给出的 TXT 值写进 DNS。本文会完成一次手工验证,并说明为什么这种方式难以接入无人值守的自动续期。
学习目标
- 理解 manual DNS Challenge 中人工操作发生在哪一步
- 能按 Certbot 提示创建并核对
_acme-challengeTXT 记录 - 判断手工 DNS 验证适合临时签发还是长期自动续期
手工 DNS-01 实际在做什么
DNS-01 的证明对象不是 Web 服务器,而是域名的 DNS 控制权。Certbot 向 ACME CA 申请授权后,会得到一个挑战值,并要求你在 _acme-challenge.example.com 下发布 TXT 记录。CA 从公网查询到正确值后,才会认为你能够控制该域名。

通配符证书必须使用 DNS-01,因为 HTTP-01 不能证明 *.example.com 这一类通配符标识符的控制权。若一次申请同时包含 example.com 和 *.example.com,Certbot 可能要求在同一个 _acme-challenge.example.com 名称下同时保留两个不同 TXT 值;不要为了添加第二个值而覆盖第一个值。
完成一次手工验证
下面的命令申请根域名和通配符证书,并强制使用 manual DNS-01。运行后 Certbot 会暂停,等待你完成 DNS 记录发布。
sudo certbot certonly --manual --preferred-challenges dns -d 'example.com' -d '*.example.com'预期输出
Certbot 会要求创建 _acme-challenge.example.com 的 TXT 记录。
TXT 值为动态挑战值,例如 <TOKEN>。
完成 DNS 发布后,终端会等待你确认并继续验证。<TOKEN> 每次申请都会变化,不能复用旧值。若 Certbot 为两个授权分别给出不同值,应让它们同时存在,等本次验证完成后再删除。
在确认继续前,可以从公网 DNS 视角查询 TXT 记录:
dig TXT _acme-challenge.example.com +short预期输出
"<TOKEN>"实际查询结果应包含 Certbot 当前显示的全部挑战值;如果仍看不到新值,不要急着在 Certbot 中继续,否则 CA 查询到旧记录或空结果时会导致验证失败。
手工方式为什么难以自动续期
问题不在签发能力,而在每次续期都会产生新的挑战值。无人值守的 certbot renew 无法自行登录 DNS 控制台、创建 TXT、等待其可见,再在验证后清理记录,所以纯交互式 manual 流程会停在人工步骤。
Certbot 的 manual 模式可以配合 --manual-auth-hook 和 --manual-cleanup-hook 把创建、删除 TXT 的动作交给脚本,但这实际上已经把 DNS 自动化责任转移给外部程序。脚本仍需要安全地调用 DNS API,并正确处理失败、传播等待和清理。
什么时候仍适合手工 DNS
手工方式适合一次性测试、DNS 服务商没有可用 API,或短期迁移期间临时签发证书。它的优点是通用,不依赖特定 Provider 插件;代价是每次挑战都需要人工介入。
如果证书将长期运行在生产环境并依赖自动续期,应优先选择受支持的 DNS Provider 插件或可靠的 DNS API 自动化方案,让 TXT 记录的创建、等待和清理由 Certbot 的续期流程自动完成。