セルフホスト型サービス
community-scripts/ProxmoxVE avatar
community-scripts/ProxmoxVE

community-scripts/ProxmoxVE:一行で LXC と VM を入れる Helper Scripts

Proxmox VE ヘルパー スクリプト (コミュニティ エディション)。コマンドを Proxmox シェルに貼り付け、いくつかのプロンプトに答えると、コンテナーまたは VM が起動して実行されます。

スター 29,597フォーク 2,885ShellMIT

ひと目でわかる

これは何?
community-scripts.org からコピーしたシェルを Proxmox の root シェルへ貼る。tteck の仕事を継いだコミュニティ版。対象は PVE 8.4 と 9.0/9.1/9.2。
誰に向いている?
Proxmox VE 8.4 または 9.x を既に持ち、Jellyfin や Home Assistant を LXC で試したい homelab 向けである。Proxmox 以外の Debian や root 無しの運用には向かない。
商用利用できる?
できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
今もメンテナンスされている?
されています。直近 1 日以内に新しいコミットがあります。
何の言語で書かれている?
主に Shell です(GitHub の言語統計による)。

回答はプロジェクトの GitHub データ(最終同期:2026年9月15日)と当サイトの分析に基づくもので、法的助言ではありません。

オープンソース詳細解説

tteck 基盤の Proxmox VE Helper-Scripts

community-scripts/ProxmoxVE の README 標題は Proxmox VE Helper-Scripts である。一行でサービス、コンテナ、VM を入れる、と要約し、tteck のオリジナルを基盤とするコミュニティプロジェクトだと明記している。Paste a command into your Proxmox shell, answer a few prompts, and your container or VM is up and running、というのが使い方の核だ。パッケージを手で探し、設定ファイルを考古学者のように掘る作業を省く、と README は書いている。

対象カテゴリはホームオートメーション、メディアサーバ、ネットワーク、データベース、監視など数百サービスに及ぶ。言語メタデータは Shell、ライセンスは MIT、公開サイトは https://community-scripts.org/。スクリプトの実体は GitHub、検索とコマンドコピーの UI は公式サイト、という分担である。star 数は採用の根拠にしない。最近のリリースタグは日付型で、素材上は 2026-08-28、2026-08-27、2026-08-26 が並ぶ。

これは Kubernetes 用の Helm チャート集ではない。ホストが Proxmox VE であること、インストール中にインターネットへ出られることが前提だ。スクリプトを手元 macOS で dry-run する手順は README に無い。

PVE 8.4 と 9.0/9.1/9.2、root シェル必須

Requirements 表は Proxmox VE の版を 8.4、9.0、9.1、9.2 に限定する。Host OS は Proxmox VE(Debian 系)。Access はホスト上の root シェル。Network はインストール中のインターネット接続が必要、と書いてある。それより古い PVE や、Proxmox を載せない素の Debian についての代替手順は README に無い。

一般ユーザー権限の SSH だけでは、スクリプト冒頭で止まる可能性が高い。オフラインや air-gap 向けのミラー手順も書かれていない。インストールが外部からパッケージとコンテナテンプレを取る以上、ファイアウォールで外向きを閉じたラボでは Default モードでも失敗する。対応表に 8.3 や 7.x が無いので、古いノードへ貼る前に pveversion の出力を表と照合する。

9.2 まで列挙されているのは README 取得時点の表であり、新しいマイナーが出たあとの追従速度は CHANGELOG.md を見る。素材のリリースタグが日付なのも、アプリの semver ではなくスクリプト束のスナップショットだからだ。

community-scripts.org で一行コマンドを取る五手順

Getting Started は公式サイトを正規の入口にしている。community-scripts.org を開き、Home Assistant や Nginx Proxy Manager などを検索する。スクリプトページの one-line install command をコピーする。それを Proxmox シェルへ貼る。Default か Advanced を選び、プロンプトに答える。各ページはコンテナの中身、デフォルトの CPU/RAM/ストレージ、post-install メモを載せる、と README は説明する。

GitHub の README 本文には、個別サービスの完全な bash 一行は載っていない。コマンド文字列の正本はサイト側である。サイトが落ちている、またはページのコマンドと GitHub 上のスクリプトが一時的にずれる、という失敗モードは README が数値では示さない。採用するなら、貼る前に GitHub の該当スクリプトパスとサイトのハッシュや日付を見比べる。

Home Assistant や Nginx Proxy Manager は README が検索例として出しているだけで、必須インストールではない。自分のノードに要らないサービスを Default で量産すると、ストレージと CT ID が先に尽きる。

Default は五分、Advanced と post-install helper

How Scripts Work 節は全スクリプトが同じ型だと書く。Default mode は CPU、RAM、ストレージに無難な既定値を選び、質問を最小にする。大半の導入は五分未満で終わる、というのが README の自己申告である。Advanced mode はコンテナ設定、ネットワーク、ストレージバックエンド、アプリ設定を入れる前に細かく聞く。

導入後は各コンテナに post-install helper が付き、Proxmox シェルから呼べる。できることとして README が列挙するのは、入れたサービスの更新適用、設定ファイルを手編集しない設定変更、基本的なトラブルシュートとログ参照である。実装はスクリプトごとに違うため、対象サービスのページにある post-install 節を読まずに helper のメニューを全部本番で押すのは危険だ。

Default で試験 CT を作り、helper から更新が通ることを見てから、同じスクリプトを Advanced でストレージプール名を本番値にして入れ直す、という順が README の二つのモードと整合する。本番ノードへいきなり Advanced で巨大ディスクを切る必要は、試験用途には無い。

Jellyfin から Vaultwarden までのカテゴリ例

What's Included の表は例示である。Home Automation は Home Assistant、Zigbee2MQTT、ESPHome、Node-RED。Media は Jellyfin、Plex、Radarr、Sonarr、Immich。Networking は AdGuard Home、Nginx Proxy Manager、Pi-hole、Traefik。Monitoring は Grafana、Prometheus、Uptime Kuma、Netdata。Databases は PostgreSQL、MariaDB、Redis、InfluxDB。Security は Vaultwarden、CrowdSec、Authentik。Dev & Tools は Gitea、Portainer、VS Code Server、n8n。全一覧は community-scripts.org/categories を見よ、と README は誘導する。新しいスクリプトは定期的に足される、とも書いてある。

表に名前があることは、そのサービスの上流と同じサポート期間をこのリポジトリが約束する意味ではない。Jellyfin の LXC が上がっても、メディアコーデックや GPU パススルーの可否は各スクリプトページのメモ次第だ。README 本文はそこまで降りない。

監視スタックとメディアスタックを同じノードに Default のまま並べると、RAM 既定値が重なる。Advanced で数字を落とすか、ノードを分けるかは、README ではなく自分のハードウェアの話になる。

新規スクリプトは ProxmoxVED、既存修正は本 repo

Contributing 表は行き先を分けている。新規スクリプトは community-scripts/ProxmoxVED で先に試験する。既存スクリプトの修正はこのリポジトリへ PR し、CONTRIBUTING.md を先に読む。バグ報告は Issues、機能要望は Discussions、脆弱性は SECURITY.md、雑談と支援は Discord discord.gg/3AnUqsXnmK。Before you open a PR は、新規を本 repo へ直接出す PR は閉じる、と明記する。PR は一点に絞る。スクリプトが入れるものと非自明な判断は、対応する JSON メタデータファイルへ書け、ともある。

Core Team として MickLesk、michelroegl-brunner、BramSuurdje、CrazyWolf13、tremor021、vhsdream、asylumexp が README の表に並ぶ。これは連絡先の目安であり、スクリプトの品質保証ではない。

向くのは PVE 8.4/9.x の homelab 管理者である。向かないのは Kubernetes だけで完結したい環境と、root 無し CI から同じ一行を流したいケースである。確認は community-scripts.org で Jellyfin など一つのページを開き、表示された bash を root シェルへ貼り Default で完走させる。できた CT の ID と post-install helper が README の説明どおり出るか記録する。バージョン固定は CHANGELOG.md と GitHub Releases の 2026-08-28 タグを見る。

編集部の結論

Proxmox VE 8.4 または 9.x を既に持ち、Jellyfin や Home Assistant を LXC で試したい homelab 向けである。Proxmox 以外の Debian や root 無しの運用には向かない。community-scripts.org で対象ページの一行コマンドをコピーし、Proxmox の root シェルへ貼って Default モードで完走させ、同じシェルから post-install helper が開くことを確認してから Advanced でストレージを本番のプール名に変える。新規スクリプトを本リポジトリへ PR しても閉じられるので、試作は ProxmoxVED へ出す。

公式情報源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
コミュニティノート

コミュニティノート