CF _headers & _redirects
Cloudflare Pages & Edge-Netzwerk

Cloudflare Pages & Workers _headers & _redirects Generator

Entwickler-Referenz und Syntax-Spickzettel für Cloudflare Pages _headers und _redirects, Sicherheitsrichtlinien und Edge-Rewrites.

100% clientseitige Privatsphäre
Null Serverübertragung
Voreinstellungen:

Header Pfadbereiche

3 Bereiche
Pfadmuster:
Schnelleinfügung:
:
:
:
:
:
:
:

URL-Weiterleitungsregeln

3 Regeln
→
Condition:
→
Condition:
→
Condition:
# Cloudflare Pages _headers configuration
# Generated with ToolsAA (https://toolsaa.com)
# Docs: https://developers.cloudflare.com/pages/configuration/headers/

# Global root security headers
/*
  Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
  X-Frame-Options: DENY
  X-Content-Type-Options: nosniff
  Referrer-Policy: strict-origin-when-cross-origin
  Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=()
  Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline' https://challenges.cloudflare.com; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; connect-src 'self' https:; frame-ancestors 'none'; base-uri 'self'; form-action 'self';
  Cross-Origin-Opener-Policy: same-origin

# Long-term immutable static caching
/assets/*
  Cache-Control: public, max-age=31536000, immutable

# REST API CORS policies
/api/*
  Access-Control-Allow-Origin: *
  Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
  Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With
  Cache-Control: no-store, no-cache, must-revalidate
Pfadbereiche
3 Aktive Pfade

Entspricht Platzhaltermustern über Root- und statische Ordner hinweg.

Konfigurierte Direktiven
12 Header + 3 Weiterleitungen

In flache Edge-Konfigurationsdateien synthetisiert.

Sicherheits-Grad
A+ (100/100)

Bewertet HSTS, CSP, X-Frame-Options und zirkuläre Weiterleitungen.

100% Client-seitig & Datenschutzkonform

Alle Header-Kompilierungen, CSP-Generierungen und Weiterleitungs-Parsings finden isoliert im Browser statt. Keinerlei Server-Übertragung.

Vollständige Cloudflare Edge RFC-Konformität

Strikte Einhaltung der Cloudflare Pages _headers- und _redirects-Spezifikationen, inklusive Splats (:splat) und erzwungenen Weiterleitungen (!).

Multi-Format Cloud Deployment

Sofortiger Export als Pages Flat-Dateien, typsichere Cloudflare Workers Handler oder Next.js Routing-Konfigurationen mit einem Klick.

Technische Referenz & Architektur-Leitfaden

Cloudflare Headers & Redirects Entwickler-Referenz — Referenz-Leitfaden

Entwickler-Referenz und Syntax-Spickzettel für Cloudflare Pages _headers und _redirects, Sicherheitsrichtlinien und Edge-Rewrites.

Wichtige Parameter & Steuerelemente

sourcestring

Eingehendes URL-Routenmuster in _redirects mit Unterstützung für Platzhalter (*), Splats (:splat) und benannte Token (:slug).

Standard: /*
targetstring

Ziel-URL oder wurzelrelativer Pfad für das Rewrite oder den Redirect, der übereinstimmende Splats oder Token übernimmt.

Standard: /:splat
status301 | 302 | 307 | 308 | 200

Vom Cloudflare-Edge ausgegebener HTTP-Statuscode; 200 führt ein internes Rewrite aus, während 301 und 308 permanente Weiterleitungen darstellen.

Standard: 301
forceboolean

Erzwingt die Ausführung der Weiterleitungsregel (Format 200! oder 301!), selbst wenn am Quellpfad eine statische Datei existiert.

Standard: false
pathstring

URL-Pfadpräfix oder Glob-Muster in _headers, das definiert, für welche Anfragen die HTTP-Header-Direktiven gesendet werden.

Standard: /*

Profi-Tipps & Best Practices

Force-Flag für SPA-Routing nutzen

Bei SPA-Fallback-Regeln (/* /index.html 200) sorgt das Anhängen von ! zu 200! dafür, dass das HTML-Rewrite Vorrang vor übereinstimmenden statischen Indexdateien erhält.

Pages-Regellimits strikt beachten

Cloudflare Pages begrenzt _headers auf 100 Regeln und _redirects auf 2.000 Zeilen. Konsolidieren Sie Header unter Pfadmustern wie /assets/*, um stille Kürzungen zu verhindern.

Splat-Token für Pfade einsetzen

Mit /* /archive/:splat 301 übergeben Sie abgeglichene Pfadsegmente nahtlos an das Ziel. Vermeiden Sie komplexe Query-Bedingungen in derselben Zeile für maximale Performance.

Häufige Fallstricke & Fehlerbehebung

Statische Dateien blockieren die Ausführung von 200-Rewrites

Cloudflare Pages liefert vorhandene statische Dateien standardmäßig vor Redirect-Regeln aus. Setzen Sie force: true oder hängen Sie ein Ausrufezeichen an den Statuscode an (z. B. 200!) in _redirects, um statische Dateien zu überschreiben.

Header jenseits des 100-Regel-Limits von Cloudflare werden ignoriert

Cloudflare Pages verwirft Header-Deklarationen, die das Limit von 100 Regeln in _headers überschreiten. Bündeln Sie Sicherheits-Header (HSTS, CSP, X-Frame-Options) unter /* und Asset-Header unter /assets/*.

Häufig gestellte Fragen (FAQ)

Wo müssen die Dateien _headers und _redirects im Projekt-Build abgelegt werden?▼

Beide Dateien müssen direkt im Build-Ausgabeverzeichnis (Publish Directory) liegen, das zu Cloudflare Pages bereitgestellt wird (z. B. dist/, out/ oder build/). Liegen sie nur im Repository-Stammverzeichnis, werden sie nicht im Bereitstellungs-Artefakt erfasst.

Was ist der technische Unterschied zwischen einem 301-Redirect und einem 200-Rewrite?▼

Ein 301-Redirect sendet einen HTTP-Status 301 an den Browser und veranlasst eine neue Anfrage an die Ziel-URL, wodurch sich die Adresszeile ändert. Ein 200-Status führt ein internes Server-Rewrite durch, bei dem Cloudflare den Inhalt der Ziel-URL ausliefert, während die ursprüngliche URL im Browser unverändert bleibt – unerlässlich für SPA-Routing.

Wie behandelt Cloudflare widersprüchliche Header-Regeln für denselben Pfad?▼

Cloudflare Pages verarbeitet _headers von oben nach unten. Mehrere Treffer werden zusammengeführt; wird derselbe Header-Name für übereinstimmende Pfade mehrfach definiert, überschreibt der zuletzt in der Datei definierte Wert alle vorherigen.

Unterstützt Cloudflare Pages reguläre Ausdrücke (Regex) in _redirects?▼

Nein, die Datei _redirects unterstützt keine vollständigen regulären Ausdrücke. Musterabgleiche basieren auf Pfadpräfixen, Platzhaltern (*), Splats (:splat) und benannten Platzhaltern (:id). Für komplexe Regex-Transformationen sollten Cloudflare Workers oder Pages Functions verwendet werden.

Verwandte Werkzeuge & Dienstprogramme

Alle Werkzeuge →