このプロジェクトについて

Proxmox VE Helper-Scripts(Community Edition)は、Proxmox VE上でセルフホストサービスをインストール・設定するためのコミュニティ維持型の自動化スクリプトコレクションです。パッケージを手動で探したり設定ファイルを編集したりする代わりに、ユーザーは1つのコマンドをProxmoxシェルに貼り付け、いくつかのプロンプトに答えるだけで、実行中のコンテナまたは仮想マシンが構築されます。 このプロジェクトはtteckの元々の作業を基盤としたコミュニティ継承として位置づけられ、小さな中核チームと外部の貢献者によって維持されています。スクリプトはMITライセンスの下で公開されており、個人・商業目的での使用・改変・再配布が可能です。 要件 - Proxmox VE バージョン 8.4、9.0、9.1 または 9.2(DebianベースのProxmoxホスト) - Proxmoxホスト上のroot shellアクセス - インストール中にインターネット接続が必要 始め方 1. Proxmoxのサービスページから目的のサービスを探します(Home Assistant、Nginx Proxy Manager、Jellyfinなど)。 2. スクリプトページの表示されている1行のインストールコマンドをコピーします。 3. Proxmoxシェルを開きコマンドを貼り付けます。 4. DefaultまたはAdvanced設定を選択し、プロンプトに従います。 各スクリプトページには、コンテナの内容、デフォルトのリソース割当、インストール後の注意事項がドキュメント化されています。 スクリプトの動作 Defaultモードでは、合理的なCPU・RAM・ストレージのデフォルト値が選択され、必要な最小限の質問のみが求められ、多くのインストールは5分以内で完了するとされています。Advancedモードでは、インストール前にコンテナ設定、ネットワーク、ストレージバックエンド、アプリケーションレベルの設定が表示されます。インストール後、各コンテナにはProxmoxシェルからアクセスできるインストール後ヘルパーが含まれており、インストールしたサービスへのアップデート適用、設定ファイルの手動編集なしでのアプリケーション設定変更、基本的なトラブルシューティングおよびログアクセスが可能です。 コレクションの範囲 READMEにはホームオートメーション(Home Assistant、Zigbee2MQTT、ESPHome、Node-RED)、メディア(Jellyfin、Plex、Radarr、Sonarr、Immich)、ネットワーク(AdGuard Home、Nginx Proxy Manager、Pi-hole、Traefik)、モニタリング(Grafana、Prometheus、Uptime Kuma、Netdata)、データベース(PostgreSQL、MariaDB、Redis、InfluxDB)、セキュリティ(Vaultwarden、CrowdSec、Authentik)、開発ツール(Gitea、Portainer、VS Code Server、n8n)などのカテゴリ別に数百種類のサービスが記載されています。完全なリストはプロジェクトウェブサイトのカテゴリページで定期的に更新されています。 貢献について 新しいスクリプトはこのリポジトリに直接投稿されません。まず別別のProxmoxVEDリポジトリで提出・テストされ、このリポジトリへの新スクリプト追加PRは却下されます。バグ修正や既存スクリプトの改善はこのリポジトリで行い、1PRあたりに1つの焦点を絞った変更とし、対応するJSONメタデータファイルにスクリプトがインストールする内容と非自明な決定事項を記録します。バグはトラッカー経由で報告し、リクエストや質問はディスカッションまたはプロジェクトのDiscordで、セキュリティ脆弱性はセキュリティポリシーを通じて報告します。 サポートとライセンス 本プロジェクトはボランティアによって維持され、インフラコストは自己負担です。READMEによると、寄付の30%はtteckにとって重要な慈善活動であるがん研究とホスピスケアに送られます。ProxmoxはProxmox Server Solutions GmbHの登録商標であり、コードはMIT Licenseの下で公開されています。