Proxmox

Das Proxmox-Plug-in steuert eine Proxmox VE-Umgebung über deren REST-API. Damit kannst du:

• Die Umgebung überblicken – Cluster-Ressourcen, Nodes und deren Status ansehen
• VMs und Container verwalten – auflisten, Status prüfen, starten, stoppen, neu starten
• Snapshots anlegen und verwalten – Sicherungspunkte vor Änderungen erstellen
• Aufgaben und Logs auswerten – Cluster-Tasks und System-Journale der Nodes lesen

Typische Einsatzfälle: Server-Betrieb, VM-Verwaltung, geplante Änderungen mit Snapshot-Sicherung, Fehlersuche über Logs und Tasks.

Einrichtung

Erstelle eine Instanz im Plug-in-Manager und wähle eine Authentifizierungsart:

Feld	Bedeutung
Base URL	Adresse des Proxmox-Hosts, z. B. https://127.0.0.1:8006 (Pflicht)
Username	Benutzername, z. B. root@pam
Password	Passwort des Benutzers
API token	Alternativ ein API-Token im Format user@pve!name=secret
Verify TLS certificate	Ob das TLS-Zertifikat geprüft wird (Standard: nein – Proxmox nutzt häufig selbstsignierte Zertifikate)

Es ist genau eine Authentifizierungsart nötig: Benutzername + Passwort oder API-Token.

Tools

Verbindung und Übersicht

Tool	Funktion
proxmox_ping	Prüft die Erreichbarkeit der API und meldet die Proxmox-Version.
proxmox_cluster_resources	Listet alle Cluster-Ressourcen (Nodes, VMs, LXC-Container, Storage).
proxmox_nodes	Listet die Cluster-Nodes mit Status.
proxmox_node_status	Zeigt Status und Statistiken eines Nodes (CPU, Speicher).
proxmox_tasks	Listet die letzten Cluster-Aufgaben.

VMs und Container

Tool	Funktion
proxmox_vms	Listet die QEMU-VMs (optional auf einen Node begrenzt).
proxmox_lxc	Listet die LXC-Container (optional auf einen Node begrenzt).
proxmox_vm_status	Zeigt den Status einer VM oder eines Containers (per VMID; der Node wird automatisch aufgelöst).

Steuern

Tool	Funktion
proxmox_vm_start	Startet eine VM oder einen Container.
proxmox_vm_stop	Stoppt eine VM oder einen Container (ACPI-Herunterfahren, falls nötig erzwungen).
proxmox_vm_restart	Startet eine VM oder einen Container neu.

Snapshots

Tool	Funktion
proxmox_vm_snapshot_list	Listet die Snapshots einer VM oder eines Containers.
proxmox_vm_snapshot_create	Legt einen Snapshot an.
proxmox_vm_snapshot_delete	Löscht einen Snapshot.

Analyse

Tool	Funktion
proxmox_node_logs	Liest das systemd-Journal eines Nodes (z. B. journalctl-Ausgabe).

Typische Arbeitsabläufe

Umgebung überblicken

1. proxmox_ping – ist der Host erreichbar?
2. proxmox_nodes – welche Nodes sind im Cluster, in welchem Zustand?
3. proxmox_cluster_resources – VMs, Container und Storage auf einen Blick.
4. proxmox_node_status – Auslastung der wichtigsten Nodes prüfen.

VM sicher verwalten

1. proxmox_vms – die gewünschte VM finden, VMID notieren.
2. proxmox_vm_status – aktuellen Zustand prüfen.
3. Vor einer Änderung proxmox_vm_snapshot_create – Sicherungspunkt setzen.
4. Änderung vornehmen, z. B. proxmox_vm_restart.
5. proxmox_vm_status – verifizieren, dass die VM sauber läuft.
6. proxmox_vm_snapshot_delete – veralteten Snapshot nach erfolgreicher Prüfung entfernen.

Fehlersuche

1. proxmox_tasks – gab es fehlgeschlagene Aufgaben?
2. proxmox_node_logs der betroffenen Node – Systemfehler im Journal suchen.
3. proxmox_vm_status – Zustand der betroffenen VM prüfen.

Hinweise für KI-Agenten

• VMID statt Name: VM- und Container-Tools arbeiten mit der VMID – bei unbekannten IDs vorher proxmox_vms / proxmox_lxc aufrufen.
• Snapshots löschen ist endgültig: proxmox_vm_snapshot_delete ist destruktiv und erfordert die bestätigende Einstellung/Argumente. Ein Snapshot ist nur eine momentane Sicherung – für echte Backups sind externe Lösungen zuständig.
• Stoppen ist keine Zerstörung: proxmox_vm_stop beendet eine VM sauber (ACPI), erst bei ausgebliebener Reaktion wird erzwungen gestoppt – es geht also keine Disk-Daten verloren.
• Nach jeder Aktion prüfen: Start-, Stop- und Restart-Aktionen mit proxmox_vm_status verifizieren, bevor die nächste Aktion ausgeführt wird.