密码学与证书 / 知识点

Certbot 常见故障排查速查

自动续期故障

使用 Standalone 认证时 Certbot 需要监听验证端口;如果 Nginx 或其他服务已占用 80 端口,续期可能失败,需要调整认证方式或通过 Hook 协调服务启停。

Standalone 续期端口冲突

目标是让使用 Standalone 认证的证书恢复可续期状态,并在测试结束后确认原 Web 服务已经恢复。HTTP-01 验证要求外部验证请求能够到达 80 端口,因此不能仅把 Certbot 改到任意本地端口来绕过冲突。

前置条件

  • 确认该证书的续期配置确实使用 Standalone 认证,而不是 Nginx、Webroot 或 DNS 插件。
  • 域名必须解析到当前验证入口,公网 TCP 80 能到达执行 Certbot 的主机或被正确转发到它。
  • 如果准备临时停止 Nginx,先确认允许短暂中断 HTTP 服务,并具备 systemctl 管理权限。
  • 生产环境优先考虑改用 Nginx、Webroot 或 DNS 认证;停服务 Hook 更适合作为已有 Standalone 配置的兼容方案。

定位端口占用

先检查谁正在监听 80 端口。若输出显示 Nginx、Apache 或其他进程占用该端口,Standalone 无法同时绑定同一地址和端口。

bash
sudo ss -ltnp 'sport = :80'

预期输出:可以看到监听 80 端口的进程;PID、地址等实际值可能不同。

text
LISTEN 0 511 0.0.0.0:80 0.0.0.0:* users:(("nginx",pid=<ID>,fd=<ID>))

如果没有监听者仍出现绑定失败,还应检查容器端口映射、Socket 激活服务以及 Certbot 报错中实际尝试监听的地址。

协调 Standalone 与 Nginx

确认允许短暂停机后,可用续期 Hook 在验证前停止 Nginx,并在验证尝试结束后重新启动。先用 --dry-run 验证整个续期路径,不会把测试证书替换成正式证书。

bash
sudo certbot renew --cert-name <CERT_NAME> --dry-run \
  --pre-hook "systemctl stop nginx" \
  --post-hook "systemctl start nginx"
sudo systemctl is-active nginx

预期输出:Certbot 的具体日志文本会随版本变化,但模拟续期应成功,最后一条命令应确认 Nginx 已恢复运行。

text
<DRY_RUN_SUCCESS_MESSAGE>
active

验证与失败处理

模拟续期成功后,再按正常计划执行正式续期,并确认 80 端口重新由原服务监听。如果 Certbot 仍失败,应停止反复重试,优先检查 DNS、云防火墙、安全组、NAT 或上游代理是否允许公网访问 80 端口。

若停止 Nginx 后验证失败且服务没有自动恢复,立即执行 sudo systemctl start nginx,再用 sudo systemctl is-active nginx 确认恢复。不要在业务服务仍停止的状态下继续排查证书问题。

长期运行时,尽量让续期过程不依赖停机;已有 Standalone 配置需要迁移认证方式时,应先备份当前续期配置并完成一次测试续期,再删除旧方案。

CA 与签发限制

证书与文件故障

目录与阅读设置

记录一个想法

Certbot 常见故障排查速查

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

登录哪都通