Cloudflare (BYOCDN)

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

先决条件

在设置Cloudflare Worker路由规则之前，请确保您具有：

如何进行路由

正确配置后，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 后端发出的请求中必须设置以下头部：

设置选项

有两种方法可以为 Edge Optimize 设置 Cloudflare Worker：

无论您选择哪个选项，都必须手动将 Worker 关联到您的域——请参阅步骤：给您的域添加路由。

选项 1：部署到 Cloudflare

此选项使用​部署到 Cloudflare 按钮自动创建 Worker，并在您的 Cloudflare 帐户中配置必需的环境变量和密码。 如果您要设置新的 Worker，这个方法可以让您快速开始使用。

步骤 1：部署 Worker

点击下面的按钮，将 Edge Optimize worker 部署到您的 Cloudflare 帐户：

步骤 2：填写部署表单

点击按钮，打开 Worker 设置页面。 按照下述方法填写表单：

Worker 部署完成后，继续添加指向您的域名的路由，将 Worker 与您的域相关联。 路由未自动配置，必须手动完成。

选项 2：手动设置

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

步骤 1：创建 Cloudflare Worker

步骤 2：添加 Worker 代码

创建辅助进程后，单击​编辑代码，并将默认代码替换为worker.js中的代码。 如果您已经拥有现有的Cloudflare Worker，请将该代码与现有工作程序代码合并，而不是完全替换。

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

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

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

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

无论您使用哪个设置选项，都必须手动将 Worker 与您的域相关联。 此步骤会激活您流量中的 Worker。

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

验证故障转移行为

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

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

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

了解 Worker 逻辑

Cloudflare 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;

重要注意事项

疑难解答

允许 Optimize at Edge 通过防火墙规则（可选）

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

验证设置

完成设置后，验证机器人流量是否被路由到 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. 如何区分这两种场景

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

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