Solution communautaire

ZVM avec passthrough PCIe : options HBA disponibles aujourd’hui sur 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 natif ne dispose toujours pas d’une procédure de passthrough PCIe de première partie clairement documentée. Ne concevez donc pas une VM destinée à un HBA LSI en partant du principe qu’une case à cocher, qui n’existe peut-être pas, sera disponible. IceWhale avait initialement indiqué que le passthrough PCIe relevait des travaux prévus à long terme. En 2026, un module communautaire ZVM-Extra a ajouté le passthrough PCIe basé sur VFIO, mais il reste une extension communautaire et non une fonctionnalité intégrée à ZVM.

Si le passthrough d’un HBA est essentiel, Proxmox reste le choix d’hyperviseur le plus conventionnel. Si vous souhaitez rester sous ZimaOS, vérifiez les groupes IOMMU et l’extension communautaire dans une VM de test avant de lui confier un stockage important.

Ce qu’IceWhale a indiqué dans le fil de discussion d’origine

En novembre 2025, IceWhale a indiqué que le passthrough PCIe n’était pas prévu à court terme, mais qu’il figurait sur la feuille de route à long terme.

Ce qui a changé en 2026

Le fil de discussion du module communautaire ZVM-Extra a introduit le passthrough PCIe via VFIO ainsi que la vérification des groupes IOMMU. IceWhale a ensuite reconnu que le module comblait les lacunes actuelles de ZVM.

Le support communautaire n’est pas un support natif

ZVM-Extra fonctionne à côté de ZVM officiel et utilise le même backend libvirt. Cela ne signifie pas que ZVM natif dispose désormais d’une interface de passthrough officiellement documentée, ni que toutes les futures mises à jour de ZimaOS préserveront le fonctionnement des extensions tierces.

Vérifiez l’IOMMU avant toute autre chose

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

Votre HBA doit se trouver dans un groupe IOMMU sûr, pouvant être isolé sans monopoliser du matériel hôte critique.

Un HBA LSI est un périphérique à fort impact à affecter en passthrough

Une fois lié à VFIO et affecté à la VM, l’hôte ne doit plus utiliser les disques du contrôleur. Ne placez pas le disque système de ZimaOS ni un stockage critique pour l’hôte derrière le même HBA.

Utilisez Proxmox lorsque le passthrough est l’exigence principale

Pour TrueNAS, Unraid ou une autre VM de stockage qui doit posséder directement un HBA, Proxmox propose une procédure de passthrough PCIe mature et facilite la compréhension de l’architecture.

Gardez ZimaOS en tant que VM invitée si nécessaire

Vous pouvez exécuter ZimaOS comme VM Proxmox pour ses applications et son interface, tout en laissant une autre VM posséder le HBA. Le guide actuel consacré à ZimaOS sur Proxmox documente l’installation actuellement prise en charge de ZimaOS en tant que système invité.

Testez la persistance après redémarrage

Une configuration de passthrough qui fonctionne une fois peut tout de même échouer après un redémarrage si les pilotes de l’hôte récupèrent le périphérique ou si les métadonnées de l’extension ne sont pas réappliquées. Testez le démarrage à froid, le démarrage et l’arrêt de la VM, ainsi que la visibilité du stockage avant de lui confier des données de production.

Le guide du matériel de virtualisation détaille les contraintes matérielles.

Sauvegardez la définition de la VM avant les modifications VFIO

Enregistrez le fichier XML ou la configuration de la VM ainsi que les métadonnées du stockage avant de lier un HBA à VFIO. Une erreur de liaison du périphérique peut empêcher une VM de démarrer ou retirer le contrôleur de l’accès de l’hôte jusqu’à l’étape de récupération suivante.

Vérifiez l’intégralité du groupe IOMMU

Ne transmettez pas un périphérique simplement parce que son adresse PCI apparaît dans lspci. Inspectez chaque fonction du même groupe IOMMU et vérifiez que l’isolation du groupe ne privera pas l’hôte d’une carte réseau, d’un contrôleur SATA ou d’un autre périphérique critique.

Les VM de stockage ont besoin d’un plan de récupération

Si TrueNAS ou un autre système invité possède le HBA, documentez la manière de récupérer ce système invité, son disque de VM et la configuration du passthrough indépendamment des disques connectés au HBA. Sinon, une défaillance de l’hôte peut rendre le pool de stockage inaccessible même si les disques de données sont en bon état.

FAQ

ZVM natif prend-il désormais officiellement en charge le passthrough PCIe ?

Aucune procédure de passthrough clairement fournie par l’éditeur n’a été trouvée dans la documentation officielle actuelle ; la méthode fonctionnelle évoquée publiquement en 2026 repose sur une extension communautaire.

ZVM-Extra peut-il transmettre des périphériques PCIe ?

Sa documentation communautaire indique que oui, via VFIO et avec des vérifications des groupes IOMMU.

Devrais-je transmettre un HBA LSI à une VM de stockage ?

Uniquement si le HBA peut être isolé proprement et si l’hôte ne dépend d’aucun disque qui lui est connecté.

Proxmox est-il plus simple pour cela ?

Oui, lorsque le passthrough PCIe constitue une exigence essentielle de l’architecture plutôt qu’une simple expérimentation facultative.