Che cos’è il QEMU Guest Agent e perché la VM non mostra un IP

Guardare una macchina virtuale nel pannello di Proxmox e trovare il campo IP vuoto è un momento comune. La causa è quasi sempre la stessa: il QEMU Guest Agent non gira dentro la macchina.

Com’è fatto il canale

Il guest agent è un canale tra l’hypervisor e l’interno della macchina. Non parla via rete ma attraverso una porta seriale virtuale. La distinzione conta: il canale regge anche quando la rete della macchina è rotta, e per esso non viene aperta alcuna porta di rete.

Che cosa si perde senza

Senza agent, Proxmox non vede dentro la macchina. Il campo IP resta vuoto, perché chi lo comunica è la macchina stessa. Nemmeno una richiesta di spegnimento arriva: alla pressione del pulsante l’hypervisor non può inviare un segnale di arresto pulito verso l’interno, gli resta solo staccare la spina. Congelare il filesystem per un backup coerente fallisce per lo stesso motivo.

Come si installa

Su Debian e Ubuntu il pacchetto si chiama qemu-guest-agent, e dopo l’installazione va abilitato il servizio. Su RHEL, Rocky e AlmaLinux il pacchetto porta lo stesso nome. La maggior parte delle immagini cloud lo include già. Poi il flag dell’agent deve essere attivo nella configurazione della macchina, che va riavviata una volta; con il flag spento il canale non si stabilisce mai.

È una nuova superficie di attacco

No, e la ragione sta in dove il privilegio già si trova. Chi ha root sull’host Proxmox raggiunge già disco, memoria e console della macchina. Il guest agent non allarga quel privilegio, lo porta soltanto su un canale ordinato. Il guadagno è concreto: per raggiungere la macchina non servono più una porta SSH aperta, password distribuite o un IP da ricordare.