Communityoplossing

ZVM PCIe-passthrough: HBA-opties in ZimaOS vandaag de dag

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

Native ZVM heeft nog steeds geen duidelijk gedocumenteerde PCIe-passthroughworkflow van de eerste partij, dus plan geen LSI HBA-VM op basis van een verondersteld selectievakje dat mogelijk niet bestaat. IceWhale gaf oorspronkelijk aan dat PCIe-passthrough werk voor de langetermijnroadmap was; in 2026 voegde een communitymodule, ZVM-Extra, VFIO-gebaseerde PCIe-passthrough toe, maar het blijft een community-uitbreiding en geen onderdeel van de kern van ZVM.

Als HBA-passthrough bedrijfskritisch is, blijft Proxmox de meer conventionele keuze als host. Als je ZimaOS wilt blijven gebruiken, controleer dan de IOMMU-groepen en de community-uitbreiding in een test-VM voordat je er belangrijke opslag achter plaatst.

Wat IceWhale in de oorspronkelijke thread zei

In november 2025 zei IceWhale dat PCIe-passthrough op korte termijn niet gepland was, maar wel op de langetermijnroadmap stond.

Wat er in 2026 veranderde

De communitythread over de ZVM-Extra-module introduceerde PCIe-passthrough via VFIO en controles van IOMMU-groepen. IceWhale erkende later dat de module de huidige tekortkomingen van ZVM oploste.

Communityondersteuning is geen native ondersteuning

ZVM-Extra werkt naast de officiële ZVM en gebruikt dezelfde libvirt-backend. Dat betekent niet dat native ZVM een officieel gedocumenteerde passthroughinterface heeft gekregen, of dat toekomstige ZimaOS-updates het gedrag van extensies van derden zullen behouden.

Controleer eerst IOMMU

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

Je HBA moet zich in een veilige IOMMU-groep bevinden die kan worden geïsoleerd zonder kritieke hardware van de host over te nemen.

Een LSI HBA is een apparaat met grote impact om door te geven

Zodra de HBA aan VFIO is gekoppeld en aan de VM is toegewezen, mag de host de schijven van de controller niet langer gebruiken. Plaats de ZimaOS-systeemschijf of hostkritieke opslag niet achter dezelfde HBA.

Gebruik Proxmox wanneer passthrough de kernvereiste is

Voor TrueNAS, Unraid of een andere opslag-VM die rechtstreeks eigenaar moet zijn van een HBA, heeft Proxmox een volwassen PCIe-passthroughworkflow en is de architectuur eenvoudiger te begrijpen.

Houd ZimaOS indien nodig als gast

Je kunt ZimaOS als Proxmox-VM draaien voor de apps en interface, terwijl een andere VM eigenaar is van de HBA. De huidige handleiding voor ZimaOS op Proxmox documenteert de momenteel ondersteunde installatie van ZimaOS als gast.

Test of de configuratie na opnieuw opstarten behouden blijft

Een passthroughconfiguratie die één keer werkt, kan na een herstart alsnog mislukken als hostdrivers het apparaat opnieuw overnemen of metagegevens van de extensie niet opnieuw worden toegepast. Test een koude start, het starten en stoppen van de VM en de zichtbaarheid van de opslag voordat je productiegegevens toevertrouwt aan de configuratie.

De hardwarehandleiding voor virtualisatie behandelt de hardwarebeperkingen.

Maak een back-up van de VM-definitie voordat je VFIO-wijzigingen uitvoert

Sla de VM-XML/configuratie en metagegevens van de opslag op voordat je een HBA aan VFIO koppelt. Fouten bij het koppelen van apparaten kunnen ervoor zorgen dat een VM niet meer start of dat de controller geen toegang meer biedt aan de host totdat je een herstelstap uitvoert.

Controleer de volledige IOMMU-groep

Geef een apparaat niet door alleen omdat het PCI-adres ervan in lspci verschijnt. Controleer elke functie in dezelfde IOMMU-groep en verifieer dat het isoleren van de groep geen host-NIC, SATA-controller of ander kritiek apparaat uitschakelt.

Opslag-VM's hebben een herstelplan nodig

Als TrueNAS of een andere gast eigenaar is van de HBA, documenteer dan hoe je die gast, de VM-schijf en de passthroughconfiguratie onafhankelijk van de schijven achter de HBA kunt herstellen. Anders kan een hoststoring de opslagpool ontoegankelijk maken, zelfs wanneer de gegevensschijven gezond zijn.

Veelgestelde vragen

Ondersteunt native ZVM nu officieel PCIe-passthrough?

In de huidige officiële documentatie is geen duidelijke passthroughworkflow van de eerste partij gevonden; de publiek besproken werkende methode in 2026 is een community-uitbreiding.

Kan ZVM-Extra PCIe-apparaten doorgeven?

Volgens de communitydocumentatie kan dat via VFIO, met controles van IOMMU-groepen.

Moet ik een LSI HBA doorgeven aan een opslag-VM?

Alleen als de HBA netjes kan worden geïsoleerd en de host niet afhankelijk is van schijven die erachter zijn aangesloten.

Is Proxmox hiervoor eenvoudiger?

Ja, wanneer PCIe-passthrough een kernvereiste van het ontwerp is en geen optioneel experiment.