如何识别私有IP段地址
少数ISP在特定区域可能会分配私有IP地址给客户端，导致ESA节点接收到的是客户端IP是私有IP段的地址，这会导致在规则中使用“国家/地区、省份、运营商等”字段参数去识别客户端请求的时候无法准确识别出这部分请求。如果要识别私有IP段地址，可以按以下方式来处理。
步骤1: 新建IP网段分组
进入全局配置目录下的分组功能界面，点击新建分组，添加如下三个私有IP/网段：
A类私有IP地址：10.0.0.0～10.255.255.255，子网掩码：10.0.0.0/8。
B类私有IP地址：172.16.0.0～172.31.255.255，子网掩码：172.16.0.0/12。
C类私有IP地址：192.168.0.0～192.168.255.255，子网掩码：192.168.0.0/16。
添加完成后点击确定。
步骤2：添加私有IP网段规则
以自定义规则为例，进入WAF自定义规则配置页面，点击新增规则，逻辑表达式选择在分组中，下拉选择新建的分组。
填写完成后，点击确定即可。
添加了以上规则条件之后，使用私有IP段地址的客户端请求将会被规则准确识别。
配置IP频次限制规则后小程序图片无法访问
问题现象
在ESA中配置了IP频次限制规则（例如：10秒内超过20次请求触发JS/滑块挑战，持续1小时）后，小程序中的图片全部无法加载。删除该规则后，图片访问恢复正常。
原因分析
小程序加载页面时会并发请求大量图片资源，短时间内产生的请求数容易超过设定的频次阈值。当触发频次限制规则后，正常的图片请求也会被拦截（JS挑战或滑块验证），而小程序环境无法执行JS挑战或完成滑块验证，导致所有图片请求被阻断。
解决方案
您可以根据实际情况选择以下一种或多种方式进行处理：
调高频次阈值：将触发阈值调整为更高的值（例如100次/10秒），避免小程序正常加载图片时触发限制。
缩小匹配范围：在规则的匹配条件中排除图片类请求（例如通过URL路径或文件扩展名过滤），仅对非静态资源请求进行频次限制。
配置白名单：将小程序的已知来源IP或Referer加入白名单，使其不受频次限制规则的约束。
临时删除规则：如果暂时无法确定合适的阈值，可以先删除该频次限制规则以恢复业务，再通过ESA控制台的请求分析功能识别异常IP后，重新配置更精确的规则。
高威胁的请求的挑战验证类型有哪些？
当请求被判定为具有潜在威胁时，系统会根据设定的安全级别发起挑战：
JavaScript挑战：向客户端注入一段JS代码，验证其是否为真实的浏览器环境。此过程对用户通常是透明无感的，但可能会对不支持JavaScript的API客户端造成影响。
人机验证码：要求用户完成图形验证码或滑动验证等交互操作，以证明其为人类用户。此方式会中断用户的访问流程。
安全规则和WAF规则有什么区别？
安全级别与WAF规则相互独立，安全级别由系统基于威胁情报库自动判断，对访问者进行拦截或挑战；而WAF规则是通过用户自定义具体规则，针对特定路径、参数或行为精准执行拦截或挑战，实现更细粒度的安全控制。
为什么配置了绕过缓存规则但未生效？
按以下步骤逐项排查：
检查匹配条件：确认规则表达式是否准确，常见错误包括：OR 条件导致逻辑覆盖其他域名；文件扩展名或路径格式填写错误（如扩展名多了点号）。
确认请求特征：若规则依赖特定请求头（如
sec-fetch-site）触发，需确认实际请求是否携带该标头。调整规则顺序：ESA 按列表从上到下匹配，若绕过缓存规则位于长缓存规则之后，可能被前置规则拦截。将绕过缓存规则调整至列表顶部。
刷新缓存：修改规则后，需在控制台执行 URL 或目录刷新；仅刷新浏览器无效。
验证是否过 ESA 节点：通过响应头
Server字段判断请求是否经过 ESA 节点，使用无痕浏览器排除本地缓存干扰。
接入 ESA 后网站无法登录、跳转失败或页面内容异常怎么办？
此类问题通常因全站缓存或不当的缓存规则导致登录态 Cookie、Session 或动态 API 响应被边缘节点缓存。解决步骤：
暂停或删除可疑的全站缓存规则；
为登录页、验证码接口及后台路径单独配置绕过缓存规则，并确保其优先级最高（置于列表顶部）；
在控制台刷新相关 URL 缓存；
使用无痕浏览器验证是否恢复正常。
若以上配置无误仍异常，需排查源站业务逻辑（如 302 跳转逻辑是否正确识别登录状态）。此类情况属于源站问题，非 ESA 产品问题。
缓存规则中的等于与包含有什么区别？
匹配方式 | 说明 |
等于 | 精确匹配指定 URL 路径，同时自动涵盖该路径下的所有子路径。例如，配置 |
包含 | 模糊匹配，只要 URL 中出现指定字符串即命中，无论该字符串出现在路径的哪个位置。 |
在主机名匹配场景下，"等于"与"包含"效果类似，均可正常使用。
为什么开启缓存规则后拨测正常，关闭后反而超时？
这是正常现象，原因如下：
开启缓存时：请求由边缘节点直接响应，源站压力小，响应速度快；
关闭缓存后：所有请求（包括动态请求）均实时回源，高并发拨测可能导致源站负载过高而超时。
此现象反映源站存在性能瓶颈，属于源站问题，非 ESA 问题。建议：
通过配置缓存规则减轻回源压力；
开启 JS 挑战或智能限频功能保护源站。
删除源站文件后，为什么响应过期缓存未生效？
响应过期缓存功能仅在源站返回 4xx、5xx 错误码或请求超时的情况下才会生效。如果仅删除了源站上的某个文件，但源站仍能正常响应请求（例如返回 200 状态码的默认页面，或返回 404 状态码），则不属于源站异常的范畴，不会触发响应过期缓存。
如果需要在源站文件删除后仍能通过缓存访问该文件，需确认以下两点：
源站确实处于不可达状态（例如源站服务器宕机、网络中断或返回 5xx 错误码），而非仅删除了单个文件。
该文件的缓存在删除前已被缓存到边缘节点。如果文件从未被缓存或缓存已被主动刷新，则即使触发了响应过期缓存，也无过期缓存可用于返回。
配置缓存规则后为什么仍然在回源？
缓存时间已过期：检查配置的
TTL值，确认是否过短。可以查看响应头中的Cache‑Control等字段，确认缓存存活时间。URL 参数不同：默认情况下，不同
URL参数视为不同的缓存键。建议配置缓存键规则，忽略无关参数。规则未生效：检查规则的匹配条件（如路径匹配条件），确保覆盖目标请求。
如何验证特定 URL 的缓存状态？
什么场景下需要调整Body大小限制？
Body大小限制决定了哪些POST请求走缓存流程。超出限制的请求将被直接转发到源站，不经过缓存。选值参考：
调大限制（如6~8 KB）：POST请求Body内容复杂、JSON字段多或体积较大时（如含嵌套结构的搜索条件、多维筛选参数的聚合查询），将限制调大可确保这些请求进入缓存流程，充分利用缓存加速。
保持较小默认值（如1~2 KB）：POST请求Body仅含少量标识符或简单参数时（如用户ID、时间戳等固定字段），无需调大限制，较小的值可以避免对大体积的非查询类请求做无效缓存。
如何验证回源配置修改是否生效及排查源站功能异常？
验证回源配置变更
修改回源配置后，可通过以下方式确认是否生效：
访问网站，检查返回内容是否来自新的源站。
查看源站服务器的访问日志，确认是否有来自 ESA 节点的请求记录。
排查源站功能失效问题（如语言切换失效）
若开启 ESA 后源站某项功能出现异常：
通过本地 hosts 文件将源站域名绑定到源站 IP，绕过 ESA 直接访问源站，排除源站自身问题。
清除浏览器缓存后重试，确认问题是否与缓存相关。
错误码规则对源站错误还是边缘节点错误生效？
规则仅针对源站服务器返回的错误码生效。
如果多条规则匹配同一请求会怎样？
规则按从上到下的顺序匹配。第一条匹配的规则生效，评估随即终止。请将更具体的规则排在通用规则之前。
错误码重定向规则与请求重定向规则是否共享配额？
是。两种规则共享同一重定向规则配额。重定向规则页面显示的配额反映了两种规则类型的合计数量。
如何实现根域名（裸域名）与 www 域名之间的相互跳转？
根据接入场景不同，选择以下方案：
场景 1：根域名和 www 域名均已通过 CNAME 或 NS 接入 ESA
在 ESA 中配置对应主机名的重定向规则，实现根域名与 www 域名的相互跳转。即使已配置重定向，被重定向的源域名也需保留 CNAME 记录，以确保 ESA 能识别该域名的流量。
场景 2：根域名存在 MX 记录，无法配置 CNAME（DNS 冲突）
建议使用 DNS 服务商提供的 URL 转发功能。该方式仅支持 HTTP 协议，流量不经过 ESA，无法享受 ESA 的安全防护和加速能力。
若此前已在 DNS 配置了 URL 转发记录，改用 ESA 重定向前需先删除该记录并添加 ESA CNAME，否则 ESA 规则不会生效。
配置重定向规则后未生效或跳转错误怎么办？
请按以下步骤逐一排查：
检查匹配条件覆盖范围：确认规则匹配条件是否覆盖了用户实际访问的域名。例如：若仅配置了 www 域名规则，用户访问裸域名时规则不生效，需补充裸域名规则或使用通配符匹配。
确认域名已通过 CNAME 或 NS 接入 ESA：ESA 重定向要求域名流量经过 ESA 节点。若域名仅在源站配置了跳转，或依赖 DNS URL 转发，流量不经过 ESA，规则将不生效。
检查规则优先级：确认是否存在更高优先级的规则覆盖了当前重定向规则。请参见规则的生效优先级了解规则匹配顺序。
验证动态表达式语法：若使用动态重定向，请确认表达式语法正确，拼接目标 URL 须使用
concat函数，不能直接填写含变量的普通字符串。
配置重定向后出现死循环或网站无法访问怎么办？
请按以下步骤排查并修复：
检查是否存在循环配置：若 www 域名的回源地址指向根域名，同时又配置了根域名到 www 的重定向规则，将形成无限循环。请将源站地址还原为真实 IP 或原始源站域名。
HTTP 跳 HTTPS 建议使用专用功能：ESA 控制台提供强制 HTTPS配置项，优先使用该功能代替手动配置重定向规则，可有效避免规则冲突引发的循环跳转。
刷新缓存：若浏览器或 CDN 缓存了旧的重定向响应导致问题持续，请在 ESA 控制台刷新相关缓存后重新验证。
检查规则匹配范围：确认重定向规则的匹配条件未意外覆盖健康检查路径或其他特殊路径，避免误匹配导致服务不可用。
如何根据设备类型（如手机端）或请求特征配置条件重定向？
在重定向规则的传入请求类型匹配条件中，可基于请求头（如 User-Agent）设置判断：
匹配方式选择"包含"：User-Agent 通常为较长字符串，建议使用"包含"而非"等于"进行匹配，以兼容不同设备和浏览器的 User-Agent 格式。
手机端跳转配置示例：
匹配条件：
User-Agent 包含 Mobile，或User-Agent 包含 Android/iPhone执行动作：设置为 302 临时重定向至移动端专属域名（如
https://m.example.com）
多条件组合：可结合路径、查询参数等多个匹配条件实现精细化跳转控制，例如仅对特定页面的手机端流量执行重定向。
为什么配置了重定向规则但浏览器地址栏 URL 没有变化？
这通常是将 URL 重写与请求重定向混淆所致，两者区别如下：
请求重定向：ESA 向客户端返回 3xx 状态码，浏览器自动跳转至目标 URL，地址栏中的 URL 将发生改变。
URL 重写：ESA 仅修改回源请求路径（透明代理），浏览器地址栏 URL 保持不变。
若需保持地址栏 URL 不变仅修改回源路径，请使用 URL 重写功能；若需浏览器跳转并改变地址栏 URL，请使用请求重定向功能。