Writing

网站突然报『不安全』?手把手教你用 Certbot 自动续期 SSL 证书

详细记录 SSL 证书过期后如何用 Certbot 续期,包括首次申请、自动续期配置、定时任务设置全过程,附 Nginx/Apache 配置片段和常见错误排查。

· 8 分钟阅读
目录
  1. 第一步:检查证书状态
  2. 第二步:手动续期试试水
  3. 第三步:配置自动续期
  4. 1. 修改续期前置检查
  5. 2. 添加 crontab 定时任务
  6. 一张表看懂 Certbot 续期参数
  7. 常见错误排查
  8. 1. 报错 “No installed certificates”
  9. 2. 自动续期未执行
  10. 总结

上周我的博客突然被 Chrome 标红『不安全』,查了半天发现是 Let’s Encrypt 的 SSL 证书过期了——明明记得三个月前刚配置过证书,怎么就失效了?原来 Certbot 默认不会自动续期,得手动加配置。折腾两小时后终于搞定,把完整流程记录如下。

📌 本文摘要:从 SSL证书过期 报错出发,演示如何用 certbot renew 命令手动续期,重点解决 自动续期失效 问题。包含 Nginx 配置检查、续期前置验证、crontab 定时任务设置(避开访问高峰期),并给出 证书过期预警 的监控方案。适用于 Ubuntu/Debian 系统 + Nginx/Apache 环境。

下面直接进入操作步骤,全程用 sudo 执行:

第一步:检查证书状态

先看证书是否真的过期(有时候可能是浏览器缓存问题):

# 查看所有证书的过期时间
sudo certbot certificates

输出会显示类似这样(重点关注 Expiry Date 行):

Certificate Name: example.com
  Domains: example.com www.example.com
  Expiry Date: 2023-04-01 12:34:56+00:00 (INVALID)

如果看到 (INVALID) 或日期已过当前时间,就是证书过期了。

第二步:手动续期试试水

先跑一次续期测试(--dry-run 避免操作证书):

sudo certbot renew --dry-run

如果报错 No renewals were attempted,可能需要先停止 Nginx:

sudo systemctl stop nginx
sudo certbot renew --force-renewal
sudo systemctl start nginx

提示:遇到 Challenge failed 错误时,大概率是域名解析或防火墙问题,先用 dig +short YOUR_DOMAIN 确认解析正常。

第三步:配置自动续期

关键来了!Certbot 默认只在到期前 30 天自动续期,我们需要确保两件事:

1. 修改续期前置检查

编辑 Certbot 的续期配置文件:

sudo nano /etc/letsencrypt/renewal/YOUR_DOMAIN.conf

找到 pre-hook 和 post-hook 部分,确保 Nginx 能正确重启(Apache 用户替换为 apache2):

pre_hook = systemctl stop nginx
post_hook = systemctl start nginx

2. 添加 crontab 定时任务

用 crontab -e 添加每周日凌晨 3 点执行的任务(避开访问高峰):

0 3 * * 0 /usr/bin/certbot renew --quiet --post-hook "systemctl reload nginx"

一张表看懂 Certbot 续期参数

参数 作用 使用场景
--dry-run 模拟运行 测试续期流程
--force-renewal 强制续期 证书已过期时用
--quiet 静默模式 crontab 定时任务
--post-hook 后续操作 重启 Web 服务

常见错误排查

1. 报错 “No installed certificates”

说明首次申请证书时用的不是 Certbot,需要重新申请:

sudo certbot --nginx -d YOUR_DOMAIN -d www.YOUR_DOMAIN

2. 自动续期未执行

检查 cron 日志确认任务是否触发:

sudo grep certbot /var/log/syslog

总结

SSL 证书过期会导致网站被标红,Certbot 默认不会自动续期。最稳妥的方案是:① 用 certbot renew --dry-run 测试流程 ② 配置 crontab 每周自动续期 ③ 用 certbot certificates 监控过期时间。我的证书现在都托管在 雨云 香港节点,用优惠码 aabh 续费能打折,实测自动续期比自建更省心。

相关文章