边缘安全加速平台 EO 自助调试

如果需要确认当前在 EdgeOne 内配置的节点缓存规则、自定义 Cache Key 等配置是否已针对你的资源生效,EdgeOne 提供了自助调试工具来帮助你获取节点缓存 TTL,资源是否可缓存,Cache key 等信息,方便你进行业务配置调试。开启自助调试后,可以以通过指定的客户端 IP 来发起 URL请求,在请求中携带 EO-Debug-Headers: all 头部,即可根据返回的响应头来查看该资源在节点内是。

相关产品
边缘安全加速平台 EO 产品页,含版本规格、价格与购买入口。

一、使用场景

若你在控制台规则引擎里配置了较复杂的缓存策略、自定义 cache key,需要验证配置是否生效,可以通过该功能进行验证。

二、操作步骤

例如:当前站点 example.com 下的域名 www.example.com,当前已针对 .jpg 后缀文件配置需要在 EdgeOne 节点内缓存 600 秒;缓存 Cache Key 配置为保留指定参数 a 作为缓存键。配置完成后,需要验证当前配置是否已生效,可按照如下操作步骤验证:

1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,进入服务总览,单击网站安全加速内需配置的站点。

2. 在站点详情页面,单击站点加速,进入站点全局配置页面,在右侧导航栏中,单击自助调试。

3. 找到自助调试配置卡片中,单击 “开关”,开启自助调试功能。

4. 开启调试模式后,需要设置有效期,以及允许访问的客户端来源。其中,时间范围为 1-365 天,默认 7 天。客户端 IP 可输入 100 个,支持填写 IPv4 以及 IPv6 的 IP/IP 段,0.0.0.0/0 表示允许所有 IPv4 客户端进行调试;::/0 表示允许所有 IPv6 客户端进行调试。

5. 单击保存,则配置允许的客户端 IP 在有效时间内可进行 debug 调试。

6. 通过以上指定的客户端 IP 来源,在 Mac/Linux 环境下,发起 curl 请求进行验证,例如:

curl -voa 'http://www.example.com/test.jpg?a=1' -H 'EO-Debug-Headers: all'。请求结果如下:

在响应头中,可以看到该请求对应的 Cache Key、缓存状态、缓存时间,与示例中的配置一致,即当前配置已生效。

三、相关参考

在开启自助调试模式时,响应的 debug 头部说明如下:

头部名称 功能说明 返回值的含义说明
EO-Debug-Status 用于标识自助调试模式是否开启。 on:开启状态,且请求客户端 IP 在白名单内&请求时间在有效期内;off:关闭状态,或开启状态但请求时间超出有效期;forbidden:开启状态,但请求客户端 IP 不在白名单内。
EO-Debug-ClientIp 发起 Debug 请求的 ClientIP。 发起 Debug 请求的客户端 IP。当开启自助调试但 EO-Debug-Status 值为 forbidden 时,可以检查下是否请求的客户端 IP 不在允许的 IP/IP 段范围内。
EO-Debug-Cacheable 本次请求的 URL,按照配置节点缓存 TTL 的配置,最终该请求 URL 资源在 EdgeOne 节点内是否可缓存的状态。 yes:可缓存内容no:不可缓存内容
EO-Debug-CacheKey 本次请求的 URL,按照自定义 Cache key,最终该请求 URL 资源在 EdgeOne 节点内生成的 Cache key。 例如:www.example.com/test.jpg a=1 ,指该请求 URL 资源在 EdgeOne 内生成的 Cache Key
EO-Debug-CacheTTL 本次请求的 URL,按照配置节点缓存 TTL的配置,最终该请求 URL 资源在 EdgeOne 节点缓存 TTL 时长。 列表值,包括数字和时间单位。d 表示天,h 表示小时,m 表示分钟,s 表示秒,例如:3d0h0m0s 表示缓存TTL是 3 天;0d0h5m0s 表示缓存是 5 分钟;0d0h0m5s 表示缓存是 5 秒。
赞 (0)
上一篇 4天前
下一篇 4天前