Immich-Anmeldung schlägt nach dem Neustart des Reverse-Proxys fehl

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.

Wenn die Immich-Anmeldung nur nach einem Neustart des Reverse-Proxys fehlschlägt, klären Sie zuerst, ob der Proxy-Zugriffspfad ausgefallen ist, während die Immich-Anwendung und das Konto weiterhin direkt funktionieren.

Ein Neustart kann veraltete Upstream-Adressen, eine fehlende gemeinsame Netzwerkzugehörigkeit, Änderungen an Headern, abweichendes Cookie-Verhalten oder einen Proxyprozess aufdecken, der gestartet wurde, bevor seine Abhängigkeiten erreichbar waren. Testen Sie dasselbe Konto über den lokalen Immich-Endpunkt und die übliche öffentliche Hostadresse und untersuchen Sie dann die erste Ebene, auf der sich die beiden Zugriffspfade unterscheiden.

Direkten Zugriff verwenden, um Authentifizierungs- und Proxyfehler voneinander zu trennen

Testen Sie ein bekanntes Konto über eine vertrauenswürdige lokale Verbindung, die den Reverse-Proxy umgeht, mit dem Immich-Server. Wenn die direkte Anmeldung gelingt, während die öffentliche Hostadresse lädt, Weiterleitungen auslöst oder einen Upstream-Fehler zurückgibt, sind der Benutzerdatensatz und der grundlegende Authentifizierungspfad wahrscheinlich intakt. Konzentrieren Sie die Untersuchung auf Proxy, TLS, Routing und Browserstatus.

Ein Community-Fall, in dem der direkte Zugriff funktionierte, während die Anmeldung über den Proxy fehlschlug, veranschaulicht diese Isolierungsmethode. Der Bericht bezieht sich auf eine bestimmte Version. Nutzen Sie ihn daher als Anlass, die Zugriffspfade zu vergleichen, statt dieselbe Ursache anzunehmen.

Wenn sowohl die direkte als auch die Proxy-Anmeldung fehlschlagen, nehmen Sie keine weiteren Änderungen an den Proxy-Einstellungen vor. Prüfen Sie stattdessen den Zustand des Immich-Dienstes, die Datenbankverbindung, den Kontostatus und die Serverprotokolle. Ein zeitgleich mit dem Fehler erfolgter Proxy-Neustart kann Zufall sein; der Umgehungstest verhindert, dass dieser zeitliche Zusammenhang als unbelegte Diagnose gilt.

Prüfen, ob der Proxy den aktuellen Immich-Upstream erreichen kann

Prüfen Sie nach dem Neustart des Proxys, ob dieser den Immich-Upstream in seinem eigenen Netzwerk-Namespace auflösen und erreichen kann. In Docker ist ein Upstream mit Dienstnamen in einem gemeinsamen benutzerdefinierten Netzwerk im Allgemeinen zuverlässiger als eine manuell kopierte Container-IP, die sich bei der Neuerstellung eines Containers ändert.

Eine Diskussion über einen Ausfall des Reverse-Proxys im Zusammenhang mit der Verbindung zwischen Proxy und Immich zeigt, warum die Erreichbarkeit des Upstreams und WebSocket-fähiges Proxying geprüft werden sollten, bevor Sie eine Kontowiederherstellung versuchen. Betrachten Sie die genaue Konfiguration als anekdotischen Beleg, nicht als Vorlage für jeden Proxy.

Starten Sie nur den Proxy zweimal neu und prüfen Sie, ob sich sein Upstream jedes Mal in denselben Dienst auflöst. Ein erfolgreicher Test ist eine sofortige Verbindung ohne Änderungen an Adressen. Wenn sich Namensauflösung, Netzwerkzugehörigkeit oder Zielport nach der Neuerstellung ändern, korrigieren Sie die Compose-Netzwerkdefinition, statt wiederholt den Stack neu zu starten.

Weitergeleitete Header, TLS und Cookie-Verhalten prüfen

Die Anmeldung kann fehlschlagen, obwohl der Proxy die Immich-Seite zurückgibt, denn die Authentifizierung hängt vom vollständigen HTTP-Pfad ab. Vergleichen Sie die Proxy-Konfiguration vor und nach dem Neustart, einschließlich der Weiterleitung von Host und Schema, der HTTPS-Terminierung, Weiterleitungen, etwaiger Cookie-Umschreibungen und der Frage, ob ein zweiter Proxy oder Tunnel die Antwort ebenfalls verändert.

In einer Diskussion der Immich-Community wird ein Anmeldefehler durch doppelte Cookies beschrieben, bei dem die Cookie-Verarbeitung des Proxys zu einer hängenden Anmeldung führte. Dieser Fall lässt sich klar eingrenzen, erinnert aber daran, die Browserantwort und Cookies zu überprüfen, statt anzunehmen, dass gültige Zugangsdaten eine erfolgreiche Sitzung über den Proxy garantieren.

Lösche nicht alle Konten und setze nicht die Datenbank zurück, nur weil eine Browsersitzung festzuhängen scheint. Verwende ein privates Fenster oder einen zweiten Browser, nachdem du die ursprünglichen Cookies und die Antwort protokolliert hast. Funktioniert es mit einem sauberen Client, lösche nur die betroffenen Website-Daten und korrigiere die Proxy-Regel, die das fehlerhafte Cookie oder die Weiterleitung erzeugt hat.

Single board computer zimaboard2

Zugriffs- und Fehlerprotokolle des Proxys zum Zeitstempel der fehlgeschlagenen Anfrage auswerten

Führe einen Anmeldeversuch durch und notiere die genaue Uhrzeit, den öffentlichen Hostnamen, den Client und den zurückgegebenen Status. Überprüfe anschließend die Zugriffs- und Fehlerprotokolle des Proxys rund um diese Anfrage. Unterscheide zwischen einer Anfrage, die den Proxy nie erreicht hat, einer vom Proxy erzeugten 4xx- oder 5xx-Antwort, einem Upstream-Verbindungsfehler und einer Anfrage, die Immich erreicht und eine Anwendungsantwort erhalten hat.

Der NGINX-Leitfaden zur Fehlerbehebung anhand von Protokollen zeigt, wie Status, Upstream-Fehler, Anfragedauer und gezielte Protokollierung aussagekräftigere Hinweise liefern als wiederholtes Aktualisieren der Anmeldeseite. Wende dasselbe Prinzip auf Caddy, Traefik oder einen anderen Proxy an.

Zeigt das Proxy-Protokoll eine erfolgreiche Upstream-Antwort, während der Browser die Anmeldung nicht abschließen kann, überprüfe Weiterleitungen, Cookies, TLS und den Client-Zustand. Kann der Proxy keine Verbindung zum Upstream herstellen, behebe das Routing oder die Dienstbereitschaft. Gibt Immich selbst den Fehler zurück, folge dem entsprechenden Serverprotokoll, statt den Proxy als Ursache anzunehmen.

Nachweisen, dass die Fehlerbehebung den Neustart übersteht, der den ursprünglichen Fehler ausgelöst hat

Wiederhole nach Behebung der bestätigten Ursache genau den Auslöser: Starte nur den Reverse-Proxy neu, warte auf seine Zustandsprüfung und melde dich über den öffentlichen Hostnamen an. Öffne anschließend ein vorhandenes Asset, lade eine kleine Datei hoch und lasse die Sitzung lange genug aktiv, um den normalen API-Verkehr zu überprüfen.

Der ZimaSpace-Leitfaden zu kontrollierten Fernzugriffspfaden steckt den größeren Rahmen ab: Der Proxy ist nur eine Ebene des Fernzugriffs. Deshalb müssen DNS, TLS, Authentifizierung und der private Upstream bewusst konfiguriert und nachvollziehbar sein.

Nur dann als bestanden werten, wenn die Anmeldung zwei Neustarts des Proxys übersteht und dieselbe Konfiguration nach einem vollständigen Neustart des Stacks sauber startet. Setze kürzlich vorgenommene Proxy-Änderungen zurück, falls eine neue Header- oder Cookie-Regel den Fehler verursacht hat. Eskaliere den Fall mit dem Konfigurations-Diff des Proxys, dem Anfragestatus, dem Upstream-Fehler, dem Zeitstempel des Serverprotokolls und dem Ergebnis des direkten Tests im Vergleich zum Test über den Proxy.

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.