密码学与证书 / 系统课时
续期任务执行失败怎么查
续期任务执行失败怎么查
自动续期失败时,最有效的做法不是立刻重装 Certbot,而是沿着“调度器 → Certbot → 续期配置 → 域名验证 → 证书部署”逐层定位。完成本节后,你能找到最近一次失败发生在哪一步,并用 dry-run 验证修复是否真正生效。
学习目标
- 判断自动续期由 systemd timer、cron 还是其他机制触发
- 从续期配置和日志中定位认证、网络、Nginx 或部署阶段的失败
- 使用
certbot renew --dry-run复现问题并验证修复
从调度器确认任务有没有真正启动
先确认“定时任务没执行”还是“任务执行了但 Certbot 失败”。不同发行版的安装方式不同,Certbot 可能由 certbot.timer、cron 或打包系统提供的其他调度机制触发,因此不要只检查一个入口。
下面的命令同时查看 systemd timer 和常见 cron 配置;|| true 用于避免某个入口不存在时中断整组检查。
systemctl list-timers --all | grep -i certbot || true
systemctl status certbot.timer --no-pager || true
grep -R "certbot" /etc/cron.d /etc/crontab 2>/dev/null || true预期结果
若使用 systemd:可以看到 certbot.timer,状态通常为 active (waiting),并显示下一次触发时间 <TIME>。
若未使用 systemd timer:可能提示 Unit certbot.timer could not be found,此时应以 cron 或系统实际安装方式为准。如果 timer 已启用但长时间没有触发记录,优先检查 timer 状态和系统时钟;如果任务已触发,则继续追踪 Certbot 本身的执行结果。

用日志确定失败停在哪一层
如果调度器确实启动过任务,就查看最近一次服务日志和 Certbot 主日志。日志时间应与定时任务触发时间对应,否则很容易拿旧错误误判当前问题。
sudo journalctl -u certbot.service --since "24 hours ago" --no-pager
sudo tail -n 120 /var/log/letsencrypt/letsencrypt.log预期结果
输出最近一次续期尝试的真实时间和错误信息。若系统没有 certbot.service,第一条可能没有记录;第二条应以本机实际日志内容为准。定位时先看第一条明确错误,而不是只看最后一句“renewal failed”。认证失败通常会指向 DNS、HTTP-01 路径或端口可达性;插件加载失败会指向 authenticator;部署阶段失败则常与 Nginx 配置检查、reload 或自定义 hook 有关。
核对证书和续期配置
certbot certificates 可以确认 Certbot 当前管理哪些证书、证书名称是什么。续期配置通常位于 /etc/letsencrypt/renewal/,排查时重点核对证书名称、域名列表、认证方式和插件相关参数,不要凭记忆猜配置。
CERT_NAME='<ID>'
sudo certbot certificates
sudo sed -n '1,180p' "/etc/letsencrypt/renewal/${CERT_NAME}.conf"预期结果
certbot certificates 会列出实际的 Certificate Name 和域名;对应 renewal 配置中可看到该证书续期所使用的认证器及相关参数。实际内容以本机配置为准。这里的 <ID> 要替换成 certbot certificates 显示的 Certificate Name。若配置引用了已经不存在的 Webroot、失效的插件或旧路径,应先修复真实环境;不要为了让一次续期通过而随意删除整个 /etc/letsencrypt 目录。
用 dry-run 复现并验证修复
修复后不要等待下一次定时触发。--dry-run 会走一遍模拟续期流程,适合验证认证路径、插件和部署前条件是否已经恢复。
CERT_NAME='<ID>'
sudo certbot renew --cert-name "$CERT_NAME" --dry-run预期结果
成功时,该证书的模拟续期完成且命令以成功状态退出;失败时会直接打印失败证书和对应原因。具体提示文字可能随 Certbot 版本不同。如果 dry-run 成功而定时任务仍失败,问题通常已经从“证书续期逻辑”缩小到“调度运行环境”,例如服务账户、环境变量、网络策略或 hook 在非交互环境中的行为。继续以定时任务的实际日志为准,而不要用手工执行成功替代自动化验证。