So starten Sie einen Reverse-Proxy neu, ohne Dienste mit Sitzungsstatus neu zu starten

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Geplante Proxy-Wartungsarbeiten sind sicherer, wenn der Reverse-Proxy unabhängig von den dahinterliegenden Authentifizierungs- und Sitzungsstatusdiensten neu geladen oder gestartet werden kann.

Ein Proxy-Prozess muss normalerweise nicht den Anmeldestatus verwalten, den er weiterleitet. Erfassen Sie vor Wartungsarbeiten, welche Komponente Cookies signiert, serverseitige Sitzungen speichert, die Authentifizierung beendet und aktive HTTP-Verbindungen auslaufen lässt. Lassen Sie diese zustandsbehafteten Komponenten weiterlaufen, bevorzugen Sie sanfte Proxy-Neuladungen, wenn sich nur die Konfiguration ändert, und stellen Sie sicher, dass ein vollständiger Austausch des Proxys wieder eine Verbindung zum selben Authentifizierungs-Gateway und Sitzungsspeicher mit unveränderten Geheimnissen herstellt.

Lebenszyklus von Proxy und Authentifizierungsdienst trennen

Prüfen Sie Ihre Compose-Abhängigkeiten, Neustartrichtlinien, gemeinsamen Skripte und Aktionen des Stack-Managers, damit ein Neustart des Proxys nicht automatisch das Authentifizierungs-Gateway, die Anwendung, Redis oder die Datenbank neu erstellt.

Ein Beispiel für eine Sitzungsarchitektur verwendet Redis außerhalb des Proxy-Lebenszyklus, damit mehrere Authentifizierungsinstanzen und Neustarts denselben Sitzungs-Backend nutzen können.

Fassen Sie nicht jeden Edge-Dienst in einem einzigen pauschalen Neustartbefehl zusammen. Wenn eine Zertifikats- oder Routenänderung nur den Proxy betrifft, lassen Sie die Dienste, die den bestehenden Anmeldestatus validieren, unangetastet.

Konfiguration nach Möglichkeit neu laden, statt neu zu starten

Verwenden Sie bei Änderungen an Routen, Zertifikaten oder Headern den vom Proxy unterstützten sanften Neuladevorgang, statt den Dienst anzuhalten. Überprüfen Sie die Konfiguration vor der Anwendung, damit ein Syntaxfehler geplante Wartungsarbeiten nicht zu einem Ausfall macht.

Der NGINX-Leitfaden von API7 erläutert, wie alte Worker Verbindungen auslaufen lassen, während neue Worker Anfragen mit der aktualisierten Konfiguration annehmen.

Ein Neuladen erhält die Proxy-Prozessfamilie, schützt aber keinen separaten Authentifizierungsdienst, wenn Ihr Bereitstellungsskript auch diesen Dienst neu startet. Behandeln Sie die Lebenszyklen dieser beiden Komponenten unabhängig voneinander.

Externen Sitzungsspeicher beim Austausch des Proxys beibehalten

Wenn ein Authentifizierungs-Gateway Sitzungsdaten außerhalb von Cookies speichert, lassen Sie sein Redis- oder sonstiges Sitzungs-Backend während des Proxy-Betriebs unverändert bestehen. Dokumentieren Sie die Backend-Adresse und das von jeder Authentifizierungsinstanz verwendete Geheimnis.

OAuth2 Proxy unterstützt Redis als gemeinsamen Sitzungsspeicher, wenn Sitzungen von mehreren Instanzen gemeinsam genutzt werden müssen.

Verwechseln Sie einen entbehrlichen Cache nicht mit dem maßgeblichen Anmeldestatus. Wenn das Sitzungs-Backend zur Validierung aktueller Benutzer erforderlich ist, starten Sie es nur gemäß seinem eigenen, getesteten Wartungsverfahren neu oder leeren Sie es.

Single board computer zimaboard2

Cookie- und Signaturschlüssel stabil halten

Notieren Sie das Cookie-Verschlüsselungs- oder Signiergeheimnis des Authentifizierungs-Gateways und stellen Sie sicher, dass der Ersatz-Proxy-Stack dieselbe Geheimnisquelle einbindet. Wird bei der erneuten Bereitstellung ein neuer Wert generiert, werden ansonsten gültige Browser-Cookies ungültig.

Ein Leitfaden zu Reverse-Proxy-Sitzungen weist darauf hin, dass eine stabile Sitzungsrichtlinie Neustarts übersteht und nicht von der Lebensdauer einer einzelnen TCP-Verbindung abhängt.

Rotieren Sie Signiergeheimnisse als separate Sicherheitsänderung und legen Sie dabei ausdrücklich fest, ob eine Abmeldung erwartet wird oder eine Überlappungsstrategie gilt. Kombinieren Sie die Geheimnisrotation nicht mit einem gewöhnlichen geplanten Proxy-Neuladen, es sei denn, die Sitzungsungültigkeit ist beabsichtigt.

Verbindungen während eines vollständigen Proxy-Neustarts auslaufen lassen

Wenn die Proxy-Binärdatei oder der Container ersetzt werden muss, verwenden Sie nach Möglichkeit den dafür vorgesehenen kontrollierten oder unterbrechungsfreien Neustartmechanismus, damit bestehende Anfragen nicht mitten in der Antwort abgebrochen werden. Legen Sie für langlebige Verbindungen ein Wartungs-Timeout fest.

Die Anleitung zum Neuladen von HAProxy zeigt, wie unterbrechungsfreie Neuladungen Verbindungen erhalten, anstatt den alten Prozess sofort zu beenden.

Die Kontinuität der Verbindung und die Kontinuität der Anmeldung sind nicht dasselbe. Selbst wenn eine WebSocket-Verbindung wiederhergestellt wird, sollte die Sitzung gültig bleiben, weil der Ersatz-Proxy dieselben Authentifizierungs- und Statusdienste erreicht.

Eine Sitzung vor und nach geplanter Wartung testen

Verwenden Sie einen angemeldeten Browser und eine neue private Sitzung. Notieren Sie vor der Wartung das Sitzungscookie, die Proxy-Route, den Authentifizierungsdienst und das Backend. Laden Sie anschließend nur den Proxy neu oder ersetzen Sie ihn und wiederholen Sie dieselbe geschützte Anfrage.

Ein Caddy-Leitfaden für den Betrieb empfiehlt bei geplanten Konfigurationsaktualisierungen das Neuladen statt eines vollständigen Neustarts.

Das Wartungskonzept funktioniert, wenn bestehende Anmeldungen erhalten bleiben, neue Anmeldungen weiterhin möglich sind und keine zustandsbehaftete Abhängigkeit unbeabsichtigt neu gestartet wurde. Der zugehörige ZimaSpace-Artikel zu Sitzungsverlust nach einem Proxy-Neustart ist weiterhin der richtige Wiederherstellungszweig, wenn Benutzer noch abgemeldet sind.

Häufig gestellte Fragen

Garantiert ein kontrolliertes Neuladen des Proxys, dass Benutzer angemeldet bleiben?

Nein. Es schützt Proxy-Verbindungen, aber Benutzer können trotzdem abgemeldet werden, wenn der Authentifizierungsdienst, der Sitzungsspeicher oder das Cookie-Signaturgeheimnis gleichzeitig geändert wird.

Sollte Redis einen Proxy-Neustart immer überstehen?

Nur wenn Redis den Sitzungsstatus oder eine andere dauerhafte Abhängigkeit für die Authentifizierung speichert. Eine Redis-Instanz, die nur als Cache dient, hat eine andere Wiederherstellungsgrenze.

Reicht es aus, denselben Cookie-Namen beizubehalten?

Nein. Das Signier- oder Verschlüsselungsgeheimnis und der Backend-Sitzungsstatus müssen ebenfalls mit dem Cookie kompatibel bleiben, das der Browser bereits gespeichert hat.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.