So erkennst du, ob ein Immich-Fehler vom Client oder Server kommt

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.

Finden Sie heraus, ob ein Immich-Fehler client- oder serverseitig ist, indem Sie dieselbe Aktion mit nur einer geänderten Variable wiederholen und die fehlgeschlagene Anfrage entlang des gesamten Pfads verfolgen.

Ein Banner auf dem Mobilgerät mit der Meldung „Serverfehler“ kann dennoch durch den Clientzustand, TLS, einen Reverse-Proxy oder eine vom Server korrekt abgelehnte Anfrage verursacht werden. Ebenso beweist ein Fehler, der nur im Browser auftritt, nicht, dass der Browser defekt ist. Halten Sie Konto, Medium und Aktion unverändert, vergleichen Sie Clients und Verbindungen und nutzen Sie dann Statuscodes und zeitlich abgestimmte Protokolle, um die erste fehlerhafte Ebene zu finden.

Dieselbe Aktion auf einem zweiten Client wiederholen

Wählen Sie eine eindeutig reproduzierbare Aktion, etwa die Anmeldung, das Öffnen eines bekannten Mediums, das Hochladen desselben kleinen Fotos oder das Ausführen derselben Suche. Wiederholen Sie sie mit demselben Konto in einem Browser und auf einem Mobilgerät, ohne die Netzwerkverbindung zu ändern. Notieren Sie für beide Versuche die genaue Uhrzeit und das Ergebnis.

Ein aktueller Immich-Bericht, in dem ein Android-Client ausfiel, während andere Zugriffswege getestet wurden, zeigt den Nutzen eines Vergleichs zwischen Clients. Die Ursache in einem einzelnen Thread lässt sich nicht verallgemeinern, doch ein clientspezifisches Ergebnis grenzt den nächsten Untersuchungsbereich deutlich ein.

Wenn alle Clients dieselbe Aktion gleichzeitig nicht ausführen können, rücken Server, Datenbank, Speicher oder ein gemeinsam genutzter Netzwerkpfad auf der Liste möglicher Ursachen nach oben. Wenn nur ein Client ausfällt, während ein anderer über denselben Endpunkt funktioniert, prüfen Sie die Clientversion, den zwischengespeicherten Zustand, Berechtigungen, das lokale Zertifikatsvertrauen und die genaue abweichende Anfrage.

Ändern Sie die Verbindung, nicht das Konto oder das Medium

Vergleichen Sie als Nächstes eine vertrauenswürdige lokale Verbindung mit der üblichen Verbindung über Reverse-Proxy, VPN, Tunnel oder Fernzugriff. Verwenden Sie dasselbe Konto und führen Sie dieselbe Aktion aus. Ein Erfolg lokal bei gleichzeitigem Fehlschlag aus der Ferne deutet darauf hin, dass nicht der Medieneintrag selbst die Ursache ist, sondern eher DNS, TLS, Proxy, Firewall oder Upstream-Routing.

Der ZimaSpace-Leitfaden zur Diagnose lokaler und externer Verbindungen erklärt, warum der Erfolg im LAN und der Erfolg über das Internet unterschiedliche Belege sind. Prüfen Sie diese Abgrenzung bei Immich, bevor Sie eine mobile App neu installieren oder den Server neu aufsetzen.

Wenn beide Routen auf dieselbe Weise fehlschlagen, ändern Sie nicht länger die Proxy-Einstellungen, sondern untersuchen Sie die anwendungsseitige Anfrage. Schlägt nur die Proxy-Route fehl, erfassen Sie den Proxy-Status, das TLS-Ergebnis, die Upstream-Antwort und den Timeout. Dieser Vergleich mit nur einer geänderten Variable verhindert, dass eine Clientmeldung die Untersuchung auf die falsche Ebene lenkt.

Statuscodes als Hinweise nutzen, nicht als endgültiges Urteil

HTTP-Statusklassen helfen dabei einzugrenzen, wo Sie suchen sollten, identifizieren aber nicht automatisch die Komponente, die den Fehler verursacht hat. Ein 4xx bedeutet oft, dass die Anfrage, Authentifizierung oder Autorisierung nicht akzeptabel war; ein 5xx zeigt an, dass eine serverseitige Komponente die Anfrage nicht erfüllen konnte. Proxys können beide Klassen erzeugen, bevor Immich die Anfrage überhaupt sieht.

Der Leitfaden zu Zugriffsprotokollfeldern hebt Statuscode, URL-Pfad, Anfragezeit, Remote-Host und Anfragekennungen als nützliche Felder für die Fehlerbehebung hervor. Erfassen Sie diese Werte für den einzelnen fehlschlagenden Vorgang, statt Tausende irrelevante Zeilen zu durchsuchen.

Protokolliert der Proxy einen 502-Fehler oder einen Timeout ohne passende Immich-Anfrage, verfolgen Sie den Upstream-Pfad. Protokolliert Immich eine Anfrage und gibt einen deterministischen 4xx-Fehler zurück, prüfen Sie Authentifizierung, Berechtigungen oder den Anfrageinhalt. Meldet der Client einen Fehler, obwohl alle serverseitigen Ebenen einen 2xx-Status anzeigen, prüfen Sie das Client-Parsing, den lokalen Cache oder Folgeanfragen.

Fehlerrate, Latenz und Serverprotokolle anhand eines Zeitstempels abgleichen

Eine fehlgeschlagene Anfrage kann ein Ausreißer sein. Wiederholen Sie den Vorgang fünf bis zehn Mal und protokollieren Sie Erfolgsrate und Latenz, während Sie die relevanten Server- und Proxyprotokolle beobachten. Steigen die Fehler bei Ressourcenknappheit oder Warteschlangenspitzen an, ist der Server möglicherweise zeitweise nicht verfügbar, auch wenn ein zweiter Versuch gelingt.

Die Übersicht von Better Stack zu Fehlern und Latenz als Dienstsignalen unterscheidet Fehlerrate, Latenz und Datenverkehr. Diese Einordnung hilft dabei, eine einzelne fehlerhafte Client-Anfrage von einem Serverpfad zu unterscheiden, der sich nur unter Last verschlechtert.

Wenn die Serverprotokolle bei mehreren Clients dieselbe Ausnahme enthalten, behandeln Sie den Fehler als serverseitig, bis das Gegenteil bewiesen ist. Wenn der Server die fehlschlagende Anfrage nie erhält, untersuchen Sie DNS, TLS, Proxy und Client-Netzwerkverbindung. Wenn nur ein Client eine anders aufgebaute Anfrage sendet, aktualisieren Sie diesen Client oder setzen Sie ihn zurück, nachdem Sie genügend Belege gesichert haben, um den Unterschied zu bestätigen.

Fällen Sie das endgültige Urteil mit einem Zwei-mal-zwei-Test

Verwenden Sie zwei Clients und zwei Routen: Browser-lokal, Browser-remote, Mobilgerät-lokal und Mobilgerät-remote. Verwenden Sie dasselbe Konto und dasselbe Testobjekt. Mit dieser Matrix lassen sich client- und routenspezifische Fehler sowie Serverfehler unterscheiden, die jede Kombination betreffen.

Eine Ursache auf Client-Seite ist wahrscheinlich, wenn ein Client bei beiden Routen fehlschlägt, während ein anderer besteht. Eine Ursache auf Routenseite ist wahrscheinlich, wenn beide Clients nur über eine Route fehlschlagen. Eine Ursache auf Server-Seite ist wahrscheinlich, wenn alle vier Kombinationen denselben Anwendungsfehler reproduzieren und die Serverprotokolle denselben fehlschlagenden Vorgang zeigen.

Nachdem Sie die identifizierte Ebene behoben haben, führen Sie alle vier Zellen und einen Neustart der betroffenen Komponente erneut aus. Stoppen Sie, sobald die ursprünglich fehlerhafte Zelle besteht, ohne die Kontrolltests zu beeinträchtigen. Eskalieren Sie den Fall mit der Matrix, Zeitstempeln, HTTP-Statuscodes, Auszügen aus Proxy- und Serverprotokollen, Client-Versionen und einer reproduzierbaren Anfrage statt mit einem allgemeinen Screenshot.

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.