ZVM Extras è un’estensione della community creata per colmare le lacune operative del gestore ZVM integrato in ZimaOS, senza sostituire ZVM. Lo ZVM ufficiale rimane responsabile della creazione e della modifica delle macchine virtuali; ZVM Extras opera al suo fianco come modulo separato systemd-sysext modulo e comunica con lo stesso backend libvirt.
Il progetto è iniziato a maggio 2026 su ZimaOS 1.6.1 con avvio automatico, snapshot, passthrough USB, storage remoto, backup, watchdog e metriche. Si è poi evoluto rapidamente grazie ai test della community. L’attuale repository pubblico documenta la versione v0.7.0, verificata su ZimaOS 1.7.0-beta1, con diversi bug della v0.6.3 già corretti.
Estende ZVM invece di sostituirlo
L’autore del progetto ha deliberatamente evitato di creare un secondo gestore di VM. ZVM Extras legge lo stesso inventario delle VM e opera tramite libvirt/virsh, mentre la normale interfaccia di ZVM rimane l’autorità per la creazione delle VM e le modifiche ordinarie.
Questo design riduce i conflitti con il livello di virtualizzazione integrato, ma non elimina i rischi di compatibilità. Un aggiornamento di ZimaOS o ZVM può comunque modificare il comportamento di libvirt, l’XML delle VM, la rete o la gestione dei dispositivi sottostante all’estensione.
L’avvio automatico aggiunge ordine e ritardo per ogni VM
L’estensione può impostare l’avvio automatico delle VM selezionate dopo l’avvio dell’host ZimaOS. A differenza di un semplice interruttore «avvia tutto automaticamente», supporta l’ordinamento e i ritardi tra le VM, così i servizi infrastrutturali possono avviarsi in sequenza.
Un watchdog può anche riavviare le VM selezionate se si arrestano inaspettatamente. Dalla versione v0.7.0, la stessa area include controlli per l’avvio, l’arresto, il riavvio e lo spegnimento forzato, con avvisi quando un watchdog riavvierebbe immediatamente una VM che l’utente sta tentando di arrestare.
Gli snapshot gestiscono diversamente le VM in esecuzione e quelle arrestate
Il design originale utilizzava snapshot interni di libvirt per le VM arrestate e snapshot esterni con lo stato della memoria per le VM in esecuzione. Questa distinzione è importante perché uno snapshot live da cui è possibile ripristinare è più complesso e può consumare una quantità considerevole di spazio di archiviazione.
Lo storage NFS o SMB remoto può essere utilizzato anche come destinazione per gli snapshot, riducendo la pressione sul dispositivo NVMe locale.
Il passthrough USB è diventato un flusso di lavoro grafico
L'estensione riconcilia anche i collegamenti USB persistenti se la normale interfaccia ZVM riscrive in seguito la configurazione del guest e rimuove la voce relativa al dispositivo host.
Il passthrough PCIe usa VFIO e i gruppi IOMMU
Dalla v0.4.0, ZVM Extras supporta il passthrough PCIe. L'interfaccia mostra il raggruppamento IOMMU e il driver dell'host, blocca i dispositivi bridge evidentemente inadatti e usa VFIO per l'assegnazione.
Questa resta una funzionalità più rischiosa rispetto al collegamento diretto di un normale dispositivo USB. L'hardware scelto deve essere isolato in modo sicuro, l'host non deve dipendere da esso e un'assegnazione errata può compromettere la stabilità o la rete dell'host.
L'archiviazione remota può contenere snapshot e backup
Questo è particolarmente utile per i dischi virtuali QCOW2 di grandi dimensioni. Conservare tutti gli snapshot sullo stesso dispositivo fisico della VM attiva offre poca protezione dai guasti dell'unità locale e può consumare rapidamente lo spazio.
Il backup della VM esporta XML e immagini dei dischi
Il progetto può esportare la configurazione della VM e le immagini dei dischi come artefatto di backup autonomo. Le versioni successive ricordano la destinazione di backup selezionata, semplificando le operazioni ripetute.
Uno snapshot di una VM e un backup di una VM non sono equivalenti. Uno snapshot è principalmente un meccanismo di ripristino. Un backup separato, archiviato su un altro dispositivo, protegge dalla perdita dello spazio di archiviazione dell'host stesso.
Le metriche in tempo reale trasformano ZVM in un dashboard operativo più completo
ZVM Extras legge da libvirt le metriche di CPU, memoria, disco e rete. Gli utenti della community hanno confermato che queste misurazioni funzionavano sulle VM di test. Nella v0.6.3, un utente ha segnalato che ogni VM mostrava il 100% di memoria; l'autore ha individuato il problema nel calcolo e lo ha risolto nella v0.7.0, che ha aggiunto anche grafici sparkline con una breve cronologia.
Il cambio della scheda di rete è intenzionalmente limitato alle reti esistenti
L'estensione può modificare la rete libvirt e il modello della scheda di rete guest. L'autore ha intenzionalmente rifiutato di automatizzare la creazione di un nuovo bridge sull'host assegnando l'interfaccia Ethernet ZimaOS attiva, perché una migrazione del bridge non riuscita potrebbe rendere il NAS non raggiungibile.
Questo confine prudente è importante. Selezionare una rete esistente è molto più sicuro che riscrivere lo stack di rete principale dell'host da un componente aggiuntivo per la gestione delle VM.
La comunicazione tra VM e host può ancora incontrare i limiti di macvtap
Un utente della community riusciva a raggiungere una VM Home Assistant dalla LAN, ma non da un container reverse proxy sull’host ZimaOS, quando entrambi utilizzavano la stessa NIC fisica. L’autore della fonte sospettava il classico comportamento di isolamento dell’host di macvtap e suggeriva di controllare l’XML del guest.
Ha chiaramente indicato quella spiegazione come un’ipotesi, perché non è riuscito a riprodurre la configurazione esatta. Non trasformarla in una causa confermata alla radice di ZimaOS senza aver verificato il tipo effettivo di interfaccia.
Il progetto ha aggiunto una vera suite di test, ma non tutti i percorsi hardware sono coperti
Per la v0.4.0, l’autore ha dichiarato il superamento di 63 casi di test, inclusi analisi statica, test delle condizioni di gara, controlli CSRF/origine, protezioni contro l’iniezione di argomenti e percorsi, snapshot, esportazione dei backup, modifiche alle NIC e metriche. I casi reali di spegnimento e riaccensione e di collegamento PCIe a caldo erano intenzionalmente esclusi dall’ambito dei test automatizzati.
Un secondo utente della community ha installato autonomamente la v0.4.0, ha confermato il caricamento della sysext, rilevato una VM Debian, visualizzato le metriche e creato correttamente uno snapshot di una VM arrestata.
IceWhale ha elogiato il progetto, ma si tratta ancora di software della community
Zima-Jerry ha poi risposto che il progetto sembrava affrontare le attuali lacune di ZVM. Si tratta di un riscontro ufficiale positivo, non di un annuncio che ZVM Extras sia entrato a far parte di ZimaOS o sia supportato come un modulo integrato.
Prima dell’installazione, consulta il repository attuale di ZVM Extras e lo stato delle release. Attualmente, il repository identifica la v0.7.0 come verificata su ZimaOS 1.7.0-beta1.
Esegui il backup dei dati della VM prima di testare le estensioni di virtualizzazione della community
Snapshot, passthrough e riconciliazione XML operano tutti a stretto contatto con lo storage e la configurazione dei dispositivi della VM. Esegui prima i test con un guest usa e getta, conserva una copia dei dischi QCOW2 importanti e assicurati di poter ripristinare il sistema senza l’estensione installata.
FAQ di ZVM Extras
ZVM Extras sostituisce l’app ZVM ufficiale?
No. È progettato come estensione complementare e utilizza lo stesso backend libvirt.
Può eseguire il passthrough di dispositivi USB e PCIe dall’interfaccia grafica?
Sì. Il passthrough USB e il passthrough PCIe basato su VFIO sono funzionalità fondamentali del progetto.
Può eseguire il backup di una VM su un altro NAS?
Può montare storage NFS o SMB e usare percorsi remoti per gli snapshot o le esportazioni dei backup.
ZVM Extras è supportato ufficialmente da IceWhale?
No. Il personale di IceWhale lo ha elogiato, ma il codice sorgente e il repository attuale lo descrivono come un componente aggiuntivo della community.
