Community-Lösung

ZVM PCIe-Passthrough: HBA-Optionen unter ZimaOS heute

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

Für natives ZVM gibt es weiterhin keinen klar dokumentierten, offiziellen PCIe-Passthrough-Workflow. Planen Sie daher keine LSI-HBA-VM auf Grundlage einer angenommenen Option, die möglicherweise gar nicht existiert. IceWhale erklärte ursprünglich, PCIe-Passthrough stehe auf der langfristigen Roadmap. 2026 fügte ein Community-Modul namens ZVM-Extra PCIe-Passthrough auf VFIO-Basis hinzu, es bleibt jedoch eine Community-Erweiterung und ist kein Bestandteil des Kern-ZVM.

Wenn HBA-Passthrough unverzichtbar ist, bleibt Proxmox die konventionellere Wahl für den Host. Wenn Sie bei ZimaOS bleiben möchten, prüfen Sie die IOMMU-Gruppen und die Community-Erweiterung zuerst mit einer Test-VM, bevor Sie wichtigen Speicher darüber betreiben.

Was IceWhale im ursprünglichen Thread sagte

Im November 2025 erklärte IceWhale, dass PCIe-Passthrough kurzfristig nicht geplant sei, aber auf der langfristigen Roadmap stehe.

Was sich 2026 geändert hat

Der Community-Thread zum ZVM-Extra-Modul führte PCIe-Passthrough über VFIO und Prüfungen der IOMMU-Gruppen ein. IceWhale bestätigte später, dass das Modul aktuelle Lücken in ZVM schloss.

Community-Unterstützung ist keine native Unterstützung

ZVM-Extra läuft neben dem offiziellen ZVM und verwendet dasselbe libvirt-Backend. Das bedeutet nicht, dass ZVM nativ über eine offiziell dokumentierte Passthrough-Oberfläche verfügt oder dass künftige ZimaOS-Updates das Verhalten von Drittanbieter-Erweiterungen beibehalten.

IOMMU zuerst prüfen

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

Ihr HBA muss sich in einer sicheren IOMMU-Gruppe befinden, die isoliert werden kann, ohne kritische Hardware des Hosts zu übernehmen.

Ein LSI-HBA ist ein Gerät mit weitreichenden Auswirkungen, wenn es durchgereicht wird

Sobald der Controller an VFIO gebunden und der VM zugewiesen ist, sollte der Host die Laufwerke des Controllers nicht mehr verwenden. Platzieren Sie weder die ZimaOS-Systemfestplatte noch für den Host kritischen Speicher hinter demselben HBA.

Proxmox verwenden, wenn Passthrough die zentrale Anforderung ist

Für TrueNAS, Unraid oder eine andere Speicher-VM, die direkt auf einen HBA zugreifen muss, bietet Proxmox einen ausgereiften PCIe-Passthrough-Workflow und erleichtert die Planung der Architektur.

ZimaOS bei Bedarf als Gast behalten

Du kannst ZimaOS als Proxmox-VM für seine Apps und Benutzeroberfläche ausführen und den HBA gleichzeitig einer anderen VM zuweisen. Der aktuelle Leitfaden zu ZimaOS auf Proxmox beschreibt die derzeit unterstützte Installation von ZimaOS als Gast.

Teste, ob die Konfiguration Neustarts übersteht

Auch ein einmal funktionierendes Passthrough-Setup kann nach einem Neustart ausfallen, wenn Host-Treiber das Gerät erneut übernehmen oder die Metadaten der Erweiterung nicht wieder angewendet werden. Teste Kaltstart, Starten und Stoppen der VM sowie die Sichtbarkeit des Speichers, bevor du produktive Daten anvertraust.

Der Hardware-Leitfaden zur Virtualisierung behandelt die Hardwareanforderungen.

Sichere die VM-Definition, bevor du Änderungen an VFIO vornimmst

Sichere die VM-XML/Konfiguration und die Speichermetadaten, bevor du einen HBA an VFIO bindest. Fehler bei der Gerätebindung können dazu führen, dass eine VM nicht startet oder der Controller bis zum nächsten Wiederherstellungsschritt für den Host nicht mehr verfügbar ist.

Prüfe die gesamte IOMMU-Gruppe

Reiche ein Gerät nicht einfach nur deshalb durch, weil seine PCI-Adresse in lspci erscheint. Prüfe alle Funktionen in derselben IOMMU-Gruppe und vergewissere dich, dass die Isolierung der Gruppe dem Host keine Netzwerkkarte, keinen SATA-Controller oder ein anderes wichtiges Gerät entzieht.

Storage-VMs brauchen einen Wiederherstellungsplan

Wenn TrueNAS oder ein anderer Gast den HBA nutzt, sollte dokumentiert sein, wie sich dieser Gast, seine VM-Festplatte und die Passthrough-Konfiguration unabhängig von den am HBA angeschlossenen Laufwerken wiederherstellen lassen. Andernfalls kann ein Host-Ausfall den Zugriff auf den Speicherpool verhindern, selbst wenn die Datenfestplatten intakt sind.

FAQ

Unterstützt ZVM PCIe-Passthrough inzwischen offiziell nativ?

In den aktuellen offiziellen Dokumenten wurde kein klarer, offizieller Passthrough-Workflow gefunden. Der 2026 öffentlich diskutierte Lösungsweg basiert auf einer Community-Erweiterung.

Kann ZVM-Extra PCIe-Geräte durchreichen?

Laut der Community-Dokumentation ist das über VFIO mit IOMMU-Gruppenprüfungen möglich.

Sollte ich einen LSI-HBA an eine Storage-VM durchreichen?

Nur wenn sich der HBA sauber isolieren lässt und der Host nicht auf Laufwerke angewiesen ist, die daran angeschlossen sind.

Ist das mit Proxmox einfacher?

Ja, wenn PCIe-Passthrough eine zentrale Designanforderung und kein optionales Experiment ist.