Communityoplossing

btop op ZimaOS 1.6.1 toont alleen eth0: ingebouwde monitor versus Docker-netwerknaamruimte

An April-May 2026 thread where a user with motherboard 1GbE plus a 10GbE expansion NIC could see eth1 in ZimaOS but not in their btop environment. Other users showed the built-in host btop cycling through eth0, eth1, libvirt, docker0, and veth interfaces. Community replies attributed the difference to host versus Docker network visibility, but the original poster never confirmed a working fix.

De bron lijkt op een configuratieprobleem van btop, maar combineert in werkelijkheid twee verschillende uitvoeringsomgevingen. ZimaOS heeft sinds versie 1.3.3 een ingebouwd btop-prestatiepaneel. Daarnaast kunnen gebruikers een btop-container uit een App Store installeren. Een container ziet normaal gesproken zijn eigen netwerknaamruimte, terwijl btop op de host de interfaces kan zien die aan de host zijn blootgesteld.

Dat onderscheid verklaart waarom één deelnemer kon schakelen tussen eth0, eth1, virbr0, docker0, en verschillende veth interfaces, terwijl de btop van de oorspronkelijke poster alleen lo en eth0. De thread eindigde nog steeds niet met een bevestigde reparatie voor de exacte configuratie van de poster.

ZimaOS zelf gebruikte de 10GbE-interface

Netwerkwidget van ZimaOS waarop eth1 actief is op de 10GbE-uitbreidingsinterface
Het probleem was niet dat ZimaOS de tweede NIC niet herkende.

btop werd toegevoegd als ingebouwd prestatiepaneel in ZimaOS

IceWhale introduceerde het ingebouwde btop-paneel in ZimaOS 1.3.3. Gebruikers van nu moeten er daarom niet van uitgaan dat ze een afzonderlijke btop-container moeten installeren voor eenvoudige systeembewaking.

Zie de officiële afbakening van de ingebouwde btop-functie.

Een voorbeeld van btop op de host liet meerdere fysieke en virtuele interfaces zien

Ingebouwde btop in ZimaOS met systeemprocessen, schijven en een selector voor hostnetwerkinterfaces
De ingebouwde btop van een andere gebruiker kon schakelen tussen NIC's op de host, libvirt-, Docker- en veth-interfaces.

Een Docker-btop ziet alleen de netwerknaamruimte die eraan is toegewezen

Reacties uit de community legden uit dat een btop-container uit de App Store mogelijk alleen zijn eigen containernetwerk ziet. Dat is normaal Docker-gedrag: de applicatie kan hostinterfaces die niet aan zijn naamruimte zijn blootgesteld, niet monitoren.

De interfaceselector van btop kan een ontbrekende interface niet creëren

btop-optiescherm met de instelling voor het selecteren van de aanvankelijk gebruikte netwerkinterface
De btop-instelling kan kiezen uit interfaces die al zichtbaar zijn; deze kan Docker niet dwingen een verborgen NIC van de host beschikbaar te maken.

Het selecteren van Docker-hostnetwerken liet de bronapplicatie crashen of stoppen

De oorspronkelijke poster zei dat het overschakelen van de btop-container uit de App Store naar hostnetwerken het probleem niet oploste, omdat btop niet meer werkte. De poster overwoog ook om SYS_PTRACE of SYS_ADMIN.

De thread bevestigt die wijzigingen in rechten niet. Ze mogen daarom niet alleen worden aanbevolen om één statistiekpaneel zichtbaar te maken.

Het binaire bestand van btop op de host bestond wel, maar volgens de bron werkte het niet

ZimaOS-SSH-terminal waarin wordt weergegeven dat btop wordt gevonden via /usr/bin/btop
Het binaire bestand op de host bestond wel, maar de oorspronkelijke poster meldde nog steeds problemen bij het starten of gebruiken ervan.

De thread bevat geen bevestigde definitieve oplossing

Geen antwoord van IceWhale-medewerkers in de bron maakt duidelijk of de ingebouwde btop van de poster beschadigd was, door een eerdere handmatige installatie werd beïnvloed of te maken had met een afzonderlijke bug in versie 1.6.1.

Een veiligere huidige aanpak

  1. Gebruik eerst het ingebouwde ZimaOS-btop-paneel.
  2. Bevestig met de huidige netwerkhulpmiddelen van de host dat de NIC bestaat.
  3. Als je een containergebaseerde monitor gebruikt, begrijp dan de netwerknaamruimte ervan.
  4. Vermijd escalatie naar privileged/SYS_ADMIN uitsluitend voor metrieken.
  5. Als het ingebouwde btop niet werkt, verzamel dan de huidige versie en de directe CLI-fout in plaats van herhaaldelijk een tweede btop-pakket opnieuw te installeren.

De zwarte btop-pagina en de ontbrekende eth1 zijn twee afzonderlijke symptomen

In het begin van de thread zei de oorspronkelijke vraagsteller dat het ingebouwde btop-dashboard een zwart scherm opende. Later richtte diegene zich op een btop in de App Store/container, die wel draaide maar alleen lo en eth0. Deze oorzaken mogen niet op één hoop worden gegooid.

Een mislukt ingebouwd paneel kan betrekking hebben op de btop/ttyd-sessie van de host, terwijl ontbrekende hostinterfaces binnen een Docker-monitor te verwachten zijn door isolatie van naamruimten.

Een hoge of veranderende btop-poort is niet automatisch de hoofdoorzaak

ZimaOS start sommige terminalachtige hulpprogramma's via websessies. Een poort- of verbindingsfout in de browser bewijst niet dat de fysieke NIC verkeerd is geconfigureerd. Voer eerst de hostopdracht rechtstreeks uit en leg de exacte fout vast.

Meer containerprivileges zijn geen gratis oplossing voor monitoring

Toevoegen van SYS_ADMIN, brede toegang tot apparaten of volledige geprivilegieerde modus kunnen veel meer van de host blootleggen dan btop nodig heeft. Zelfs network_mode: host verandert het isolatiemodel van de container.

Voor systeemtelemetrie verdient een geïntegreerde hostmonitor de voorkeur boven het verlenen van bijna-hostprivileges aan een container uit de App Store, alleen zodat die elke interface kan opsommen.

Controleer eth1 op de host voordat je btop de schuld geeft

Controleer de huidige ZimaOS-netwerkpagina of de netwerkopdrachten van de host en bevestig dat de 10GbE-interface actief is, het verwachte adres heeft en verkeer verwerkt. De bron heeft dit met succes gedaan: ZimaOS zelf toonde de interface en gebruikte deze. eth1.

Als hostnetwerken de interface wel ziet, maar alleen de container niet, ligt de grens bij de monitoringomgeving, niet bij het NIC-stuurprogramma.

Behandel een defecte ingebouwde btop op de huidige ZimaOS als een nieuwe regressie

De bron gebruikte versie 1.6.1, terwijl de huidige ZimaOS-versie 1.7.1 is. Als het ingebouwde paneel vandaag nog steeds zwart is, noteer dan de huidige versie, CPU-architectuur, directe btop uitvoer, fouten in de browserconsole/-sessie en of herstel of herinstallatie iets verandert. Ga er niet van uit dat de thread uit april 2026 een huidige storing al verklaart.

Veelgestelde vragen over btop-netwerken

Kan btop eth1 selecteren als eth1 niet zichtbaar is in zijn naamruimte?

Nee. De selector schakelt alleen tussen interfaces die het actieve proces kan zien.

Heeft een andere gebruiker bevestigd dat de ingebouwde btop eth1 kon zien?

Ja. James meldde dat hij op host-btop tussen de interfaces eth0, eth1, libvirt, Docker en veth wisselde.

Heeft de bron een veilige oplossing voor Docker-privileges bevestigd?

Nee. Hostnetwerken en aanvullende mogelijkheden zijn besproken, maar er is geen definitieve werkende configuratie geverifieerd.