Sollte Home Assistant ein Host-Netzwerk oder ein Bridge-Netzwerk verwenden?

Eva Wong ist die Technische Redakteurin und und leidenschaftliche Tüftlerin bei ZimaSpace. Eine lebenslange Geek mit einer Leidenschaft für Homelabs und Open-Source-Software, sie spezialisiert sich darauf, komplexe technische Konzepte in zugängliche, praktische Anleitungenzu übersetzen. Eva ist der Meinung, dass Self-Hosting Spaß machen und nicht einschüchternd sein sollte. Durch ihre Tutorials befähigt sie die Community, Hardware-Setups zu entmystifizieren, vom Bau ihres ersten NAS bis hin zur Beherrschung von Docker-Containern.

Home Assistant sollte das Host-Netzwerk verwenden, wenn die Erkennung im LAN zwingend erforderlich ist; das Bridge-Netzwerk ist besser, wenn explizite Ports und Isolation wichtiger sind.

Keine der beiden Betriebsarten ist grundsätzlich schneller oder sicherer. Die Wahl bestimmt, welchen Netzwerk-Namespace Home Assistant sieht, wie Multicast- und Broadcast-Erkennung es erreichen, welche Ports Sie veröffentlichen und wie andere Container eine Verbindung herstellen. Entscheiden Sie anhand der Integrationen, die nach einem Neustart funktionieren müssen, und testen Sie anschließend die Erkennung, direkte Steuerung, MQTT- oder Funk-Gateways sowie den externen Zugriff über die gewählte Betriebsart, bevor Sie die Konfiguration als stabil betrachten.

Prüfen Sie zunächst, ob Home Assistant Datenverkehr zur Erkennung im LAN empfangen muss

Viele Home-Assistant-Integrationen können eine bekannte IP-Adresse oder eine Broker-Verbindung verwenden, andere sind jedoch auf mDNS, SSDP, UPnP oder Broadcast-Erkennung angewiesen. Diese Protokolle sind der Hauptgrund, warum das Host-Netzwerk bei Container-Installationen häufig verwendet wird: Home Assistant nimmt direkt am LAN-Namespace des Hosts teil, statt eine Multicast-Weiterleitung über eine Docker-Bridge zu benötigen.

Ein Leitfaden zur Docker-Netzwerkverwaltung erklärt, dass das Host-Netzwerk die Bridge-Grenze entfernt. Dadurch werden Broadcast-basierte Dienste einfacher, zugleich entfallen jedoch die Veröffentlichung von Docker-Ports und die Trennung der Netzwerk-Namespaces. Für die meisten Home-Assistant-Installationen ist dieser Zielkonflikt wichtiger als der reine Datendurchsatz.

Listen Sie die Integrationen auf, die tatsächlich eine Erkennung benötigen. Wenn jedes kritische Gerät explizite Adressen, MQTT, Zigbee über einen zugeordneten Koordinator oder einen anderen klar definierten Endpunkt verwendet, kann der Bridge-Modus problemlos funktionieren. Wenn mehrere Integrationen von lokaler Erkennung abhängen und Sie keine Multicast-Relays pflegen möchten, ist der Host-Modus normalerweise die einfachere Betriebsentscheidung.

Das Host-Netzwerk ist geeignet, wenn eine einfache Erkennung wichtiger ist als die Isolation des Namespace

Im Host-Modus bindet Home Assistant direkt an den Netzwerk-Stack des Hosts. Es gibt keine Docker-Port-Mapping-Schicht, und der Container sieht die Schnittstellen des Hosts auf eine Weise, die normalerweise besser mit der lokalen Erkennung übereinstimmt. Der Nachteil besteht in einer schwächeren Netzwerkisolation; außerdem müssen Portkonflikte auf Host-Ebene verwaltet werden.

Ein Leitfaden zur Planung eines Home-Assistant-Docker-Designs kommt zum gleichen bedingten Ergebnis: der Host-Modus vereinfacht die mDNS- und UPnP-Erkennung, während der Bridge-Modus Netzwerkgrenzen und veröffentlichte Ports expliziter macht.

Wählen Sie den Host-Modus, wenn Erkennungsfehler wiederholt auftreten und der Server ein vertrauenswürdiger Heimserver mit einer kontrollierten Anzahl von Diensten ist. Verwenden Sie den Host-Modus nicht einfach, um einen unbekannten Verbindungsfehler zu verbergen. Wenn ein Gerät auch mit Host-Netzwerk weiterhin nicht funktioniert, kann die Ursache in VLAN-Regeln, WLAN-Client-Isolation, lokalem DNS, Geräteberechtigungen oder einem Problem auf Integrationsebene liegen und nicht in der Docker-Bridge.

Das Bridge-Netzwerk ist geeignet, wenn Integrationen explizit erreichbar sind

Der Bridge-Modus weist dem Container eine private Docker-Adresse zu und ermöglicht es Ihnen, nur die Home-Assistant-Ports zu veröffentlichen, die erreichbar sein sollen. Andere Container können über benannte Docker-Netzwerke kommunizieren, während Geräte im LAN den veröffentlichten Host-Port erreichen. Dies bildet eine sauberere Grenze, wenn die Erkennung nicht unverzichtbar ist oder Sie Multicast-Datenverkehr gezielt weiterleiten.

Home-Assistant-Nutzer, die Bridge- und macvlan-Konfigurationen vergleichen, berichten, dass eine einfache Bridge mDNS erschweren kann, während alternative Netzwerkdesigns die direkte Sichtbarkeit im LAN wiederherstellen. Die nützliche Erkenntnis aus der Diskussion über das Erkennungsverhalten im Bridge-Netzwerk besteht darin, das benötigte Protokoll zu testen, statt anzunehmen, dass veröffentlichte TCP-Ports auch Multicast-Erkennung übertragen.

Wählen Sie den Bridge-Modus, wenn die erforderlichen Geräte über eine explizite IP-Adresse, einen Hostnamen, einen Broker oder einen zugeordneten Hardwarepfad erreichbar sind und Sie engere Grenzen zwischen den Diensten wünschen. Wenn eine Integration nur deshalb fehlschlägt, weil sie ein Gerät im LAN nicht erkennen kann, versuchen Sie zunächst, den Endpunkt explizit zu konfigurieren. Wechseln Sie erst dann zum Host-Modus oder zu einem fortgeschritteneren Netzwerk, wenn die Integration dieses Erkennungsverhalten tatsächlich benötigt.

-15% OFF

Überprüfen Sie die Entscheidung nach einem Neustart anhand derselben Integrationsmatrix

Erstellen Sie einen Test mit fünf Zeilen: Zugriff auf das lokale Dashboard, ein mDNS- oder SSDP-Gerät, eine Integration mit expliziter IP-Adresse, ein Broker- oder Funk-Gateway sowie der normale Pfad über Reverse-Proxy oder VPN. Testen Sie nach einer Neuerstellung des Containers und nach einem Neustart des Hosts, nicht nur unmittelbar nach der Änderung von Compose, da zwischengespeicherte Erkennungsdaten einen Netzwerkmodus verbergen können, der später fehlschlägt.

Die Fehlerbehebung von ZimaSpace bei der Erreichbarkeit von Docker-Subnetzen zeigt dieselbe Grenze: Die Verfügbarkeit einer Anwendung und die Erreichbarkeit eines Containernetzwerks sind unterschiedliche Prüfungen, selbst wenn sich beide auf demselben physischen Server befinden.

Behalten Sie den Host-Modus bei, wenn er die erforderliche Erkennung zuverlässig gewährleistet und Sie den gemeinsam genutzten Namespace akzeptieren. Behalten Sie den Bridge-Modus bei, wenn jede erforderliche Integration erreichbar bleibt und die explizite Grenze die betriebliche Unklarheit verringert. Wenn keine der beiden Varianten erfolgreich ist, wechseln Sie nicht weiter zwischen den Modi, sondern prüfen Sie VLAN-Routing, Multicast-Weiterleitung, Firewall-Regeln oder den Integrationstransport selbst; der Netzwerkmodus ist nur eine Ebene des gesamten Pfads.

Support & 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.