密码学与证书 / 系统课时

Challenge 404 应该怎么排查

Challenge 404 应该怎么排查

HTTP-01 Challenge 返回 404,说明请求通常已经到达某个 Web 服务,问题重点不再是端口是否开放,而是“Certbot 写到哪里”和“Nginx 从哪里读取”没有对上。本篇用一个可控测试文件还原路径映射,再定位错误的 webroot、Server Block 或 location。

学习目标

  • 根据 404 判断故障已经进入 HTTP 路由与文件映射层
  • 验证 -w 指定的 webroot 与 Nginx 对外路径是否一致
  • 识别虚拟主机、location、反向代理和多节点导致的错配

先用测试文件验证真实映射

使用 Webroot 模式时,Certbot 会把挑战文件写到 WEBROOT/.well-known/acme-challenge/。因此最有效的排查方法不是反复重试签发,而是先手工放一个文件,再通过真实域名读取它。

在 Web 服务器上执行:

bash
WEBROOT=/var/www/example
sudo mkdir -p "$WEBROOT/.well-known/acme-challenge"
printf 'probe-ok\n' | sudo tee "$WEBROOT/.well-known/acme-challenge/probe" >/dev/null
test -f "$WEBROOT/.well-known/acme-challenge/probe" && echo "file-ready"

预期输出:

text
file-ready

然后从公网另一台机器访问真实域名:

bash
curl -fsS "http://example.com/.well-known/acme-challenge/probe"

预期输出:

text
probe-ok

如果服务器上确认文件存在,而公网请求仍返回 404,就几乎可以确定是 Nginx 路由、虚拟主机选择、代理转发或多节点分发没有映射到这个目录。

对齐 Certbot 与 Nginx 的路径

假设 Certbot 使用 -w /var/www/example,那么 Token 的实际文件应位于 /var/www/example/.well-known/acme-challenge/<TOKEN>。Nginx 必须让相同 URL 最终读取同一个文件系统位置。

片段示例:下面配置需要放在实际承载该域名的 server {} 中:

nginx
location ^~ /.well-known/acme-challenge/ {
    root /var/www/example;
    try_files $uri =404;
}

对于请求 /.well-known/acme-challenge/probe,这段 root 配置会读取 /var/www/example/.well-known/acme-challenge/probe。如果这里的 root 与 Certbot 的 -w 不一致,即使 Certbot 成功生成了 Token 文件,公网仍会看到 404。

Certbot Webroot 与 Nginx Challenge 路径映射

404 最常见的错配点

先看域名是否命中了你以为的 Server Block。server_name 不匹配、默认站点优先级错误,都会让 Challenge 请求进入另一个站点配置,即使目标目录中的文件完全正确。

再看 location 是否被其他规则截获。常见情况包括把所有请求代理给应用、对点号目录统一拒绝、try_files 回退到前端入口,或另一个更具体的 location 覆盖了 Challenge 路径。Challenge 路径应优先直接读取静态文件,不要先交给业务应用处理。

如果使用 alias 而不是 root,要按 alias 的路径替换语义重新计算实际文件位置,尤其注意末尾斜杠;不要直接照搬 root 的目录推导方式。

最后检查多节点环境。负载均衡后有多台 Web 服务器时,Certbot 只在其中一台写入 Token,而 CA 请求被分发到另一台,也会稳定得到 404。此时需要共享 Challenge 文件、让所有节点同步响应,或改用更适合该架构的验证方式。

修复后的验收标准

先让测试地址通过真实域名稳定返回 probe-ok,再删除测试文件并重新执行 Certbot。若仍失败,应查看实际处理 Challenge 请求的 Nginx 访问日志,确认命中的主机名、节点和请求 URI,而不是继续猜测文件路径。

Challenge 404 的判断核心只有一条:URL 已经到达 HTTP 服务,但最终读取的资源不是 Certbot 写下的那个文件。只要把“域名 → Server Block → location → 文件系统”这条映射逐段对齐,问题通常就能被精确定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

Challenge 404 应该怎么排查

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

登录哪都通