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

ZimaOSでのZVM PCIeパススルー:現在利用できる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を使う

TrueNAS、Unraid、またはHBAを直接専有する必要がある別のストレージVMには、Proxmoxの成熟したPCIeパススルーのワークフローを使うと、構成を把握しやすくなります。

必要に応じてZimaOSをゲストOSとして使う

アプリやUIにはZimaOSをProxmoxのVMとして実行し、HBAは別のVMに管理させることができます。現行の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デバイスをパススルーできますか?

コミュニティのドキュメントでは、VFIOとIOMMUグループの確認を使えば可能とされています。

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

HBAを適切に分離でき、ホストがそのHBA配下のディスクに依存していない場合に限ります。

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

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