Proxmox × CyberPanel

Was ist der QEMU Guest Agent
und warum ist er wichtig?

Klicke auf die Buttons und sieh selbst, wie es funktioniert.

🤖
Kurz erklärt
Stell dir vor, Proxmox ist der Vermieter einer Wohnung und deine CyberPanel-VM ist der Mieter. Ohne Agent kann der Vermieter nicht klingeln — er weiß nicht, was drinnen passiert, und kann den Mieter nicht bitten, aufzuräumen, bevor er geht. Der QEMU Guest Agent ist genau diese Türklingel — er verbindet die beiden.
👀
Sieht die echte IP
Proxmox kennt die interne Adresse der VM
💾
Sicheres Herunterfahren
Speichert alle Daten vor dem Ausschalten
📸
Sauberer Snapshot
Backup ohne beschädigte Daten
Die Gefahr eines erzwungenen Shutdowns — Simulation
Wenn du in Proxmox auf „Hard Shutdown" klickst ohne installierten Agent, ist das wie das Ziehen des Netzsteckers. WordPress war gerade dabei, etwas in die Datenbank zu schreiben — die Daten bleiben halb geschrieben und können beschädigt werden. Mit installiertem Agent bittet Proxmox die VM höflich herunterzufahren, und diese schreibt vorher alles fertig.
❌ Ohne Agent — Hard Shutdown
W
W
W
⚠ WordPress schreibt in die Datenbank...
✅ Mit Agent — Sicheres Herunterfahren
W
W
W
⚠ WordPress schreibt in die Datenbank...
❌ Ohne Agent
Proxmox beendet den Prozess sofort.
Die WordPress-Datenbank kann beschädigt werden.
Beim Neustart funktioniert die Website möglicherweise nicht mehr.
✅ Mit Agent
Proxmox sendet ein freundliches Signal.
Die VM schreibt alles fertig und fährt dann herunter.
Die Website funktioniert nach dem Neustart einwandfrei.
🔍
Wie Proxmox die IP deiner VM erkennt
Ohne Agent sieht Proxmox die VM als „schwarze Box" — es weiß, dass sie läuft, aber nicht, welche IP-Adresse sie hat. Aktiviere den Agent unten und beobachte, wie Proxmox sofort erkennt, dass VM vm-101 unter der Adresse 192.168.1.30 erreichbar ist.
QEMU Guest Agent AUS
🖥️ Proxmox Host (pve01)
192.168.1.10
Dein Proxmox-Host — immer sichtbar
📦 VM-101 (CyberPanel)
???
Agent aus — IP unbekannt
IP-Adresse
Hostname
Betriebssystem
🛠️
Wie installiert man ihn? (2 Befehle)
Öffne das Terminal deiner CyberPanel-VM (über Proxmox Console oder SSH) und führe diese zwei Befehle aus. Das ist alles — der Agent startet automatisch und bleibt nach jedem Neustart aktiv.
vm-101 terminal
renuka@vm-101:~$ sudo apt install qemu-guest-agent -y
→ installiert den Agent
root@vm-101:~# systemctl enable --now qemu-guest-agent
→ startet ihn und aktiviert ihn beim Boot
✓ Fertig! Der Agent läuft jetzt auf vm-101
⚠ Nicht vergessen: Nach der Installation gehe zu Proxmox → vm-101 → Hardware → und aktiviere die Option „QEMU Guest Agent" in den VM-Einstellungen. Sonst verwendet Proxmox ihn nicht, auch wenn er in der VM läuft.