Guest agent : pourquoi il est important et comment le réinstaller

Ce que fournit qemu-guest-agent, comment détecter qu'il a disparu, et comment le restaurer sur Debian, Ubuntu, AlmaLinux et Windows Server.

Mis à jour le 23 août 2026

Le panneau tire une partie de ses données non pas de l'extérieur, mais d'un petit service interne au système — qemu-guest-agent. Il n'ouvre aucun port et ne touche pas au réseau : la communication passe par le canal de virtualisation interne.

Ce qu'il fournit

L'espace disque réellement utilisé dans l'anneau de l'aperçu. Sans l'agent, le panneau ne connaît que la taille de l'image.
Un redémarrage et un arrêt propres : le système reçoit un signal et arrête correctement les services au lieu d'une coupure brutale.
Une liste précise des adresses réseau de la machine.

Sans l'agent, la machine continue de fonctionner ; le panneau affiche simplement moins d'informations, et les redémarrages deviennent difficiles — avec tous les risques pour la base de données et le système de fichiers.

Comment détecter son absence

Le premier signe est que, dans l'aperçu à l'adresse /hosting/vds/m/<id>, l'espace disque utilisé disparaît. Dans ce cas, le panneau affiche lui-même la commande d'installation pour votre système.

Vérifiez depuis l'intérieur :

systemctl status qemu-guest-agent
ls -l /dev/virtio-ports/org.qemu.guest_agent.0

S'il n'y a aucun périphérique dans /dev/virtio-ports, le service démarre puis se met immédiatement en veille : le canal dont il a besoin n'existe pas.

Installation

Debian et Ubuntu :

apt update
apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

AlmaLinux et CentOS Stream :

dnf install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

Windows Server 2022 et 2025 : l'agent fait partie du jeu de pilotes virtio-win. Installez virtio-win-guest-tools, puis dans le composant logiciel enfichable « Services », assurez-vous que QEMU Guest Agent est en cours d'exécution et configuré pour démarrer automatiquement.

Après quelques secondes, actualisez l'aperçu — l'espace utilisé devrait apparaître.

Pourquoi il disparaît

Cause	Ce qui s'est passé
Installation avec un ensemble de paquets minimal	L'agent n'a jamais été présent au départ
`apt autoremove`	Supprimé comme « dépendance inutile »
Nettoyage des « services supplémentaires »	Le service a été désactivé manuellement
Réinstallation du système d'exploitation	Une image neuve sans votre configuration personnalisée

Vous pouvez le rétablir à tout moment sans risque : le service ne crée pas de charge notable et ne touche pas au réseau.

Erreurs courantes

Le service est active mais aucune donnée n'apparaît dans le panneau — attendez la mise à jour des graphiques et vérifiez la présence du périphérique dans /dev/virtio-ports.
Unit qemu-guest-agent.service not found — le paquet n'est pas installé, il n'est pas cassé.
L'agent est installé mais les redémarrages restent difficiles — vérifiez le démarrage automatique : systemctl is-enabled qemu-guest-agent.

L'agent ne remplace pas l'accès à la machine. Si le système ne démarre pas, ce n'est pas lui qui vous aide — c'est le disque de secours.