search

Cloudflare Setup

Wenn du Cloudflare vor smoxy verwendest, musst du zwei Dinge konfigurieren, um Konflikte zu vermeiden: Bild-Caching und Cache-Invalidierung.

hashtag
Bildoptimierung

Wenn smoxy Bilder nach WebP oder AVIF konvertiert, ändert es den Content-Type-Header, behält aber die ursprüngliche Dateiendung bei. Cloudflare cached basierend auf der Dateiendung, nicht dem Content-Type — ein AVIF-Bild kann also unter einer .jpg-Endung gecacht werden, wodurch Browser das falsche Format erhalten.

Lösung: Erstelle eine Cloudflare Cache Rule, die den Cache für Bilddateien umgeht.

Cache Rule Expression:

(ends_with(http.request.uri.path, ".png")) or
(ends_with(http.request.uri.path, ".jpeg")) or
(ends_with(http.request.uri.path, ".jpg")) or
(ends_with(http.request.uri.path, ".gif")) or
(ends_with(http.request.uri.path, ".webp")) or
(ends_with(http.request.uri.path, ".avif"))

Setze die Aktion auf Bypass Cache für passende Anfragen.

Wenn du einen Cloudflare Pro- oder Business-Plan hast, deaktiviere zusätzlich Cloudflare Polish (Bildoptimierung), um doppelte Optimierung zu vermeiden.

hashtag
Cache-Invalidierung

smoxy verwendet die HTTP-Methoden BAN und PURGE zur Invalidierung gecachter Inhalte. Cloudflare kann diese Requests auf zwei Arten stören:

  • BAN-Requests — Cloudflares DDoS-Schutz kann sie blockieren, wenn viele in kurzer Zeit gesendet werden

  • PURGE-Requests — Cloudflare blockiert diese vollständig, und keine WAF-Regel kann das überschreiben

Lösung: Erstelle eine Subdomain mit deaktiviertem Cloudflare-Proxy (DNS-only-Modus) und sende deine Invalidierungsanfragen darüber.

hashtag
Einrichtung

  1. Füge in Cloudflare DNS einen neuen Eintrag für eine Subdomain hinzu (z. B. smoxy.example.com)

  2. Setze den Proxy-Toggle auf DNS only (graues Wolken-Symbol) — das bedeutet, Cloudflare proxied keine Anfragen an diese Subdomain

  3. Richte den Eintrag auf smoxy

hashtag
Muss die Subdomain in smoxy konfiguriert werden?

Nein. Wenn deine Hauptdomain (z. B. example.com) bereits in smoxy eingerichtet und einer Site zugewiesen ist, werden alle Subdomains automatisch über dieselbe Site geroutet. Die Invalidierungs-Subdomain nutzt deine bestehende Site-Konfiguration.

hashtag
Verwendung

Sende deine Invalidierungsanfragen an die Subdomain statt an die Hauptdomain:

Das umgeht Cloudflare vollständig, sodass BAN- und PURGE-Requests smoxy erreichen, ohne blockiert zu werden.

Last updated

Was this helpful?