Ce qu’est l’agent invité QEMU, et pourquoi la VM n’affiche pas d’IP

Regarder une machine virtuelle dans le panneau Proxmox et trouver le champ IP vide est un moment courant. La cause est presque toujours la même : l’agent invité QEMU ne tourne pas dans la machine.

À quoi ressemble le canal

L’agent invité est un canal entre l’hyperviseur et l’intérieur de la machine. Il ne parle pas par le réseau mais par un port série virtuel. Cette distinction compte : le canal tient même quand le réseau de la machine est cassé, et aucun port réseau n’est ouvert pour lui.

Ce que l’on perd sans lui

Sans agent, Proxmox ne voit pas dedans. Le champ IP reste vide, car celui qui la rapporte est la machine elle-même. Une demande d’arrêt n’aboutit pas non plus : quand on presse le bouton, l’hyperviseur ne peut pas envoyer un signal d’extinction propre vers l’intérieur, il ne lui reste que la prise. Geler le système de fichiers pour une sauvegarde cohérente échoue pour la même raison.

Comment il s’installe

Sous Debian et Ubuntu le paquet s’appelle qemu-guest-agent, et le service doit être activé après l’installation. Sous RHEL, Rocky et AlmaLinux le paquet porte le même nom. La plupart des images cloud le contiennent déjà. Ensuite, l’indicateur d’agent doit être actif dans la configuration de la machine et celle-ci redémarrée une fois ; l’indicateur éteint, le canal ne s’établit jamais.

Est-ce une nouvelle surface d’attaque

Non, et la raison tient à l’endroit où le privilège se trouve déjà. Qui possède root sur l’hôte Proxmox atteint déjà le disque, la mémoire et la console de la machine. L’agent invité n’élargit pas ce privilège, il le transporte simplement sur un canal ordonné. Le gain est concret : accéder à la machine ne demande plus d’ouvrir un port SSH, de distribuer des mots de passe ni de retenir une IP.