Communityoplossing

ZimaOS had internettoegang, maar Docker-apps konden geen verbinding maken

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.

Na het wijzigen van internetprovider en het opnieuw installeren van ZimaOS ontdekte een communitylid dat de host internetsites kon pingen en afbeeldingen uit de App Store kon downloaden, terwijl applicaties in containers geen externe services konden bereiken. qBittorrent kon niet downloaden en Jellyfin kon geen metadata ophalen.

De oorspronkelijke kwestie werd opgelost door de getroffen containers van bridgenetwerken naar de hostmodus te verplaatsen. Latere reacties beschreven een tweede geval met vergelijkbare symptomen, maar een andere oorzaak: als gateway was een openbaar WAN-adres ingevoerd en de verbinding van de gebruiker vereiste voor Jellyfin naast IPv4 ook IPv6.

Connectiviteit van de host bewees niet dat containers verbinding hadden

De auteur kon de webterminal van ZimaOS gebruiken en apps installeren, wat aantoonde dat het besturingssysteem zelf een werkende uitgaande verbinding had. Dat betekende niet dat elk Docker-netwerk correct was gerouteerd. De problemen met de apps moesten daarom vanuit de container worden getest en mochten niet alleen uit de connectiviteit van de host worden afgeleid.

Zima-teamlid Giorgio stelde voor om de connectiviteit via een browsercontainer te testen en een andere netwerkmodus uit te proberen in het instellingenpaneel van de applicatie. In het bericht staat ook dat externe stores, YAML-installatie en installatie via de CLI diagnostische applicaties kunnen leveren, maar dat dit opties zijn en geen bevestigde vereisten.

ZimaOS-applicatie-instellingen met de optie voor de Docker-netwerkmodus
De netwerkmodus kan worden gewijzigd in het instellingenpaneel van de applicatie.

De hostmodus loste het oorspronkelijke geval met bridgenetwerken op

De auteur verplaatste alle getroffen containers naar de hostmodus en meldde dat internettoegang daarna werkte. In de thread wordt niet vastgesteld waarom de bridgemodus na de schone installatie niet werkte. De hostmodus moet daarom voor deze configuratie als de geslaagde wijziging worden beschouwd, niet als bewijs van een universeel probleem met bridgenetwerken.

Een latere deelnemer wees op een belangrijk neveneffect: na het wijzigen van de modus kan de dashboardlink nog steeds naar de oude gepubliceerde hostpoort verwijzen. Bij Jellyfin moest de deelnemer rechtstreeks naar poort 8096 gaan, omdat het dashboard nog steeds poort 8097 opende.

Applicatiepagina die wordt weergegeven nadat een container naar hostnetwerken is overgeschakeld
De latere gebruiker kwam na het wijzigen van de netwerkmodus aanvankelijk op het verkeerde adres uit.

Een later geval bracht een onjuiste gateway aan het licht

De Jellyfin-logs van de tweede gebruiker bevatten No route to host tijdens het verbinden met een externe metadataservice. Communityleden adviseerden om zonder de VPN te testen en de gateway in de netwerkinstellingen van ZimaOS te controleren.

Op een screenshot bleek dat de geconfigureerde gateway het openbare WAN-adres van de gebruiker was. In de reacties werd uitgelegd dat de gateway het adres van de lokale router op hetzelfde LAN-subnet moest zijn. De gebruiker corrigeerde de gateway en schakelde in Jellyfin naast IPv4 ook IPv6 in, omdat de AT&T-verbinding de voorkeur gaf aan IPv6. Daarna bevestigde de gebruiker dat metadata en afbeeldingen weer konden worden opgehaald.

ZimaOS-netwerkinstellingen met de gatewaywaarde die door de community werd onderzocht
Het gatewayveld verlegde het onderzoek van de containerimage naar de routering van de host.
ZimaOS-appmenu waarmee containerinstellingen en de terminal kunnen worden geopend
Via dit appmenu konden de instellingen en diagnostische functies op containerniveau worden geopend.

Houd de twee communityresultaten gescheiden

  • Oorspronkelijk geval uit oktober 2025: bridgenetwerken werkten niet voor de containers van de auteur; de hostmodus herstelde de toegang.
  • Vervolggeval uit januari 2026: de gateway was ingesteld als openbaar IP-adres en Jellyfin moest voor deze internetverbinding ook IPv6 ingeschakeld hebben.

Beide gevallen hadden het brede symptoom “apps kunnen geen verbinding maken met internet”, maar ze hadden niet één bewezen onderliggende oorzaak gemeen. De thread ondersteunt het afzonderlijk controleren van de netwerkmodus, het adres dat na een moduswijziging wordt gebruikt, de gatewayconfiguratie, de invloed van de VPN en de beschikbaarheid van protocollen.

Veelgestelde vragen

Waarom kan ZimaOS apps downloaden terwijl een container offline blijft?

De host en een Docker-container kunnen verschillende routerings- en netwerkconfiguraties gebruiken. In het oorspronkelijke geval bleef de connectiviteit van de host intact, terwijl applicaties via het bridgenetwerk geen verbinding konden maken.

Behoudt Jellyfin de oude dashboardpoort wanneer het naar de hostmodus wordt gewijzigd?

Niet noodzakelijk. Een deelnemer ontdekte dat het dashboard nog steeds naar poort 8097 verwees, terwijl Jellyfin in de hostmodus rechtstreeks bereikbaar was via poort 8096.