Solution communautaire

Transfert direct PCIe de ZVM : options de 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.

Le ZVM natif ne dispose toujours pas d’un processus de passthrough PCIe clairement documenté par l’éditeur. Ne prévoyez donc pas de configurer une VM avec un HBA LSI en supposant qu’une case à cocher existe forcément. IceWhale avait d’abord indiqué que le passthrough PCIe faisait partie de sa feuille de route à 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 au cœur du ZVM.

Si le passthrough d’un HBA est essentiel à votre activité, Proxmox reste le choix d’hyperviseur le plus conventionnel. Si vous souhaitez rester sur ZimaOS, vérifiez les groupes IOMMU et l’extension communautaire dans une VM de test avant de lui confier des données importantes.

Ce qu’IceWhale a déclaré dans le fil d’origine

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

Ce qui a changé en 2026

Le fil du module ZVM-Extra communautaire a introduit le passthrough PCIe via VFIO et les vérifications des groupes IOMMU. IceWhale a ensuite reconnu que le module répondait aux lacunes actuelles du ZVM.

La prise en charge communautaire n’est pas une prise en charge native

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

Vérifiez l’IOMMU avant toute chose

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

Votre HBA doit se trouver dans un groupe IOMMU sûr, qui peut être isolé sans priver l’hôte de matériel essentiel.

Un HBA LSI est un périphérique à fort impact à transférer

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

Utilisez Proxmox si le passthrough est une exigence essentielle

Pour TrueNAS, Unraid ou une autre VM de stockage qui doit contrôler directement un HBA, Proxmox offre un processus mature de passthrough PCIe et facilite la compréhension de l’architecture.

Conservez ZimaOS comme système hôte si nécessaire

Vous pouvez exécuter ZimaOS dans une VM Proxmox pour ses applications et son interface, tout en laissant une autre VM gérer le HBA. Le guide actuel sur ZimaOS avec Proxmox décrit 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 confier des données de production à cette configuration.

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

Sauvegardez la définition de la VM avant toute modification de VFIO

Enregistrez la configuration XML de la VM et les métadonnées de stockage avant de lier un HBA à VFIO. Des erreurs de liaison de périphérique peuvent empêcher le démarrage d’une VM ou retirer le contrôleur de l’accès de l’hôte jusqu’à l’étape de récupération suivante.

Vérifiez l’ensemble 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 supprimera pas une carte réseau, un contrôleur SATA ou un autre périphérique critique de l’hôte.

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

Si TrueNAS ou un autre système invité gère le HBA, documentez comment récupérer ce système invité, son disque de VM et la configuration de passthrough indépendamment des disques connectés au HBA. Sinon, une panne 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 ?

Aucun processus clair de passthrough officiel n’a été trouvé dans la documentation officielle actuelle ; en 2026, la méthode fonctionnelle évoquée publiquement est une extension communautaire.

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

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

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

Seulement si le HBA peut être isolé proprement et que 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 est une exigence centrale de conception et non une simple expérimentation facultative.