密码学与证书 / 系统课时

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 子目录。

Nginx HTTP-01 URI 到 Webroot 的路径映射

配置专用 challenge Location

下面是放在对应 HTTP server 块中的片段示例。^~ 可以让这条前缀规则优先处理挑战路径,也能减少常见的“禁止访问点目录”正则规则误伤 .well-known 的机会。示例把其他 HTTP 请求重定向到 HTTPS,但让挑战路径直接返回文件。

nginx
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。

bash
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"

预期输出

text
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 申请本身失败”分开定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

Nginx 怎样暴露验证目录

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

登录哪都通