Cloudflare-Cache-Lösch-Tutorial: Ein umfassender Leitfaden für Web- und DevOps-Administratoren

Wie wirkt sich das Löschen des Cloudflare-Caches auf die Bereitstellung und Fehlerbehebung aus?

Das Leeren des Cloudflare-Caches ist ein wichtiger Schritt im Release- und Fehlerbehebungszyklus von Websites und Anwendungen. Dieser praxisorientierte Leitfaden von Experten behandelt Bereinigungsmethoden, Sicherheitstipps, Befehlszeilenbefehle, Automatisierung in CI/CD-Pipelines sowie Nginx/Apache- und WordPress-Konfigurationen. So können Website-Administratoren, DevOps-Teams, Entwickler, Händler und Gamer Änderungen nach einem Update oder einer Fehlerbehebung schnell und sicher an die Edge-Server (über 85 Standorte weltweit) übertragen.

Warum ist es notwendig, den Cloudflare-Cache zu leeren?

Cache leeren Dies ist notwendig, wenn alte Versionen von Inhalten (wie CSS/JS/Bilder oder im Edge-Cache gespeichertes HTML) zu fehlerhafter Darstellung oder Leistungsproblemen führen.

• Nach dem Aktualisieren von statischen Dateien oder HTML-Inhalten, die im Edge-Cache gespeichert sind.
• Nach der Bereitstellung einer Anwendung oder der Migration muss die neue Version sofort in den Edge-Geräten angezeigt werden.
• Um Anzeigeprobleme oder Fehler im Zusammenhang mit veralteten Inhalten zu beheben.
• In zeitkritischen Szenarien wie dem Handel oder dem Gaming müssen Live-Inhalte sofort aktualisiert werden.

Arten der Cache-Löschung in Cloudflare

1) Alles entsorgen

Alle Caches in einer Zone löschen. Schnell und einfach, aber Teuer Und manchmal erhöht es die Last auf dem Ursprungsserver.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"purge_everything":true}'

2) Bereinigung nach URL (selektive Bereinigung nach URL)

Gezieltes Löschen bestimmter Dateien oder Seiten; die beste Option zum Aktualisieren bestimmter Assets oder Seiten, um die Nebenwirkungen einer vollständigen Löschung zu vermeiden.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"files":["https://example.com/css/app.css","https://example.com/js/app.js"]}'

3) Nach Tag bereinigen – Erweitert

Aufräumen nach Etikett Geeignet zum Ungültigmachen einer Gruppe von Ressourcen, die mit einem Tag gekennzeichnet sind; nützlich in komplexen Anwendungen und Microservices.

Notiz: Diese Funktion kann je nach Tarif oder Enterprise-Konto variieren.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"tags":["product-123","homepage-v2"]}'

4) Entwicklungsmodus und Cache-Umgehung

Der Entwicklermodus im Dashboard deaktiviert das Caching in Edge für 3 Stunden – perfekt für die kurzfristige Entwicklung.

Um API-Routen zu umgehen oder basierend auf Cookies von Seitenregeln Oder Arbeiter Verwenden.

Abrufen der Zonen-ID und Erstellen eines API-Tokens mit minimalem Zugriff

Sie können die API verwenden, um die Zonen-ID zu erhalten; im Antwortfeld Ausweis Es ist dasselbe wie die Zonen-ID.

curl -X GET "https://api.cloudflare.com/client/v4/zones?name=example.com" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json"

Um ein API-Token zu erstellen, gehen Sie zu folgendem Pfad Cloudflare → Mein Profil → API-Tokens → Token erstellen Erteilen Sie nur die notwendigen Berechtigungen. Zone → Cache leeren Für bestimmte Zonen ist es ausreichend. Token auf eine bestimmte Zone beschränken und ein Ablaufdatum festlegen Erhöht die Sicherheit erheblich.

Überprüfen des Cache-Status einer Antwort (cf-cache-status)

Zum Debuggen aus dem Header cf-cache-status Verwenden Sie die typischen Werte, die wie folgt lauten: SCHLAG, VERMISSEN, ABGELAUFEN, DYNAMISCH, BYPASS, REVALIDIERT.

curl -I -s -D - https://example.com | grep -i cf-cache-status

Serverkonfigurationstipps und Header (Nginx/Apache)

Für statische Dateien (komprimiert und unveränderlich)

Die Verwendung von Langzeit-Cache-Control zusammen mit Fingerprinting (Hash des Dateinamens) ist der beste Ansatz, um die Notwendigkeit einer vollständigen Löschung von Assets zu reduzieren.

location ~* \.(js|css|jpg|jpeg|png|svg|woff2?)$ {
    expires 30d;
    add_header Cache-Control "public, max-age=2592000, s-maxage=2592000, immutable";
}

Diese Einstellung ergänzt die bestehenden Einstellungen. Alles zwischenspeichern / Edge-Cache TTL Cloudflare führt dazu, dass Assets über einen längeren Zeitraum am Netzwerkrand gespeichert werden.

Für HTML-Seiten (aktualisierbar)

location / {
    add_header Cache-Control "no-cache, must-revalidate, max-age=0";
}

In Cloudflare können Sie eine niedrigere Edge Cache TTL festlegen oder Seitenregeln verwenden, um wichtige Seiten besser zu kontrollieren.

Beachten Sie den Origin-Header

Im Cloudflare-Dashboard gibt es im Bereich „Caching“ eine Option, mit der Sie festlegen können, ob Cloudflare die Ursprungsheader berücksichtigt oder eigene Einstellungen verwendet. Es wird empfohlen, diese Option zu aktivieren, um mehr Kontrolle zu haben. Ursprungs-Cache-Steuerung Verwenden.

Integration mit WordPress und Plugins

Das offizielle Cloudflare-Plugin für WordPress ermöglicht die automatische Löschung nach der Veröffentlichung oder Aktualisierung.

• Cache-Plugins wie WP Rocket oder W3 Total Cache bieten lokale Bereinigungsoptionen; nutzen Sie die Bereinigung gleichzeitig mit Cloudflare, um auch den Edge-Server zu aktualisieren.
• Bei kritischen Websites (z. B. Trading-VPS oder Gaming-Websites) sollten die TTL-Einstellungen verkürzt und die selektive Datenbereinigung aktiviert werden, um Latenz und Stabilität zu gewährleisten.

Automatisierte Cache-Bereinigung in CI/CD

Fügen Sie einen einfachen Schritt hinzu, um generierte URLs nach der automatisierten Bereitstellung (GitHub Actions / GitLab CI / Jenkins) zu löschen. Verwenden Sie unbedingt ein Geheimnisverwaltungssystem zum Speichern von Tokens.

- name: Purge Cloudflare cache
  run: |
    curl -X POST "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/purge_cache" \
    -H "Authorization: Bearer ${{ secrets.CF_API_TOKEN }}" \
    -H "Content-Type: application/json" \
    --data "{\"files\": [\"https://example.com/path/to/file.js\"]}"

Linux-Skripte für die Stapelbereinigung

Um eine Liste von URLs zu löschen, können Sie eine Datei und jq verwenden. Für eine schnellere Ausführung teilen Sie die Liste in 30 Batches auf und führen diese parallel aus.

cat urls.txt | jq -R -s -c 'split("\n")[:-1]' | \
xargs -I{} curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
 -H "Authorization: Bearer <API_TOKEN>" -H "Content-Type: application/json" \
 --data '{"files":'{}'}'

Sicherheitstipps und Einschränkungen

Mindestberechtigungen Für API-Token: Nur “Cache Purge” und beschränkt auf die notwendigen Zonen; ein Ablaufdatum festlegen.

• Ratenbegrenzungen: Die Purge-API hat Anfragebegrenzungen; vermeiden Sie kontinuierliche Purge Everything und verwenden Sie Batch-Purges bei Bedarf.
• Protokollierung: Jeder Bereinigungsvorgang sollte in den CI- oder Systemprotokollen protokolliert werden, um Ursache und Zeitpunkt zu ermitteln – dies ist für Audits nützlich.

Sonderfälle – Arbeiter, KV und Rendering/GPU

Wenn Sie Cloudflare Workers verwenden, wird der Workers-Cache durch die standardmäßige Zonen-Cache-Bereinigung möglicherweise nicht geleert; verwenden Sie im Workers-Code Cache löschen Und verwenden Sie spezielle Lösungen.

Bei großen Dateien wie Modell- oder Renderdateien empfiehlt sich die langfristige Cache-Steuerung für unveränderliche Dateien und die selektive Bereinigung für Aktualisierungen.

Für sensible Nutzer wie Händler und Gamer ist die Wahl des richtigen Standorts und der richtigen CDN-Konfiguration wichtig, um den Ping zu reduzieren; das Caching sollte intelligent konfiguriert werden, um kritische Inhalte aktuell zu halten.

Bewährte Verfahren und praktische Ratschläge

• Verwenden Sie „Alles säubern“ nur als letzten Ausweg. Verwenden.
• Verwenden Sie „Nach URL oder Tags bereinigen“, um Nebenwirkungen zu minimieren.
• Überschriften Cache-Steuerung Ursprung korrekt einstellen.
• Für statische Inhalte empfiehlt sich die Verwendung eines langlebigen Caches in Kombination mit Fingerprinting, um neue Dateien ohne vollständige Löschung zu veröffentlichen.
• Verwenden Sie Seitenregeln oder Cloudflare Workers für sensible Routen oder APIs, die umgangen werden müssen.
• Automatisierung: Kombinieren Sie die detaillierte Bereinigung (neue Dateien) mit CI nach jedem Deployment.
• Sicherheit: Verwenden Sie eingeschränkte Token und überprüfen Sie die Zugriffsrechte regelmäßig.

Um ein ausgewogenes Verhältnis zwischen Geschwindigkeit und Stabilität zu gewährleisten, erzielt man die besten Ergebnisse mit einer Kombination aus optionalen Ursprungs- und Spülverteilern.

Abschluss

Das Leeren des Cloudflare-Caches mag einfach erscheinen, erfordert aber Kenntnisse über die verschiedenen Löscharten, Header sowie deren Auswirkungen auf Leistung und Sicherheit. Mit der richtigen Konfiguration, einschließlich Origin Cache-Control, Tags und selektiven Löschungen, können Sie die Geschwindigkeit und Stabilität Ihrer Anwendung gewährleisten – insbesondere in Infrastrukturen mit über 85 globalen Standorten und der Nutzung von GPU-Servern, dedizierten VPS oder Anti-DDoS-Diensten.

Wenn Sie mehr über Tarife, Cache-Einstellungen und die Automatisierung nach der Veröffentlichung erfahren möchten, können Sie die entsprechenden Ressourcen und Seiten aufrufen oder sich an das Support-Team wenden.

Häufig gestellte Fragen