Solution communautaire

btop sur ZimaOS 1.6.1 n’affiche que eth0 : moniteur intégré contre espace de noms réseau Docker

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.

La source ressemble à un problème de configuration de btop, mais elle mélange en réalité deux environnements d’exécution différents. ZimaOS dispose d’un panneau de performances btop intégré depuis la version 1.3.3. Par ailleurs, les utilisateurs peuvent installer un conteneur btop depuis l’App Store. Un conteneur ne voit normalement que son propre espace de noms réseau, tandis que btop exécuté sur l’hôte peut voir les interfaces exposées à l’hôte.

Cette distinction explique pourquoi un participant pouvait parcourir eth0, eth1, virbr0, docker0, ainsi que plusieurs interfaces veth interfaces, alors que le btop de l’auteur d’origine ne proposait que lo et eth0. Le fil ne s’est toutefois pas conclu par une réparation confirmée pour la configuration exacte de l’auteur.

ZimaOS utilisait bien l’interface 10 GbE

Widget réseau de ZimaOS montrant eth1 active sur l’interface d’extension 10 GbE
Le problème ne venait pas du fait que ZimaOS ne reconnaissait pas la deuxième carte réseau.

btop a été ajouté comme panneau de performances intégré à ZimaOS

IceWhale a introduit le panneau btop intégré dans ZimaOS 1.3.3. Les utilisateurs actuels ne devraient donc pas supposer qu’ils doivent installer un conteneur btop distinct uniquement pour obtenir une surveillance système de base.

Voir le périmètre officiel de la fonctionnalité btop intégrée.

Un exemple de btop sur l’hôte montrait plusieurs interfaces physiques et virtuelles

btop intégré à ZimaOS affichant les processus système, les disques et un sélecteur d’interface réseau de l’hôte
Le btop intégré d’un autre utilisateur pouvait parcourir les interfaces réseau de l’hôte, de libvirt, de Docker et de veth.

Un btop Docker ne voit que l’espace de noms réseau qui lui est attribué

Les réponses de la communauté ont expliqué qu’un conteneur btop de l’App Store peut ne voir que son propre réseau de conteneur. C’est un comportement normal de Docker : l’application ne peut pas surveiller les interfaces de l’hôte qui ne sont pas exposées dans son espace de noms.

Modifier le sélecteur d’interface de btop ne peut pas créer une interface manquante

Écran des options de btop montrant le réglage initial de sélection de l’interface réseau
Le réglage de btop peut choisir parmi les interfaces qu’il voit déjà ; il ne peut pas rendre visible une interface réseau de l’hôte masquée par Docker.

La sélection du réseau de l’hôte Docker a fait planter ou a arrêté l’application source

L’auteur d’origine a indiqué que le passage du conteneur btop de l’App Store au réseau de l’hôte n’avait pas résolu le problème, car btop avait cessé de fonctionner. Il a également envisagé d’ajouter SYS_PTRACE ou SYS_ADMIN.

Le fil ne valide pas ces modifications des privilèges ; elles ne devraient donc pas être recommandées uniquement pour afficher un panneau de statistiques.

Le binaire btop de l’hôte existait, mais la source indiquait qu’il ne fonctionnait pas

Terminal SSH de ZimaOS montrant que l’exécution de btop renvoie /usr/bin/btop
Le binaire de l’hôte existait, mais l’auteur d’origine signalait toujours des problèmes pour le lancer ou l’utiliser.

Le fil ne contient pas de correctif final confirmé

Aucune réponse du personnel d’IceWhale dans la source n’établit si le btop intégré de l’auteur avait été corrompu, affecté par une installation manuelle antérieure ou touché par un bug distinct de la version 1.6.1.

Une approche actuelle plus sûre

  1. Utilisez d’abord le panneau btop intégré de ZimaOS.
  2. Confirmez l’existence de la carte réseau avec les outils réseau actuels de l’hôte.
  3. Si vous utilisez un outil de supervision conteneurisé, tenez compte de son espace de noms réseau.
  4. Évitez d’augmenter les privilèges, notamment SYS_ADMIN, uniquement pour obtenir des métriques.
  5. Si btop intégré ne fonctionne pas, recueillez la version actuelle et l’erreur directe de l’interface de ligne de commande au lieu de réinstaller sans cesse un second paquet btop.

La page btop noire et l’absence d’eth1 sont deux symptômes distincts

Au début du fil, l’auteur du message initial a indiqué que le btop du tableau de bord intégré s’ouvrait sur un écran noir. Plus tard, il s’est concentré sur un btop de l’App Store ou du conteneur qui fonctionnait, mais n’affichait que lo et eth0. Ces éléments ne doivent pas être réduits à une seule cause.

Un panneau intégré défaillant peut impliquer la session btop/ttyd de l’hôte, tandis que l’absence d’interfaces de l’hôte dans un outil de supervision Docker est attendue en raison de l’isolation de l’espace de noms.

Un port btop élevé ou variable n’est pas automatiquement la cause première

ZimaOS lance certains outils de type terminal via des sessions web. Voir une erreur de port ou de connexion dans le navigateur ne prouve pas que la carte réseau physique est mal configurée. Exécutez d’abord la commande directement sur l’hôte et capturez son erreur exacte.

Davantage de privilèges au conteneur n’est pas une solution de supervision gratuite

Ajouter SYS_ADMIN, un accès étendu aux périphériques ou le mode entièrement privilégié peuvent exposer une bien plus grande partie de l’hôte que nécessaire à btop. Même network_mode: host modifie le modèle d’isolation du conteneur.

Pour la télémétrie système, il est préférable d’utiliser un outil de supervision intégré à l’hôte et fonctionnel plutôt que d’accorder à un conteneur de l’App Store des privilèges proches de ceux de l’hôte simplement pour lui permettre d’énumérer toutes les interfaces.

Vérifiez eth1 sur l’hôte avant d’accuser btop

Vérifiez la page réseau actuelle de ZimaOS ou les commandes réseau de l’hôte, et confirmez que l’interface 10 GbE est active, possède l’adresse attendue et transporte du trafic. La source l’a fait avec succès : ZimaOS lui-même l’affichait et l’utilisait eth1.

Si la mise en réseau de l’hôte voit l’interface, mais que le conteneur est le seul à ne pas la voir, le problème vient de l’environnement de supervision, et non du pilote de la carte réseau.

Traitez un btop intégré défaillant sur la version actuelle de ZimaOS comme une nouvelle régression

La source utilisait la version 1.6.1, tandis que la version actuelle de ZimaOS est la 1.7.1. Si le panneau intégré est toujours noir aujourd’hui, indiquez la version actuelle, l’architecture du processeur, la sortie directe btop la sortie, l’erreur de la console ou de la session du navigateur, et si une récupération ou une réinstallation modifie le problème. Ne supposez pas que le fil d’avril 2026 explique déjà une panne actuelle.

FAQ réseau de btop

btop peut-il sélectionner eth1 si eth1 n’est pas visible dans son espace de noms ?

Non. Le sélecteur ne fait défiler que les interfaces visibles par le processus en cours d’exécution.

Un autre utilisateur a-t-il confirmé que le btop intégré pouvait voir eth1 ?

Oui. James a indiqué avoir fait défiler les interfaces eth0, eth1, libvirt, Docker et veth dans le btop de l’hôte.

La source a-t-elle confirmé une correction sûre des privilèges Docker ?

Non. La mise en réseau de l’hôte et l’ajout de capacités ont été évoqués, mais aucune configuration fonctionnelle finale n’a été vérifiée.