Sollte Immich das Host-Netzwerk oder ein Bridge-Netzwerk verwenden?
Für die meisten Docker-basierten Immich-Bereitstellungen ist ein benutzerdefiniertes Bridge-Netzwerk die sauberere Standardwahl; Host-Netzwerk ist eine gezielte Umgehungslösung und kein allgemeines Leistungsupgrade.
Immich benötigt hauptsächlich zuverlässige Verbindungen zwischen Client und Server, Server und Datenbank, Server und Redis, Server und maschinellem Lernen sowie zwischen Server und Reverse-Proxy. Beide Netzwerkmodi können diese Verbindungen bereitstellen. Die Wahl sollte getroffen werden, indem der tatsächliche Fehler oder die konkrete Zugriffsanforderung reproduziert, jeweils nur ein Modus getestet und die Konfiguration beibehalten wird, die sich am einfachsten beobachten und wiederherstellen lässt.
Beginnen Sie mit den Verbindungen, die Immich tatsächlich benötigt
Stellen Sie den Stack als Verbindungen und nicht 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 maschinelle Lernen. Notieren Sie, welche Verbindungen innerhalb von Docker bleiben und welche die Host-Grenze überschreiten.
Ein benutzerdefiniertes Bridge-Netzwerk gibt Containern ihren eigenen Netzwerk-Namespace und ermöglicht gleichzeitig, dass sich Dienste im selben Netzwerk über ihren Dienstnamen gegenseitig auflösen. Die Übersicht zur Docker-Netzwerkverwaltung ist für diese Unterscheidung hilfreich: Veröffentliche Ports bedienen den Host oder externe Clients, während Container-DNS den Datenverkehr zwischen Diensten übernimmt.
Wenn jeder erforderliche Pfad über ein Bridge-Netzwerk bereits funktioniert, hat das Host-Netzwerk kein nachgewiesenes Problem gelöst. Behalten Sie das Bridge-Netzwerk bei und dokumentieren Sie Dienstnamen, Netzwerke und veröffentlichte Ports, damit eine spätere Proxy- oder Compose-Änderung mit einer bekannten Topologie abgeglichen werden kann.
Bevorzugen Sie ein benutzerdefiniertes Bridge-Netzwerk, wenn Isolation und stabile Dienstnamen wichtig sind
Der Bridge-Modus ermöglicht die Kommunikation der Immich-Dienste über ein ausdrücklich definiertes Anwendungsnetzwerk, ohne jeden Container-Port auf dem Host offenzulegen. Das ist besonders nützlich, wenn ein Reverse-Proxy dasselbe Netzwerk verwendet und den Immich-Dienst direkt über seinen Dienstnamen ansprechen kann. Dadurch verringert sich die Abhängigkeit von einer Container-IP, die sich nach einer Neuerstellung ändern kann.
Die Homelab-Analyse zu den Abwägungen beim Host-Netzwerk weist darauf hin, dass der Wegfall von Docker-NAT für gewöhnlichen Webverkehr im Homelab selten einen nennenswerten Leistungsgewinn bringt. Die wichtigeren Unterschiede betreffen die Namespace-Isolation, die Veröffentlichung von Ports und die Art, wie Dienste einander finden.
Der Bridge-Modus ist erst dann konzeptionell ungeeignet, wenn ein erforderlicher Pfad nicht abgebildet werden kann oder unzuverlässig bleibt, nachdem Netzwerk, DNS, Firewall und Proxy-Zugehörigkeit korrigiert wurden. Wechseln Sie nicht einfach deshalb den Modus, weil ein Client „Server nicht erreichbar“ meldet; weisen Sie zunächst nach, dass die Anfrage tatsächlich an der Docker-Grenze hängen bleibt.
Verwenden Sie das Host-Netzwerk nur für eine konkrete, reproduzierbare Anforderung
Der Host-Modus platziert den Container im Netzwerk-Namespace des Hosts. Dadurch entfällt die Docker-Portübersetzung und der Dienst erhält den Netzwerkkontext des Hosts. Das kann bestimmte Erkennungs- oder ungewöhnliche Routing-Szenarien vereinfachen, entfernt jedoch auch die Portgrenze auf Containerebene und erhöht die Wahrscheinlichkeit von Konflikten mit bereits belegten Host-Ports.
Ein aktueller Vergleich von Bridge- und Host-Netzwerken stellt die Wahl anhand von Leistung, Isolation, Dienstfreigabe und Fehlerbehebung dar. Wenden Sie diese Kriterien auf den Immich-Pfad an, anstatt anzunehmen, dass der Host-Modus grundsätzlich zuverlässiger ist.
Wenn der Host-Modus ein Symptom behebt, wiederholen Sie den Test zweimal und erklären Sie den Grund. Bestätigen Sie beispielsweise, dass derselbe Hostname, dasselbe Konto, derselbe Proxy und derselbe Client im Bridge-Modus scheitern und im Host-Modus funktionieren, während die Anwendungsprotokolle ansonsten fehlerfrei bleiben. Lässt sich das Ergebnis nicht wiederholen, hat die Modusänderung möglicherweise lediglich einen DNS- oder veralteten Netzwerkzustand verborgen.
Halten Sie den Reverse-Proxy auf einer expliziten, wiederherstellbaren Route
Ein Reverse-Proxy sollte Immich nach jedem Neustart der Container über eine stabile Upstream-Definition erreichen können. Verwenden Sie im Bridge-Modus bevorzugt ein gemeinsames benutzerdefiniertes Netzwerk und einen Upstream über den Dienstnamen statt einer manuell kopierten Container-IP. Richten Sie den Proxy im Host-Modus auf die vorgesehene Host-Adresse und den vorgesehenen Port und prüfen Sie dabei mögliche Konflikte.
Das Testmuster für Host- und Bridge-Netzwerke von ZimaSpace verwendet eine vergleichbare bedingte Regel: Eine einfachere Diensterkennung kann den Host-Modus rechtfertigen, während Isolation und eine explizite Proxy-Integration für ein Bridge-Netzwerk sprechen. Immich verwendet andere Protokolle; übernehmen Sie daher die Entscheidungsmethode und nicht Plex-spezifische Portannahmen.
Starten Sie zuerst nur den Proxy neu, dann nur Immich und anschließend den gesamten Stack. Eine funktionierende Konfiguration stellt jedes Mal dieselben lokalen und entfernten Routen wieder her, ohne dass IP-Adressen bearbeitet werden müssen. Eine Topologie, die nach einer Neuerstellung manuell neu verdrahtet werden muss, ist nicht stabil genug – unabhängig davon, ob sie das Host- oder Bridge-Netzwerk verwendet.
Wählen Sie den Modus, der denselben Abnahmetest mit geringerem Risiko besteht
Testen Sie die lokale Webanmeldung, die Verbindung mit der mobilen App, einen kleinen Upload, einen großen Upload, den Zugriff über den Reverse-Proxy, den Zustand der Kommunikation zwischen den Diensten und einen vollständigen Neustart. Erfassen Sie Latenzen und Fehler, gewichten Sie jedoch geringfügige Durchsatzunterschiede nicht übermäßig, wenn beide Modi deutlich unter der Netzwerkgrenze bleiben.
Wählen Sie das Bridge-Netzwerk, wenn alle Funktionen bestehen und Sie von expliziter Freigabe, Container-DNS und Isolation profitieren. Wählen Sie den Host-Modus, wenn ein erforderlicher Pfad in einem korrekt konfigurierten Bridge-Netzwerk reproduzierbar fehlschlägt und der Host-Modus ihn behebt, ohne Portkonflikte zu verursachen oder die Freigabe über das von Ihnen akzeptierte Maß hinaus zu erweitern.
Wenn beide Modi auf dieselbe Weise fehlschlagen, hören Sie auf, zwischen den Netzwerkmodi umzuschalten. Die Ursache liegt dann eher bei DNS, TLS, Proxy-Headern, Authentifizierung, Firewall, Speicher oder der Anwendung selbst. Bewahren Sie die fehlerhafte Anfrage und die Protokolle auf, kehren Sie zur einfacheren, bekannten funktionierenden Topologie zurück und untersuchen Sie die nächste Grenze.
Empfohlene Produkte
Support & Tipps
Mehr zum Lesen
So optimieren Sie Immich-Datenbankverbindungen für gleichzeitig ausgeführte Container
Erhöhen Sie max_connections nicht als Erstes. Messen Sie die Immich-Sitzungen, summieren Sie den Bedarf aller Container, halten Sie Kapazitäten für die Administration frei und...
So verhindern Sie doppelte Jobs oder Importe in Immich
Trennen Sie wiederholte Aufträge von doppelten Assets. Verwenden Sie einen einzigen kanonischen Aufnahmeweg, kontrollieren Sie Wiederholungsversuche und Pfadänderungen und testen Sie anschließend den erneuten...
So reparieren Sie Immich, nachdem das Datenbank-Volume vollgelaufen ist
Löschen Sie niemals PostgreSQL-WAL-Dateien, um Speicherplatz freizugeben. Stoppen Sie Schreibvorgänge von Immich, bewahren Sie den Datenbankstatus, schaffen Sie sicheren zusätzlichen Speicherplatz, stellen Sie PostgreSQL...
