Sollte Immich das Host-Netzwerk oder ein Bridge-Netzwerk verwenden?

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.

Für die meisten Docker-basierten Immich-Installationen ist eine benutzerdefinierte Bridge die sauberere Standardeinstellung. Das Host-Netzwerk ist eine gezielte Ausweichlösung, kein allgemeiner Leistungsgewinn.

Immich benötigt vor allem zuverlässige Verbindungen zwischen Client und Server, Server und Datenbank, Server und Redis, Server und Machine-Learning-Modul sowie zum Reverse-Proxy. Beide Netzwerkmodi können diese bereitstellen. Entscheide anhand des tatsächlich reproduzierten Fehlers oder Zugriffsbedarfs, teste immer nur einen Modus auf einmal und behalte die Konfiguration, die sich am einfachsten überwachen und wiederherstellen lässt.

Mit den tatsächlich erforderlichen Netzwerkpfaden von Immich beginnen

Stelle den Stack als Verbindungen statt als Container dar: Clients erreichen den öffentlichen oder lokalen Immich-Endpunkt; der Proxy erreicht den Immich-Server; die Anwendung erreicht PostgreSQL und Redis; und der Server erreicht das Machine-Learning-Modul. Halte fest, welche Verbindungen innerhalb von Docker bleiben und welche die Host-Grenze überschreiten.

Eine benutzerdefinierte Bridge gibt Containern einen eigenen Netzwerk-Namespace und ermöglicht es Diensten im selben Netzwerk, einander über den Dienstnamen zu finden. Die Übersicht zu Docker-Netzwerkmodi hilft, den Unterschied zu verstehen: Freigegebene Ports bedienen Clients auf dem Host oder außerhalb davon, während Container-DNS den Datenverkehr zwischen Diensten abwickelt.

Wenn jeder erforderliche Netzwerkpfad auf einer Bridge bereits funktioniert, hat das Host-Netzwerk kein nachgewiesenes Problem gelöst. Behalte die Bridge bei und dokumentiere Dienstnamen, Netzwerke und freigegebene Ports. So lässt sich eine spätere Änderung am Proxy oder an Compose mit einer bekannten Topologie abgleichen.

Benutzerdefinierte Bridge bevorzugen, wenn Isolation und stabile Dienstnamen wichtig sind

Im Bridge-Modus können Immich-Dienste über ein ausdrücklich festgelegtes Anwendungsnetzwerk miteinander kommunizieren, ohne jeden Container-Port auf dem Host freizugeben. Das ist besonders nützlich, wenn sich ein Reverse-Proxy dasselbe Netzwerk teilt und den Immich-Dienst direkt über seinen Namen ansprechen kann. So ist man weniger auf eine Container-IP angewiesen, die sich nach einer Neuerstellung ändern kann.

Die Analyse der Vor- und Nachteile von Host-Netzwerken im Homelab stellt fest, dass der Wegfall von Docker-NAT für gewöhnlichen Webverkehr im Homelab selten einen nennenswerten Leistungsvorteil bringt. Wichtiger sind die Isolation durch Namespaces, die Portfreigabe und die Art, wie Dienste einander finden.

Der Bridge-Modus ist als Konzept nur dann ungeeignet, wenn sich ein erforderlicher Netzwerkpfad nicht abbilden lässt oder trotz Korrekturen an Netzwerk, DNS, Firewall und Proxy-Zuordnung unzuverlässig bleibt. Wechsle nicht einfach den Modus, nur weil ein Client „Server nicht erreichbar“ meldet. Weise zuerst nach, dass die Anfrage an der Docker-Grenze aufgehalten wird.

Host-Netzwerk nur bei einem konkreten, reproduzierbaren Bedarf verwenden

Im Host-Modus wird der Container im Netzwerk-Namespace des Hosts ausgeführt. Dadurch entfällt die Docker-Portübersetzung und der Dienst erhält den Netzwerkzugriff des Hosts. Das kann bestimmte Erkennungs- oder ungewöhnliche Routing-Szenarien vereinfachen, hebt aber auch die Portgrenze des Containers auf und erhöht das Risiko von Portkonflikten auf dem Host.

Ein aktueller Vergleich von Bridge- und Host-Netzwerk betrachtet Leistung, Isolation, Dienstfreigabe und Fehlersuche. Wende diese Kriterien auf den Immich-Pfad an, statt anzunehmen, dass der Host-Modus grundsätzlich zuverlässiger ist.

Wenn der Host-Modus ein Symptom behebt, wiederhole den Test zweimal und erkläre, warum. Bestätige zum Beispiel, dass derselbe Hostname, dasselbe Konto, derselbe Proxy und derselbe Client mit der Bridge scheitern und im Host-Modus funktionieren, während die Anwendungsprotokolle ansonsten keine Probleme zeigen. Lässt sich das Ergebnis nicht wiederholen, könnte der Moduswechsel lediglich DNS- oder veraltete Netzwerkzustände kaschiert haben.

Sorge für eine explizite, wiederherstellbare Route zum Reverse-Proxy

Ein Reverse-Proxy sollte Immich nach dem Neustart eines der Container über eine stabile Upstream-Konfiguration erreichen können. Verwende bei einer Bridge vorzugsweise ein gemeinsames benutzerdefiniertes Netzwerk und einen Upstream mit Dienstnamen statt einer manuell kopierten Container-IP. Im Host-Modus richtest du den Proxy auf die vorgesehene Host-Adresse und den Port und prüfst dabei auf Kollisionen.

Das Testmuster für Host versus Bridge von ZimaSpace folgt einer ähnlichen bedingten Regel: Eine einfachere Erkennung kann den Host-Modus rechtfertigen, während Isolation und explizite Proxy-Integration für eine Bridge sprechen. Immich verwendet andere Protokolle; übernimm daher die Entscheidungsmethode und nicht Plex-spezifische Portannahmen.

Starte zuerst nur den Proxy neu, dann nur Immich und anschließend den gesamten Stack. Bei einem stabilen Design funktionieren dieselben lokalen und externen Routen jedes Mal wieder, ohne dass IP-Adressen geändert werden müssen. Eine Topologie, die nach der Neuerstellung manuelle Umverdrahtung erfordert, ist nicht stabil genug - unabhängig davon, ob sie Host- oder Bridge-Netzwerk verwendet.

Wähle den Modus, der denselben Abnahmetest mit geringerem Risiko besteht

Teste die lokale Webanmeldung, die Verbindung über die mobile App, einen kleinen Upload, einen großen Upload, den Zugriff über den Reverse-Proxy, den Zustand der Kommunikation zwischen Diensten und einen vollständigen Neustart. Halte Latenzen und Fehler fest, aber gewichte winzige Durchsatzunterschiede nicht zu stark, wenn beide Modi deutlich unter der Netzwerkobergrenze bleiben.

Wähle Bridge, wenn alle Funktionen erfolgreich sind und du von expliziter Freigabe, Container-DNS und Isolation profitierst. Wähle Host, wenn ein erforderlicher Pfad auf einer korrekt konfigurierten Bridge reproduzierbar scheitert und der Host-Modus das Problem behebt, ohne Portkonflikte zu verursachen oder die Freigabe über das von dir akzeptierte Maß hinaus zu erweitern.

Wenn beide Modi auf dieselbe Weise scheitern, schalte das Netzwerk nicht weiter um. Die Ursache liegt wahrscheinlich eher bei DNS, TLS, Proxy-Headern, Authentifizierung, Firewall-Regeln, Speicher oder der Anwendung selbst. Sichere die fehlerhafte Anfrage und die Protokolle, kehre zur einfacheren, bekanntermaßen funktionierenden Topologie zurück und untersuche die nächste Schnittstelle.

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.