Azure Front Door (BYOCDN)

此配置将代理式流量(来自 AI 机器人和 LLM 用户代理的请求)路由到 Edge Optimize 后端服务(live.edgeoptimize.net)。 人类访客和 SEO 机器人仍将照常从您的源站获得响应。 完成设置后,可在响应中查找头部 x-edgeoptimize-request-id 以测试配置是否成功。

Azure Front Door 不支持在边缘节点运行自定义代码。 路由通过​ 规则集 ​和专用于 Edge Optimize 的​ 源站组 ​共同进行配置。 故障切换由 Azure Front Door 基于优先级的源站组健康探测机制负责处理。

先决条件

在配置 Azure Front Door 路由规则之前,请确保您已具备以下条件:

  • 拥有 Azure Front Door 配置文件的访问权限。
  • 从Edge UI检索到Adobe Brand Visibility优化API密钥。 有关步骤,请参阅检索您的 API 密钥
  • (可选)要测试暂存路由,请参阅暂存 API 密钥

步骤 1:为 Edge Optimize 创建源站组

您的 Azure Front Door 配置文件中已包含一个指向源站的默认源站组。 请为 Edge Optimize 创建一个​ ​的源站组:

  • 名称:edge-optimize-origin-group

  • 源站(基于优先级的故障切换):

    • 优先级 1live.edgeoptimize.net(源站主机标头:live.edgeoptimize.net
    • 优先级 2 — 您的域名终结点(例如 www.example.com)。 此配置用于故障切换:如果 Edge Optimize 不可用,请求将路由到您的域名,然后重新进入 Azure Front Door,并由默认源站提供服务。
  • 健康探测:已启用

    • 路径:/health/<your-domain>(例如,/health/www.example.com
    • 协议:HTTPS
    • 间隔:225 秒
  • 会话关联:已禁用

  • 证书主题名称验证:已启用

包含两个基于优先级的源站及健康探测的 Edge Optimize 源站组

NOTE
在 Azure 门户中,edge-optimize-origin-group 源站组会显示 "Unassociated"(未关联)警告。 这是预期行为,因为该源站组是通过规则集的路由覆盖进行引用,而不是直接由路由引用。

步骤 2:配置路由

通常,在创建 Azure Front Door 配置文件时会自动创建一条默认路由。 规则集(步骤 3)会针对代理式流量覆盖源站组配置,因此无需为 Edge Optimize 单独创建路由。

步骤 3:创建规则集

依次进入​规则集 > 添加规则集,并将其命名为 EORouting。 按照以下顺序添加三个规则。

显示请求头清理和机器人路由规则的 EORouting 规则集

规则 1:StripIncomingEOHeaders01

删除传入请求中的 Edge Optimize 请求头,以防止伪造请求。 无需设置条件,适用于所有请求。 停止继续评估:

操作,删除以下每个请求头:

  • x-edgeoptimize-url
  • x-edgeoptimize-config
  • x-edgeoptimize-api-key
  • x-edgeoptimize-fetcher-key

规则 2:EOGPTBotRootGET03

将访问 HTML 页面路径的机器人请求路由至 Edge Optimize。 停止继续评估:开启

条件(必须全部满足):

  • 请求方法:等于 GET
  • 请求路径:正则表达式(^$|^.*/$|(^|.*/)[^./]+$|^.*\.html$)(匹配网站根路径、以 / 结尾的路径、无扩展名的页面路径以及 .html 路径)
  • User-Agent:包含以下任意值: chatgpt-usergptbotoai-searchbotadobeedgeoptimize-aiperplexitybotperplexity-userclaudebotclaude-userclaude-searchbot。 将字符串转换设置为​转换为小写
  • x-edgeoptimize-monitor不包含 1
  • x-edgeoptimize-request不包含 failover1

操作

  • 覆盖请求头 x-edgeoptimize-url = /{url_path}?{query_string}
  • 覆盖请求头 x-edgeoptimize-config = LLMCLIENT=TRUE;
  • 覆盖请求头 x-edgeoptimize-api-key = YOUR_API_KEY
  • 覆盖请求头 x-edgeoptimize-monitor = 1
  • 覆盖路由配置:源站组 → edge-optimize-origin-group,转发协议 → 与传入请求保持一致,缓存 → 禁用

规则 3:HealthProbeRewrite03

重写 Azure Front Door 的健康探测请求,使其访问您的源站时使用 /,而不是 /health/<domain>。 这样,Azure Front Door 无需在您的源站配置专用健康检查端点,即可监控 Edge Optimize 的可用性。 停止继续评估:开启

健康探测重写规则

条件(必须全部满足):

  • 请求 URL 路径: /health/开头
  • x-fd-healthprobe包含 1

操作

  • URL 重写,源路径:/health/;目标路径:/
  • 覆盖响应头 custom-origin-health = routed(用于诊断,验证完成后可移除)
  • 向请求头 user-agent 追加 AdobeEdgeOptimize/1.0(注意前面保留一个空格,Azure Front Door 会按原样追加该值)
  • 覆盖路由配置:源站组 → default-origin-group,转发协议 → 与传入请求保持一致,缓存 → 禁用

步骤 4:将规则集关联到路由

打开您的路由,滚动到页面底部的​ 规则 ​部分,然后从下拉列表中选择 EORouting 规则集。 如果您已有其他规则集,请使用​ 移至顶部 ​将 EORouting 调整到 #1 的位置。 Optimize at Edge 规则仅会拦截代理式流量和 Edge Optimize 回环请求,其他所有流量都会不受影响地继续经过您的其他规则进行处理。 保存配置,并等待其生效(约需 20 分钟)。

允许 Optimize at Edge 通过防火墙规则(可选)

如果您的CDN使用WAF或机器人管理器:

  • 在WAF或机器人管理器中允许列表*AdobeEdgeOptimize/1.0*用户代理,以便Edge上的优化服务可以获取您的源内容。

  • 如果您的防火墙需要用户代理以外的其他验证,请生成密钥(例如,openssl rand -hex 32)并:

    • 将带有密码的x-edgeoptimize-fetcher-key添加到您的路由规则中其他x-edgeoptimize-*标头旁边。
    • 添加WAF或机器人管理器规则,以允许请求x-edgeoptimize-fetcher-key与同一密码匹配。
  • 在Edge中优化会按原样转发此标头 — 您拥有完整的密钥生命周期。

验证设置

完成设置后,验证机器人流量是否被路由到 Edge Optimize,以及人类流量是否不受影响。

1. 测试机器人流量(应被优化)

用代理式用户代理模拟 AI 机器人请求:

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

成功的响应包括 x-edgeoptimize-request-id 头部,用于确认请求是通过 Edge Optimize 路由的:

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. 测试人类流量(不应受影响)

模拟一个常规的人类浏览器请求:

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

响应​ ​应包含 x-edgeoptimize-request-id 头部。 页面内容和响应时间应保持与启用 Optimize at Edge 之前时完全相同。

3. 如何区分这两种场景

页眉
机器人流量(已优化)
人类流量(不受影响)
x-edgeoptimize-request-id
存在——包含唯一的请求 ID
不存在

也可以在Adobe Brand Visibility UI中查看流量路由的状态。 导航到​ 客户配置 ​并选择​ CDN配置 ​选项卡。

将优化部署到 AI 代理——已完成

要进一步了解Edge优化,包括可用的机会、自动优化工作流和常见问题,请返回Edge优化概述

recommendation-more-help
brand-visibility-help-main-toc