Heimserver & Self-Hosting

Veraltete Inhalte mit NGINX ausliefern - Etwas Aktualität gegen einen kleineren Ausfall tauschen

Veraltete Inhalte mit NGINX ausliefern - Etwas Aktualität gegen einen kleineren Ausfall tauschen

Ein Anwendungsserver antwortet nicht mehr, doch NGINX hat den öffentlichen Artikel von gestern noch im Cache. Welche Antwort ist ehrlicher: der ältere Artikel oder eine aktuelle Seite mit 502 Bad Gateway?

Darauf gibt es keine allgemeingültige Antwort. Eine ältere Dokumentationsseite kann während eines kurzen Ausfalls weiterhin nützlich sein. Ein veralteter Kontostand, eine Zugriffsentscheidung oder eine dringende Korrektur kann dagegen unvertretbar sein. Veraltete Inhalte auszuliefern ist daher nicht nur ein Schalter für mehr Leistung. Es ist eine Richtlinie, die einen Teil der Aktualität gegen begrenzte Kontinuität eintauscht. Dieser Tausch ist nur sinnvoll, wenn Antwort, Cache-Key und Fehlerzeitraum verstanden sind.

NGINX kann diese Richtlinie mit proxy_cache_use_stale ausdrücklich festlegen. Entscheidend ist nicht allein die Direktive, sondern ihre Begrenzung: Was darf in den Cache gelangen, welche Fehler gelten, wie lange bleiben ältere Inhalte vertretbar und woran erkennt ein Betreiber, dass der Fallback aktiv ist?

Stale bedeutet weder fehlend noch beschädigt

RFC 9111 bezeichnet eine gespeicherte Antwort als fresh, solange ihr Alter ihre Freshness Lifetime nicht überschritten hat. Danach ist sie stale. Stale beschreibt das Alter, nicht die Integrität. Der Cache kann weiterhin eine vollständige Antwort enthalten, die zum Zeitpunkt ihrer Speicherung gültig war.

Unter normalen Bedingungen kann ein Cache diese Antwort beim Origin revalidieren, häufig mit If-None-Match oder If-Modified-Since. Der Origin kann sie mit 304 Not Modified bestätigen oder eine neue Repräsentation senden. Bei einem Ausfall des Origins kann dieser Austausch möglicherweise nicht abgeschlossen werden. Eine Stale-on-Error-Richtlinie erlaubt dem Cache, die ältere gespeicherte Antwort zu verwenden, anstatt den Fehler weiterzugeben.

Dieser Fallback hat zwei Voraussetzungen, die leicht übersehen werden:

  • Ein passender Cache-Eintrag muss bereits vorhanden sein. Eine kalte Anfrage kann nicht auf ein Objekt zurückfallen, das nie gespeichert wurde.
  • Der Eintrag muss noch vorgehalten werden. In NGINX kann der Parameter inactive einen Eintrag nach einer Zeit ohne Zugriff entfernen, unabhängig davon, ob Freshness und erlaubte Stale-Zeiträume etwas anderes nahelegen.

Die Auslieferung veralteter Inhalte ist somit ein bedingtes Sicherheitsnetz, keine Offline-Kopie der gesamten Website und keine Verfügbarkeitsgarantie.

Drei Zeitangaben beantworten unterschiedliche Fragen

Eine sorgfältige Konfiguration trennt drei Arten von Zeit:

  1. Freshness Lifetime: wie lange die Antwort normalerweise ohne Validierung wiederverwendet werden darf, meist gesteuert durch max-age, s-maxage, Expires oder eine NGINX-Regel zur Cache-Gültigkeit.
  2. Erlaubte Veraltung: wie lange eine abgelaufene Antwort unter einer bestimmten Ausnahme, etwa einem Origin-Fehler, noch akzeptabel bleibt.
  3. Cache-Aufbewahrung: wie lange NGINX einen nicht abgerufenen Eintrag behält, unter anderem gesteuert durch inactive, Cache-Größe und Verdrängung.

Diese Zeitangaben sind nicht austauschbar. Eine Antwort kann stale und dennoch gespeichert sein, fresh und trotzdem aus Platzgründen verdrängt werden oder weit über den Zeitraum hinaus gespeichert bleiben, in dem sie laut Richtlinie ausgeliefert werden darf. Alle drei Werte als „Cache-Timeout“ zu bezeichnen, verdeckt Entscheidungen, die getrennt bleiben sollten.

NGINX-Richtlinie und HTTP-Antwortrichtlinie

Die Erlaubnis zur Auslieferung veralteter Inhalte lässt sich an zwei sinnvollen Stellen ausdrücken.

Am Reverse Proxy dokumentiert NGINX für proxy_cache_use_stale konkrete Bedingungen wie error, timeout, invalid_header, updating und ausgewählte HTTP-Statuscodes. Standardmäßig ist die Direktive off. Damit kann der Infrastrukturbetreiber eine Richtlinie für einen Konfigurationsbereich festlegen.

proxy_cache_use_stale error timeout invalid_header
                      http_500 http_502 http_503 http_504;

In der Origin-Antwort können die von RFC 5861 definierten Erweiterungen eine zeitlich begrenzte Richtlinie direkt mit der Repräsentation verbinden:

Cache-Control: public, max-age=300, stale-if-error=900

Dieses Beispiel besagt, dass die Antwort 300 Sekunden fresh bleibt und bei einem Fehler für bis zu weitere 900 Sekunden Veraltung verwendet werden darf. Es macht die Antwort nicht für 1.200 Sekunden fresh und verspricht nicht, dass ein Cache sie speichert. RFC 5861 beschreibt Fehler für diese Erweiterung als Antworten, die andernfalls den Status 500, 502, 503 oder 504 hätten.

NGINX unterstützt sowohl stale-if-error als auch stale-while-revalidate aus den vom Upstream gelieferten Cache-Control-Feldern. Laut Dokumentation hat diese headerbasierte Erlaubnis eine niedrigere Priorität als die in proxy_cache_use_stale konfigurierten Parameter. Diese Reihenfolge ist wichtig: Eine weitreichende Proxy-Regel kann die enger gefasste Absicht der Anwendung überdauern oder überschreiben.

Die Zuständigkeit für die Richtlinie sollte bewusst gewählt werden. Ein von der Anwendung gesetzter Header begleitet jede Antwort und kann je nach Ressource variieren. Eine NGINX-Regel kann eine einheitliche Betriebsrichtlinie bereitstellen, selbst wenn der Upstream die Erweiterung nicht ausgeben kann. Beides zu kombinieren ist zulässig, sofern die tatsächlich wirksame Priorität geprüft und nicht nur angenommen wird.

Eine eng begrenzte Konfiguration für öffentliche Seiten

Das folgende Beispiel ist absichtlich auf einen anonymen öffentlichen Pfad begrenzt. Die Zeitwerte sind Beispiele und keine allgemeingültigen Empfehlungen. Die Konfiguration wird außerdem nicht als Produktionskonfiguration dieser Website dargestellt.

# http context
proxy_cache_path /var/cache/nginx/public
    levels=1:2
    keys_zone=public_pages:10m
    max_size=1g
    inactive=60m
    use_temp_path=off;

server {
    location /public/ {
        proxy_pass http://app_backend;

        proxy_cache public_pages;
        proxy_cache_methods GET HEAD;
        proxy_cache_valid 200 5m;
        proxy_cache_revalidate on;
        proxy_cache_lock on;

        proxy_cache_use_stale error timeout invalid_header
                              http_500 http_502 http_503 http_504
                              updating;
        proxy_cache_background_update on;

        add_header X-Cache-Status $upstream_cache_status always;
    }
}

proxy_cache_background_update on startet einen Hintergrund-Subrequest, der einen abgelaufenen Cache-Eintrag aktualisiert, während der Client die veraltete Version erhält. Für dieses Verhalten muss NGINX die Stale-Nutzung während updating erlauben. Das löst ein anderes Problem als stale-if-error: Das Hintergrund-Update verbirgt die Latenz der Aktualisierung, während Stale-on-Error einen fehlgeschlagenen Zugriff auf den Upstream oder eine fehlerhafte Upstream-Antwort behandelt.

proxy_cache_lock on erfüllt ebenfalls eine andere Aufgabe. Für einen Cache-Key darf jeweils nur eine Anfrage ein neues Cache-Element befüllen, während gleichartige Anfragen warten. Dadurch erreichen weniger gleichwertige Cache-Misses gleichzeitig den Upstream. Die Direktive erzeugt jedoch keine veralteten Inhalte und hilft der ersten Anfrage nicht, wenn kein nutzbarer Eintrag vorhanden ist.

Der NGINX-Leitfaden zum Caching erläutert diese Mechanismen gemeinsam, doch eine reale Bereitstellung benötigt weiterhin anwendungsspezifische Regeln. Vom Upstream gesendetes Cache-Control, Set-Cookie, Vary, Autorisierung und der Cache-Key beeinflussen, ob eine Wiederverwendung korrekt ist. NGINX speichert Antworten mit Set-Cookie sowie Antworten mit Vary: * normalerweise nicht. Diese Standardwerte sind Schutzmaßnahmen, ersetzen aber keine Klassifizierung der Routen.

Festlegen, was diesen Fallback niemals verwenden darf

Die wichtigste Cache-Regel ist möglicherweise die Ausschlussliste. Ein gemeinsam genutzter Cache kann eine gespeicherte Antwort für mehrere Benutzer wiederverwenden. Eine falsche Grenze kann daher Daten offenlegen oder den Zustand eines Benutzers einem anderen anzeigen. Die Cache-Control-Referenz von MDN empfiehlt private für personalisierte Inhalte und erklärt, dass no-store die Speicherung verhindert. RFC 9111 schränkt außerdem das Shared Caching von Anfragen mit Authorization ausdrücklich ein.

Login-Seiten, Konto-Dashboards, benutzerspezifische API-Antworten, Warenkörbe, Autorisierungsentscheidungen und andere sensible Zustände sollten nicht allein deshalb unter eine weitreichende öffentliche Cache-Regel fallen, weil sie GET verwenden. Ein Bypass anhand eines Session-Cookies kann Teil des Designs sein. Die zufällige Abwesenheit eines Cookies beweist jedoch nicht, dass jede Repräsentation einer Route öffentlich ist.

Auch öffentliche Inhalte können ungeeignet für einen Stale-Fallback sein. Beispiele sind eine dringende Sicherheitsmeldung, ein zurückgezogener Download, eine schnell wechselnde Verfügbarkeit oder eine Seite, deren alte Anweisungen nach einem Deployment gefährlich werden. Für solche Ressourcen kann ein sichtbarer Fehler ehrlicher sein als eine scheinbar normale, aber veraltete Antwort. Direktiven wie no-cache, must-revalidate und no-store drücken strengere Anforderungen aus. RFC 9111 verbietet die Stale-Auslieferung, wenn eine anwendbare Protokolldirektive sie untersagt.

Den Fallback sichtbar machen, bevor man sich darauf verlässt

Eine erfolgreiche 200-Antwort kann einen fehlerhaften Origin verbergen. NGINX stellt die Variable $upstream_cache_status bereit. Mögliche Zustände sind unter anderem HIT, MISS, EXPIRED, REVALIDATED, STALE und UPDATING. Im Beispiel wird sie zur Diagnose als X-Cache-Status ausgegeben. Falls der interne Cache-Zustand nicht öffentlich sichtbar sein soll, kann der Wert stattdessen in ein Access-Log geschrieben werden.

Ein sicherer Test erfordert mehr als nginx -t. Eine Syntaxprüfung kann die Cache-Richtlinie nicht beweisen. In einer Staging-Umgebung oder einem kontrollierten Wartungsfenster:

  1. Eine bekannte öffentliche URL abrufen und bestätigen, dass eine geeignete Antwort in den vorgesehenen Cache gelangt.
  2. Die URL erneut abrufen und den erwarteten Cache-Status beobachten.
  3. Warten, bis die Antwort stale wird, und den Test-Upstream anschließend genau einen ausdrücklich konfigurierten Fehler zurückgeben lassen.
  4. Bestätigen, dass der Response Body die bekannte ältere Repräsentation enthält und der Status STALE meldet, anstatt jede 200-Antwort als Beweis für den Fallback zu betrachten.
  5. Den Test mit einer kalten URL und einer privaten Route wiederholen. Keine von beiden darf das öffentliche Stale-Objekt erhalten.
  6. Den Upstream wiederherstellen und prüfen, dass Revalidierung oder Ersetzung den Cache auf aktuelle Inhalte zurückführt.

Auch die relevanten Dimensionen des Cache-Keys sollten getestet werden: Host, Query-String, Encoding, Sprache und jedes von Vary benannte Feld. Das Fehlerverhalten ist nur so sicher wie die Auswahl der Antwort, die ihm vorausgeht.

Der Tausch ist nützlich, weil er begrenzt ist

Veraltete Inhalte können die sichtbaren Auswirkungen eines kurzen Anwendungsausfalls reduzieren. Sie reparieren jedoch weder die Anwendung noch sichern sie Schreibvorgänge oder garantieren die Erreichbarkeit jeder URL. Der Mechanismus kann die Entdeckung eines Problems zudem verzögern, wenn das Monitoring nur die an den Client gesendeten Statuscodes beobachtet. Origin-Zustand und Stale-Antworten benötigen daher getrennte Signale.

Die Entscheidung fällt leichter, wenn sie pro Ressource formuliert wird: Wie alt darf diese Repräsentation werden, bevor ein Fehler ehrlicher ist? Welche Fehler rechtfertigen die Ausnahme? Kann dieselbe gespeicherte Antwort sicher jede dem Key zugeordnete Anfrage bedienen? Woran erkennt ein Betreiber, dass die Ausnahme aktiv ist?

Für stabile, anonyme Artikel oder Dokumentation kann ein kurzes und beobachtbares Stale-Fenster ein vernünftiges Werkzeug für Kontinuität sein. Für persönliche, sensible, widerrufbare oder schnell wechselnde Zustände kann es völlig ungeeignet sein. Das Ziel besteht nicht darin, jeden Ausfall zu verbergen. Es geht darum, im Voraus festzulegen, wo leicht veraltete öffentliche Informationen sicherer sind als gar keine Informationen, und diese Erlaubnis so eng zu halten, dass diese Aussage wahr bleibt.

References