In sintesi: QEMU Guest Agent richiede sia un canale host sia un demone guest
Attivare “QEMU Guest Agent” nell’interfaccia di un hypervisor copre solo metà della configurazione. La definizione della VM deve esporre un canale virtio-serial denominato org.qemu.guest_agent.0 e il sistema operativo guest deve effettivamente eseguire qemu-guest-agent. Se manca uno dei due elementi, l’agent non può funzionare.
La guida al Guest Agent di libvirt documenta entrambi i requisiti. QEMU descrive lo stesso modello di canale host/guest nelle sue note sull’architettura del Guest Agent.
Se ZimaOS è il guest su Proxmox
La normale istruzione Debian apt install qemu-guest-agent non si applica direttamente a ZimaOS standard. ZimaOS è un sistema Buildroot in stile appliance, non un host Debian/Ubuntu; quindi apt e yum non sono strumenti generici per la gestione dei pacchetti. La guida alla gestione dei pacchetti di ZimaOS spiega questo limite.
Di conseguenza, attivare la casella dell’agent guest in Proxmox non installa automaticamente un demone all’interno di ZimaOS. La guida a ZimaOS su Proxmox rappresenta una base più sicura per i test delle VM.
Se ZimaOS è l’hypervisor che esegue un’altra VM
Un test separato dell’aprile 2026 nella discussione ha verificato una VM guest ZVM e non ha trovato /dev/virtio-ports all’interno del guest né il canale org.qemu.guest_agent.0 nell’XML della VM. Questo risultato spiega perché la sola installazione del demone guest non sarebbe stata sufficiente nella build testata.
# All’interno di un guest Linux
ls -l /dev/virtio-ports/
# Su un host libvirt
virsh dumpxml <vm-name> | grep -A4 -B2 guest_agentNon considerare il risultato dell’aprile 2026 come una garanzia permanente sul prodotto. Verifica il canale nella build attuale prima di concludere che ZVM ne sia ancora privo.
Cosa fare quando servono funzionalità affidabili del Guest Agent
Se il tuo flusso di lavoro dipende dall’arresto corretto del guest, dalla segnalazione dell’IP, dal congelamento e scongelamento del filesystem o dall’orchestrazione dei backup, usa una combinazione guest/hypervisor in cui entrambi i componenti supportino esplicitamente QEMU Guest Agent. Per la pianificazione attuale della virtualizzazione su ZimaOS, consulta i requisiti di Virtual Machine Manager e la panoramica delle macchine virtuali Zima.
