密码学与证书 / 知识点

Certbot 常见故障排查速查

HTTP-01 验证故障

CA 已访问目标域名,但获取到的挑战内容不正确;优先检查域名解析、虚拟主机匹配以及 /.well-known/acme-challenge/ 是否由正确站点提供。

排查 HTTP-01 unauthorized

目标是确认 CA 请求的 http://<DOMAIN>/.well-known/acme-challenge/<TOKEN> 最终由正确虚拟主机返回完全匹配的挑战内容。unauthorized 通常不是 Certbot 本身无法运行,而是公网请求到达了错误地址、错误站点,或挑战路径被重写、代理、缓存覆盖。

前置条件

  • 能修改目标站点的 Web 根目录或虚拟主机配置,并具备必要的 sudo 权限。
  • 已记录当前 Nginx/Apache、反向代理或负载均衡配置;改动前先保留可回退版本。
  • 明确 <DOMAIN> 的预期公网 IPv4/IPv6 地址,以及 HTTP-01 实际使用的 Web 根目录 <PATH>。
  • 如果域名前有 CDN、WAF 或负载均衡,确认挑战请求经过的真实链路。

定位顺序

  1. 先核对 A/AAAA 记录,确认没有旧地址或错误 IPv6 记录。
  2. 在 Certbot 使用的 Web 根目录创建一个固定测试文件,模拟挑战文件。
  3. 用 curl --resolve 绕过公网 DNS 直连预期源站,确认虚拟主机和 Web 根目录本身正确。
  4. 再按公网 DNS 请求同一路径;只有源站请求与公网请求都返回相同内容,才重试证书申请。

片段示例:把 <DOMAIN>、<PATH> 和 <IP> 替换为当前站点的真实值后执行。

bash
DOMAIN="<DOMAIN>"
WEBROOT="<PATH>"
ORIGIN_IP="<IP>"
TOKEN="anystack-acme-check"

echo "A:"
dig +short A "$DOMAIN"
echo "AAAA:"
dig +short AAAA "$DOMAIN"

sudo mkdir -p "$WEBROOT/.well-known/acme-challenge"
printf '%s\n' "$TOKEN" | sudo tee "$WEBROOT/.well-known/acme-challenge/$TOKEN" >/dev/null

echo "origin:"
curl --resolve "$DOMAIN:80:$ORIGIN_IP" -i "http://$DOMAIN/.well-known/acme-challenge/$TOKEN"
echo "public:"
curl -i "http://$DOMAIN/.well-known/acme-challenge/$TOKEN"

预期输出(示意,实际地址和响应头可能不同):

text
A:
<IP>
AAAA:
<IPV6_OR_EMPTY>
origin:
HTTP/1.1 200 OK
...
anystack-acme-check
public:
HTTP/1.1 200 OK
...
anystack-acme-check

验证与失败处理

如果 origin 正确而 public 错误,优先检查 DNS、CDN、WAF、负载均衡和 NAT 是否把域名导向了别的后端。如果两次请求都错误,检查虚拟主机匹配、root/DocumentRoot、/.well-known/acme-challenge/ 的 location 或 rewrite 规则,以及是否被应用路由接管。

若 A 记录正确但存在指向旧服务器的 AAAA 记录,CA 可能经 IPv6 命中错误主机;应修正 IPv6 服务或删除无效 AAAA 记录。若挑战路径被统一重定向,重定向后的目标也必须能返回该 token,不能最终落到登录页、404 页面或通用首页。

只有公网请求稳定返回测试 token 后,再重试原来的 Certbot 申请或续期命令。若仍失败,停止反复重试并查看 Certbot 错误中记录的具体 URL、状态码和返回内容,再沿同一路径复现。

清理与恢复

排查完成后删除 anystack-acme-check 测试文件。若为排障临时修改了虚拟主机、rewrite、CDN 缓存规则或代理策略,应恢复到经过验证的正式配置并重新加载服务;不要删除 Certbot 后续续期仍依赖的 ACME challenge 例外规则。

Nginx 集成故障

DNS-01 验证故障

自动续期故障

目录与阅读设置

记录一个想法

Certbot 常见故障排查速查

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

登录哪都通