Caching & CDN

Browser-Caching mit Cache-Control: Header richtig setzen (nginx und Apache)

Veröffentlicht am 13. Oktober 2026

Cache-Control verständlich erklärt: was max-age, no-cache, no-store und immutable bedeuten und welche Header Sie für HTML, CSS, JS und Bilder setzen sollten.

Browser-Caching ist eine der wirksamsten und zugleich günstigsten Methoden, eine Website schneller zu machen. Hat der Browser eine Datei bereits gespeichert, muss er sie beim nächsten Seitenaufruf nicht erneut herunterladen. Gesteuert wird das über den HTTP-Header Cache-Control. Falsch gesetzt, führt er allerdings dazu, dass Besucher veraltete Inhalte sehen oder dass gar nichts zwischengespeichert wird. Dieser Artikel erklärt die wichtigsten Direktiven und zeigt bewährte Einstellungen für nginx und Apache.

Wie Browser-Caching funktioniert

Wenn ein Browser eine Datei lädt, schickt der Server zusammen mit dem Inhalt Header mit. Darin steht, ob und wie lange die Datei zwischengespeichert werden darf. Solange eine gespeicherte Antwort frisch ist, verwendet der Browser sie ohne Anfrage an den Server. Ist sie veraltet (stale), fragt er nach, ob sich etwas geändert hat. Hat sich nichts geändert, antwortet der Server mit dem kurzen Status 304 Not Modified statt mit der ganzen Datei.

Für diese Nachfrage (Revalidierung) dienen zwei Merkmale:

nginx und Apache setzen beide Header für statische Dateien standardmässig.

Die wichtigsten Direktiven

DirektiveBedeutung
max-age=NDie Antwort ist N Sekunden lang frisch.
s-maxage=NWie max-age, gilt aber nur für geteilte Caches (Proxy, CDN) und hat dort Vorrang.
no-cacheDarf gespeichert werden, muss aber vor jeder Wiederverwendung beim Server geprüft werden.
no-storeDarf von keinem Cache gespeichert werden.
privateNur der Browser darf speichern, kein CDN oder Proxy.
publicAuch geteilte Caches dürfen speichern.
must-revalidateIst die Antwort veraltet, muss sie vor der Wiederverwendung geprüft werden.
immutableDie Datei ändert sich nicht, solange sie frisch ist. Der Browser prüft sie auch beim Neuladen nicht.
stale-while-revalidate=NEine veraltete Antwort darf noch N Sekunden ausgeliefert werden, während im Hintergrund aktualisiert wird.

Der häufigste Irrtum: no-cache heisst nicht «nicht cachen»

no-cache erlaubt das Speichern ausdrücklich. Es verlangt nur, dass der Browser vor jeder Verwendung beim Server nachfragt. Ist die Datei unverändert, kommt ein schnelles 304. Wer wirklich verhindern will, dass etwas gespeichert wird, etwa bei sensiblen Daten, verwendet no-store.

Laut MDN entspricht max-age=0, must-revalidate in der Wirkung no-cache; empfohlen wird, direkt no-cache zu schreiben.

Die bewährte Strategie: Cache Busting

Das Dilemma: Lange Cache-Zeiten sind schnell, aber Änderungen kommen dann nicht beim Besucher an. Die Lösung heisst Cache Busting. Statische Dateien erhalten eine Version oder einen Hash im Dateinamen, zum Beispiel style.3f9a2c.css. Ändert sich der Inhalt, ändert sich der Dateiname, und damit wird automatisch eine neue Datei geladen.

Daraus ergibt sich eine einfache Zwei-Klassen-Regel:

RessourceEmpfohlener HeaderBegründung
Versionierte Dateien (CSS, JS, Schriften, Bilder mit Hash im Namen)Cache-Control: max-age=31536000, immutableÄndern sich nie, ein Jahr Caching ist sicher
HTML-SeitenCache-Control: no-cacheImmer aktuell, verweisen auf die jeweils neuen Dateinamen
Bilder ohne Versionierungz. B. Cache-Control: max-age=604800 (7 Tage)Kompromiss zwischen Tempo und Aktualität
Persönliche Inhalte (Kundenkonto, Warenkorb)Cache-Control: private, no-cache oder no-storeDürfen nicht in einem CDN landen

Die Werte max-age=31536000, immutable für versionierte Dateien und no-cache für HTML entsprechen den Empfehlungen in der MDN-Dokumentation. Moderne Build-Tools wie Vite, webpack oder Astro erzeugen Hash-Dateinamen automatisch. Bei WordPress hängen viele Themes eine Versionsnummer als Parameter an (?ver=…); das funktioniert ebenfalls, solange die Nummer bei jeder Änderung tatsächlich wechselt.

Wichtig: Header immer explizit setzen

Fehlt Cache-Control, dürfen Browser die Cache-Dauer heuristisch selbst schätzen, meist anhand des Änderungsdatums. Das Ergebnis ist schwer vorhersehbar. Setzen Sie den Header deshalb für alle Antworten bewusst.

Konfiguration in nginx

# Versionierte statische Dateien: ein Jahr, unveränderlich
location ~* \.(?:css|js|woff2|svg|webp|avif|jpg|jpeg|png)$ {
    add_header Cache-Control "public, max-age=31536000, immutable";
    access_log off;
}

# HTML: immer revalidieren
location / {
    add_header Cache-Control "no-cache";
    try_files $uri $uri/ /index.html;
}

Beachten Sie bei nginx: add_header-Anweisungen werden nur dann von einer übergeordneten Ebene geerbt, wenn auf der aktuellen Ebene keine eigene add_header-Anweisung steht. Setzen Sie in einem location-Block einen Header, müssen Sie andere Header (zum Beispiel Sicherheits-Header) dort wiederholen. Ab nginx 1.29.3 können Sie dieses Verhalten mit add_header_inherit merge; ändern: Dann werden die Header der übergeordneten Ebene ergänzt statt ersetzt.

Verwenden Sie die Jahres-Regel nur, wenn die Dateien tatsächlich versioniert sind. Sonst sehen Besucher nach einer Änderung bis zu einem Jahr die alte Version.

Konfiguration in Apache

Mit mod_headers (in .htaccess oder der Virtual-Host-Konfiguration):

<IfModule mod_headers.c>
  <FilesMatch "\.(css|js|woff2|svg|webp|avif|jpe?g|png)$">
    Header set Cache-Control "public, max-age=31536000, immutable"
  </FilesMatch>
  <FilesMatch "\.html?$">
    Header set Cache-Control "no-cache"
  </FilesMatch>
</IfModule>

Bei dynamisch erzeugten Seiten, etwa durch PHP, greift die FilesMatch-Regel für .html nicht. Dort setzen Sie den Header in der Anwendung oder im CMS.

Caching überprüfen

  1. Öffnen Sie die Chrome DevTools (F12) und wechseln Sie in den Tab Network.
  2. Laden Sie die Seite neu und klicken Sie auf eine Datei. Unter Headers sehen Sie die Cache-Control-Antwort.
  3. Laden Sie die Seite ein zweites Mal ohne «Disable cache». In der Spalte Size steht bei gecachten Dateien «(memory cache)» oder «(disk cache)», bei revalidierten Dateien der Status 304.
  4. Alternativ auf der Kommandozeile: curl -I https://www.example.ch/style.css zeigt die Header.

Auch PageSpeed Insights weist in der Diagnose auf statische Dateien mit zu kurzer Cache-Dauer hin.

Browser-Cache und CDN-Cache zusammen

Cache-Control steuert nicht nur den Browser, sondern auch Proxies und CDNs. Mit s-maxage können Sie dem CDN eine andere Dauer vorgeben als dem Browser, zum Beispiel:

Cache-Control: max-age=60, s-maxage=3600

Der Browser prüft nach einer Minute, das CDN behält die Seite eine Stunde. Das ist sinnvoll, wenn Sie den CDN-Cache bei Änderungen gezielt leeren können. Mehr dazu im Artikel CDN erklärt. Wie sich Caching auf die Server-Antwortzeit auswirkt, lesen Sie unter TTFB erklärt.

Checkliste

Weitere Artikel zum Thema