密码学与证书 / 系统课时

renew --dry-run 测试了什么

renew --dry-run 测试了什么

certbot renew --dry-run 用来提前演练证书续期链路:它会按现有续期配置执行认证并向测试 CA 申请测试证书,但不会用测试证书替换当前生产证书。理解它覆盖和不覆盖的范围,才能正确判断“dry-run 成功”代表什么。

学习目标

  • 说明 renew --dry-run 实际验证的续期环节
  • 区分 dry-run 与真实生产续期的差异
  • 判断哪些 Hook 和部署动作还需要额外验证

dry-run 会走过哪些环节

Certbot 会读取已保存的续期配置,复用证书原先使用的认证器及相关参数,然后向测试 ACME 服务发起模拟续期。HTTP-01、DNS-01 或 Standalone 等认证方式仍需要真正完成相应的域名控制权验证,因此 DNS、端口、Webroot、插件凭据等问题都会在这里暴露出来。

renew dry-run 的模拟续期链路

这意味着 dry-run 不只是检查命令语法。只要续期依赖公网 DNS、80 端口、Nginx 配置、Webroot 路径或 DNS API 凭据,这些依赖仍需要在测试时可用。

执行一次完整演练

在生产服务器上直接运行:

bash
sudo certbot renew --dry-run

预期结果

text
命令完成模拟续期;成功的证书会在结果摘要中显示模拟续期成功。
当前生产证书不会被测试证书替换。
实际日志文字、证书名称和路径会随 Certbot 版本与本机证书数量不同。

若只想验证一个证书,可以再配合 --cert-name 选择对应证书,避免其他证书的错误干扰判断。

哪些事情不会被 dry-run 等价验证

--dry-run 使用测试 CA,取得的是测试证书,而且不会把它保存为当前生产证书。因此它不能证明生产 CA 在未来某个时间点一定能成功签发,也不能证明网站已经加载了新生产证书。

Hook 也要单独注意:pre-hook 和 post-hook 会在 dry-run 中按规则运行,而 deploy-hook 默认不会运行。若部署动作本身也需要测试,可使用 --run-deploy-hooks;此时 Hook 使用的是当前活动证书,而不是本次临时取得的测试证书。

怎样解读 dry-run 成功

dry-run 成功说明当前续期配置、认证插件和域名验证链路在测试环境下能够协同工作,是自动续期前最重要的验收之一。但它仍是一次时间点测试:以后若 DNS、Nginx、Webroot、插件凭据、网络策略或 Hook 发生变化,真实续期仍可能失败。

因此,正确结论不是“证书以后一定会续上”,而是“以当前配置和环境,主要续期链路已经通过了一次不替换生产证书的模拟验证”。

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

目录与阅读设置

阅读设置

17

记录一个想法

renew --dry-run 测试了什么

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

登录哪都通