Was der QEMU Guest Agent ist und warum die VM keine IP zeigt

Im Proxmox-Panel auf eine virtuelle Maschine zu schauen und das IP-Feld leer zu finden, ist ein häufiger Moment. Die Ursache ist fast immer dieselbe: der QEMU Guest Agent läuft in der Maschine nicht.

Wie der Kanal aussieht

Der Guest Agent ist ein Kanal zwischen Hypervisor und Maschineninnerem. Er spricht nicht über das Netz, sondern über eine virtuelle serielle Schnittstelle. Dieser Unterschied zählt: der Kanal bleibt auch dann bestehen, wenn das Netz der Maschine kaputt ist, und es wird kein Netzwerkport dafür geöffnet.

Was ohne ihn verloren geht

Ohne Agent sieht Proxmox nicht in die Maschine hinein. Das IP-Feld bleibt leer, denn wer sie meldet, ist die Maschine selbst. Auch ein Abschaltbefehl kommt nicht an: beim Druck auf die Schaltfläche kann der Hypervisor kein höfliches Herunterfahren nach innen senden, ihm bleibt nur der Stecker. Das Einfrieren des Dateisystems für eine konsistente Sicherung scheitert aus demselben Grund.

Wie er installiert wird

Unter Debian und Ubuntu heißt das Paket qemu-guest-agent, nach der Installation muss der Dienst aktiviert werden. Unter RHEL, Rocky und AlmaLinux trägt das Paket denselben Namen. Die meisten Cloud-Images bringen ihn schon mit. Danach muss in der Konfiguration der Maschine das Agent-Flag gesetzt und die Maschine einmal neu gestartet werden; bei gesetztem Flag entsteht der Kanal sonst nie.

Ist das eine neue Angriffsfläche

Nein, und der Grund liegt darin, wo das Recht ohnehin schon sitzt. Wer auf dem Proxmox-Host Root hat, erreicht Platte, Speicher und Konsole der Maschine bereits. Der Guest Agent erweitert dieses Recht nicht, er bringt dasselbe Recht nur auf einen geordneten Kanal. Der Gewinn ist handfest: für den Zugriff müssen kein SSH-Port geöffnet, keine Passwörter verteilt und keine IP auswendig gelernt werden.