Akamai (BYOCDN)

此設定會將代理式流量 (來自 AI 機器人和 LLM 使用者代理的要求) 路由至 Edge Optimize 後端服務 (live.edgeoptimize.net)。 真人訪客和 SEO 機器人仍照常由您的來源伺服器提供服務。 若要測試設定,在完成設定之後,請於回應中尋找 x-edgeoptimize-request-id 標頭。

先決條件

設定Akamai屬性管理員規則之前,請確定您具備:

  • 您網域的 Akamai Property Manager 存取權。
  • 從 LLM Optimizer 使用者介面擷取的 Edge Optimize API 金鑰。 相關步驟請參閱檢索 API 金鑰
  • (選用) 若要測試中繼路由,請參閱中繼 API 金鑰

設定

下列 Akamai Property Manager 規則將代理式 HTML 頁面流量路由至 Edge Optimize。 設定包含以下步驟:

​1. 設定路由條件(使用者代理和HTML流量比對)

設定下列使用者 AI 代理的路由:

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
僅對代理式 HTML 頁面流量套用邊緣架構最佳化路由規則。 常見的設定是使用​ 副檔名 ​等要求端準則來比對 html,以及針對無副檔名頁面 URL 比對 EMPTY_STRING。 如果您的網站透過其他 URL 模式提供 HTML,或包含如 API 端點等無副檔名的非頁面路由,請使用其他路徑準則來精確調整此規則。

設定路由準則

​2. 設定來源和SSL行為

將來源設為 live.edgeoptimize.net,而「對照 SAN 至」設為 *.edgeoptimize.net

NOTE
如果新增邊緣最佳化規則後屬性啟用失敗,請檢查該規則是否使用與預設規則不同的原始伺服器 SSL 驗證模式。 若確實不同,請更新邊緣最佳化規則使其符合預設規則。 例如,若預設規則使用​平台設定,此處也應使用​平台設定。 如果您無法使用必要的設定,請聯絡 Akamai 支援。

Set 來源和 SSL 行為

​3. 設定快取金鑰變數

將快取鍵變數 PMUSER_EDGE_OPTIMIZE_CACHE_KEY 設為 LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}

設定快取金鑰變數

​4. 快取規則

快取規則

​5. 修改傳入的請求標題

設定以下傳入要求標頭:
x-edgeoptimize-api-key 設定為從 LLMO 擷取的 API 金鑰
x-edgeoptimize-config 設定為 LLMCLIENT=TRUE;
x-edgeoptimize-url 設定為 {{builtin.AK_URL}}

修改傳入要求標頭

允許透過防火牆規則在Edge最佳化(選用)

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

  • 允許列出WAF或機器人管理員中的*AdobeEdgeOptimize/1.0*使用者代理程式,讓Edge最佳化服務可以擷取您的來源內容。

  • 如果您的防火牆需要使用者代理程式以外的其他驗證,請產生密碼(例如,openssl rand -hex 32)並:

    • 將帶有密碼的x-edgeoptimize-fetcher-key新增到路由規則中與其他x-edgeoptimize-*標頭一起。
    • 新增WAF或機器人管理員規則以允許x-edgeoptimize-fetcher-key符合相同密碼的請求。
  • 在Edge最佳化會依原樣轉送此標題 — 您擁有完整的金鑰生命週期。

在 Property Manager 中設定 x-edgeoptimize-fetcher-key 標頭

NOTE
同時將 Akamai Bot Manager 中的 *AdobeEdgeOptimize/1.0* 使用者代理和 x-edgeoptimize-fetcher-key 標頭加入允許清單。

​6. 修改傳入的回應標題

修改傳入回應標頭

​7. 快取ID修改

快取 ID 修改

​8. 修改傳出請求標頭

x-forwarded-host 標頭設為 {{builtin.AK_HOST}}

修改傳出要求標頭

​9. 站台容錯移轉

「站台容錯移轉」設定包含兩個部分:主要「在Edge最佳化」路由規則內的容錯移轉行為,以及在發生遞補時新增回應標題的同層級規則。

9a。 設定站台容錯移轉行為

在主要的「在Edge最佳化」路由規則內,建立名為​ 站台容錯移轉行為 ​的子規則。 將其設為​ 符合任何 ​並新增這些條件:

  • 回應狀態碼​在400599的範圍內。
  • 來源逾時​為Yes

網站容錯移轉

設定站台容錯移轉行為

9b. 設定容錯移轉回應標頭規則

IMPORTANT
建立 EdgeOptimize 容錯移轉,測試標頭​規則作為路由規則的​同級 (位於相同層級) 規則,而​ 不是 ​以巢狀方式置於路由規則內。 在 Akamai Property Manager 規則樹狀結構中,階層應該如下所示:
code language-none
▼ Optimize at Edge                         ← parent rule group
      ▼ Optimize at Edge Routing               ← routing child
          Site Failover Behavior                 ← nested child
      EdgeOptimize Failover - Test Header      ← sibling of routing child
當Akamai為原始主機名稱重新建立失敗的請求時,會評估同層級規則。 路由規則的API金鑰條件可防止將該請求再次傳送至Edge Optimize。
同時請確保​ 邊緣最佳化路由 ​規則不會被任何後續的相符規則覆寫,以免後續規則變更相同請求的來源、快取行為或快取 ID。 如果另一個相符的規則重設這些行為,邊緣最佳化路由或快取可能無法如預期運作。

設定容錯移轉回應標頭規則

網站容錯移轉可確保Edge Optimize傳回錯誤或逾時,Akamai會針對原始主機名稱重新建立請求,以便訪客仍可收到網站的正常回應。

情境
行為
Edge Optimize 傳回 2XX3XX
提供最佳化的回應。 x-edgeoptimize-request-id已存在。
Edge最佳化傳回4XX-5XX,或來源逾時
系統會為原始主機名稱重新建立請求。 回應包含x-edgeoptimize-fo: true

驗證設定

完成設定後,請確認機器人流量會路由至 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-id
存在:包含唯一的要求 ID
不存在
x-edgeoptimize-fo
唯有發生容錯移轉時存在 (值:true)
不存在

您也可以在 LLM Optimizer 使用者介面中確認流量路由的狀態。 瀏覽至​ 客戶組態 ​並選取​ CDN組態 ​標籤。

將最佳化部署到 AI 代理:已完成

若要進一步瞭解Edge最佳化,包括可用的機會、自動最佳化工作流程和常見問答,請返回Edge最佳化概覽

recommendation-more-help
llm-optimizer-help-main-toc