多くの homelab や小さな team の Proxmox cluster は、いつの間にか細かい script だらけになる。VM status を見る script、臨時 migration、PBS から backup を探す script、事故中に危ない操作をしないためのメモ。Web UI は大半の作業をこなせるが、on-call、CI、repeatable runbook に入れるなら terminal のほうが扱いやすい。ただし、terminal tool が infrastructure に write できるなら、ただ見た目のよい TUI で終わってはいけない。

今日見るのは fabriziosalmi/proxxx。Rust で書かれた Proxmox VE / Proxmox Backup Server terminal cockpit で、CLI、TUI、MCP server、alert/HITL daemon を一つの proxxx binary にまとめている。README の方向性は明確だ。Cluster に追加 daemon を置かず、既存の PVE/PBS REST API と SSH で管理する。Read operation は速く、write operation は pre-flight risk gate を通し、必要なら Telegram で human-in-the-loop approval を挟む。

GitHub repository API、README、LICENSE、Cargo.toml、latest release、tags、commits API を 2026-08-29 18:03 Asia/Shanghai 時点で確認すると、fabriziosalmi/proxxx は 23 stars、2 forks。主要言語は Rust、license は MIT、default branch は main、repository 作成日は 2026-05-01 17:08:46 UTC、latest push は 2026-08-29 10:02:39 UTC。最新 commit は 8a4888d、commit time は 2026-08-29 09:58:22 UTC、内容は supply-chain audit failure を解消する dependency update。Latest GitHub Release は v0.13.2、published time は 2026-07-07 13:57:40 UTC。Cargo.toml の crate version も 0.13.2 で、MSRV は Rust 1.95 とされている。

プロジェクト概要

項目内容
リポジトリfabriziosalmi/proxxx
位置づけProxmox VE / PBS 向け Rust TUI、CLI、MCP server、ops cockpit
Stars23
Forks2
主要言語Rust
ライセンスMIT
作成日2026-05-01 17:08:46 UTC
Latest push2026-08-29 10:02:39 UTC
最新 commit8a4888d、2026-08-29 09:58:22 UTC
最新 Releasev0.13.2、2026-07-07 13:57:40 UTC
キーワードProxmox、TUI、CLI、GitOps、HITL、MCP、audit log

単なる Proxmox TUI ではない

proxxx の入口は、よくある terminal dashboard に見える。proxxx で TUI を開き、proxxx ls nodes、proxxx ls guests、proxxx fleet で node、guest、storage、multi-cluster view を確認する。README では cluster-wide read を一秒程度で行うこと、fuzzy search、fleet view、cross-cluster find <vmid> を強調している。複数の PVE node を毎日触る人には、この時点ですでに便利だ。

ただし面白いのは、read-only inspection と危険な write operation を分けて扱っているところだ。README には start、stop、migrate、snapshot、clone、backup、patch、disk move などの write path が並ぶ。これらに対して、proxxx は per-guest と state-change の二種類の pre-flight risk gate を使う。たとえば running guest、long uptime、HA managed、non-empty pool delete、root role ACL delete、shared storage delete、bulk change などを検出する。Terminal 操作を速くするだけでなく、「速さが誤操作を増幅する」ことを前提にしている。

これは Proxmox では特に大事だ。PVE は homelab でも使われるし、小さな会社の本番 workload を支えることもある。前者には single binary、少ない設定、SSH session からの素早い操作がうれしい。後者には audit、approval、replayable command、CI-friendly JSON が必要になる。proxxx はその両端を一つの tool に入れようとしている。

GitOps と incident freeze が実運用っぽい

README の proxxx state {export,diff,apply} は、Proxmox configuration を review 可能な desired state に寄せる機能だ。Byte-stable TOML を export し、pools、ACL grants、storage definitions、backup jobs、cluster firewall、notification matchers、HA rules/resources、PCI/USB device mappings などを state family として扱い、diff と apply を提供する。

この設計の価値は、「Proxmox を Kubernetes にする」ことではない。小さな virtualization environment にも、git に入れられ、code review でき、CI で gate できる declarative layer を作ることだ。Merge 前に drift check を走らせたり、state apply を dry-run したりできる。README には reconcile run、reconcile converge、opt-in の auto_converge daemon も出てくる。ただし severe change は无人で自動適用せず、alert して人間の確認を待つ。

incident freeze も実運用の tool らしい機能だ。proxxx incident freeze --reason X --ttl 4h は cluster-wide mutation を止め、read operation は残す。thaw すると解除される。派手な機能ではないが、incident investigation や高リスク window で「見ていただけのつもりが、つい操作した」を防ぐ layer になる。

MCP server の境界が比較的しっかりしている

最近の infrastructure tool は MCP server を追加しがちだが、本当に難しいのは permission boundary だ。proxxx README では stdio JSON-RPC と HTTP/SSE transport を提供し、tool registry は compile-time fixed、destructive tools は default で fail-closed と説明している。Matching policy が HITL approval に route しない限り、破壊的 tool は拒否される。HTTP serve は default で loopback-only、non-loopback bind には mcp_token が必要だ。

これは「cluster を agent に任せる」よりずっと現実的だ。LLM / agent integrator にとって、最小の安全な入口は cluster digest を読ませ、node や guest を照会し、説明を手伝わせることだ。いきなり migration や delete を許すことではない。proxxx の describe --output llm-context も実用的で、token-compact な text context を生成して AI chat に貼れる。ここでの姿勢は、人の操作を補助することであって、agent に virtualization platform を直接任せることではない。

install と supply chain も丁寧

proxxx は Homebrew、.deb、Linux musl static binary、source build を用意している。README には download command だけでなく、SHA-256、sigstore keyless cosign signature、CycloneDX SBOM の verification flow も書かれている。Latest release v0.13.2 の assets にも、macOS Apple Silicon、Linux x86_64/aarch64 musl tarball、sha256、cosign bundle、SBOM file が含まれている。

23 stars の小さな project としては、supply-chain への投資がかなり厚い。ただ、infrastructure を操作する tool なら自然でもある。VM を止め、disk を migrate し、firewall を変えられる binary であれば、release verification は README の最後に一言添えるだけでは足りない。README では zero telemetry も掲げており、local config/cache/audit log は user-controlled path に置かれ、audit log は SQLite と HMAC-SHA256 chain で tamper signal を出す。正式な compliance system の代わりではないが、tool 作者がどの risk layer で動くのか理解していることは伝わる。

向いている人

一つ目は Proxmox homelab user、特に 1-3 node を持ち、Web UI と SSH の間を行き来している人だ。Single binary、TUI、ls guests、console handoff、PBS browse/restore はすぐ役に立つ。

二つ目は小さな platform / SRE team。大規模な private cloud platform を入れるほどではないが、JSON output、risk gate、HITL、audit log、drift check、batch operation は必要になっている。proxxx は Proxmox 操作の reviewable entry point になり得る。

三つ目は LLM を infrastructure observability layer に接続したい人だ。MCP server、read-only profile、destructive tool fail-closed、loopback-only HTTP default は、多くの agent ops project よりも controlled experiment を始めやすい。

Caveats

第一に、まだかなり新しい project だ。Stars は 23 で、最近の commit は活発だが、実ユーザー規模と長期 maintenance はこれから見る必要がある。Production では read-only profile と test cluster から始めるのがよい。

第二に、機能範囲が広い。TUI、CLI、GitOps、MCP、HITL、audit、PBS restore、console handoff が一つの binary に入っている。統一されているのは利点だが、それぞれの path は自分の環境で検証すべきだ。README の広さだけで staging を飛ばしてはいけない。

第三に、用途はかなり vertical だ。Proxmox VE/PBS を使っていないなら、汎用 terminal ops tool ではない。Terraform/OpenTofu、Ansible、monitoring、approval system がすでに成熟している環境では、全体の platform engineering を置き換えるものではなく、Proxmox-specific cockpit として見るのが自然だ。

まとめ

fabriziosalmi/proxxx が面白いのは、Proxmox terminal management を「より速い command」から「より制御された operation surface」へ寄せているところだ。TUI と single binary は入口を軽くし、risk gate、HITL、incident freeze、audit log、release verification は危険な操作の境界を戻している。

まだ早い project なので慎重な検証は必要だ。それでも、実際の workload を載せた Proxmox cluster を運用しているなら、proxxx の問題意識はかなり正しい。Terminal tool は使いやすいだけでなく、手が速すぎるときに止めてくれるべきだ。

プロジェクトアドレス：https://github.com/fabriziosalmi/proxxx