Em resumo: o QEMU Guest Agent precisa de um canal no anfitrião e de um daemon no convidado
Ativar o “QEMU Guest Agent” na interface de um hipervisor é apenas metade da configuração. A definição da VM tem de expor um canal virtio-serial chamado org.qemu.guest_agent.0, e o sistema operativo convidado tem de executar efetivamente o qemu-guest-agent. Se faltar algum dos lados, o agente não poderá funcionar.
O guia do Guest Agent do libvirt documenta ambos os requisitos. O QEMU descreve o mesmo modelo de canal entre anfitrião e convidado nas suas notas sobre a arquitetura do Guest Agent.
Se o ZimaOS for o convidado no Proxmox
A instrução normal do Debian, apt install qemu-guest-agent, não se aplica diretamente ao ZimaOS de origem. O ZimaOS é um sistema Buildroot de estilo appliance, e não um anfitrião Debian/Ubuntu, pelo que apt e yum não são métodos gerais de gestão de pacotes. O guia de gestão de pacotes do ZimaOS explica essa limitação.
Isto significa que ativar a caixa do agente convidado no Proxmox não instala magicamente um daemon dentro do ZimaOS. O guia do ZimaOS no Proxmox é a referência de base mais segura para testar VMs.
Se o ZimaOS for o hipervisor que executa outra VM
Um teste separado, realizado em abril de 2026 na discussão, verificou um convidado ZVM e não encontrou /dev/virtio-ports dentro do convidado nem o canal org.qemu.guest_agent.0 no XML da VM. Esse resultado explica por que instalar apenas o daemon no convidado não teria ajudado nessa versão testada.
# Dentro de um convidado Linux
ls -l /dev/virtio-ports/
# Num anfitrião libvirt
virsh dumpxml <vm-name> | grep -A4 -B2 guest_agentNão trate o resultado de abril de 2026 como uma garantia permanente do produto. Verifique o canal na versão atual antes de concluir que o ZVM continua sem o disponibilizar.
O que fazer quando precisa de funcionalidades fiáveis do Guest Agent
Se o seu fluxo de trabalho depender do encerramento correto do convidado, da comunicação do endereço IP, do congelamento/descongelamento do sistema de ficheiros ou da orquestração de cópias de segurança, utilize uma combinação de convidado/hipervisor em que ambos os lados suportem explicitamente o QEMU Guest Agent. Para o planeamento atual da virtualização no ZimaOS, consulte os requisitos do Virtual Machine Manager e a visão geral das máquinas virtuais Zima.
