密码学与证书 / 系统课时

续期任务执行失败怎么查

续期任务执行失败怎么查

自动续期失败时,最有效的做法不是立刻重装 Certbot,而是沿着“调度器 → Certbot → 续期配置 → 域名验证 → 证书部署”逐层定位。完成本节后,你能找到最近一次失败发生在哪一步,并用 dry-run 验证修复是否真正生效。

学习目标

  • 判断自动续期由 systemd timer、cron 还是其他机制触发
  • 从续期配置和日志中定位认证、网络、Nginx 或部署阶段的失败
  • 使用 certbot renew --dry-run 复现问题并验证修复

从调度器确认任务有没有真正启动

先确认“定时任务没执行”还是“任务执行了但 Certbot 失败”。不同发行版的安装方式不同,Certbot 可能由 certbot.timer、cron 或打包系统提供的其他调度机制触发,因此不要只检查一个入口。

下面的命令同时查看 systemd timer 和常见 cron 配置;|| true 用于避免某个入口不存在时中断整组检查。

bash
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

预期结果

text
若使用 systemd:可以看到 certbot.timer,状态通常为 active (waiting),并显示下一次触发时间 <TIME>。
若未使用 systemd timer:可能提示 Unit certbot.timer could not be found,此时应以 cron 或系统实际安装方式为准。

如果 timer 已启用但长时间没有触发记录,优先检查 timer 状态和系统时钟;如果任务已触发,则继续追踪 Certbot 本身的执行结果。

Certbot 自动续期故障定位链路

用日志确定失败停在哪一层

如果调度器确实启动过任务,就查看最近一次服务日志和 Certbot 主日志。日志时间应与定时任务触发时间对应,否则很容易拿旧错误误判当前问题。

bash
sudo journalctl -u certbot.service --since "24 hours ago" --no-pager
sudo tail -n 120 /var/log/letsencrypt/letsencrypt.log

预期结果

text
输出最近一次续期尝试的真实时间和错误信息。若系统没有 certbot.service,第一条可能没有记录;第二条应以本机实际日志内容为准。

定位时先看第一条明确错误,而不是只看最后一句“renewal failed”。认证失败通常会指向 DNS、HTTP-01 路径或端口可达性;插件加载失败会指向 authenticator;部署阶段失败则常与 Nginx 配置检查、reload 或自定义 hook 有关。

核对证书和续期配置

certbot certificates 可以确认 Certbot 当前管理哪些证书、证书名称是什么。续期配置通常位于 /etc/letsencrypt/renewal/,排查时重点核对证书名称、域名列表、认证方式和插件相关参数,不要凭记忆猜配置。

bash
CERT_NAME='<ID>'
sudo certbot certificates
sudo sed -n '1,180p' "/etc/letsencrypt/renewal/${CERT_NAME}.conf"

预期结果

text
certbot certificates 会列出实际的 Certificate Name 和域名;对应 renewal 配置中可看到该证书续期所使用的认证器及相关参数。实际内容以本机配置为准。

这里的 <ID> 要替换成 certbot certificates 显示的 Certificate Name。若配置引用了已经不存在的 Webroot、失效的插件或旧路径,应先修复真实环境;不要为了让一次续期通过而随意删除整个 /etc/letsencrypt 目录。

用 dry-run 复现并验证修复

修复后不要等待下一次定时触发。--dry-run 会走一遍模拟续期流程,适合验证认证路径、插件和部署前条件是否已经恢复。

bash
CERT_NAME='<ID>'
sudo certbot renew --cert-name "$CERT_NAME" --dry-run

预期结果

text
成功时,该证书的模拟续期完成且命令以成功状态退出;失败时会直接打印失败证书和对应原因。具体提示文字可能随 Certbot 版本不同。

如果 dry-run 成功而定时任务仍失败,问题通常已经从“证书续期逻辑”缩小到“调度运行环境”,例如服务账户、环境变量、网络策略或 hook 在非交互环境中的行为。继续以定时任务的实际日志为准,而不要用手工执行成功替代自动化验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

续期任务执行失败怎么查

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

登录哪都通