密码学与证书 / 系统课时

怎样手工验证 Challenge 路径

怎样手工验证 Challenge 路径

在让 Certbot 发起 HTTP-01 验证前,先手工放置一个测试文件并从公网访问,可以快速确认 Nginx、站点目录和域名入口是否已经把 /.well-known/acme-challenge/ 暴露出来,避免把基础路径问题误判成 Certbot 故障。

学习目标

  • 理解 HTTP-01 Challenge URL 与磁盘文件之间的对应关系
  • 手工创建测试文件并使用 curl 验证 HTTP 返回结果
  • 根据状态码判断当前环境是否具备继续申请证书的条件

确认 URL 与文件路径的对应关系

HTTP-01 验证时,CA 会请求类似 http://<HOST>/.well-known/acme-challenge/<TOKEN> 的地址。Nginx 必须把这个 URL 映射到 Certbot 能写入、Web 服务也能读取的目录。

例如采用 /var/www/certbot 作为验证根目录时,可以使用下面的 Nginx 配置。以下为片段示例,需要放在负责 <HOST> 的 server 块中。

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

此时请求 /.well-known/acme-challenge/manual-check.txt 会对应到磁盘文件 /var/www/certbot/.well-known/acme-challenge/manual-check.txt。修改配置后应先执行 nginx -t,再重新加载 Nginx,并确认实际生效配置与此映射一致。

创建测试文件

下面的命令创建验证目录和一个内容固定的测试文件。目录应与实际 Nginx 配置保持一致。

bash
sudo mkdir -p /var/www/certbot/.well-known/acme-challenge
printf '%s\n' 'anystack-http01-ok' | sudo tee /var/www/certbot/.well-known/acme-challenge/manual-check.txt

预期输出

text
anystack-http01-ok

如果 Nginx 工作进程使用受限账户,还要确保目录及文件至少具有读取和目录遍历权限。这里不需要给验证目录开放写权限给 Nginx;Certbot 或部署脚本只需能够创建 Challenge 文件即可。

从域名入口访问测试文件

不要只检查服务器上的文件是否存在。HTTP-01 的关键是外部请求能否通过域名和 80 端口读取该文件。将 <HOST> 替换为实际申请证书的域名后执行:

bash
HOST="<HOST>"
curl -i "http://$HOST/.well-known/acme-challenge/manual-check.txt"

预期输出

text
HTTP/1.1 200 OK
...

anystack-http01-ok

响应头中的服务器类型、日期和其他字段可能不同;真正需要确认的是状态码为 200,并且响应正文与测试文件内容完全一致。

判断是否可以继续申请

返回 200 且正文正确,说明从域名 URL 到 Challenge 文件的基本链路已经打通,可以继续让 Certbot 使用相同 Webroot 或对应的 Nginx 配置完成 HTTP-01 验证。

如果得到 404,优先检查请求是否进入了正确的 Server Block、location 是否匹配以及 root 对应的实际磁盘路径。如果连接超时或拒绝连接,则应先排查 DNS、80 端口监听、防火墙和上游网络,而不是继续修改 Challenge 文件内容。

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

目录与阅读设置

阅读设置

17

记录一个想法

怎样手工验证 Challenge 路径

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

登录哪都通