# Den Kapsule CDN-Cache leeren

Source: https://support.kapsulehost.com/de-de/cdn-cache-purge

Beim Leeren wird die am Edge gespeicherte Kopie Ihrer Inhalte entfernt, sodass der nächste Besucher eine frisch von Ihrem Origin geholte Version erhält. Das tun Sie, wenn Sie eine Änderung veröffentlicht haben und noch die alte Version angezeigt wird.

Caching macht das CDN schnell, und es ist auch der Grund, warum eine gerade vorgenommene Änderung womöglich nicht sofort erscheint. Statt Ihre Cache-Lebensdauern auf null zu setzen, lassen Sie sie lang und leeren den Cache bei Bedarf. Diese Anleitung behandelt beides und zeigt außerdem, wie Sie einen Edge-Cache von einem Browser-Cache unterscheiden, bevor Sie an der falschen Stelle suchen.

## Wann Sie den Cache leeren müssen

Leeren Sie den Cache, nachdem Sie etwas geändert haben, das Besucher über eine URL abrufen:

- Sie haben eine CSS- oder JavaScript-Datei ersetzt, und die alte wird noch ausgeliefert.
- Sie haben eine neue Version eines Bildes unter einem bereits vorhandenen Dateinamen hochgeladen.
- Sie haben einen Fehler auf einer Seite behoben und möchten, dass die fehlerhafte Version weltweit sofort verschwindet.
- Sie haben den Inhalt einer Seite geändert und können nicht warten, bis die Edge-TTL abläuft.

Sie müssen den Cache nicht leeren, wenn Sie eine ganz neue Seite oder einen neuen Dateinamen hinzugefügt haben. Für eine URL, die noch nie angefragt wurde, ist nichts zwischengespeichert.

> **Tip:** Wenn Sie Ihre Asset-Dateinamen versionieren (`style.a1b2c3.css` statt `style.css`), müssen Sie den Cache kaum je leeren. Ein neuer Dateiname ist eine neue URL, also wird er frisch von Ihrem Origin geholt und unter einem eigenen Schlüssel zwischengespeichert.

## Wo Sie das Leeren des Caches finden

1. Melden Sie sich bei [KPanel](https://kpanel.kapsulehost.com) an.
2. Klicken Sie in der linken Seitenleiste auf **Websites** und dann auf Ihre Site.
3. Öffnen Sie im Menü der Site **Leistung** und dann **Kapsule CDN**.
4. Scrollen Sie zur Karte **Cache leeren**.

Die direkte Adresse ist `/websites/<site-id>/cdn`.

![Die Karte Cache leeren auf der Kapsule CDN-Seite](https://support.kapsulehost.com/help/screenshots/cdn-cache-purge.881b7fa3.webp)

> **Note:** Die Funktion zum Leeren erscheint erst, wenn das CDN für die Site eingeschaltet ist. Zeigt die Seite das Banner **CDN ist für diese Website aus** oder fordert sie Sie auf, eine eigene Domain zu verbinden, gibt es am Edge noch nichts zu leeren. [Kapsule CDN auf Ihrer Website aktivieren](https://support.kapsulehost.com/de-de/cdn-enabling) listet genau auf, welche Pläne es enthalten.

## Eine einzelne URL leeren

1. Geben Sie in der Karte **Cache leeren** die vollständige öffentliche URL in das Feld **Zu löschende URL (leer lassen für gesamte Website)** ein. Der Platzhalter des Feldes zeigt die erwartete Form: `https://your-domain.tld/path`.
2. Klicken Sie auf **Leeren**.
3. Es erscheint eine Bestätigung, die die eingegebene URL als geleert meldet.

Verwenden Sie genau die URL, die ein Besucher anfragen würde, einschließlich Schema (`https://`), Host und Pfad. Das Leeren wird anhand der URL abgeglichen, daher sind `https://example.com/about` und `https://example.com/about/` zwei verschiedene Cache-Einträge, und dasselbe gilt für dieselbe Seite mit angehängtem Query-String.

Eine einzelne URL zu leeren ist der richtige erste Schritt, wenn Sie genau wissen, was sich geändert hat. Es wirkt sofort und lässt den Rest Ihres Caches unberührt, sodass der Rest der Site schnell bleibt.

## Die ganze Site leeren

1. Lassen Sie das Feld **Zu löschende URL** vollständig leer.
2. Klicken Sie auf **Leeren**.
3. Die Bestätigung lautet „Cache vollständig geleert.“

> **Warning:** Beim vollständigen Leeren werden alle zwischengespeicherten Objekte der Site an jedem Edge-Standort entfernt. Bis jede URL erneut angefragt wird, wird jeder Besucher von Ihrem Origin bedient. Der Origin bekommt also eine Lastspitze ab, und der erste Besucher jeder Seite wartet auf einen vollständigen Roundtrip. Leeren Sie bei einer stark besuchten Site lieber gezielt die URLs, die Sie geändert haben.

Jedes Leeren wird im Aktivitätsprotokoll des Kontos mit der URL oder einer Markierung für die gesamte Zone festgehalten, sodass Sie sehen, wer was wann geleert hat.

## Cache-Lebensdauern und ihr Zusammenspiel

Die Karte **Cache-TTLs** auf derselben Seite legt fest, wie lange Inhalte ohne Leeren bestehen bleiben:

| Einstellung | Was sie steuert | Standard |
|---|---|---|
| **Edge-TTL (Sekunden)** | Wie lange der Edge eine Kopie hält, bevor er sie neu von Ihrem Origin holt | 3600 (1 Stunde) |
| **Browser-TTL (Sekunden)** | Wie lange der Browser eines Besuchers seine eigene lokale Kopie behält | 3600 (1 Stunde) |

Die beiden sind unabhängig voneinander, und genau das ist die häufigste Ursache für Verwirrung. Das Leeren betrifft den **Edge**. Es reicht nicht in den Browser eines Besuchers hinein. Wenn Sie den Cache leeren und selbst noch die alte Version sehen, schauen Sie mit ziemlicher Sicherheit auf Ihren eigenen Browser-Cache.

Um das auszuschließen, laden Sie die Seite in einem privaten Fenster oder Inkognito-Fenster, oder führen Sie ein erzwungenes Neuladen durch. Zeigt das private Fenster die neue Version, hat das Leeren funktioniert, und Sie warten nur noch auf Ihren eigenen Browser und die Browser anderer Besucher, die sich aktualisieren, sobald ihre Browser-TTL abläuft.

> **Tip:** Wenn Sie häufig veröffentlichen und Dateinamen nicht versionieren können, setzen Sie die **Browser-TTL** auf einen kurzen Wert (einige Minuten) und lassen Sie die **Edge-TTL** lang. So behalten Sie den Großteil des Edge-Vorteils und verkürzen zugleich deutlich das Zeitfenster, in dem Besucher an einer alten Kopie hängen bleiben können.

## Bildoptimierung und Leeren

Wenn **Bildoptimierung in Echtzeit** eingeschaltet ist (eine Funktion von Kapsule CDN+), speichert der Edge neben dem Original auch die optimierte Ableitung jedes Bildes. Das Leeren der Bild-URL entfernt auch die Ableitung, sodass ein ersetztes Bild bei der nächsten Anfrage neu optimiert wird. Ein separates Leeren für optimierte Bilder gibt es nicht.

Dasselbe gilt für **WebP für unterstützte Browser bereitstellen**: Die WebP-Variante liegt unter derselben URL und wird durch dasselbe Leeren entfernt.

## Fehlerbehebung

**„CDN für diese Website nicht bereitgestellt.“** Die Site hat noch keine Edge-Zone. Aktivieren Sie zuerst das CDN und warten Sie, bis das Zertifikat vollständig bereitgestellt ist.

**„Leeren fehlgeschlagen.“** Die Anfrage zum Leeren hat den Edge nicht erreicht. Warten Sie einen Moment und versuchen Sie es erneut. Schlägt es weiterhin fehl, wird die Edge-Zone möglicherweise gerade bereitgestellt. Prüfen Sie, ob die Seite das Banner **CDN ist an** zeigt.

**Ich habe den Cache geleert, und die Seite ist immer noch alt.** Prüfen Sie zuerst in einem privaten Fenster. Zeigt auch ein privates Fenster die alte Version, vergewissern Sie sich, dass Sie genau die richtige URL geleert haben, einschließlich eines abschließenden Schrägstrichs und Query-Strings, und leeren Sie dann die ganze Site.

**Nur manche Besucher sehen die Aktualisierung.** Deren Browser befinden sich noch innerhalb der Browser-TTL. Es ist nichts falsch: Sie erhalten die neue Version, sobald diese abläuft, oder sofort bei einem erzwungenen Neuladen.

**Der Origin ist nach dem vollständigen Leeren zusammengebrochen.** Das ist die oben beschriebene Spitze an nicht zwischengespeichertem Traffic. Erhöhen Sie die Edge-TTL und leeren Sie beim nächsten Mal nur die URLs, die sich geändert haben. [Website-Geschwindigkeit verbessern](https://support.kapsulehost.com/de-de/website-speed) beschreibt, wie Sie den Origin selbst widerstandsfähiger machen.

Wenn das Leeren gelingt, der Edge aber länger als einige Minuten weiter alte Inhalte ausliefert, schreiben Sie an [support@kapsulehost.com](mailto:support@kapsulehost.com) und nennen Sie die genaue URL und den Zeitpunkt des Leerens.