密码学与证书 / 系统课时
Nginx 怎样暴露验证目录
Nginx 怎样暴露验证目录
Certbot 即使正确生成了挑战文件,只要 Nginx 没把同一目录映射到 /.well-known/acme-challenge/,CA 仍会得到 404。这里用一个独立 location 把请求 URI、磁盘路径和 Certbot 的 -w 参数对齐,并用探针文件验证映射。
学习目标
- 理解 Nginx
root与 HTTP-01 请求 URI 如何拼成实际文件路径 - 配置只处理
/.well-known/acme-challenge/的独立 Location - 在申请证书前用真实 HTTP 请求验证目录已经可访问
对齐 URI、root 和 Webroot
假设 Certbot 使用 -w /var/www/letsencrypt。当 CA 请求:
/.well-known/acme-challenge/<TOKEN>
如果对应 location 配置 root /var/www/letsencrypt;,Nginx 查找的实际文件就是:
/var/www/letsencrypt/.well-known/acme-challenge/<TOKEN>
因此 Certbot 的 -w 与 Nginx 的 root 应指向同一个 Webroot 基准目录,而不是直接指向 acme-challenge 子目录。

配置专用 challenge Location
下面是放在对应 HTTP server 块中的片段示例。^~ 可以让这条前缀规则优先处理挑战路径,也能减少常见的“禁止访问点目录”正则规则误伤 .well-known 的机会。示例把其他 HTTP 请求重定向到 HTTPS,但让挑战路径直接返回文件。
server {
listen 80;
server_name <DOMAIN>;
location ^~ /.well-known/acme-challenge/ {
root /var/www/letsencrypt;
default_type text/plain;
try_files $uri =404;
}
location / {
return 301 https://$host$request_uri;
}
}这是 Nginx 配置片段,需并入实际站点配置。生效后的关键行为是:只有挑战路径从 /var/www/letsencrypt 读取文件,普通 HTTP 请求仍按站点策略跳转到 HTTPS。
用探针文件验证映射
证书申请前先放一个固定内容的测试文件,再通过 HTTP 读取它。把 <DOMAIN> 换成已经指向当前服务器的真实域名;如果服务器自身无法回访公网地址,可以从另一台外部主机执行最后的 curl。
set -e
DOMAIN="<DOMAIN>"
WEBROOT="/var/www/letsencrypt"
TOKEN="probe"
sudo mkdir -p "$WEBROOT/.well-known/acme-challenge"
printf '%s\n' 'acme-probe' | sudo tee "$WEBROOT/.well-known/acme-challenge/$TOKEN" >/dev/null
sudo nginx -t
sudo systemctl reload nginx
body="$(curl -fsS "http://$DOMAIN/.well-known/acme-challenge/$TOKEN")"
test "$body" = "acme-probe"
printf '%s\n' "$body"
sudo rm -f "$WEBROOT/.well-known/acme-challenge/$TOKEN"预期输出
nginx: configuration file <PATH> syntax is ok
nginx: configuration file <PATH> test is successful
acme-probe<PATH> 是当前 Nginx 主配置文件的实际路径,发行版不同可能不同。只要最终响应体严格是 acme-probe,就说明请求 URI 与磁盘目录已经对齐。
常见映射失败怎么判断
返回 404 时,先对比三个值:Certbot 的 -w、Nginx 的 root、探针文件的实际绝对路径。三者只要有一个多写或少写了 .well-known/acme-challenge,最终路径就会错位。
如果返回 301 或站点首页,说明挑战请求落进了其他 location 或重定向规则;如果返回 403,检查 Nginx 用户是否有目录执行权限和文件读取权限。通过探针测试后再运行 Certbot,可以把“Webroot 暴露错误”和“ACME 申请本身失败”分开定位。