ProxmoxからNixOSとIncusへの移行
Migrating from Proxmox to NixOS and Incus (nijho.lt)
要約
この記事では、筆者が数年間使用してきたProxmoxクラスターを、宣言型設定管理システムであるNixOSと仮想化管理ツールIncusに移行した経験について語られています。ProxmoxのGUI中心の命令型システムが抱える「状態のずれ」やAIエージェントとの相性の悪さといった課題を挙げ、NixOSの宣言性と再現性の高さが、複雑な設定やトラブルシューティング、さらにはAIを活用したインフラ管理においていかに優れているかを強調しています。これにより、ホームラボの運用がより柔軟かつ堅牢になったと述べています。
全文翻訳
NixOSに完全移行:ProxmoxからNixOS + Incusへ
私は公式にProxmoxクラスタを廃止しました。長年、単一のNUCから始めてマルチノードクラスタに拡張してきたホームラボをProxmoxで運用してきましたが、すべてをNixOS上で動作するIncusに移行しました。
更新 2026-06-26: この投稿はHacker Newsのフロントページに掲載され、多くの読者がProxmoxはWeb UIでのクリック操作に限定されないことを正しく指摘しました。
qm、pct、設定ファイル、REST API、Terraformプロバイダー、Ansibleワークフローなどがあります。私の意図は、Proxmoxが自動化できないということではありません。その自動化をもってしても、デバッグのために一時的なコマンドを一つ実行し、それが自動化フレームワークに反映されない場合、状態のドリフトは依然として発生し得ます。私が求めたのは、再現可能な設定自体を真実の情報源とすることでした。私が気にかけているのは、ボタンかコマンドかではなく、バージョン管理されたテキストファイルからホストを再構築できるか、そしてすべての重要な変更がそこにキャプチャされていると確信できるかです。
熱心な信奉者になるまで #
私は常にNixの熱心な信奉者だったわけではありません。実際、当初はNix言語とその構文を嫌悪していました。その仕組みが理解できず、ドットファイルの設定にはすでに自分独自の特定の方法を持っていました。シンボリックリンクにはDotbotを、バイナリ管理には私が書いたdotbinsというツールを使用していました。ほとんどのツールでNixが必要だとは感じていませんでした。Macでは長らくnix-darwinを使用していましたが、それはHomebrewパッケージとアプリケーション設定を指定するためだけでした。
私の真の転換は、ゲーミングPCを購入したとき(ローカルLLMに関する投稿で説明した通り)に起こりました。当初、ゲームをプレイしたかったのと、Windowsを絶対に避けたいという理由からPop!_OSをインストールしました。いくつかのゲームは動作しましたが、NVIDIAドライバーの問題に常に直面し、ランダムな命令的なコマンドを実行して修正する必要がありました。これは悪い解決策だと感じました。なぜなら、後でこれらのデバッグ手順を再現することが決してできなかったからです。その後、NVIDIAドライバーを更新するという愚かなことをしてしまい、ドライバーのバージョンやリポジトリを命令的に管理することが悲劇の元凶であることを理解していませんでした。その結果、GRUBのブートループに陥ってしまいました。フラストレーションを感じ、NixOSをインストールし、そのアトミックアップデートの約束がこの問題を解決してくれることを期待しました。結果は素晴らしかったです。システムを新しいディスクに移行するまで、すべてがバイト単位で同等になるとは本当に信じていませんでした。ドライブをクローンしたのではなく、Nixの設定を新しいインストールに適用しただけです。起動し、データをコピーし、すべてが同一でした。それが理解できた瞬間でした。
命令的システムの摩擦 #
Proxmoxは素晴らしいソフトウェアです。それは私の参入障壁を下げ、仮想化、LXCコンテナ、ZFSについて私が知っていることのほとんどすべてを教えてくれました。しかし、根本的に、Proxmoxはボタンをクリックすることを中心に構築されています。それはGUIファーストのパラダイムです。TerraformやAnsibleで自動化することも可能ですが、しばしばツールとの戦いのように感じられます。状態のドリフトは現実です。デバッグのためにUIで設定を変更し、それを忘れてしまい、6ヶ月後にあなたの「インフラストラクチャ・アズ・コード」が現実と同期しなくなります。手動でシステムを管理する人間にとっては、これは迷惑なことです。しかし、AIエージェントを導入すると、これはオペレーターにとって悲劇となります。「YOLOモード」で動作するエージェントは、問題を修正するために数百もの命令的なコマンドを実行する可能性があります。成功するかもしれませんが、システムは未定義で再現不可能な状態になり、誰も—エージェント自身でさえ—それを完全に理解したり、後で再現したりすることはできません。
この摩擦はハードウェア管理にも現れます。私のHP EliteDeskでは、Intel I219-LMネットワークカードには、ハードウェアオフロードが有効になっているとハングするという既知のバグがあります。Proxmoxでこれを数年前に修正したことをかすかに覚えていましたが、詳細は忘れていました。NixOSを設定したとき、同じ問題に直面しました。ネットワークがランダムにドロップしました。しかし、今回は修正がルートシェル履歴で実行された忘れられたコマンドではありません。それは私の設定にある文書化されたsystemdサービスです。フォーラムのスレッドを引用して、なぜtso off gso offが必要なのかを正確に説明するコメントを追加しました。このマシンを再インストールした場合でも、修正は自動的に適用されます。Proxmoxでは、この苦痛を再び発見しなければならなかったでしょう。
もう一つの例は私のIntel NUCです。私のホームラボはテレビの後ろにあるため、ホームシアターPC(HTPC)としても使用できるか疑問に思いました。Proxmoxでは、GPUをVMにパススルーしてビデオ出力を得る必要がありました。しかし、そうするとProxmoxホストはGPUへのアクセスを完全に失い、問題が発生した場合にローカルコンソールが使用できなくなります。これは厳密なトレードオフでした。メディアプレーヤーか、デバッグ可能なハイパーバイザーかのどちらかです。試しましたが、あまりにも手間がかかったため、すぐに元に戻しました。NixOSでは、選択する必要はありません。ホストOSはKodiを直接実行し、ネイティブのハードウェアアクセラレーションとビデオ出力を提供します。同時に、incusはバックグラウンドで動作し、コンテナをホストします。仮想化のオーバーヘッドや「ヘッドレスホスト」の制限なしに、同じハードウェアでHTPCとサーバーの両方を得ることができます。
より深い哲学的な違いもあります。ProxmoxやTrueNASのようなシステムはアプライアンスとして設計されています。ホスト上で任意のコマンドを実行することは想定されていません。パッケージのインストールや設定ファイルの微調整は、ミドルウェアを破損させたり、アップグレード時に変更を失ったりする可能性があるため推奨されません。あなたは実質的に、あなた自身のハードウェアの潜在能力から締め出されています。NixOSでは、ホストは完全に私のものです。Kodiのインストール、ネットワークドライバーの調整、ローカルLLMの実行など、恐れることなくいじることができます。状態は宣言的なので、100%明白で再現可能です。ホストの設定を破損させても、数秒で動作状態に回復できます。たとえマシンが重要なサービスを実行していてもです。
エージェントによる増幅 #
私は以前からエージェントコーディングへの移行について書いてきました。AIエージェントがタスクを実行する世界では、CLIファーストで宣言的なシステムが王様です。AIエージェントは、VLANタグの設定やディスクのリサイズのためにWebインターフェースで「ボタンをクリックする」ことを信頼性高く行うことはできません。テキストが必要です。決定論が必要です。
NixOSに移行したことで、私のインフラ全体がテキストファイルで定義されるようになりました。これは、私のAIエージェントが私のインフラを読み、理解し、さらには安全に変更できることを意味します。Proxmoxの不透明なデータベースとUI主導のワークフローは、私のエージェントにとってブラックボックスでした。NixOSは開かれた本です。「Faster Whisper APIサーバーをポート9000でデプロイし、LANに公開する」というタスクをエージェントに実行させたい場合、それは「Services」メニュー、次に「Network」メニュー、そして「Firewall」メニューをナビゲートする必要はありません。それは単にsystemdサービス定義を記述し、同じファイルにnetworking.firewall.allowedTCPPorts = [ 9000 ];を追加するだけです。エージェントは、git diffやアクティブな設定を確認することで、変更が成功したことを検証することさえできます。これは、私が生きている「エージェントコーディング」革命のインフラストラクチャの対価です。
長年NixOSを使用している友人が、特に8台のマシンを管理する上で、私の設定がいかにうまく構造化されているかを褒めてくれました。面白いのは、私が自分で書いた設定行はほとんどないということです。私は多くのセッションを通じて、エージェントAIを使用してすべてを行いました。単一のマシンから2台、そして最終的に9台へと、何度も再構築とリファクタリングを行いました。AIはリファクタリングの重労働をこなし、私のPC、NUC、HPが共通モジュールを共有しつつ、それぞれのユニークな個性を保つようにしています。
アーキテクチャ:Incusとシミュレーション #
永続的でステートフルなLXCコンテナとVMを管理するための、純粋な「Nix」の方法があればと今でも願っています。nixos-containersやmicrovm.nixのようなプロジェクトはありますが、それらは堅牢なハイパーバイザーの運用成熟度やライブマイグレーション機能に欠けることが多いです。Incus(LXDのコミュニティフォーク)はこのギャップを完璧に埋めます。これにより、ホストにはNixOSの「牛」管理が可能になり、安定した管理可能な環境で「ペット」のレガシーワークロード(古いUbuntuコンテナやHome Assistant VMなど)を実行できます。特に、IncusはクリーンなCLIを通じて完全に制御可能であり、私のエージェントワークフローにおいて完璧な市民となります。
時間をかけて、DNSやメディアマネージャーなどのサービスであるほとんどのレガシーLXCコンテナを、VM内で実行される宣言的なDocker Composeファイルにすでに移行していました。しかし、まだ大きな抵抗がありました:Home Assistant OSです。これに代わる良い選択肢がありませんでした。Home Assistantを確実に実行するには、Proxmoxのような専用のアプライアンスOSが必要だと想定していました。IncusをNixOS上で実行すれば、Home Assistant用のフルVMを実行することがいかに簡単であるかに気づいていませんでした。それは単なる別のQEMUプロセスですが、コンテナと同じ容易さで管理されます。
私が実行した興味深いことの一つは、物理マシンと全く同じ設定を複製するIncus VMを作成したことです。最後のProxmoxホストを実際にオフにする前に、同じ設定を実行する仮想マシンがあったため、完全な設定が機能することにすでに自信がありました。私はオーバーライドを含む小さなファイルを持っているだけです。その後、仮想マシンが機能することを確認できました。これにより、物理サーバーを「破壊して再構築」する恐怖がなくなりました。
移行 #
vzdumpとqemu-imgのおかげで、移行は驚くほど簡単でした。7年以上にわたる私のデジタル履歴をデータ損失なしで移動した方法を以下に示します。
また、ドットファイルに詳細な移行ノートも保持しています。これらのノートは、同じことを試みる人にとって十分なはずです。もしそうでなくても、AI(私はGemini 3 Proを使用しました)に渡せば、間違いなく解決策を見つけられるでしょう。
1. LXCコンテナの移行 #
LXCコンテナ(Docker、DNSなどを実行)については、実質的に「テレポート」しました。実行中のProxmoxコンテナを標準化されたtarballにダンプし、コピーして、新しいIncusコンテナに直接ストリームしました。
Proxmoxで:
# コンテナ101を圧縮アーカイブにダンプ
vzdump 101 --dumpdir /var/lib/vz/dump --mode suspend --compress zstd
NixOSで(私のmigrate-lxc.shスクリプトを使用):
# バックアップを新しいIncusコンテナにストリーム
./migrate-lxc.sh vzdump-lxc-101-*.tar.zst ubuntu-container
このスクリプトは、新しいコンテナを作成し、そのルートファイルシステムをマウントし、Proxmoxのダンプで上書きします。UIDのマッピングやmachine-idの修正など、面倒な部分を自動的に処理します。
2. 仮想マシンの移行 #
VM(Home Assistant OSなど)については、ディスク形式の変換の問題でした。ProxmoxはLVM-thinまたはZFS zvolを使用します。IncusはQCOW2または生のZFSで問題ありません。
Proxmoxで:
# ZFSボリュームをQCOW2ファイルにエクスポート
qemu-img convert -p -O qcow2 /dev/zvol/rpool/data/vm-100-disk-0 vm-100.qcow2
NixOSで(migrate-vm.shを使用):
# ディスクをインポートしてVMを作成
./migrate-vm.sh vm-100.qcow2 home-assistant
結果 #
現在、ホストOS、ネットワーキング、ストレージ、ハイパーバイザーの設定を含む、私のすべてのマシン群を単一のgitリポジトリから管理しています。両方の世界の最良の部分を得ています。必要な場所には永続的でステートフルなサービスがあり、再現可能で堅牢なホストオペレーティングシステムがあります。ホストマシンをワイプし、NixOSを再インストールし、リストアスクリプトを実行すれば、数分でオンラインに戻ることができます。何よりも、3年前にWeb UIでどのチェックボックスをクリックしたかを思い出す必要は決してありません。すべてコードにあります。そしてコードであるため、エージェントがそれを管理するのを手伝ってくれます。
参考文献と設定 #
この記事で言及されているすべての設定ファイルは、私のドットファイルリポジトリで入手できます。
- flake.nix: 私のフリート全体(PC、NUC、HP)を定義するエントリポイント。
- networking.nix: Intel I219-LMネットワークハングの宣言的な修正。
- kodi.nix: ホストでKodiを直接実行するNUC HTPCの設定。
- ai.nix: Faster Whisperの宣言的なサービス定義。
- incus-overrides.nix: Incus VM内で物理マシンをシミュレートするために使用されるオーバーライド。
- migrate-lxc.sh: Proxmox
vzdumpアーカイブをIncusコンテナにインポートするためのスクリプト。 - migrate-vm.sh: QCOW2ディスクイメージをIncus VMにインポートするためのスクリプト。
- PROXMOX_MIGRATION.md: 移行の詳細な生のノートとインベントリ。