密码学与证书 / 系统课时
Challenge 返回 404 怎么排查
Challenge 返回 404 怎么排查
HTTP-01 Challenge 返回 404 表示请求已经到达某个 HTTP 服务,但该服务没有在请求路径上找到目标资源。排查时不要反复重试 Certbot,而应沿着 DNS、Nginx Server Block、Location 映射和磁盘文件四层逐级缩小范围。
学习目标
- 按固定顺序定位 HTTP-01 Challenge 的
404来源 - 区分 Server Block、Location 与实际文件路径造成的错误
- 使用本机定向请求和公网请求验证修复结果
先确认 404 出现在哪一层
一个 Challenge 请求至少会经过域名解析、80 端口入口、Nginx 虚拟主机选择、location 匹配、文件路径拼接等环节。只看到 404 无法直接断定文件不存在,因为请求也可能进入了错误的站点配置。

检查实际生效的 Nginx 配置
首先确认 Nginx 配置本身没有语法错误。这个动作也能避免出现“修改了文件但配置根本没有重新加载”的误判。
sudo nginx -t预期输出
nginx: the configuration file <PATH> syntax is ok
nginx: configuration file <PATH> test is successful<PATH> 会随发行版和安装方式变化。如果测试失败,应先修复语法问题;如果测试成功,再用 sudo nginx -T 查看完整生效配置,确认负责 <HOST> 的 server_name 中确实存在 Challenge 的 location。
一个常见的 Webroot 映射如下。以下为片段示例,需要结合实际站点配置使用。
location ^~ /.well-known/acme-challenge/ {
root /var/www/certbot;
default_type text/plain;
try_files $uri =404;
}这里使用 root 时,请求 /.well-known/acme-challenge/manual-check.txt 对应的文件是 /var/www/certbot/.well-known/acme-challenge/manual-check.txt。如果实际文件放在别处,即使文件真实存在也会返回 404。
绕过 DNS 检查 Server Block 和文件映射
先在服务器本机创建一个已知内容的文件,再让 curl 把 <HOST> 强制解析到本机。这样可以暂时排除公网 DNS,将注意力集中在 Nginx 虚拟主机和路径映射上。
HOST="<HOST>"
sudo mkdir -p /var/www/certbot/.well-known/acme-challenge
printf '%s\n' 'challenge-path-ok' | sudo tee /var/www/certbot/.well-known/acme-challenge/manual-check.txt >/dev/null
curl -i --resolve "$HOST:80:127.0.0.1" "http://$HOST/.well-known/acme-challenge/manual-check.txt"预期输出
HTTP/1.1 200 OK
...
challenge-path-ok如果这里仍然是 404,问题基本位于 Nginx:常见原因包括请求进入了另一个 server 块、Challenge 的 location 没有匹配、root 或 alias 写错,以及目标文件路径与配置不一致。
如果本机定向请求已经返回 200,但公网访问仍然失败,则应把排查重点移到 DNS 和入口网络,而不是继续修改文件目录。
核对 DNS 与公网访问
域名可能同时存在 A 和 AAAA 记录。若 AAAA 指向另一台没有部署 Challenge 文件的服务器,部分验证请求仍可能失败,因此两类记录都要核对。
HOST="<HOST>"
dig +short A "$HOST"
dig +short AAAA "$HOST"预期结果
<IP>
<IPv6>没有配置某类记录时,对应命令可能没有输出。实际返回的每个地址都应指向能够正确响应该域名 HTTP-01 请求的入口。
随后从能够代表公网访问路径的机器再次请求 Challenge URL:
HOST="<HOST>"
curl -i "http://$HOST/.well-known/acme-challenge/manual-check.txt"预期输出
HTTP/1.1 200 OK
...
challenge-path-ok按现象选择修复位置
本机使用 --resolve 仍返回 404 时,先修正 Nginx 的 server_name、location 和文件映射,并在修改后执行 nginx -t 与重新加载。若本机已经是 200、公网却不是 200,则检查 DNS 是否指向正确服务器、IPv4 与 IPv6 是否一致,以及公网 80 端口是否真正进入当前 Nginx 实例。
排查 HTTP-01 的关键不是“多试几次 Certbot”,而是证明同一个 <HOST>、同一条 Challenge URL 能稳定返回磁盘中预期的令牌内容。只有这条链路成立,证书申请阶段的 HTTP-01 验证才具备成功条件。