Soluzione della community

ZVM con passthrough PCIe: opzioni HBA attualmente disponibili su ZimaOS

IceWhale said PCIe passthrough was long-term roadmap work; a 2026 community ZVM-Extra module later added VFIO-based PCIe passthrough outside core ZVM.

ZVM nativo non dispone ancora di una procedura PCIe passthrough di prima parte chiaramente documentata, quindi non pianificare una VM con HBA LSI basandoti su una casella di controllo che potrebbe non esistere. IceWhale aveva inizialmente dichiarato che il PCIe passthrough faceva parte della roadmap a lungo termine; nel 2026, un modulo ZVM-Extra della community ha aggiunto il PCIe passthrough basato su VFIO, ma resta un’estensione della community e non una funzionalità integrata di ZVM.

Se il passthrough dell’HBA è essenziale, Proxmox rimane la scelta più convenzionale come host. Se vuoi rimanere su ZimaOS, verifica i gruppi IOMMU e l’estensione della community in una VM di test prima di affidarle dati importanti.

Cosa ha dichiarato IceWhale nel thread originale

Nel novembre 2025, IceWhale ha dichiarato che il PCIe passthrough non era previsto a breve termine, ma era incluso nella roadmap a lungo termine.

Cosa è cambiato nel 2026

Il thread del modulo ZVM-Extra della community ha introdotto il passthrough PCIe tramite VFIO e i controlli dei gruppi IOMMU. In seguito IceWhale ha riconosciuto che il modulo colmava alcune lacune attuali di ZVM.

Il supporto della community non equivale al supporto nativo

ZVM-Extra affianca ZVM ufficiale e utilizza lo stesso backend libvirt. Questo non significa che ZVM nativo disponga ora di un’interfaccia di passthrough documentata ufficialmente o che ogni futuro aggiornamento di ZimaOS manterrà il comportamento delle estensioni di terze parti.

Controlla l’IOMMU prima di qualsiasi altra cosa

dmesg | grep -Ei 'DMAR|IOMMU'
find /sys/kernel/iommu_groups/ -type l

Il tuo HBA deve trovarsi in un gruppo IOMMU sicuro, isolabile senza sottrarre hardware essenziale all’host.

Un HBA LSI è un dispositivo con un impatto elevato da assegnare tramite passthrough

Una volta associato a VFIO e assegnato alla VM, l’host non dovrebbe più utilizzare i dischi collegati al controller. Non collegare il disco di sistema di ZimaOS o lo storage essenziale dell’host allo stesso HBA.

Usa Proxmox quando il passthrough è un requisito fondamentale

Per TrueNAS, Unraid o un’altra VM di storage che deve controllare direttamente un HBA, Proxmox offre una procedura PCIe passthrough collaudata e rende l’architettura più facile da comprendere.

Mantieni ZimaOS come guest, se necessario

Puoi eseguire ZimaOS come VM di Proxmox per utilizzarne app e interfaccia, lasciando che un’altra VM controlli l’HBA. L’attuale guida a ZimaOS su Proxmox documenta l’installazione attualmente supportata di ZimaOS come guest.

Verifica la persistenza dopo il riavvio

Una configurazione passthrough che funziona una volta può comunque non funzionare dopo un riavvio se i driver dell’host riprendono il controllo del dispositivo o se i metadati dell’estensione non vengono riapplicati. Verifica l’avvio a freddo, l’avvio e l’arresto della VM e la visibilità dello storage prima di affidarle dati di produzione.

La guida ai requisiti hardware per la virtualizzazione illustra i vincoli hardware.

Esegui il backup della definizione della VM prima delle modifiche VFIO

Salva l’XML o la configurazione della VM e i metadati dello storage prima di associare un HBA a VFIO. Errori nell’associazione dei dispositivi possono impedire l’avvio della VM o rimuovere il controller dall’accesso dell’host fino al successivo intervento di ripristino.

Controlla l’intero gruppo IOMMU

Non assegnare un dispositivo tramite passthrough solo perché il suo indirizzo PCI compare in lspci. Esamina ogni funzione dello stesso gruppo IOMMU e verifica che isolare il gruppo non sottragga all’host una scheda di rete, un controller SATA o un altro dispositivo essenziale.

Le VM di storage hanno bisogno di un piano di ripristino

Se TrueNAS o un altro guest controlla l’HBA, documenta come ripristinare quel guest, il relativo disco della VM e la configurazione del passthrough indipendentemente dai dischi collegati all’HBA. In caso contrario, un guasto dell’host può rendere inaccessibile il pool di storage anche quando i dischi dati sono integri.

Domande frequenti

ZVM nativo supporta ufficialmente il PCIe passthrough?

Non è stata trovata una procedura di passthrough chiara e ufficiale nella documentazione attuale; il percorso funzionante discusso pubblicamente nel 2026 è un’estensione della community.

ZVM-Extra può assegnare dispositivi PCIe tramite passthrough?

La documentazione della community indica di sì, tramite VFIO e controlli dei gruppi IOMMU.

Dovrei assegnare un HBA LSI a una VM di storage?

Solo se l’HBA può essere isolato correttamente e l’host non dipende da alcun disco collegato a esso.

Proxmox è più semplice per questo scopo?

Sì, quando il PCIe passthrough è un requisito fondamentale del progetto e non un esperimento opzionale.