En bref : QEMU Guest Agent nécessite à la fois un canal hôte et un démon invité
Activer « QEMU Guest Agent » dans l’interface d’un hyperviseur ne représente que la moitié de la configuration. La définition de la machine virtuelle doit exposer un canal virtio-serial nommé org.qemu.guest_agent.0, et le système d’exploitation invité doit réellement exécuter qemu-guest-agent. Si l’un des deux éléments manque, l’agent ne peut pas fonctionner.
Le guide de l’agent invité libvirt documente ces deux exigences. QEMU décrit le même modèle de canal hôte-invité dans ses notes sur l’architecture de Guest Agent.
Si ZimaOS est le système invité sur Proxmox
L’instruction Debian habituelle apt install qemu-guest-agent ne s’applique pas directement à ZimaOS standard. ZimaOS est un système de type appliance basé sur Buildroot, et non un système hôte Debian/Ubuntu ; apt et yum ne constituent donc pas des méthodes générales de gestion des paquets. Le guide des gestionnaires de paquets de ZimaOS explique cette limite.
Ainsi, activer la case de l’agent invité dans Proxmox n’installe pas automatiquement un démon dans ZimaOS. Le guide de ZimaOS sur Proxmox constitue une base plus sûre pour les tests de machines virtuelles.
Si ZimaOS est l’hyperviseur qui exécute une autre machine virtuelle
Un test distinct réalisé en avril 2026 dans le fil de discussion a examiné une machine virtuelle invitée ZVM et n’a trouvé ni /dev/virtio-ports dans l’invité, ni canal org.qemu.guest_agent.0 dans le fichier XML de la machine virtuelle. Ce résultat explique pourquoi l’installation du seul démon invité n’aurait pas été utile dans la version testée.
# Dans un invité Linux
ls -l /dev/virtio-ports/
# Sur un hôte libvirt
virsh dumpxml <vm-name> | grep -A4 -B2 guest_agentNe considérez pas le résultat d’avril 2026 comme une garantie permanente concernant le produit. Vérifiez la présence du canal dans la version actuelle avant de conclure que ZVM ne le prend toujours pas en charge.
Que faire lorsque vous avez besoin de fonctionnalités fiables de l’agent invité
Si votre flux de travail dépend de l’arrêt propre de l’invité, du signalement de son adresse IP, du gel et du dégel du système de fichiers ou de l’orchestration des sauvegardes, utilisez une combinaison invité/hyperviseur dans laquelle les deux parties prennent explicitement en charge QEMU Guest Agent. Pour planifier la virtualisation avec les versions actuelles de ZimaOS, consultez les exigences de Virtual Machine Manager ainsi que la présentation des machines virtuelles Zima.
