ACME HTTP验证要求域名请求到达哪里,验证失败时应检查哪些环节?
很多人看到 ACME 验证失败时,第一反应是检查 443 端口或证书配置。但 HTTP-01 验证的第一跳并不是 HTTPS,而是证书颁发机构的验证服务器访问域名的 80 端口,请求路径固定为:
http://你的域名/.well-known/acme-challenge/令牌
这个请求会按照域名的公开 DNS 记录,到达 A 记录或 AAAA 记录指向的公网入口。公网入口可能是源站、负载均衡、CDN、WAF、NAT 映射后的服务器,也可能是某个并没有部署 ACME 客户端的边缘节点。最终是否通过,取决于这条完整链路能否返回当前挑战对应的准确内容。
因此,验证失败时不能只看“证书申请命令有没有报错”,还要确认 DNS 指向、80 端口、反向代理、IPv4/IPv6、挑战文件或动态路由,以及缓存和访问控制是否共同满足要求。
概念边界:HTTP-01验证到底检查什么
HTTP-01不是访问首页
HTTP-01 验证检查的是特定域名下的特定路径,而不是首页能否打开。以 example.com 为例,验证 URL 类似:
http://example.com/.well-known/acme-challenge/abc123-example-token
其中:
example.com是申请证书时提交的域名标识;/.well-known/acme-challenge/是固定目录;- 最后的令牌由 ACME 服务端生成;
- 响应正文应为该令牌对应的
key authorization,而不是首页 HTML、JSON 错误信息或应用登录页面。
如果申请的是以下多个域名,每个域名都可能有独立的验证请求:
example.com
www.example.com
api.example.com
能够打开 example.com,并不代表 www.example.com 或 api.example.com 的 HTTP-01 验证也能通过。验证请求中的 Host 会对应具体域名,Web 服务器必须根据这个域名选择正确的站点和路由。
验证请求实际会到达哪里
可以把请求路径抽象成下面这条链路:

ACME验证服务器
↓
公开DNS解析结果
↓
A/AAAA记录指向的公网IP
↓
防火墙、安全组、NAT或端口映射
↓
CDN、WAF、负载均衡或反向代理
↓
Web服务器站点配置
↓
/.well-known/acme-challenge/下的文件或动态处理器
所以,“请求到达哪里”的准确答案不是“到达运行 ACME 客户端的服务器”,而是:
到达该域名公开 DNS 解析出来的公网入口,并由这个入口链路上的某个组件返回挑战内容。
例如,ACME 客户端运行在内网服务器 10.0.0.20 上,但域名的 A 记录指向公网负载均衡 203.0.113.10,那么验证请求首先到达的是负载均衡,而不是 10.0.0.20。只有负载均衡把该路径正确转发到后端,或者自身直接提供挑战内容,验证才可能成功。
针对证书验证所依赖的公网入口、域名站点和多节点部署,A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器资源,覆盖建站、业务后台、接口服务和数据库等场景。不同地区可配合相应线路、带宽、存储及多IP方案,为公网Web服务、负载均衡后端和跨地区业务部署提供服务器基础。
HTTP-01通常使用80端口
HTTP-01 的初始请求使用标准 HTTP 入口,也就是公网 TCP 80 端口。源站内部可以把 80 端口映射到其他端口,例如公网 80 转发到内部 8080,但不能简单地让验证服务只监听公网 8080,然后期待 ACME 服务端自动访问该端口。
部分实现会处理从 HTTP 到 HTTPS 的有限重定向,但重定向会额外引入以下依赖:
- 443 端口是否可达;
- HTTPS 虚拟主机和 SNI 是否配置正确;
- 证书链是否能被验证服务端接受;
- CDN、WAF或应用是否改变了重定向结果;
- 重定向是否继续指向允许的协议和端口。
实施前更稳妥的条件是:让初始 HTTP 验证 URL 直接返回 200 OK 和正确的挑战内容,而不是依赖多次重定向。
工作机制:从令牌生成到验证通过
ACME客户端如何准备挑战内容
申请证书时,ACME 服务端会为域名生成一个挑战令牌。客户端通常有两种处理方式:
- 在 Web 根目录下临时创建令牌文件;
- 通过 Web 服务器、反向代理或应用接口动态返回令牌内容。
客户端还会根据账户密钥生成与令牌关联的 key authorization。验证服务端访问挑战 URL 后,会将响应内容与该挑战对应的值进行比对。
因此,挑战文件名和文件内容都不能自行编造。仅创建一个名为 test 的文件,或者返回固定字符串,不能替代当前订单中的真实令牌。
验证服务端如何发起请求
典型请求可以表示为:
GET /.well-known/acme-challenge/abc123-example-token HTTP/1.1
Host: example.com
Accept: */*
User-Agent: ACME validation service
实际请求头可能因验证服务端实现而有所不同,不能把某个固定 User-Agent 或固定来源 IP 当成可靠识别条件。验证服务端可能从不同网络位置发起请求,也可能对失败结果进行重试。
实施前应确保:
- 不要求登录;
- 不要求 Cookie;
- 不依赖特定浏览器 User-Agent;
- 不仅允许某一个验证服务器 IP;
- 不将挑战路径交给需要 JavaScript 执行的页面;
- 不返回带有额外内容的错误页面。
响应正文需要是当前挑战要求的准确值。哪怕 HTTP 状态为 200,如果正文实际是网站首页、统一错误页或旧令牌,仍会被判定为验证失败。
多节点环境必须保持一致
如果域名背后有多个 A 或 AAAA 记录,或者负载均衡后有多台 Web 服务器,验证请求可能被分配到任意一个节点。
例如:
| 节点 | 挑战路径响应 | 可能结果 |
|---|---|---|
| 203.0.113.10 | 返回当前令牌 | 成功 |
| 203.0.113.11 | 返回旧令牌 | 失败 |
| 203.0.113.12 | 返回404 | 失败 |
| 2001:db8::10 | 连接超时 | 失败或间歇失败 |
这类问题常表现为“偶尔成功、重复申请时失败”,或者同一个域名在不同网络环境下结果不一致。ACME 客户端所在的服务器本地访问成功,并不能证明所有公网入口都返回了相同内容。
影响因素:实施前必须确认哪些条件
1. DNS解析结果是否指向可用入口
首先检查申请证书的每个域名,而不是只检查主域名:
dig +short A example.com
dig +short AAAA example.com
dig +short A www.example.com
dig +short AAAA www.example.com
需要重点关注:
- A 记录是否仍指向旧服务器;
- AAAA 记录是否存在但 IPv6 服务没有部署;
- 使用了 CNAME 时,CNAME 的最终目标是否正确;
- 内外网 DNS 是否存在分流;
- DNS 切换后,外部递归解析器是否仍拿到旧地址;
- 多个地址背后的节点是否都已经准备好挑战路径。
如果存在 AAAA 记录,不能因为 IPv4 测试成功就忽略 IPv6。一个常见场景是:IPv4 已经开放 80 端口,但 AAAA 指向的 IPv6 地址没有监听 HTTP,或者被防火墙丢弃。此时验证服务端若选择 IPv6,请求就可能超时或连接失败。
2. 公网80端口是否真正可达
服务器本机监听端口,不等于公网可以访问。中间可能存在云安全组、边界防火墙、NAT、运营商网络策略或负载均衡监听器配置。
可以先从不在目标服务器上的网络环境进行测试:
curl -4 -i --max-time 10 \
http://example.com/.well-known/acme-challenge/当前实际令牌
如果环境支持 IPv6,再测试:
curl -6 -i --max-time 10 \
http://example.com/.well-known/acme-challenge/当前实际令牌
这里的“当前实际令牌”必须来自正在进行的 ACME 订单。若客户端尚未创建挑战文件,返回 404 只能说明当前没有该文件,不能单独证明公网链路一定有问题。
可将结果按层次理解:

- 连接超时:优先检查路由、防火墙、安全组、NAT和监听器;
- 连接被拒绝:通常表示目标地址可达,但没有服务监听或端口转发;
- 能建立连接并返回 HTTP 响应:说明至少已经到达某个 HTTP 处理组件;
- 返回 404、403或其他状态:继续判断是正确服务返回的,还是中间设备返回的。
3. Web服务器是否匹配了正确的域名和路径
当同一台服务器承载多个站点时,ACME 请求的 Host 可能被错误地分配到默认站点。默认站点首页能打开,并不表示目标域名的挑战路径正确。
静态文件方式的 Nginx 配置可以类似下面的形式:
server {
listen 80;
server_name example.com www.example.com;
location ^~ /.well-known/acme-challenge/ {
root /var/www/acme;
default_type text/plain;
try_files $uri =404;
}
}
按照这个配置,令牌文件应位于类似路径:
/var/www/acme/.well-known/acme-challenge/当前实际令牌
配置示例只说明路由关系,不代表可以直接覆盖现有站点配置。修改前应备份原配置,确认影响范围仅包含目标域名和挑战路径,并使用软件提供的配置检查命令验证语法:
nginx -t
如果变更导致其他站点异常,应恢复备份配置并重新执行配置检查,再按现有运维流程加载配置。
除 Nginx 外,Apache、Caddy、应用网关或自研服务也可以提供相同路径,但必须确认它们不会把该路径重写到首页、登录页或前端路由。
4. 文件权限和路径层级是否满足读取要求
挑战文件存在,不代表 Web 服务进程一定能读取。需要同时确认:
- 文件名与令牌完全一致,大小写不能改变;
- 目录层级完整;
- Web 服务进程对目录具有遍历权限;
- 对文件具有读取权限;
- SELinux、AppArmor等安全策略没有阻止读取;
- 部署脚本没有在验证请求到达前删除文件;
- 挑战结束后清理任务没有误删正在使用的文件。
Linux 环境可以用只读检查命令确认路径和属性:
namei -l /var/www/acme/.well-known/acme-challenge/当前实际令牌
stat /var/www/acme/.well-known/acme-challenge/当前实际令牌
如果使用动态接口,则应确认接口返回的是当前订单的 key authorization,而不是根据请求参数直接拼接未经校验的内容。动态处理器还要避免被应用鉴权、中间件或统一异常处理接管。
5. 反向代理、CDN和WAF是否改变了请求
有 CDN 或 WAF 时,DNS 指向的可能是边缘节点。此时需要分别确认:

- 边缘节点是否允许
/.well-known/acme-challenge/; - 该路径是否被转发到正确源站;
- 是否启用了缓存;
- 是否把 404、403或旧令牌缓存下来;
- 是否要求验证码、登录或特定请求头;
- 是否限制了验证服务器的访问频率;
- 边缘节点和源站的域名、Host转发是否一致。
挑战内容是短文本,通常不需要缓存。实施前可以为该路径设置不缓存或较短缓存策略,并在验证期间观察边缘访问日志和源站访问日志。不要仅凭源站本地 curl 成功就判断 CDN 链路正常,因为公网请求可能一直停留在边缘缓存。
6. HTTP重定向和应用重写是否可控
以下规则经常导致 HTTP-01 失败:
- 所有路径都重定向到登录页面;
/.well-known被前端路由接管;- HTTP 统一跳转到不存在的 HTTPS 站点;
- 末尾自动补斜杠,导致令牌路径改变;
- 反向代理丢失或改写
Host; - 统一错误页把所有状态改成
200 OK; - 访问控制只允许公司办公网或固定来源地址。
重定向并非在所有实现中都绝对不允许,但它会增加判断变量。对实施前检查而言,优先验证原始 HTTP URL 直接返回 200,并且响应体精确等于挑战内容。
验证方法:如何定位请求究竟停在哪一层
第一步:使用实际挑战令牌进行公网测试
在 ACME 客户端已经创建挑战内容后,从外部网络请求完整 URL:
curl -sS -D /tmp/acme-headers.txt \
-o /tmp/acme-body.txt \
--max-time 10 \
http://example.com/.well-known/acme-challenge/当前实际令牌
cat /tmp/acme-headers.txt
cat /tmp/acme-body.txt
检查三项:
- 状态码是否为
200; Location是否存在异常跳转;- 响应正文是否与客户端生成的
key authorization完全一致。
如果要确认正文没有被额外字符、HTML模板或错误页替换,可以比较文件内容,而不是只在浏览器中查看:
cmp -s /tmp/acme-body.txt /path/to/expected-key-authorization
echo $?
返回 0 表示两个文件内容一致。该命令只读取和比较文件,不会修改服务配置。
第二步:分别验证IPv4和IPv6入口
使用 curl -4 和 curl -6 分别测试,可以快速判断是否只有一个地址族存在问题:
| 测试结果 | 判断方向 |
|---|---|
| IPv4和IPv6都返回相同的正确内容 | 地址族和挑战路由基本一致 |
| IPv4成功,IPv6超时 | 检查AAAA记录、IPv6路由、防火墙和监听 |
| IPv4返回200,IPv6返回404 | 检查IPv6入口使用的虚拟主机或后端 |
| 两者都返回404 | 检查令牌文件、路径映射和客户端状态 |
| 两者返回内容不同 | 检查多节点、CDN缓存或负载均衡分流 |
如果 DNS 返回多个 IPv4 地址,应逐个测试。可以对指定地址强制连接,同时保留原始 Host:
curl -i --max-time 10 \
--resolve example.com:80:203.0.113.10 \
http://example.com/.well-known/acme-challenge/当前实际令牌
curl -i --max-time 10 \
--resolve example.com:80:203.0.113.11 \
http://example.com/.well-known/acme-challenge/当前实际令牌
这类测试适合核对各个公网地址是否配置一致。示例中的 IP 需要替换为实际 DNS 解析结果。
第三步:对照边缘和源站日志
用令牌文件名或完整请求路径搜索访问日志,通常比查看普通首页访问更有效。可以按下面的方式判断:
- 边缘日志没有记录:请求可能没有到达该 CDN、WAF或负载均衡;
- 边缘有记录,源站没有记录:检查边缘缓存、转发规则和回源条件;
- 源站有记录且返回 200,但公网得到 404:检查缓存、多个边缘节点或域名路由;
- 源站记录显示 403:检查认证、文件权限、安全模块和访问控制;
- 同一时间不同节点返回不同正文:检查部署同步和负载均衡后端;
- 日志中出现的 Host 不是申请证书的域名:检查代理转发和虚拟主机配置。
日志时间应与 ACME 客户端发起挑战的时间对应。若请求路径中没有当前令牌,可能测试的是旧订单,或者客户端还没有进入真正的验证阶段。
常见错误与优先检查环节
| 现象 | 优先检查内容 | 典型原因 |
|---|---|---|
| DNS解析失败 | A、AAAA、CNAME及权威DNS | 域名记录缺失或仍指向旧入口 |
| 连接超时 | 路由、防火墙、安全组、NAT | 公网80端口未放行或IPv6不可达 |
| 连接被拒绝 | 监听器和端口映射 | 没有服务监听80端口 |
| 404 Not Found | 令牌文件、站点匹配、路径映射 | 文件未创建、Host匹配错误、重写规则接管 |
| 403 Forbidden | 权限、WAF、认证和来源限制 | 目录不可读、挑战路径需要登录 |
| 301/302循环 | Location、HTTP/HTTPS和代理规则 | 重定向循环或跳转到不可访问地址 |
| 200但正文错误 | 文件内容、缓存、多节点同步 | 返回首页、旧令牌或缓存内容 |
| 只有部分请求成功 | 多IP、多节点、CDN和IPv4/IPv6 | 后端配置不一致或分流结果不同 |
| HTTP验证通过但申请仍失败 | CAA、订单状态、账户权限和限额 | 传输链路正常,但其他授权条件不满足 |
适用限制:什么时候不应继续纠缠HTTP-01
HTTP-01 适合能够稳定提供公网 HTTP 服务、并能控制 80 端口入口的域名。以下场景需要重新评估验证方式:
- 申请通配符证书,例如
*.example.com; - 域名没有稳定的公网 80 端口;
- 服务器只允许内网访问;
- 站点必须强制登录,无法公开提供挑战路径;
- DNS、CDN或多地域入口无法保持挑战内容一致;
- 业务环境不允许临时修改边缘或源站路由。
HTTP-01 不能用于通配符验证。此时通常需要使用 DNS-01,通过 DNS 中的 TXT 记录证明域名控制权;如果环境具备相应条件,也可以评估其他 ACME 挑战类型。选择其他方式后,验证位置和检查项会变化,不能继续用 /.well-known/acme-challenge/ 判断结果。
还要把 HTTP 链路问题与其他失败类型分开。即使挑战 URL 已经稳定返回正确内容,以下因素仍可能导致订单失败:
- CAA 记录不允许当前证书颁发机构;
- 申请的域名与完成验证的域名不一致;
- ACME 账户、订单或授权状态已经过期;
- 客户端使用了旧令牌;
- 触发了服务端的申请频率或失败次数限制;
- 证书申请包含了另一个未通过验证的域名。
实际判断时,可以使用一个明确边界:只有当每个申请域名的公开 A/AAAA 入口、80端口、指定挑战路径和响应正文都在外部网络中验证一致,并且日志能够对应到这次挑战,才可以认为 HTTP-01 传输链路已具备通过条件。 若这一步已经满足而订单仍失败,就应转向检查 CAA、订单状态、账户权限或其他域名授权条件,而不是继续反复修改 Web 根目录。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5885.html



