Communityoplossing

ZVM-extra's voor ZimaOS: automatisch starten, snapshots, USB-/PCIe-passthrough en back-ups van virtuele machines

A May-August 2026 community project that adds operational controls beside ZimaOS's built-in ZVM: autostart, snapshots, USB and PCIe passthrough, VM backup/export, remote storage, metrics, NIC switching, power controls, and a VNC console. IceWhale staff praised the work but it remains a community add-on.

ZVM Extras is een community-uitbreiding die is gebouwd om operationele tekortkomingen van de ingebouwde ZVM-manager van ZimaOS op te vullen, zonder ZVM zelf te vervangen. De officiële ZVM blijft verantwoordelijk voor het maken en bewerken van virtuele machines; ZVM Extras staat er als afzonderlijke systemd-sysext module en communiceert met dezelfde libvirt-backend.

Het project begon in mei 2026 op ZimaOS 1.6.1 met automatisch starten, snapshots, USB-doorvoer, externe opslag, back-ups, watchdogs en statistieken. Daarna ontwikkelde het zich snel door tests door de community. De huidige openbare repository documenteert v0.7.0, geverifieerd op ZimaOS 1.7.0-beta1, waarbij verschillende bugs uit v0.6.3 al zijn opgelost.

Het breidt ZVM uit in plaats van het te vervangen

De auteur van de broncode vermeed bewust het bouwen van een tweede VM-manager. ZVM Extras leest dezelfde VM-inventaris en werkt via libvirt/virsh, terwijl de normale ZVM-interface leidend blijft voor het maken van VM's en gewone bewerkingen.

Dat ontwerp vermindert conflicten met de ingebouwde virtualisatielaag, maar elimineert compatibiliteitsrisico's niet. Een update van ZimaOS of ZVM kan nog steeds het gedrag van libvirt, VM-XML, netwerken of apparaatbeheer onder de uitbreiding wijzigen.

Automatisch starten voegt een volgorde en vertraging per VM toe

Met de uitbreiding kunnen geselecteerde VM's automatisch worden gestart nadat de ZimaOS-host is opgestart. In tegenstelling tot een eenvoudige schakelaar voor “alles automatisch starten”, ondersteunt de uitbreiding een volgorde en vertragingen tussen VM's, zodat infrastructuurservices opeenvolgend kunnen opstarten.

Een watchdog kan geselecteerde VM's ook opnieuw starten als ze onverwacht stoppen. In v0.7.0 kreeg hetzelfde gedeelte knoppen voor starten, stoppen, opnieuw opstarten en geforceerd uitschakelen, met waarschuwingen wanneer een watchdog een VM onmiddellijk opnieuw zou starten die de gebruiker probeert te stoppen.

Snapshots behandelen actieve en gestopte VM's verschillend

ZVM Extras-tabblad voor snapshots met een actieve Linux-VM en knoppen voor het maken van snapshots, het kiezen van een opslagdoel, terugzetten en verwijderen
De uitbreiding biedt een grafische interface voor het maken, terugzetten en verwijderen van snapshots, zodat gebruikers ze niet handmatig met virsh hoeven te beheren.

Het oorspronkelijke ontwerp gebruikte interne libvirt-snapshots voor gestopte VM's en externe snapshots met geheugenstatus voor actieve VM's. Dat onderscheid is belangrijk, omdat een live snapshot waarnaar kan worden teruggekeerd complexer is en aanzienlijk wat opslagruimte kan verbruiken.

Externe NFS- of SMB-opslag kan ook als doel voor snapshots worden gebruikt, waardoor het lokale NVMe-apparaat minder wordt belast.

USB-doorvoer werd een grafische workflow

ZVM Extras-tab voor USB-doorvoer met een overzicht van USB-apparaten van de host en permanente koppel- en ontkoppelknoppen
Het bronproject toont USB-apparaten van de host en maakt permanente koppeling aan een geselecteerde VM mogelijk zonder de libvirt-XML handmatig te bewerken.

De extensie herstelt ook permanente USB-koppelingen als de normale ZVM-interface later de gastconfiguratie herschrijft en de hostapparaatvermelding verwijdert.

PCIe-passthrough gebruikt VFIO en IOMMU-groepen

In v0.4.0 voegde ZVM Extras PCIe-passthrough toe. De interface toont IOMMU-groepering en het stuurprogramma van de host, blokkeert duidelijk ongeschikte bridge-apparaten en gebruikt VFIO voor toewijzing.

Dit blijft een functie met een hoger risico dan het doorgeven van een gewoon USB-apparaat. De gekozen hardware moet veilig worden geïsoleerd, de host mag er niet van afhankelijk zijn en een onjuiste toewijzing kan de stabiliteit of netwerkwerking van de host beïnvloeden.

Externe opslag kan snapshots en back-ups bevatten

Het tabblad Remote storage van ZVM Extras voor het toevoegen van NFS- of SMB-shares als bestemmingen voor snapshots en back-ups
NFS- en SMB-koppelingen kunnen worden geconfigureerd als externe doelen voor VM-snapshots en back-upexports.

Dit is vooral nuttig voor grote virtuele QCOW2-schijven. Elke snapshot op hetzelfde fysieke apparaat bewaren als de actieve VM biedt weinig bescherming tegen een lokale schijfstoring en kan snel ruimte in beslag nemen.

VM-back-up exporteert XML en schijfimages

Het project kan de VM-configuratie en schijfimages exporteren als een zelfstandig back-uparchief. Latere versies onthouden het geselecteerde back-updoel, waardoor herhaalde bewerkingen eenvoudiger worden.

Een VM-snapshot en een VM-back-up zijn niet hetzelfde. Een snapshot is voornamelijk bedoeld om terug te draaien. Een afzonderlijke back-up die op een ander apparaat is opgeslagen, beschermt tegen verlies van de hostopslag zelf.

Live statistieken maken van ZVM een operationeler dashboard

ZVM Extras leest CPU-, geheugen-, schijf- en netwerkstatistieken uit libvirt. Communitygebruikers bevestigden dat deze metingen op test-VM's werkten. In v0.6.3 meldde een gebruiker dat elke VM 100% geheugengebruik weergaf; de auteur traceerde het berekeningsprobleem en loste het op in v0.7.0, waarin ook korte sparklines met historische gegevens werden toegevoegd.

Het wisselen van netwerkkaarten is bewust beperkt tot bestaande netwerken

De extensie kan het libvirt-netwerk en -model van de netwerkkaart van een gast wijzigen. De auteur weigerde bewust om het aanmaken van een nieuwe hostbridge te automatiseren door de actieve Ethernetinterface van ZimaOS eraan te koppelen, omdat een mislukte bridge-migratie de NAS offline kan halen.

Deze voorzichtige afbakening is belangrijk. Een bestaand netwerk selecteren is veel veiliger dan de primaire netwerkstack van de host herschrijven vanuit een add-on voor VM-beheer.

VM ↔ hostcommunicatie kan nog steeds tegen macvtap-beperkingen aanlopen

Een communitygebruiker kon een Home Assistant-VM vanaf het LAN bereiken, maar niet vanuit een reverse-proxycontainer op de ZimaOS-host, terwijl beide dezelfde fysieke NIC gebruikten. De bronauteur vermoedde het klassieke macvtap-hostisolatiegedrag en adviseerde de XML-configuratie van de guest te controleren.

Hij labelde die uitleg duidelijk als een hypothese, omdat hij de exacte opstelling niet kon reproduceren. Beschouw dit niet als een bevestigde hoofdoorzaak in ZimaOS zonder eerst het daadwerkelijke interfacetype te inspecteren.

Het project voegde een echte testsuite toe, maar niet elk hardwarepad wordt gedekt

Voor v0.4.0 meldde de auteur dat 63 testgevallen slaagden, waaronder statische analyse, racetests, CSRF-/origin-beveiligingen, beveiligingen tegen argument- en padinjectie, snapshots, back-upexport, NIC-wijzigingen en statistieken. Echte stroomuitval- en live-PCIe-koppelingsgevallen vielen bewust buiten de scope van die geautomatiseerde tests.

Een tweede communitygebruiker installeerde onafhankelijk v0.4.0, bevestigde dat de sysext werd geladen, detecteerde een Debian-VM, gaf statistieken weer en maakte met succes een snapshot van een gestopte VM.

IceWhale prees het project, maar het blijft communitysoftware

Zima-Jerry antwoordde later dat het project de huidige tekortkomingen van ZVM leek aan te pakken. Dat is positieve officiële feedback, geen aankondiging dat ZVM Extras onderdeel is geworden van ZimaOS of wordt ondersteund zoals een ingebouwde module.

Bekijk vóór de installatie de huidige repository en release-status van ZVM Extras. In de repository wordt v0.7.0 momenteel aangeduid als geverifieerd op ZimaOS 1.7.0-beta1.

Maak een back-up van VM-gegevens voordat je community-extensies voor virtualisatie test

Snapshots, passthrough en XML-verzoening werken allemaal dicht bij de VM-opslag en apparaatconfiguratie. Test eerst met een wegwerp-guest, bewaar een kopie van belangrijke QCOW2-schijven en zorg dat je kunt herstellen zonder dat de extensie is geïnstalleerd.

Veelgestelde vragen over ZVM Extras

Vervangt ZVM Extras de officiële ZVM-app?

Nee. Het is ontworpen als begeleidende extensie en gebruikt dezelfde libvirt-backend.

Kan het USB- en PCIe-apparaten via de GUI doorgeven?

Ja. USB-passthrough en op VFIO gebaseerde PCIe-passthrough zijn kernfuncties van het project.

Kan het een VM back-uppen naar een andere NAS?

Het kan NFS- of SMB-opslag koppelen en externe paden gebruiken voor snapshots of back-upexports.

Wordt ZVM Extras officieel ondersteund door IceWhale?

Nee. Medewerkers van IceWhale prezen het, maar de bron en de huidige repository beschrijven het als een community-add-on.