HTTP Cache-Control Header

Der HTTP-Header Cache-Control ist ein Request- und Response-Header, der Caching-Direktiven für Browser, CDNs und Proxies definiert. Er ist der primäre Mechanismus zur Steuerung von HTTP-Cache-Verhalten und Performance-Optimierung.

Typ

Request-Header und Response-Header

Syntax

Der Header listet Caching-Direktiven als kommaseparierte Liste auf.

http 
Cache-Control: max-age=3600, public
Cache-Control: no-cache, no-store, must-revalidate

Direktiven

Die Direktiven steuern Cache-Verhalten für verschiedene Komponenten.

max-age=<seconds>
Maximale Cache-Dauer in Sekunden. Response ist so lange frisch.
s-maxage=<seconds>
Cache-Dauer für Shared Caches (CDN, Proxies), überschreibt max-age.
public
Response darf von allen Caches gespeichert werden inkl. CDN.
private
Response nur im Browser-Cache, nicht in Shared Caches.
no-cache
Cache muss Revalidierung durchführen bevor gecachte Version verwendet wird.
no-store
Response darf nicht gecacht werden (sensible Daten).
must-revalidate
Stale Responses dürfen nicht verwendet werden ohne Revalidierung.
immutable
Response ändert sich nie während Cache-Lifetime, keine Revalidierung nötig.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Cache-Control-Header.

Beispiel 1 Statische Assets langfristig cachen

http 
Cache-Control: public, max-age=31536000, immutable

JavaScript, CSS und Bilder mit Content-Hash im Filename können 1 Jahr gecacht werden.

Beispiel 2 API-Response kurzfristig cachen

http 
Cache-Control: private, max-age=300

API-Response wird 5 Minuten im Browser gecacht, nicht in CDN. Für user-spezifische Daten.

Beispiel 3 Sensitive Daten nicht cachen

http 
Cache-Control: no-store, no-cache, must-revalidate

Verhindert Caching von sensiblen Daten wie Authentifizierungs-Responses oder persönlichen Informationen.

CDN Cache Flow

Cache-Control Direktiven für CDN und Browser

Vorteile für die Systemarchitektur

  • Performance-Optimierung: Reduziert Server-Last und Latenz durch effektives Caching
  • Bandbreiten-Einsparung: Weniger Origin-Requests bedeuten niedrigere Traffic-Kosten
  • Skalierbarkeit: CDN-Caching ermöglicht globale Content-Delivery ohne Origin-Überlastung

Spezifikation

RFC 9111 – HTTP Caching https://www.rfc-editor.org/rfc/rfc9111.html#name-cache-control

Weitere Spezifikationen

ETag Header, Last-Modified Header, Expires Header