Cloudflare (BYOCDN)

Deze configuratie leidt verwerpelijk verkeer (verzoeken van AI bots en gebruikersagenten LLM) aan de Edge Optimize backend dienst (live.edgeoptimize.net). Menselijke bezoekers en SEO-bots worden nog steeds van je herkomst bediend zoals gewoonlijk. Als u de configuratie wilt testen nadat de installatie is voltooid, zoekt u naar de koptekst x-edgeoptimize-request-id in de reactie.

Eerste vereisten

Voordat u de Cloudflare Worker instelt die regels routeert, moet u ervoor zorgen dat:

hoe het verpletteren van werken

Wanneer correct gevormd, wordt een verzoek aan uw domein (bijvoorbeeld, www.example.com/page.html) van een agentische gebruikersagent onderschept door de Arbeider van de Vormgeving van de Wolk en verpletterd aan het Edge Optimize achtereind. Het achterste verzoek omvat de vereiste kopballen.

het Testen van het achterste eindverzoek

U kunt het verpletteren verifiëren door een direct verzoek aan Edge te richten optimaliseert achtereind.

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

Vereiste Kopballen

Bij aanvragen naar de Edge Optimize-backend moeten de volgende headers worden ingesteld:

Opties instellen

Er zijn twee manieren om de Cloudflare Worker voor Edge Optimize in te stellen:

Ongeacht welke optie u kiest, moet u de worker aan uw domein manueel verbinden — zie ​ Stap: Voeg een route aan uw domein ​ toe.

Optie 1: Distribueren naar Cloudflare

Deze optie gebruikt stelt aan Cloudflare knoop op om de worker automatisch tot stand te brengen en de vereiste milieuvariabelen en geheimen in uw rekening van de Vast te vormen. Dit is de snelste manier om aan de slag te gaan als u een nieuwe worker instelt.

Stap 1: De worker implementeren

Klik op de onderstaande knop om de Edge Optimize-worker te implementeren in uw Cloudflare-account:

​

Stap 2: Het implementatieformulier invullen

Als u op de knop klikt, wordt de instellingspagina van de workers geopend. Vul het formulier als volgt in:

Nadat de worker wordt opgesteld, ga aan ​ te werk voeg een route aan uw domein ​ toe om de worker met uw domein te verbinden. Het verpletteren wordt niet automatisch gevormd en moet manueel worden voltooid.

Optie 2: Handmatige installatie

Voer de volgende stappen uit om de worker handmatig te maken en te configureren.

Stap 1: De cloud Worker maken

Stap 2: De code van de Worker toevoegen

Na het creëren van de arbeider, geeft de klik code uit en vervangt de standaardcode met de code van ​ worker.js ​. Als u al een bestaande Cloudflakkering hebt, voegt u de code samen met de bestaande arbeiderscode in plaats van deze volledig te vervangen.

Klik sparen en stel op om de worker te publiceren.

Stap 3: Omgevingsvariabelen en geheimen configureren

Omgevingsvariabelen slaan gevoelige configuratie als de API-sleutel veilig op.

Voeg een route aan uw domein toe add-a-route-to-your-domain

Ongeacht de instellingsoptie die u hebt gebruikt, moet u de worker handmatig koppelen aan uw domein. Deze stap activeert de arbeider op uw verkeer.

Alternatief, kunt u routes op het streekniveau vormen:

het verifiëren van failovergedrag

Als Edge Optimize niet beschikbaar is of een fout retourneert, mislukt de worker automatisch naar de oorsprong. Voorbeelden van failover-reacties zijn de header x-edgeoptimize-fo :

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

U kunt de gebeurtenissen van failover in de logboeken van de Werknemers van de Wolk controleren om kwesties problemen op te lossen.

Begrijpend de logica van de Arbeider

De Cloudflare Worker implementeert de volgende logica:

het Aanpassen van de configuratie

U kunt het arbeidersgedrag aanpassen door de configuratieconstanten bij de bovenkant van de code te wijzigen:

Agentic bot list

Wijzig de array AGENTIC_BOTS om gebruikersagents toe te voegen of te verwijderen:

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

gerichte wegen

Standaard worden alle HTML-pagina’s gerouteerd naar Edge Optimize. Als u het routeren wilt beperken tot specifieke paden, wijzigt u de 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'];

configuratie Failover

Standaard mislukt de worker op een 4XX- of 5XX-fout in Edge Optimize. Pas dit gedrag aan:

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

Belangrijke overwegingen

Problemen oplossen

staat Optimize bij Edge door (facultatieve) firewallregels toe

Als uw CDN een WAF- of botbeheer gebruikt:

verifieer de opstelling

Na de voltooiing van de opstelling, verifieer dat beide verkeer aan Edge Optimize wordt verpletterd en dat het menselijke verkeer onaangetast blijft.

1. Het verkeer van de Bot van de test (zou moeten worden geoptimaliseerd)

Simuleer een AI bot request using an agentic user-agent:

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

Een succesvol antwoord bevat de header x-edgeoptimize-request-id , waarmee wordt bevestigd dat het verzoek is gerouteerd via Edge Optimize:

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

2. Het menselijke verkeer van de test (zou NIET moeten worden beïnvloed)

Simuleer een regelmatig verzoek van een menselijke browser:

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"

De reactie zou ​​niet x-edgeoptimize-request-id kopbal moeten bevatten. De pagina-inhoud en de reactietijd moeten gelijk blijven aan voordat u Optimaliseren in Edge inschakelt.

3. Hoe te tussen de twee scenario’s te onderscheiden

De status van het verkeer dat verplettert kan ook in LLM Optimizer UI worden gecontroleerd. Navigeer aan configuratie van de Klant en selecteer de CDN configuratie tabel.

Meer leren over Optimaliseren bij Edge, met inbegrip van beschikbare kansen, auto-optimaliseringswerkschema’s, en FAQs, terugkeer aan ​ optimaliseren bij het overzicht van Edge ​.