So testen Sie, ob DNS die Ursache für Immich-Verbindungsfehler ist

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.

DNS ist wahrscheinlich die Ursache bei Immich, wenn der betroffene Client den genauen Immich-Hostnamen nicht in die Adresse auflösen kann, die den Dienst bereitstellen sollte, oder wenn sich diese Antwort je nach Resolver, Netzwerk oder Zeitpunkt ändert.

Testen Sie die Namensauflösung getrennt von der Erreichbarkeit der Anwendung. Eine erfolgreiche Verbindung auf IP-Ebene kann zeigen, dass eine Route und ein Port vorhanden sind, beweist aber nicht, dass HTTPS, Reverse-Proxy-Routing, Zertifikate oder hostbasierte Regeln ohne den Hostnamen funktionieren. Am sichersten ist es, den genauen fehlerhaften Namen zu notieren, ihn vom betroffenen Client abzufragen, die Resolver zu vergleichen und anschließend die ursprüngliche Immich-Aktion nach einer einzelnen Änderung an der DNS-Ebene erneut auszuführen.

Den genauen Hostnamen und Fehlerpfad bestimmen

Notieren Sie den Hostnamen, den der betroffene Immich-Client tatsächlich verwendet, das verwendete Netzwerk, den Zeitpunkt des Fehlers und ob die Web-App, die mobile App oder beide betroffen sind. Beginnen Sie nicht mit einem allgemeinen Test, etwa der Auflösung einer beliebigen öffentlichen Domain, denn damit wird nur nachgewiesen, dass irgendein DNS-Pfad funktioniert.

Vergleichen Sie denselben Hostnamen auf einem funktionierenden und einem betroffenen Client. Notieren Sie alle A- und AAAA-Antworten, den antwortenden Resolver und ob sich der Client im Heimnetzwerk, im Mobilfunknetz oder hinter einem VPN befindet. Unterschiedliche Antworten können bei Split-DNS beabsichtigt sein, müssen aber dennoch jeden Client zu einem erreichbaren Endpunkt führen.

Prüfen Sie als Gegenprobe, ob die erwartete Serveradresse und der Port erreichbar sind, ohne sich auf die normale DNS-Abfrage zu verlassen. Verwenden Sie dies nur, um den Netzwerkpfad einzugrenzen: HTTPS-Zertifikate, SNI, Reverse-Proxys und virtuelle Hosts können eine IP-basierte Anfrage weiterhin ablehnen, selbst wenn der Dienst ordnungsgemäß funktioniert.

DNS vom betroffenen Client abfragen, nicht nur vom Server

Führen Sie eine DNS-Abfrage auf dem Gerät oder in der Umgebung aus, bei der der Fehler tatsächlich auftritt. Wenn sich der Immich-Client hinter einem VPN, einem privaten DNS-Profil, einem Container-Stub oder einem vom Router bereitgestellten Resolver befindet, kann eine Abfrage direkt auf dem Server einen anderen Resolverpfad verwenden und das Problem verschleiern.

Fragen Sie den fehlerhaften Hostnamen zuerst über den Standardresolver des Clients ab und anschließend ausdrücklich über einen bekannten Vergleichsresolver oder den vorgesehenen internen Resolver. Eine gezielte dig-Abfrage zeigt die zurückgegebene Antwort, den antwortenden Server, den Status und die Abfragezeit. So sehen Sie, ob der Fehler einem bestimmten Resolver folgt.

Wiederholen Sie die Abfrage mehrmals, statt sich auf einen einzigen Erfolg zu verlassen. Notieren Sie NXDOMAIN, SERVFAIL, Timeouts, veraltete Adressen oder uneinheitliche A-/AAAA-Antworten. Eine stabile, korrekte Antwort lenkt den Verdacht von der grundlegenden DNS-Auflösung weg und eher auf Routing, Proxy, TLS, Firewall oder Anwendungskonfiguration.

Resolver-Ergebnisse und Fehlertypen vergleichen

Interpretieren Sie den Antwortcode, bevor Sie Einstellungen ändern. NXDOMAIN bedeutet, dass der abgefragte Name aus Sicht dieses Resolvers nicht existiert; SERVFAIL bedeutet, dass die Auflösung nicht abgeschlossen werden konnte; ein Timeout bedeutet, dass der Resolver nicht rechtzeitig geantwortet hat. Eine syntaktisch erfolgreiche Antwort kann dennoch falsch sein, wenn sie auf eine veraltete Routeradresse oder einen nicht erreichbaren Endpunkt verweist.

Fehler wegen eines nicht gefundenen Namens und vorübergehende Resolver-Ausfälle sind unterschiedliche Fälle. Nutzen Sie Unterschiede bei Fehlern der Namensauflösung, um zu entscheiden, ob ein fehlender Eintrag, ein nicht erreichbarer Resolver oder ein instabiler DNS-Pfad behoben werden muss, statt jeden Auflösungsfehler als dasselbe Problem zu behandeln.

Liefert nur der Heim-Resolver die alte oder falsche Adresse, während ein anderer Resolver den vorgesehenen öffentlichen Wert zurückgibt, prüfen Sie lokale Überschreibungen, Split-DNS-Einträge, per DHCP bereitgestelltes DNS, Filterdienste und Caches. Liefern alle Resolver dieselbe korrekte Adresse, ändern Sie nichts mehr an DNS und fahren Sie mit der Dienstverbindung fort.

Mit einer kontrollierten Umgehung DNS als Ursache bestätigen oder ausschließen

Richten Sie eine einzelne vorübergehende, umkehrbare Kontrolle ein, die ausschließlich die Namensauflösung für den fehlerhaften Client ändert. Fragen Sie beispielsweise direkt einen anderen Resolver ab oder verwenden Sie vorübergehend einen hosts-Dateieintrag, der den genauen Immich-Hostnamen der bekannten Zieladresse zuordnet. Bewahren Sie die ursprünglichen Einstellungen auf, damit sich der Test sofort rückgängig machen lässt.

Funktioniert der ursprüngliche Immich-Ablauf, während der Hostname unverändert bleibt und sich nur sein Auflösungspfad geändert hat, ist DNS sehr wahrscheinlich die Ursache. Schlägt derselbe Hostname weiterhin fehl, nachdem er zur bestätigten Zieladresse aufgelöst wurde, liegt die Ursache hinter DNS. Prüfen Sie dann das Proxy-Routing, Zertifikate, NAT, Firewall-Regeln oder den Immich-Dienst selbst.

Lässt sich das Fehlerzeitfenster im Haushalt mit einer einzelnen Abfrage nicht reproduzieren, vergleichen Sie im Zeitverlauf den Zustand von Host, Container, lokalem Resolver, Upstream-Resolver, DHCP, VPN und Cache. Eine mehrstufige DNS-Fehlerprüfung hilft dabei, sporadische Fälle zu erkennen, die bei einem einmaligen Test nicht auftreten.

Den richtigen Cache leeren und den ursprünglichen Immich-Ablauf erneut testen

Nachdem Sie einen DNS-Eintrag, Resolver, eine DHCP-Option, eine Split-DNS-Regel oder eine lokale Überschreibung korrigiert haben, leeren Sie nach Möglichkeit nur den Cache des betroffenen Clients oder Resolvers. Leeren Sie nicht wiederholt jede Ebene, ohne festzuhalten, was geändert wurde. Andernfalls lässt sich ein vorübergehender Erfolg möglicherweise nicht erklären.

Lösen Sie den Hostnamen erneut auf dem betroffenen Client auf und überprüfen Sie die vorgesehene A-/AAAA-Antwort, den Resolver und die Antwortzeit. Öffnen Sie Immich anschließend über den normalen Hostnamen, laden Sie ältere Dateien, führen Sie eine Suche durch und testen Sie einen sicheren Upload oder eine andere Schreibaktion, damit die Prüfung mehr als nur eine Anmeldeseite umfasst.

Wiederholen Sie die Prüfung im Netzwerkzustand, in dem der Fehler ursprünglich aufgetreten ist, z. B. über mobile Daten, Ihr Heim-WLAN, ein VPN-verbundenes WLAN oder nach einer Router-/DHCP-Erneuerung. DNS ist erst dann als Ursache ausgeschlossen, wenn der normale Hostname auch bei dem Auslöser unverändert bleibt, der zuvor den Fehler verursacht hat. Andernfalls halten Sie die neuen Erkenntnisse fest und fahren mit der nächsten Netzwerkebene fort.

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.