Communitylösning

ZVM PCIe-genomströmning: HBA-alternativ på ZimaOS idag

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

Inbyggda ZVM har fortfarande inget tydligt dokumenterat förstapartssätt att genomkoppla PCIe, så planera inte för en LSI-HBA-VM utifrån antagandet att det finns en kryssruta som kanske inte ens existerar. IceWhale uppgav ursprungligen att genomkoppling av PCIe var långsiktigt färdplansarbete; 2026 lade en ZVM-Extra-modul från communityn till PCIe-genomkoppling via VFIO, men den är fortfarande ett community-tillägg och inte en del av ZVM-kärnan.

Om genomkoppling av HBA är verksamhetskritisk är Proxmox fortfarande det mer konventionella valet av värdplattform. Om du vill fortsätta använda ZimaOS bör du testa IOMMU-grupperna och community-tillägget i en test-VM innan du placerar viktig lagring bakom det.

Vad IceWhale sa i den ursprungliga tråden

I november 2025 uppgav IceWhale att PCIe-genomkoppling inte var planerad på kort sikt, men fanns med på den långsiktiga färdplanen.

Vad som ändrades 2026

Tråden om communityns ZVM-Extra-modul introducerade PCIe-genomkoppling via VFIO och kontroller av IOMMU-grupper. IceWhale bekräftade senare att modulen åtgärdade aktuella brister i ZVM.

Community-stöd är inte inbyggt stöd

ZVM-Extra fungerar vid sidan av officiella ZVM och använder samma libvirt-backend. Det betyder inte att inbyggda ZVM har fått ett officiellt dokumenterat gränssnitt för genomkoppling eller att framtida uppdateringar av ZimaOS kommer att bevara funktionaliteten hos tredjepartstillägg.

Kontrollera IOMMU först av allt

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

Din HBA måste ligga i en säker IOMMU-grupp som kan isoleras utan att kritisk maskinvara tas från värden.

En LSI-HBA är en enhet med stor påverkan att genomkoppla

När styrenheten har bundits till VFIO och tilldelats VM:n ska värden inte längre använda styrenhetens diskar. Placera inte ZimaOS-systemdisken eller värdkritisk lagring bakom samma HBA.

Använd Proxmox när genomkoppling är huvudkravet

För TrueNAS, Unraid eller en annan lagrings-VM som måste ha direkt åtkomst till en HBA har Proxmox ett moget arbetsflöde för PCIe-genomkoppling, vilket gör arkitekturen lättare att förstå.

Behåll ZimaOS som gäst om det behövs

Du kan köra ZimaOS som en Proxmox-VM för dess appar och gränssnitt och låta en annan VM äga HBA-kortet. Den aktuella guiden för ZimaOS på Proxmox beskriver den gästinstallation av ZimaOS som stöds för närvarande.

Testa att inställningarna består efter omstart

En passthrough-konfiguration som fungerar en gång kan ändå sluta fungera efter en omstart om värddatorns drivrutiner tar över enheten igen eller om tilläggsmetadata inte tillämpas på nytt. Testa kallstart, start och stopp av VM:en samt lagringens synlighet innan du använder den för produktionsdata.

Den hårdvaruguiden för virtualisering går igenom hårdvarubegränsningarna.

Säkerhetskopiera VM-definitionen innan du gör VFIO-ändringar

Spara VM:ens XML/konfiguration och lagringsmetadata innan du binder ett HBA-kort till VFIO. Fel vid enhetsbindning kan göra att en VM inte startar eller att styrenheten blir oåtkomlig från värddatorn fram till nästa återställningssteg.

Kontrollera hela IOMMU-gruppen

Skicka inte vidare en enhet bara för att dess PCI-adress visas i lspci. Kontrollera alla funktioner i samma IOMMU-grupp och verifiera att isolering av gruppen inte tar bort ett nätverkskort, en SATA-styrenhet eller någon annan kritisk enhet från värddatorn.

Lagrings-VM:ar behöver en återställningsplan

Om TrueNAS eller en annan gäst äger HBA-kortet ska du dokumentera hur du återställer den gästen, dess VM-disk och passthrough-konfigurationen oberoende av diskarna som är anslutna till HBA-kortet. Annars kan ett fel på värddatorn göra lagringspoolen oåtkomlig även om datadiskarna är oskadda.

Vanliga frågor

Har inbyggda ZVM officiellt stöd för PCIe-passthrough nu?

Det finns inget tydligt arbetsflöde för passthrough från första part i de aktuella officiella dokumenten. Den arbetsmetod från 2026 som diskuteras offentligt är ett community-tillägg.

Kan ZVM-Extra skicka vidare PCIe-enheter?

Enligt dokumentationen från dess community är svaret ja, via VFIO med kontroller av IOMMU-gruppen.

Bör jag skicka vidare ett LSI-HBA-kort till en lagrings-VM?

Bara om HBA-kortet kan isoleras på ett tillförlitligt sätt och värddatorn inte är beroende av några diskar som är anslutna till det.

Är Proxmox enklare för detta?

Ja, när PCIe-passthrough är ett grundläggande designkrav snarare än ett frivilligt experiment.