ACME HTTP验证要求域名请求到达哪里,验证失败时应检查哪些环节?

发布人:A5数据发布时间:2026-10-26 16:54阅读量:69

很多人看到 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 服务器必须根据这个域名选择正确的站点和路由。

验证请求实际会到达哪里

可以把请求路径抽象成下面这条链路:

概念边界:HTTP-01验证到底检查什么配图

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 服务端会为域名生成一个挑战令牌。客户端通常有两种处理方式:

  1. 在 Web 根目录下临时创建令牌文件;
  2. 通过 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

检查三项:

  1. 状态码是否为 200;
  2. Location 是否存在异常跳转;
  3. 响应正文是否与客户端生成的 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

相关推荐