コミュニティソリューション

ZVMのPCIeパススルー:現在のZimaOSにおけるHBAの選択肢

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には、明確に文書化された公式のPCIeパススルー手順がまだないため、存在しない可能性のあるチェックボックスを前提にLSI HBA用VMを計画しないでください。IceWhaleは当初、PCIeパススルーを長期ロードマップの作業と説明していました。2026年には、コミュニティ製のZVM-ExtraモジュールによってVFIOベースのPCIeパススルーが追加されましたが、依然としてZVMコアの機能ではなく、コミュニティ拡張機能です。

HBAパススルーがミッションクリティカルな場合は、Proxmoxのほうが一般的なホストの選択肢です。ZimaOSを使い続けたい場合は、重要なストレージを接続する前に、テストVMでIOMMUグループとコミュニティ拡張機能を検証してください。

元のスレッドでIceWhaleが説明した内容

2025年11月、IceWhaleはPCIeパススルーを短期的には予定していないものの、長期ロードマップには掲載していると説明しました。

2026年に変わったこと

コミュニティのZVM-Extraモジュールのスレッドでは、VFIOとIOMMUグループのチェックを介したPCIeパススルーが導入されました。その後IceWhaleは、このモジュールが現在のZVMの不足機能を補っていると認めました。

コミュニティサポートはネイティブサポートではない

ZVM-Extraは公式ZVMと並行して動作し、同じlibvirtバックエンドを使用します。これは、ネイティブZVMに公式に文書化されたパススルーUIが追加されたことや、今後のすべてのZimaOSアップデートでサードパーティ拡張機能の動作が維持されることを意味しません。

まずIOMMUを確認する

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

HBAは、ホストの重要なハードウェアを奪うことなく分離できる、安全なIOMMUグループに属している必要があります。

LSI HBAはパススルーの影響が大きいデバイス

VFIOにバインドしてVMに割り当てると、ホストはそのコントローラーに接続されたディスクを使用しないようにする必要があります。ZimaOSのシステムディスクやホストに不可欠なストレージを、同じHBAの背後に配置しないでください。

パススルーが中核要件ならProxmoxを使う

HBAを直接所有する必要があるTrueNAS、Unraid、その他のストレージVMには、Proxmoxのほうが成熟したPCIeパススルーの手順があり、構成も理解しやすくなります。

必要ならZimaOSをゲストとして維持する

アプリやUIのためにZimaOSをProxmox VMとして実行し、別のVMにHBAを所有させることができます。現在のProxmoxへのZimaOSインストールガイドでは、現在サポートされているZimaOSゲストのインストール方法を説明しています。

再起動後の永続性をテストする

一度は動作するパススルー構成でも、ホストのドライバーがデバイスを再取得したり、拡張機能のメタデータが再適用されなかったりすると、再起動後に失敗することがあります。本番データを信頼する前に、コールドブート、VMの起動と停止、ストレージの認識をテストしてください。

仮想化ハードウェアガイドでは、ハードウェア要件について説明しています。

VFIOを変更する前にVM定義をバックアップする

HBAをVFIOにバインドする前に、VMのXML/構成とストレージのメタデータを保存してください。デバイスのバインドを誤ると、VMが起動しなくなったり、次の復旧手順までコントローラーにホストからアクセスできなくなったりする可能性があります。

IOMMUグループ全体を確認する

PCIアドレスがlspciに表示されるからといって、そのデバイスを安易にパススルーしないでください。同じIOMMUグループに含まれるすべてのファンクションを確認し、グループを分離してもホストのNIC、SATAコントローラー、その他の重要なデバイスが失われないことを検証してください。

ストレージVMには復旧計画が必要

TrueNASなどのゲストがHBAを所有する場合は、HBAの背後にあるディスクとは独立して、そのゲスト、VMディスク、パススルー構成を復旧する方法を文書化してください。そうしないと、データディスクが正常でも、ホスト障害によってストレージプールにアクセスできなくなる可能性があります。

よくある質問

ネイティブZVMは現在、PCIeパススルーを公式にサポートしていますか?

現在の公式ドキュメントには、明確な公式パススルー手順は見つかりませんでした。2026年に公開の場で議論されている動作手段は、コミュニティ拡張機能です。

ZVM-ExtraでPCIeデバイスをパススルーできますか?

コミュニティのドキュメントでは、IOMMUグループのチェックを伴うVFIOによって可能だと説明されています。

LSI HBAをストレージVMにパススルーすべきですか?

HBAを問題なく分離でき、ホストがその背後にあるディスクに依存していない場合に限ってください。

この用途ではProxmoxのほうが簡単ですか?

PCIeパススルーが任意の実験ではなく中核的な設計要件である場合は、はい。