ZVM Extras ist eine Community-Erweiterung, die operative Lücken rund um den integrierten ZVM-Manager von ZimaOS schließen soll, ohne ZVM selbst zu ersetzen. Der offizielle ZVM bleibt für das Erstellen und Bearbeiten virtueller Maschinen zuständig; ZVM Extras steht als separates systemd-sysext Modul und kommuniziert mit demselben libvirt-Backend.
Das Projekt startete im Mai 2026 auf ZimaOS 1.6.1 mit automatischem Start, Snapshots, USB-Passthrough, Remote-Speicher, Backups, Watchdogs und Metriken. Anschließend entwickelte es sich durch Community-Tests schnell weiter. Das aktuelle öffentliche Repository dokumentiert v0.7.0, verifiziert auf ZimaOS 1.7.0-beta1; mehrere Fehler aus v0.6.3 wurden bereits behoben.
Es erweitert ZVM, statt es zu ersetzen
Der Autor des Quelltexts vermied bewusst, einen zweiten VM-Manager zu entwickeln. ZVM Extras liest dasselbe VM-Inventar und arbeitet über libvirt/virsh, während die normale ZVM-Oberfläche für die Erstellung von VMs und die gewöhnliche Bearbeitung maßgeblich bleibt.
Dieses Design verringert Konflikte mit der integrierten Virtualisierungsschicht, beseitigt jedoch nicht das Kompatibilitätsrisiko. Ein ZimaOS- oder ZVM-Update kann weiterhin das Verhalten von libvirt, die VM-XML, die Netzwerkkonfiguration oder die Geräteverwaltung unterhalb der Erweiterung ändern.
Automatischer Start mit VM-spezifischer Reihenfolge und Verzögerung
Die Erweiterung kann ausgewählte VMs so markieren, dass sie nach dem Start des ZimaOS-Hosts automatisch gestartet werden. Anders als ein einfacher Schalter „Alles automatisch starten“ unterstützt sie eine Reihenfolge und Verzögerungen zwischen VMs, sodass Infrastrukturdienste nacheinander gestartet werden können.
Ein Watchdog kann ausgewählte VMs außerdem neu starten, wenn sie unerwartet beendet werden. Ab v0.7.0 kamen in demselben Bereich Steuerelemente zum Starten, Anhalten, Neustarten und Erzwingen des Ausschaltens hinzu, einschließlich Warnungen, wenn ein Watchdog eine VM sofort neu starten würde, die der Benutzer gerade anzuhalten versucht.
Snapshots behandeln laufende und angehaltene VMs unterschiedlich
Im ursprünglichen Design wurden interne libvirt-Snapshots für angehaltene VMs und externe Snapshots mit Speicherzustand für laufende VMs verwendet. Dieser Unterschied ist wichtig, da ein Live-Snapshot, zu dem zurückgekehrt werden kann, komplexer ist und erheblichen Speicherplatz beanspruchen kann.
Remote-NFS- oder -SMB-Speicher kann ebenfalls als Snapshot-Ziel verwendet werden, wodurch der lokale NVMe-Datenträger entlastet wird.
USB-Passthrough wurde zu einem GUI-Workflow
Die Erweiterung gleicht außerdem persistente USB-Zuweisungen ab, falls die normale ZVM-Oberfläche später die Gastkonfiguration neu schreibt und den Host-Geräteeintrag entfernt.
PCIe-Passthrough verwendet VFIO und IOMMU-Gruppen
Ab v0.4.0 unterstützte ZVM Extras PCIe-Passthrough. Die Benutzeroberfläche zeigt IOMMU-Gruppen und den Host-Treiber an, blockiert offensichtlich ungeeignete Bridge-Geräte und verwendet VFIO für die Zuweisung.
Dies ist weiterhin eine Funktion mit höherem Risiko als das Durchreichen eines gewöhnlichen USB-Geräts. Die ausgewählte Hardware muss sicher isoliert sein, der Host darf nicht von ihr abhängen, und eine fehlerhafte Zuweisung kann die Stabilität oder Netzwerkverbindung des Hosts beeinträchtigen.
Entfernter Speicher kann Snapshots und Backups aufnehmen
Das ist besonders bei großen virtuellen QCOW2-Festplatten nützlich. Wenn alle Snapshots auf demselben physischen Gerät wie die aktive VM gespeichert werden, bietet das nur wenig Schutz vor einem lokalen Laufwerksausfall und kann den Speicher schnell aufbrauchen.
VM-Backup exportiert XML und Festplatten-Images
Das Projekt kann die VM-Konfiguration und Festplatten-Images als eigenständiges Backup-Artefakt exportieren. Spätere Versionen speichern das ausgewählte Backup-Ziel, wodurch sich wiederholte Vorgänge einfacher durchführen lassen.
Ein VM-Snapshot und ein VM-Backup sind nicht gleichwertig. Ein Snapshot dient in erster Linie als Möglichkeit zum Zurücksetzen. Ein separates Backup auf einem anderen Gerät schützt vor dem Verlust des Host-Speichers selbst.
Live-Metriken machen ZVM zu einem besser nutzbaren Betriebs-Dashboard
ZVM Extras liest CPU-, Arbeitsspeicher-, Festplatten- und Netzwerkmetriken aus libvirt aus. Nutzer aus der Community bestätigten, dass diese Messwerte bei Test-VMs funktionierten. In v0.6.3 meldete ein Nutzer, dass bei jeder VM 100 % Arbeitsspeicherauslastung angezeigt wurden. Der Autor ermittelte die Ursache des Berechnungsproblems und behob es in v0.7.0. Diese Version fügte außerdem Sparklines mit einem kurzen Verlauf hinzu.
Das Wechseln der Netzwerkkarte ist bewusst auf vorhandene Netzwerke beschränkt
Die Erweiterung kann das libvirt-Netzwerk und das Modell der virtuellen Netzwerkkarte eines Gasts ändern. Der Autor hat bewusst darauf verzichtet, die Erstellung einer neuen Host-Bridge zu automatisieren, indem die aktive Ethernet-Schnittstelle von ZimaOS als Port eingebunden wird, da eine fehlgeschlagene Bridge-Migration das NAS vom Netzwerk trennen könnte.
Diese vorsichtige Abgrenzung ist wichtig. Die Auswahl eines vorhandenen Netzwerks ist deutlich sicherer, als den primären Netzwerk-Stack des Hosts über eine Erweiterung zur VM-Verwaltung umzuschreiben.
Die Kommunikation zwischen VM und Host kann weiterhin an macvtap-Grenzen stoßen
Ein Community-Nutzer konnte eine Home-Assistant-VM aus dem LAN erreichen, jedoch nicht aus einem Reverse-Proxy-Container auf dem ZimaOS-Host, obwohl beide dieselbe physische Netzwerkkarte verwendeten. Der Autor der Quelle vermutete das klassische Host-Isolationsverhalten von macvtap und empfahl, die Gast-XML zu prüfen.
Er kennzeichnete diese Erklärung eindeutig als Hypothese, weil er die genaue Konfiguration nicht reproduzieren konnte. Mache daraus keine bestätigte Ursache im ZimaOS-Root-System, ohne den tatsächlichen Schnittstellentyp zu prüfen.
Das Projekt erhielt eine echte Testsuite, aber nicht jeder Hardwarepfad ist abgedeckt
Für v0.4.0 meldete der Autor 63 bestandene Testfälle, darunter statische Analyse, Race-Tests, CSRF-/Origin-Kontrollen, Schutzmaßnahmen gegen Argument- und Pfadinjektionen, Snapshots, Sicherungsexport, NIC-Änderungen und Metriken. Echte Fälle mit Aus- und Wiedereinschalten sowie das Live-Anbinden von PCIe-Geräten lagen bewusst außerhalb des Umfangs dieser automatisierten Tests.
Ein zweiter Community-Nutzer installierte v0.4.0 unabhängig davon, bestätigte, dass die Sysext geladen wurde, erkannte eine Debian-VM, zeigte Metriken an und erstellte erfolgreich einen Snapshot einer gestoppten VM.
IceWhale lobte das Projekt, aber es ist weiterhin Community-Software
Zima-Jerry antwortete später, dass das Projekt offenbar aktuelle Schwächen von ZVM behebt. Das ist positives offizielles Feedback, aber keine Ankündigung, dass ZVM Extras Teil von ZimaOS geworden ist oder wie ein integriertes Modul unterstützt wird.
Prüfe vor der Installation das aktuelle Repository und den Veröffentlichungsstatus von ZVM Extras. Im Repository wird derzeit v0.7.0 als unter ZimaOS 1.7.0-beta1 verifiziert angegeben.
VM-Daten vor dem Testen von Community-Virtualisierungserweiterungen sichern
Snapshots, Passthrough und der XML-Abgleich greifen direkt in die Speicher- und Gerätekonfiguration der VM ein. Teste zuerst mit einem entbehrlichen Gast, bewahre eine Kopie wichtiger QCOW2-Festplatten auf und stelle sicher, dass du die Wiederherstellung ohne installierte Erweiterung durchführen kannst.
FAQ zu ZVM Extras
Ersetzt ZVM Extras die offizielle ZVM-App?
Nein. Es ist als begleitende Erweiterung konzipiert und verwendet dasselbe libvirt-Backend.
Kann es USB- und PCIe-Geräte über die grafische Oberfläche durchreichen?
Ja. USB-Passthrough und PCIe-Passthrough auf VFIO-Basis gehören zu den Kernfunktionen des Projekts.
Kann damit eine VM auf ein anderes NAS gesichert werden?
Es kann NFS- oder SMB-Speicher einbinden und Remote-Pfade für Snapshots oder Sicherungsexporte verwenden.
Wird ZVM Extras offiziell von IceWhale unterstützt?
Nein. Mitarbeiter von IceWhale lobten es, aber die Quelle und das aktuelle Repository beschreiben es als Community-Erweiterung.
