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 後端。 後端要求包含必要的標頭。
測試後端要求
您可以直接向邊緣最佳化後端傳送要求，以驗證路由設定。
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-hostwww.example.comx-edgeoptimize-url/page.html 或 /products?id=123x-edgeoptimize-api-keyyour-api-key-herex-edgeoptimize-configLLMCLIENT=TRUE;設定選項
有兩種方法可設定Cloudflare以在Edge最佳化：
- 選項1：在Adobe Brand Visibility中引導式設定（建議） — 使用Adobe Brand Visibility來部署Worker、新增路由及驗證設定。
- 選項2：手動設定 — 提供逐步指示，讓您自行建立及設定Worker。 如果您已有網域的Cloudflare Worker且需要將Edge Optimize程式碼合併至其中，或如果您偏好完全控制部署，請使用此選項。
對於手動設定，您必須手動將Worker連結至您的網域。 請參閱新增路由至您的網域。
選項1：Adobe Brand Visibility中的引導式設定
- 針對您要設定的URL開啟CDN設定。
- 在 將最佳化部署到AI代理程式 中，視需要選取啟用。
- 選取 在Cloudflare 中部署路由。
- 選取與Cloudflare OAuth連線。 使用可以管理Worker和Worker路由的Cloudflare使用者登入，然後核准對正確帳戶和區域的存取權。 您不需要在Adobe Brand Visibility中輸入API Token。
- 選取網站的Cloudflare區域。 確保目標主機名稱具有代理的DNS記錄，且不是由現有的自訂背景工作或重疊背景工作路由處理。
- 依照引導式步驟部署專用的Worker、新增路由及驗證設定。
從Adobe Brand Visibility
選項 2：手動設定
依照下列步驟手動建立和設定工作程式。
步驟 1：建立 Cloudflare Worker
- 登入您的 Cloudflare 儀表板。
- 在側邊欄中導覽至「Worker 與頁面」。
- 按一下「建立應用程式」，然後按一下「建立 Worker」。
- 為您的 Worker 命名 (例如
edge-optimize-router)。 - 按一下「部署」，使用預設程式碼建立 Worker。
步驟 2：新增 Worker 程式碼
建立 Worker 之後，按一下「編輯程式碼」，然後以 worker.js 的程式碼取代預設程式碼。 如果您已有現有的 Cloudflare Worker，請將程式碼與既有的 Worker 程式碼合併，而非完全取代。
按一下「儲存並部署」，以發佈工作程式。
步驟 3：設定環境變數和密鑰
環境變數會安全地儲存敏感設定，例如您的 API 金鑰。
-
在您的 Worker 設定中，導覽至「設定」>「變數」。
-
在「環境變數」之下，按一下「新增變數」。
-
新增下列變數：
table 0-row-3 1-row-3 2-row-3 變數名稱 說明 必要 EDGE_OPTIMIZE_API_KEYAdobe 提供的 Edge Optimize API 金鑰。 是 EDGE_OPTIMIZE_TARGET_HOSTEdge Optimize 要求的目標主機 (以 x-forwarded-host標頭傳送) 以及容錯移轉的原始網域。 必須是沒有通訊協定的網域 (例如www.example.com，而非https://www.example.com)。是 -
對於 API 金鑰，按一下「加密」，安全地將其儲存。
-
按一下「儲存並部署」。
將路由新增至您的網域 add-a-route-to-your-domain
如果您使用手動設定，請手動將Worker連結至您的網域。 此步驟會針對您的流量啟動背景工作。
- 前往 Worker 的「設定」>「觸發程序」。
- 在「路由」之下，按一下「新增路由」。
- 輸入您的網域模式 (例如
www.example.com/*或example.com/*)。 - 從下拉式清單中選取您的區域。
- 按一下儲存。
或者，您可以在區域層級設定路由：
- 在 Cloudflare 中導覽至您的網域。
- 前往「Worker 路由」。
- 按一下「新增路由」並指定模式和 Worker。
驗證容錯移轉行為
如果 Edge Optimize 無法使用或傳回錯誤，Worker 會自動容錯移轉至您的來源。 容錯移轉回應包含 x-edgeoptimize-fo 標頭：
< HTTP/2 200
< x-edgeoptimize-fo: 1
您可以在 Cloudflare Worker 記錄中監視容錯移轉事件，以便進行疑難排解。
了解 Worker 邏輯
Cloudflare Worker 會實施下列邏輯：
-
使用者代理偵測：檢查傳入要求的使用者代理是否與任何已定義的代理式機器人相符 (不區分大小寫)。
-
路徑目標選擇：根據目標路徑選擇性篩選要求。 預設情況下，會路由所有 HTML 頁面 (以
/、無副檔名或.html結尾的 URL)。 您可以使用TARGETED_PATHS陣列指定特定路徑。 -
迴圈保護：
x-edgeoptimize-request標頭能防止無限迴圈。 當 Edge Optimize 將要求傳回您的來源時，此標頭設為"1"，而 Worker 傳遞要求時不會將其路由回到 Edge Optimize。 -
標頭安全性：在設定 Edge Optimize 標頭之前，Worker 會移除傳入要求中任何現有的
x-edgeoptimize-*標頭，以避免標頭注入攻擊。 -
標頭對應： Worker 會設定 Edge Optimize 的必要標頭：
x-forwarded-host：識別原始網站網域。x-edgeoptimize-url：保留原始要求路徑和查詢字串。x-edgeoptimize-api-key：使用 Edge Optimize 驗證要求。x-edgeoptimize-config：提供快取鍵設定。
-
容錯移轉邏輯：如果 Edge Optimize 傳回任何錯誤狀態代碼 (4XX 用戶端錯誤或 5XX 伺服器錯誤)，或要求因網路錯誤而失敗，Worker 會使用
EDGE_OPTIMIZE_TARGET_HOST自動容錯移轉至您的來源。 容錯移轉回應包含x-edgeoptimize-fo: 1標頭，用於表示已發生容錯移轉。 -
重新導向處理：
redirect: "manual"選項可以確保來自 Edge Optimize 的重新導向回應會傳遞至用戶端，而 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'];
容錯移轉設定
預設情況下，Worker 會在 Edge Optimize 發生任何 4XX 或 5XX 錯誤時進行容錯移轉。 自訂此行為：
// 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 Worker 記錄，以便監視要求及進行疑難排解。 導覽至「Workers」>「您的 Worker」>「記錄」來檢視即時記錄。 Worker 記錄容錯移轉事件以供偵錯使用。
疑難排解
x-edgeoptimize-request-id 標頭AGENTIC_BOTS 陣列中。EDGE_OPTIMIZE_API_KEY 設定正確。 聯絡 Adobe 確認您的 API 金鑰有效。x-edgeoptimize-request 標頭檢查已就緒。TARGETED_PATHS 的設定正確。x-edgeoptimize-fo: 1 標頭FAILOVER_ON_4XX 和 FAILOVER_ON_5XX 是否設定為 true。 檢查 Worker 記錄中的錯誤訊息。TARGETED_PATHS (若已指定) 中，並且符合 HTML 頁面規則運算式模式。EDGE_OPTIMIZE_TARGET_HOST 包含通訊協定 (例如 https://)。example.com，而非 https://example.com)。透過防火牆規則允許邊緣最佳化 (選用)
如果您的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 標頭。 頁面內容和回應時間應與啟用邊緣最佳化之前維持相同。
3. 如何區分這兩種情境
x-edgeoptimize-request-idx-edgeoptimize-fo1)流量路由的狀態也可以在Adobe Brand Visibility UI中檢視。 瀏覽至 客戶組態 並選取 CDN組態 標籤。
若要進一步瞭解Edge最佳化，包括可用的機會、自動最佳化工作流程和常見問答，請返回Edge最佳化概覽。