Fazit: Der QEMU-Gastagent benötigt sowohl einen Host-Kanal als auch einen Gast-Daemon
Das Aktivieren des „QEMU Guest Agent“ in der Benutzeroberfläche des Hypervisors ist nur die halbe Einrichtung. Die VM-Definition muss einen Virtio-Serial-Kanal mit dem Namen org.qemu.guest_agent.0 bereitstellen, und das Gastbetriebssystem muss tatsächlich qemu-guest-agent ausführen. Fehlt eine der beiden Seiten, kann der Agent nicht funktionieren.
Der libvirt-Leitfaden zum Gastagenten dokumentiert beide Voraussetzungen. QEMU beschreibt dasselbe Host-/Gast-Kanalmodell in seinen Hinweisen zur Gastagenten-Architektur.
Wenn ZimaOS der Gast unter Proxmox ist
Die übliche Debian-Anweisung apt install qemu-guest-agent lässt sich nicht direkt auf das unveränderte ZimaOS übertragen. ZimaOS ist ein Appliance-System auf Buildroot-Basis und kein Debian-/Ubuntu-System. Daher sind apt und yum keine allgemeinen Wege zur Paketverwaltung. Der Leitfaden zur Paketverwaltung in ZimaOS erläutert diese Abgrenzung.
Das bedeutet, dass das Aktivieren des Kontrollkästchens für den Proxmox-Gastagenten nicht automatisch einen Daemon in ZimaOS installiert. Der Leitfaden zu ZimaOS unter Proxmox ist die zuverlässigere Grundlage für VM-Tests.
Wenn ZimaOS der Hypervisor ist und eine andere VM ausführt
Ein separater Test im April 2026 überprüfte einen ZVM-Gast und fand im Gast weder /dev/virtio-ports noch im VM-XML einen org.qemu.guest_agent.0-Kanal. Dieses Ergebnis erklärt, warum die alleinige Installation des Gast-Daemons in der getesteten Version nicht geholfen hätte.
# In einem Linux-Gast
ls -l /dev/virtio-ports/
# Auf einem libvirt-Host
virsh dumpxml <vm-name> | grep -A4 -B2 guest_agentBetrachte das Ergebnis vom April 2026 nicht als dauerhafte Produktgarantie. Überprüfe den Kanal in der aktuellen Version, bevor du zu dem Schluss kommst, dass ZVM ihn weiterhin nicht unterstützt.
Was du tun solltest, wenn du zuverlässige Gastagenten-Funktionen benötigst
Wenn dein Arbeitsablauf ein sauberes Herunterfahren des Gasts, die Meldung der IP-Adresse, das Einfrieren und Auftauen von Dateisystemen oder die Orchestrierung von Backups voraussetzt, verwende eine Gast-/Hypervisor-Kombination, bei der beide Seiten den QEMU-Gastagenten ausdrücklich unterstützen. Informationen zur aktuellen Planung der ZimaOS-Virtualisierung findest du in den Anforderungen des Virtual Machine Managers und in der Übersicht zu virtuellen Maschinen auf Zima-Hardware.
