Community-Lösung

ZimaOS hatte Internetzugang, aber Docker-Apps konnten keine Verbindung herstellen

The ZimaOS host and App Store could reach the internet while qBittorrent and Jellyfin could not. Host mode resolved the first setup; a later user fixed an incorrect gateway and enabled IPv6 for Jellyfin.

Nach dem Wechsel des Internetanbieters und der Neuinstallation von ZimaOS stellte ein Community-Mitglied fest, dass der Host Internetseiten anpingen und App-Store-Images herunterladen konnte, während Anwendungen innerhalb von Containern keine externen Dienste erreichten. qBittorrent konnte nichts herunterladen, und Jellyfin konnte keine Metadaten abrufen.

Der ursprüngliche Fall wurde gelöst, indem die betroffenen Container von der Bridge-Netzwerkverbindung in den Host-Modus verschoben wurden. Spätere Antworten dokumentierten einen zweiten Fall mit ähnlichen Symptomen, aber einer anderen Ursache: Als Gateway war eine öffentliche WAN-Adresse eingetragen worden, und für die Jellyfin-Verbindung des Nutzers war neben IPv4 auch IPv6 erforderlich.

Host-Konnektivität bewies nicht die Konnektivität der Container

Der Autor konnte das Webterminal von ZimaOS verwenden und Apps installieren, was zeigte, dass das Betriebssystem selbst über einen funktionierenden ausgehenden Netzwerkpfad verfügte. Das bestätigte jedoch nicht, dass jedes Docker-Netzwerk korrekt geroutet wurde. Die Fehler der Apps mussten daher aus der Perspektive des Containers getestet werden, statt sie vom Host abzuleiten.

Das Zima-Teammitglied Giorgio schlug vor, die Konnektivität über einen Browser-Container zu testen und im Einstellungsbereich der Anwendung einen anderen Netzwerkmodus auszuprobieren. Der Beitrag weist außerdem darauf hin, dass Drittanbieter-Stores, YAML-Installationen und CLI-Installationen Diagnoseanwendungen bereitstellen können; diese Optionen sind jedoch keine bestätigte Voraussetzung.

ZimaOS-Anwendungseinstellungen mit der Steuerung für den Docker-Netzwerkmodus
Der Netzwerkmodus kann im Einstellungsbereich der Anwendung geändert werden.

Der Host-Modus löste den ursprünglichen Fall mit dem Bridge-Netzwerk

Der Autor verschob alle betroffenen Container in den Host-Modus und berichtete, dass der Internetzugriff daraufhin funktionierte. Der Beitrag klärt nicht, warum der Bridge-Modus nach der sauberen Installation fehlschlug. Daher sollte der Host-Modus für dieses Setup als erfolgreiche Änderung dokumentiert werden, nicht als Beleg für einen allgemeinen Fehler des Bridge-Netzwerks.

Ein späterer Teilnehmer wies auf einen wichtigen Nebeneffekt hin: Nach dem Wechsel des Modus kann der Dashboard-Link weiterhin auf den zuvor veröffentlichten Host-Port verweisen. Bei Jellyfin musste der Teilnehmer direkt Port 8096 aufrufen, nachdem das Dashboard weiterhin Port 8097 öffnete.

Anwendungsseite nach dem Wechsel eines Containers zum Host-Netzwerk
Der spätere Nutzer erreichte nach der Änderung des Netzwerkmodus zunächst die falsche Adresse.

Ein späterer Fall offenbarte ein falsches Gateway

Die Jellyfin-Protokolle des zweiten Nutzers enthielten beim Kontakt mit einem externen Metadatendienst No route to host. Community-Mitglieder empfahlen, den Test ohne VPN durchzuführen und das in den Netzwerkeinstellungen von ZimaOS angezeigte Gateway zu überprüfen.

Ein Screenshot zeigte, dass als Gateway die öffentliche WAN-Adresse des Nutzers konfiguriert war. Die Antworten erklärten, dass stattdessen die lokale Router-Adresse im selben LAN-Subnetz verwendet werden müsse. Der Nutzer korrigierte das Gateway und aktivierte in Jellyfin zusätzlich zu IPv4 auch IPv6, da die AT&T-Verbindung IPv6 bevorzugte. Anschließend bestätigte der Nutzer, dass der Abruf von Metadaten und Bildern funktionierte.

ZimaOS-Netzwerkeinstellungen mit dem von der Community untersuchten Gateway-Wert
Das Gateway-Feld lenkte die Untersuchung vom Container-Image auf das Routing des Hosts.
ZimaOS-App-Menü zum Öffnen der Container-Einstellungen und des Terminals
Über dieses App-Menü gelangt man zu den Einstellungen und zur containerbezogenen Diagnose.

Die beiden Ergebnisse der Community getrennt betrachten

  • Ursprünglicher Fall aus Oktober 2025: Das Bridge-Netzwerk funktionierte für die Container des Autors nicht; der Host-Modus stellte den Zugriff wieder her.
  • Nachfolgender Fall aus Januar 2026: Als Gateway war eine öffentliche IP-Adresse konfiguriert, und Jellyfin musste für diesen ISP-Netzwerkpfad zusätzlich mit aktiviertem IPv6 betrieben werden.

Beide Fälle führten zum allgemeinen Symptom „Apps können nicht auf das Internet zugreifen“, hatten jedoch keine nachgewiesene gemeinsame Ursache. Der Beitrag unterstützt daher die getrennte Prüfung von Netzwerkmodus, nach einer Modusänderung verwendeter Adresse, Gateway-Konfiguration, VPN-Einfluss und verfügbarer Protokolle.

FAQ

Warum kann ZimaOS Apps herunterladen, während ein Container offline bleibt?

Der Host und ein Docker-Container können unterschiedliche Routing- und Netzwerkkonfigurationen verwenden. Im ursprünglichen Fall blieb die Konnektivität des Hosts intakt, während Anwendungen im Bridge-Netzwerk fehlschlugen.

Bleibt beim Wechsel von Jellyfin in den Host-Modus der alte Dashboard-Port erhalten?

Nicht unbedingt. Ein Teilnehmer stellte fest, dass das Dashboard weiterhin auf Port 8097 verwies, während Jellyfin im Host-Modus direkt über Port 8096 erreichbar war.