密码学与证书 / 系统课时

配置 acme-challenge 验证目录

配置 acme-challenge 验证目录

本节把 HTTP-01 验证路径真正接到 Nginx:建立独立 Webroot、配置 /.well-known/acme-challenge/ Location,并用测试文件从公网验证。完成后,Certbot 写入的 Challenge 文件就能被 CA 通过 80 端口读取。

学习目标

  • 建立可由 Certbot 写入、由 Nginx 读取的 Challenge 目录
  • 正确映射 /.well-known/acme-challenge/ 到文件系统
  • 用 nginx -t 与公网 curl 验证配置是否可用

先确定 URL 到文件的映射

Webroot 模式会把验证文件写入指定 Webroot 下的 .well-known/acme-challenge/ 目录,因此 Web 服务器必须能对外提供这个隐藏路径。这里统一把 Webroot 设为 /var/www/letsencrypt。([Certbot文档][1])

请求 http://<HOST>/.well-known/acme-challenge/<TOKEN> 时,目标文件应是 /var/www/letsencrypt/.well-known/acme-challenge/<TOKEN>。让 URL、Nginx Location 与磁盘路径保持一一对应,后续 Certbot 才不需要额外搬运验证文件。

acme-challenge 的 URL、Nginx 与 Webroot 路径映射

建立目录并加入 Nginx Location

先在负责这两个域名 HTTP 流量的 server 块中保留专用 Challenge Location。下面是完整的 80 端口示例;实际使用时把域名替换为自己的两个域名。如果网站需要把普通 HTTP 请求重定向到 HTTPS,应把重定向放在 location /,不要让它抢先处理 Challenge 路径。

nginx
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    location ^~ /.well-known/acme-challenge/ {
        root /var/www/letsencrypt;
        default_type text/plain;
        try_files $uri =404;
    }

    location / {
        return 301 https://$host$request_uri;
    }
}

这里使用 root 后,Nginx 会按当前请求 URI 组合实际文件路径;try_files $uri =404 会先检查对应文件是否存在,不存在就返回 404。([Nginx][2])

创建测试文件并从公网验证

下面的命令创建目录与探针文件,检查配置语法,重载 Nginx,再分别访问两个域名。把 <HOST_1>、<HOST_2> 替换为真实域名;两条 DNS 记录都应已指向这台服务器,并允许公网访问 TCP 80。

bash
sudo install -d -m 0755 /var/www/letsencrypt/.well-known/acme-challenge
printf 'acme-ok\n' | sudo tee /var/www/letsencrypt/.well-known/acme-challenge/probe.txt >/dev/null

sudo nginx -t
sudo systemctl reload nginx

HOST1="<HOST_1>"
HOST2="<HOST_2>"
for host in "$HOST1" "$HOST2"; do
  printf '%s: ' "$host"
  curl -fsS "http://$host/.well-known/acme-challenge/probe.txt"
done

预期输出

text
nginx: the configuration file <PATH> syntax is ok
nginx: configuration file <PATH> test is successful
<HOST_1>: acme-ok
<HOST_2>: acme-ok

<PATH> 会随 Nginx 安装位置变化。最好从服务器外部网络执行最后的 HTTP 检查;本机访问成功只能证明 Nginx 本地路由正确,不能证明公网 DNS、防火墙与 80 端口都已打通。

如果返回 404,按“磁盘文件是否存在 → server_name 是否命中 → Location 是否被其他规则覆盖”的顺序检查;如果连接超时或拒绝,再检查 DNS、云安全组、防火墙和监听端口。只有两个域名都能稳定返回 acme-ok,才进入正式证书申请。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置 acme-challenge 验证目录

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

登录哪都通