Cloudflare (BYOCDN)

Diese Konfiguration leitet den Agent-basierten Traffic (Anfragen von KI-Bots und LLM-Benutzer-Agents) an den Backend-Service von Edge Optimize (live.edgeoptimize.net) weiter. Menschliche Besuchende und SEO-Bots werden weiterhin wie gewohnt von Ihrem Ursprung aus unterstützt. Um die Konfiguration zu testen, suchen Sie nach Abschluss der Einrichtung in der Antwort nach dem x-edgeoptimize-request-id-Header.

Voraussetzungen

Bevor Sie die Routing-Regeln für Cloudflare-Worker einrichten, stellen Sie sicher, dass Sie über Folgendes verfügen:

Funktionsweise des Routings

Bei korrekter Konfiguration wird eine Anfrage an Ihre Domain (z. B. www.example.com/page.html) von einem Agent-basierten Benutzer-Agent durch den Cloudflare Worker abgefangen und an das Edge Optimize-Backend weitergeleitet. Die Backend-Anfrage enthält die erforderlichen Header.

Testen der Backend-Anfrage

Sie können das Routing überprüfen, indem Sie eine direkte Anfrage an das Backend von Edge Optimize stellen.

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

Erforderliche Header

Bei Anfragen an das Backend von Edge Optimize müssen die folgenden Header festgelegt werden:

Einrichtungsoptionen

Es gibt zwei Möglichkeiten, Cloudflare Worker für Edge Optimize einzurichten:

Unabhängig davon, welche Option Sie auswählen, müssen Sie den Worker manuell mit Ihrer Domain verknüpfen. Weitere Informationen dazu finden Sie unter Schritt: Hinzufügen einer Route zu Ihrer Domain.

Option 1: Bereitstellen in Cloudflare

Bei dieser Option wird die Schaltfläche In Cloudflare bereitstellen verwendet, um den Worker automatisch zu erstellen und die erforderlichen Umgebungsvariablen und Geheimnisse in Ihrem Cloudflare-Konto zu konfigurieren. Dies ist der schnellste Methode zum Einrichten eines neuen Workers.

Schritt 1: Bereitstellen des Workers

Klicken Sie auf die Schaltfläche unten, um den Edge Optimize-Worker in Ihrem Cloudflare-Konto bereitzustellen:

Schritt 2: Ausfüllen des Bereitstellungsformulars

Durch Klicken auf die Schaltfläche wird die Seite zur Einrichtung des Workers geöffnet. Füllen Sie das Formular wie folgt aus:

Nachdem der Worker bereitgestellt wurde, fahren Sie mit Hinzufügen einer Route zu Ihrer Domain fort, um den Worker mit Ihrer Domain zu verknüpfen. Das Routing wird nicht automatisch konfiguriert und muss manuell abgeschlossen werden.

Option 2: Manuelle Einrichtung

Führen Sie diese Schritte aus, um den Worker manuell zu erstellen und zu konfigurieren.

Schritt 1: Cloudflare Worker erstellen

Schritt 2: Worker-Code hinzufügen

Klicken Sie nach dem Erstellen des Sekundärs auf Code bearbeiten und ersetzen Sie den Standardcode durch den Code aus worker.js. Wenn Sie bereits über einen Cloudflare-Worker verfügen, führen Sie den Code mit Ihrem vorhandenen Worker-Code zusammen, anstatt ihn vollständig zu ersetzen.

Klicken Sie auf Save and deploy (Speichern und bereitstellen), um den Worker zu veröffentlichen.

Schritt 3: Konfigurieren von Umgebungsvariablen

Umgebungsvariablen speichern vertrauliche Konfigurationen wie Ihren API-Schlüssel auf sichere Weise.

Hinzufügen einer Route zu Ihrer Domain add-a-route-to-your-domain

Unabhängig davon, welche Einrichtungsoption Sie verwendet haben, müssen Sie den Worker manuell mit Ihrer Domain verknüpfen. Dieser Schritt aktiviert den Worker in Ihrem Traffic.

Alternativ können Sie Routen auf Zonenebene konfigurieren:

Überprüfen des Failover-Verhaltens

Wenn Edge Optimize nicht verfügbar ist oder einen Fehler zurückgibt, führt der Worker automatisch ein Failover zu Ihrem Ursprung durch. Die Failover-Antworten enthalten den x-edgeoptimize-fo-Header:

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

Sie können Failover-Ereignisse in den Cloudflare Workers-Protokollen überwachen, um Probleme zu beheben.

Grundlegendes zur Worker-Logik

Der Cloudflare Worker implementiert die folgende Logik:

Anpassen der Konfiguration

Sie können das Worker-Verhalten anpassen, indem Sie die Konfigurationskonstanten oben im Code ändern:

Liste Agent-basierter Bots

Ändern Sie das Array AGENTIC_BOTS, um Benutzer-Agents hinzuzufügen oder zu entfernen:

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

Zielpfade

Standardmäßig werden alle HTML-Seiten an Edge Optimize weitergeleitet. Um das Routing auf bestimmte Pfade zu beschränken, ändern Sie das Array 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'];

Failover-Konfiguration

Standardmäßig erfolgt ein Failover des Workers bei einem 4XX- oder 5XX-Fehler von Edge Optimize. Passen Sie dieses Verhalten an:

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

Wichtige Aspekte

Fehlerbehebung

Zulassen von „Optimize at Edge“ durch Firewall-Regeln (optional)

Wenn Ihr CDN einen WAF oder Bot Manager verwendet:

Überprüfen des Setups

Stellen Sie nach Abschluss des Setups sicher, dass Bot-Traffic an Edge Optimize weitergeleitet wird und dass der menschliche Traffic nicht betroffen ist.

1. Testen des Bot-Traffics (sollte optimiert werden)

Simulieren Sie eine KI-Bot-Anfrage mithilfe eines Agent-basierten Benutzer-Agents:

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

Eine erfolgreiche Antwort enthält den x-edgeoptimize-request-id-Header, der bestätigt, dass die Anfrage über Edge Optimize weitergeleitet wurde:

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

2. Testen des menschlichen Traffics (sollte NICHT betroffen sein)

Simulieren Sie eine normale menschliche Browser-Anfrage:

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"

Die Antwort sollte nicht den x-edgeoptimize-request-id-Header enthalten. Der Seiteninhalt und die Antwortzeit sollten nach der Aktivierung von „Optimize at Edge“ unverändert bleiben.

3. So lassen sich die beiden Szenarien voneinander unterscheiden

Der Status des Traffic-Routings kann auch in der LLM Optimizer-Benutzeroberfläche überprüft werden. Navigieren Sie zu Kundenkonfiguration und wählen Sie die Registerkarte CDN-Konfiguration aus.

Weitere Informationen zu „Optimieren bei Edge", einschließlich verfügbarer Opportunitys, Workflows für die automatische Optimierung und häufig gestellte Fragen, finden Sie unter "​ bei Edge - Überblick.