文档Adobe Brand Visibility

Cloudflare (BYOCDN)

最近更新： 2026年8月7日

创建对象：

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

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

先决条件

在配置 Cloudflare Worker 路由规则之前，请确保您已具备以下条件：

  • 具有 Cloudflare 帐户，并且在您的域中启用了 Workers。
  • 可以在 Cloudflare 中访问您的域的 DNS 设置。
  • 从Edge UI检索到Adobe Brand Visibility优化API密钥。 有关步骤，请参阅检索您的 API 密钥。
  • （可选）要测试暂存路由，请参阅暂存 API 密钥。

如何进行路由

正确配置后，Cloudflare Worker 会截获代理式用户代理对您的域（例如 www.example.com/page.html）的请求，并将其路由到 Edge Optimize 后端。 后端请求包含必需的头部。

测试后端请求

您可以直接向 Edge Optimize 后端发出请求来验证这个路由。

curl -svo /dev/null https://live.edgeoptimize.net/page.html \
  -H 'x-forwarded-host: www.example.com' \
  -H 'x-edgeoptimize-url: /page.html' \
  -H 'x-edgeoptimize-api-key: $EDGE_OPTIMIZE_API_KEY' \
  -H 'x-edgeoptimize-config: LLMCLIENT=TRUE;'

必需的头部

对 Edge Optimize 后端发出的请求中必须设置以下头部：

页眉
描述
示例
x-forwarded-host
请求的原始主机。 用于识别网站域。
www.example.com
x-edgeoptimize-url
请求的原始 URL 路径和查询字符串。
/page.html 或 /products?id=123
x-edgeoptimize-api-key
Adobe 为您的域提供的 API 密钥。
your-api-key-here
x-edgeoptimize-config
用于区分缓存键的配置字符串。
LLMCLIENT=TRUE;

设置选项

可通过两种方式为Edge中的优化配置Cloudflare：

对于手动设置，您必须手动将Worker链接到您的域。 请参阅向您的域添加路由。

选项1：Adobe Brand Visibility中的引导式设置

  1. 为要配置的URL打开​CDN配置。
  2. 在​ 将优化部署到AI代理 ​中，根据需要选择​启用。
  3. 选择​ 在Cloudflare ​中部署路由。
  4. 选择​连接到Cloudflare OAuth。 使用可以管理Workers和Worker路由的Cloudflare用户登录，然后批准对正确帐户和区域的访问。 您无需在Adobe Brand Visibility中输入API令牌。
  5. 为站点选择Cloudflare区域。 确保目标主机名具有代理的DNS记录，并且不是由现有的自定义工作进程或重叠的工作进程路由处理。
  6. 按照引导式步骤部署专用的Worker 、添加路由并验证配置。

从Adobe Brand Visibility 🔗 在Cloudflare中部署路由

NOTE
引导式设置可作为符合条件的帐户的早期访问功能。 要获得入门培训帮助，请联系您的Adobe客户团队或发送电子邮件至llmo-at-edge@adobe.com。

选项 2：手动设置

按照这些步骤手动创建和配置 Worker。

步骤 1：创建 Cloudflare Worker

  1. 登录您的 Cloudflare 仪表板。
  2. 在侧边栏中导航到 Workers 和页面。
  3. 点击​创建应用程序，然后点击​创建 Worker。
  4. 为您的 Worker 命名（例如 edge-optimize-router）。
  5. 点击​部署，用默认代码创建 Worker。

Cloudflare Workers 仪表板

步骤 2：添加 Worker 代码

创建 Worker 后，点击​编辑代码，然后使用 worker.js 中的代码替换默认代码。 如果您已经有一个 Cloudflare Worker，请将该代码与现有 Worker 代码合并，而不要完全替换现有代码。

点击​保存并部署，发布 Worker。

步骤 3：配置环境变量和密码

环境变量可以安全地存储敏感配置，例如您的 API 密钥。

  1. 在 Worker 的设置中，导航前往​设置 > 变量。

  2. 在​ 环境变量 ​中点击​添加变量。

  3. 添加以下变量：

    table 0-row-3 1-row-3 2-row-3
    变量名称 描述 必需
    EDGE_OPTIMIZE_API_KEY Adobe 提供的 Edge Optimize API 密钥。 是
    EDGE_OPTIMIZE_TARGET_HOST Edge Optimize 请求的目标主机（作为 x-forwarded-host 头部发送）和故障转移的源域。 域名不能包含协议头（例如 www.example.com，不能是 https://www.example.com）。 是

  4. 对于 API 密钥，点击​加密，以安全存储。

  5. 点击​保存并部署。

Cloudflare 环境变量

添加指向您的域名的路由 add-a-route-to-your-domain

如果您使用手动设置，请手动将Worker链接到您的域。 此步骤会针对您的流量激活工作程序。

  1. 前往 Worker 的​设置 > 触发器。
  2. 在​ 路由 ​中点击​添加路由。
  3. 输入您的域模式（例如 www.example.com/* 或 example.com/*）。
  4. 从下拉列表中选择您的区域。
  5. 单击​保存。

或者，您也可以在区域层面配置路由：

  1. 在 Cloudflare 中导航到您的域。
  2. 前往 Workers 路由。
  3. 点击​添加路由，指定模式和 Worker。

Cloudflare Worker 路由

验证故障转移行为

如果 Edge Optimize 不可用或返回错误，Worker 就会自动将故障转移到您的源站。 故障转移响应包含 x-edgeoptimize-fo 头部：

< HTTP/2 200
< x-edgeoptimize-fo: 1

您可以在 Cloudflare Worker 日志中监控故障转移事件，以解决问题。

了解 Worker 逻辑

Cloudflare Worker 会实施以下逻辑：

  1. 用户代理检测：​检查传入请求的用户代理是否与任何已定义的代理式机器人匹配（不区分大小写）。

  2. 路径目标：​可选择根据目标路径筛选请求。 默认情况下，会将所有 HTML 页面（以 /、无扩展名或以 .html 结尾的URL）路由。 您可以使用 TARGETED_PATHS 数组指定特定路径。

  3. 循环保护： x-edgeoptimize-request 头部可阻止无限循环。 如果 Edge Optimize 将请求送回到您的源站，这个头部设置为 "1"，并且 Worker 传递请求时未将其路由回到 Edge Optimize。

  4. 头部安全性：​在设置 Edge Optimize 头部之前，Worker 会从传入请求中移除任何现有的 x-edgeoptimize-* 头部，以防止头部注入攻击。

  5. 头部映射： Worker 设置 Edge Optimize 所需的头部：

    • x-forwarded-host——识别原始站点域。
    • x-edgeoptimize-url——保留原始请求路径和查询字符串。
    • x-edgeoptimize-api-key——通过 Edge Optimize 对请求进行身份验证。
    • x-edgeoptimize-config——提供缓存键配置。

  6. 故障转移逻辑：​如果 Edge Optimize 返回任何错误状态代码（4XX 客户端错误或 5XX 服务器错误），或者由于网络出错而请求失败，Worker 就会使用 EDGE_OPTIMIZE_TARGET_HOST 自动将故障转移到您的源站。 故障转移响应包含 x-edgeoptimize-fo: 1 头部，表示已进行了故障转移。

  7. 重定向处理：redirect: "manual" 选项可确保来自 Edge Optimize 的重定向响应被传递到客户端，而无需 Worker 跟随这些响应。

自定义配置

您可以通过更改代码顶部的配置常量来自定义 Worker 行为：

代理式机器人列表

更改 AGENTIC_BOTS 数组，以添加或移除用户代理：

const AGENTIC_BOTS = [
  'AdobeEdgeOptimize-AI',
  'ChatGPT-User',
  'GPTBot',
  'OAI-SearchBot',
  'PerplexityBot',
  'Perplexity-User',
  'ClaudeBot',
  'Claude-User',
  'Claude-SearchBot',
  // Add additional user agents as needed
];

目标路径

默认情况下，所有 HTML 页面都会被路由到 Edge Optimize。 要将路由限制到特定路径，请更改 TARGETED_PATHS 数组：

// Route all HTML pages (default)
const TARGETED_PATHS = null;

// Or specify exact paths to route
const TARGETED_PATHS = ['/', '/page.html', '/products', '/about-us'];

故障转移配置

默认情况下，如果 Edge Optimize 返回任何 4XX 或 5XX 错误，Worker 都会触发故障转移。 自定义这个行为：

// Default: failover on any 4XX or 5XX error
const FAILOVER_ON_4XX = true;
const FAILOVER_ON_5XX = true;

// Failover only on 5XX server errors (not 4XX client errors)
const FAILOVER_ON_4XX = false;
const FAILOVER_ON_5XX = true;

// Disable automatic failover (not recommended)
const FAILOVER_ON_4XX = false;
const FAILOVER_ON_5XX = false;

重要注意事项

  • 故障转移行为：​如果 Edge Optimize 返回任何错误（4XX 或 5XX 状态代码），或者由于网络出错而请求失败，Worker 就会自动将故障转移到您的源站。 故障转移使用 EDGE_OPTIMIZE_TARGET_HOST 作为源域（类似于 Fastly 的 F_Default_Origin 或 CloudFront 的 Default_Origin）。 故障转移响应包含 x-edgeoptimize-fo: 1 头部，可用于监控和调试。

  • 缓存：​默认情况下，Cloudflare 会根据 URL 缓存响应。 由于代理式流量获得的内容与人工流量不同，因此请确保您的缓存配置考虑到这一点。 请考虑使用缓存 API 或缓存头来区分缓存的内容。 x-edgeoptimize-config 头部应包含在您的缓存键中。

  • 速率限制：​监控您的 Edge Optimize 使用情况，需要时考虑为代理式流量实施速率限制。

  • 测试：​将配置部署到生产环境之前，始终在暂存环境中进行测试。 验证代理式流量和人类流量都按预期运行。 通过模拟 Edge Optimize 错误来测试故障转移行为。

  • 日志记录：​启用 Cloudflare Workers 日志记录，以监控请求，解决问题。 导航到 Workers > 您的 Worker > 日志，查看实时日志。 Worker 会记录故障转移事件，用于进行调试。

故障排除

问题
可能的原因
解决方案
响应中没有 x-edgeoptimize-request-id 头部
Worker 路由不匹配，或用户代理不在代理式机器人列表中。
验证您的路由模式是否与请求 URL 匹配。 检查用户代理是否在 AGENTIC_BOTS 数组中。
来自 Edge Optimize 的 401 或 403 错误
API 密钥无效或缺失。
验证是否在环境变量和密码中正确设置了 EDGE_OPTIMIZE_API_KEY。 请联系 Adobe 确认您的 API 密钥为活跃状态。
无限重定向或循环
循环保护头未经过正确设置或检查。
确保已设置了 x-edgeoptimize-request 头部检查。
人类流量受到影响
Worker 路由逻辑过于宽泛。
验证用户代理匹配逻辑正确且不区分大小写。 检查 TARGETED_PATHS 已正确配置。
响应时间慢
Edge Optimize 后端的网络延迟。
第一个请求会发生这个现象；后续请求会缓存在 Edge Optimize 中。
响应中的 x-edgeoptimize-fo: 1 头部
Edge Optimize 返回了错误，故障转移到了源站。
查看 Cloudflare Workers 日志，了解特定的错误代码。 通过 Adobe 验证 Edge Optimize 服务状态。
故障转移不起作用
故障转移标志已禁用，或故障转移逻辑中出错。
验证 FAILOVER_ON_4XX 和 FAILOVER_ON_5XX 都已设置为 true。 检查 Worker 日志中的错误消息。
某些路径未优化
路径与目标路径或 HTML 页面模式不匹配。
验证路径位于 TARGETED_PATHS（如果已指定）并与 HTML 页面正则表达式模式匹配。
因主机无效，请求失败
EDGE_OPTIMIZE_TARGET_HOST 包含协议（例如 https://）。
仅使用不带协议的域名（例如 example.com，而不是 https://example.com）。
故障转移过程中出现 530 错误
Cloudflare 无法连接到源站，或者故障转移请求的头部无效。
确保故障转移功能会移除 Edge Optimize 头部。 验证您的源站可访问并且 DNS 配置正确。

允许 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
不存在
x-edgeoptimize-fo
仅在发生故障转移的情况下存在（值：1）
不存在

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

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

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

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