密码学与证书 / 系统课时
配置 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 才不需要额外搬运验证文件。

建立目录并加入 Nginx Location
先在负责这两个域名 HTTP 流量的 server 块中保留专用 Challenge Location。下面是完整的 80 端口示例;实际使用时把域名替换为自己的两个域名。如果网站需要把普通 HTTP 请求重定向到 HTTPS,应把重定向放在 location /,不要让它抢先处理 Challenge 路径。
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。
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预期输出
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,才进入正式证书申请。