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

ZimaOS向けZVMの追加機能:自動起動、スナップショット、USB/PCIeパススルー、VMバックアップ

A May-August 2026 community project that adds operational controls beside ZimaOS's built-in ZVM: autostart, snapshots, USB and PCIe passthrough, VM backup/export, remote storage, metrics, NIC switching, power controls, and a VNC console. IceWhale staff praised the work but it remains a community add-on.

ZVM Extrasは、ZVM自体を置き換えることなく、ZimaOSに組み込まれたZVMマネージャーの運用上の不足を補うために構築されたコミュニティ拡張機能です。公式のZVMは引き続き仮想マシンの作成と編集を担い、ZVM Extrasは独立した systemd-sysext モジュールであり、同じlibvirtバックエンドと通信します。

このプロジェクトは、autostart、スナップショット、USBパススルー、リモートストレージ、バックアップ、ウォッチドッグ、メトリクスを備え、ZimaOS 1.6.1上で2026年5月に始まりました。その後、コミュニティによるテストを通じて急速に進化しました。現在の公開リポジトリでは、ZimaOS 1.7.0-beta1で検証されたv0.7.0が文書化されており、v0.6.3の複数のバグはすでに修正されています。

ZVMを置き換えるのではなく拡張

ソースの作者は、2つ目のVMマネージャーを構築することを意図的に避けました。ZVM Extrasは同じVMインベントリを読み取り、libvirt/virshを介して動作します。一方、通常のZVMインターフェースはVMの作成と通常の編集における正式な管理元であり続けます。

この設計により、組み込みの仮想化レイヤーとの競合は軽減されますが、互換性のリスクがなくなるわけではありません。ZimaOSまたはZVMの更新によって、拡張機能の下でlibvirtの動作、VM XML、ネットワーク、デバイス処理が変更される可能性は依然としてあります。

自動起動にVMごとの順序と遅延を追加

この拡張機能では、ZimaOSホストの起動後に選択したVMを自動的に起動するよう設定できます。単純な「すべて自動起動」スイッチとは異なり、VM間の順序と遅延を設定できるため、インフラサービスを順番に起動できます。

ウォッチドッグは、予期せず停止した選択中のVMを再起動することもできます。v0.7.0では、同じ領域に起動、停止、再起動、強制停止の操作が追加され、ユーザーが停止しようとしているVMをウォッチドッグが直ちに再起動する場合には警告が表示されます。

スナップショットは実行中と停止中のVMを異なる方法で処理

ZVM Extrasのスナップショットタブ。スナップショットの作成、保存先、復元、削除の操作を備えた実行中のLinux VMを表示
この拡張機能は、ユーザーがvirshで手動管理する必要なく、スナップショットの作成、復元、削除を行えるGUIを提供します。

当初の設計では、停止中のVMには内部libvirtスナップショットを、実行中のVMにはメモリ状態を含む外部スナップショットを使用していました。この違いは重要です。実行中のVMのスナップショットはより複雑で、相当なストレージ容量を消費する可能性があるためです。

リモートのNFSまたはSMBストレージもスナップショットの保存先として使用でき、ローカルNVMeデバイスへの負荷を軽減できます。

USBパススルーがGUIワークフローに

ZVM ExtrasのUSBパススルータブ。ホストのUSBデバイスを一覧表示し、永続的な接続・切断操作を提供
元のプロジェクトではホストUSBデバイスを表示し、libvirt XMLを手動で編集せずに、選択したVMへの永続的な接続を設定できます。

この拡張機能は、通常のZVM UIが後からゲスト設定を書き換え、ホストデバイスのエントリを削除した場合でも、永続的なUSB接続を再調整します。

PCIeパススルーはVFIOとIOMMUグループを使用

v0.4.0までに、ZVM ExtrasはPCIeパススルーを追加しました。インターフェースにはIOMMUグループとホストドライバーが表示され、明らかに不適切なブリッジデバイスはブロックされ、割り当てにはVFIOが使用されます。

これは、通常のUSBデバイスをパススルーするよりも高リスクな機能です。選択したハードウェアは安全に分離され、ホストがそれに依存しないようにする必要があります。また、不適切な割り当てはホストの安定性やネットワークに影響を及ぼす可能性があります。

リモートストレージにはスナップショットとバックアップを保存可能

スナップショットとバックアップの保存先としてNFSまたはSMB共有を追加するZVM Extrasのリモートストレージタブ
NFSおよびSMBマウントは、VMスナップショットとバックアップのエクスポート先となるリモートターゲットとして設定できます。

これは、大容量のQCOW2仮想ディスクで特に役立ちます。アクティブなVMと同じ物理デバイスにすべてのスナップショットを保持しても、ローカルドライブの故障に対する保護はほとんどなく、容量を急速に消費する可能性があります。

VMバックアップはXMLとディスクイメージをエクスポート

このプロジェクトでは、VMの設定とディスクイメージをスタンドアロンのバックアップアーティファクトとしてエクスポートできます。後のバージョンでは、選択したバックアップ先が記憶されるため、繰り返し行う操作が簡単になります。

VMスナップショットとVMバックアップは同じものではありません。スナップショットは主にロールバックのための仕組みです。別のデバイスに保存した個別のバックアップは、ホストのストレージ自体が失われた場合に備えてデータを保護します。

ライブメトリクスにより、ZVMはより実用的なダッシュボードになる

ZVM Extrasは、libvirtからCPU、メモリ、ディスク、ネットワークのメトリクスを読み取ります。コミュニティユーザーは、テスト用VMでこれらの測定が機能することを確認しました。v0.6.3では、すべてのVMでメモリ使用率が100%と表示されるという報告がありましたが、作成者は計算の問題を突き止め、v0.7.0で修正しました。このバージョンでは短期間の履歴スパークラインも追加されています。

NICの切り替えは既存ネットワークに意図的に限定

この拡張機能では、ゲストNICのlibvirtネットワークとモデルを変更できます。作成者は、稼働中のZimaOS Ethernetインターフェースを新しいホストブリッジに組み込む処理の自動化を意図的に見送りました。ブリッジ移行に失敗すると、NASがオフラインになる可能性があるためです。

この慎重な境界線は重要です。既存のネットワークを選択するほうが、VM管理アドオンからホストの主要なネットワークスタックを書き換えるよりはるかに安全です。

VM ↔ ホスト間通信は依然として macvtap の制限を受ける可能性がある

あるコミュニティユーザーはLANからHome Assistant VMにアクセスできましたが、同じ物理NICを使用していたZimaOSホスト上のリバースプロキシコンテナからはアクセスできませんでした。出典の作者は、典型的なmacvtapのホスト分離動作を疑い、ゲストXMLを確認するよう提案しました。

彼はその説明が仮説であることを明確に示していました。正確な構成を再現できなかったためです。実際のインターフェースの種類を確認せずに、これをZimaOSの確定した根本原因とみなさないでください。

このプロジェクトには実用的なテストスイートが追加されましたが、すべてのハードウェア経路が網羅されているわけではありません

v0.4.0について、作者は静的解析、競合テスト、CSRF/オリジン制御、引数・パスインジェクション対策、スナップショット、バックアップのエクスポート、NIC変更、メトリクスなど、63件のテストケースに合格したと報告しています。実際の電源サイクルやPCIeデバイスのライブ接続のケースは、意図的にその自動テストの範囲外とされました。

別のコミュニティユーザーも独自にv0.4.0をインストールし、sysextが読み込まれること、Debian VMが検出されること、メトリクスが表示されること、停止中のVMのスナップショットが正常に作成されることを確認しました。

IceWhaleはこのプロジェクトを高く評価しましたが、今もコミュニティ製ソフトウェアです

その後、Zima-Jerryは、このプロジェクトが現在のZVMの欠点に対処しているようだと返信しました。これは肯定的な公式フィードバックであり、ZVM ExtrasがZimaOSの一部になった、または組み込みモジュールのようにサポートされるようになったという発表ではありません。

インストール前に、現在のZVM Extrasリポジトリとリリース状況を確認してください。現在のリポジトリでは、v0.7.0がZimaOS 1.7.0-beta1で検証済みとされています。

コミュニティ製仮想化拡張機能をテストする前にVMデータをバックアップ

スナップショット、パススルー、XMLの整合性調整は、いずれもVMのストレージとデバイス構成に密接に関わります。まずは破棄可能なゲストでテストし、重要なQCOW2ディスクのコピーを保管し、拡張機能をインストールしていない状態でも復元できることを確認してください。

ZVM Extras FAQ

ZVM Extrasは公式のZVMアプリを置き換えますか?

いいえ。コンパニオン拡張機能として設計されており、同じlibvirtバックエンドを使用します。

GUIからUSBデバイスやPCIeデバイスをパススルーできますか?

はい。USBパススルーとVFIOベースのPCIeパススルーは、このプロジェクトの中核機能です。

別のNASにVMをバックアップできますか?

NFSまたはSMBストレージをマウントし、スナップショットやバックアップのエクスポートにリモートパスを使用できます。

ZVM ExtrasはIceWhaleによって正式にサポートされていますか?

いいえ。IceWhaleのスタッフは高く評価しましたが、出典と現在のリポジトリではコミュニティ製アドオンと説明されています。