密码学与证书 / 系统课时

dry-run 失败应该先查什么

dry-run 失败应该先查什么

certbot renew --dry-run 失败时,最有效的做法不是立刻重装 Certbot,而是先确定失败发生在哪个环节。通常应按“Certbot 错误信息 → DNS → Challenge 路径或端口 → 续期插件配置”的顺序定位,这样能最快缩小范围。

学习目标

  • 根据 dry-run 输出判断失败所属阶段
  • 检查域名解析和 HTTP-01 Challenge 是否真正到达本机
  • 核对续期配置中的认证插件与当前服务器环境是否一致

先把失败缩小到一个证书

多证书服务器先只测失败的证书。将 <CERTNAME> 替换为 certbot certificates 中显示的证书名称:

bash
sudo certbot renew --dry-run --cert-name <CERTNAME> -v

预期结果

text
成功:该证书的模拟续期完成。
失败:输出会保留更具体的认证、连接、插件或 Hook 错误信息。
实际错误文字会随认证方式和 Certbot 版本不同。

先看最靠近失败位置的错误,而不是只看最后一行。若出现域名解析错误、连接超时、unauthorized、插件加载失败或凭据读取失败,应分别进入对应分支。

Certbot dry-run 失败的排查顺序

检查 DNS 是否指向正确入口

HTTP-01 验证首先依赖公网 DNS。若域名刚迁移、同时存在旧 A 记录或 AAAA 仍指向旧服务器,CA 可能访问到错误主机。将 <HOST> 替换为证书中的真实域名:

bash
dig +short A <HOST>
dig +short AAAA <HOST>

预期结果

text
A/AAAA 查询应返回当前站点入口对应的公网 <IP>。
没有配置的记录类型可以为空;若返回旧地址或错误地址,应先修正 DNS。

若同时发布 A 和 AAAA,两个方向都要能正确完成验证,不能只确认 IPv4 后忽略错误的 IPv6 入口。

检查 HTTP-01 路径是否真的可访问

使用 webroot 或 Nginx 完成 HTTP-01 时,公网请求必须能取到 /.well-known/acme-challenge/ 下的文件。可在实际 Webroot 中放一个临时探针。将 <PATH> 替换为站点根目录,将 <HOST> 替换为真实域名:

bash
sudo mkdir -p <PATH>/.well-known/acme-challenge
printf 'certbot-probe\n' | sudo tee <PATH>/.well-known/acme-challenge/probe.txt >/dev/null
curl -fsSL http://<HOST>/.well-known/acme-challenge/probe.txt
sudo rm <PATH>/.well-known/acme-challenge/probe.txt

预期输出

text
certbot-probe

如果这里返回 404,应检查 Nginx 的 server_name、root 或针对 /.well-known/ 的 location;如果超时或拒绝连接,应先检查公网 80 端口、防火墙、反向代理和负载均衡入口。使用 standalone 时还要确认 80 端口能在续期期间交给 Certbot 监听。

核对续期插件配置

Certbot 的续期参数通常保存在 /etc/letsencrypt/renewal/<CERTNAME>.conf。重点核对其中的 authenticator 与当前环境是否一致:原来使用 webroot,但站点目录已经迁移;原来使用 Nginx 插件,但插件没有安装;使用 DNS 插件时,凭据文件被移动、权限变化或 API Token 失效,都会让 dry-run 失败。

不要把手工修改续期文件作为首选修复手段。优先通过 Certbot 支持的命令重新配置或重新签发,并在变更后再次执行 dry-run。若证书最初使用 --manual 且没有自动认证 Hook,它本身就不具备无人值守续期所需的自动 Challenge 能力。

修复后怎样验收

每次只修改一个明确问题,然后重新运行同一个 --cert-name <CERTNAME> --dry-run。这样可以确认是哪项改动真正解决了故障,也能避免 DNS、Nginx 和插件配置同时变化后无法判断根因。

当目标证书的 dry-run 稳定成功,并且自动续期所依赖的 DNS、端口、路径、插件和凭据都与生产环境一致时,才算把这条续期链路验证完整。

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

目录与阅读设置

阅读设置

17

记录一个想法

dry-run 失败应该先查什么

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

登录哪都通