mcpField
P
proxmox

proxmox

github.com/poindexter12クラウド・DevOps736 回インストール40 週間前に更新
リポジトリ

proxmox について

proxmoxは、Proxmox VEの仮想マシン、コンテナ、クラスター、ホームラボ基盤の管理に使うリファレンススキルです。テーマ別資料、コマンドの案内、導入前のチェックリストを提供します。

主な機能

  1. 01VMとLXCの管理リファレンス
  2. 02ネットワーク、ストレージ、クラスターの資料
  3. 03cloud-initとバックアップの資料
  4. 04主要なCLIツールのガイド
  5. 05導入前の検証チェックリスト

活用シーン

  1. 01VMとLXCの仮想化方式を選択
  2. 02ネットワークブリッジ、VLAN、ストレージの設定
  3. 03クラスターの高可用性とバックアップの計画
  4. 04導入前にノードとリソースの状態を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/poindexter12/waypoint --skill proxmox

インストール後、Claude Code で/proxmoxを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
automation-tools.md
backup.md
cli-tools.md
cloud-init-templates.md
clustering.md
docker-hosting.md
networking.md
storage.md
troubleshooting.md
vm-lxc.md

詳細

Proxmox スキル

VM 管理、コンテナ、クラスタリング、ホームラボインフラストラクチャ向けの Proxmox VE 仮想化プラットフォームリファレンスです。

クイックリファレンス

# VM management (qm)
qm list                           # List all VMs
qm status <vmid>                  # Check VM status
qm start <vmid>                   # Start VM
qm stop <vmid>                    # Stop VM (graceful)
qm shutdown <vmid>                # Shutdown VM (ACPI)
qm unlock <vmid>                  # Remove lock
qm config <vmid>                  # Show VM config

# Container management (pct)
pct list                          # List all containers
pct status <ctid>                 # Check container status
pct start <ctid>                  # Start container
pct stop <ctid>                   # Stop container
pct enter <ctid>                  # Enter container shell

# Cluster management (pvecm)
pvecm status                      # Cluster status and quorum
pvecm nodes                       # List cluster nodes

# API shell (pvesh)
pvesh get /nodes                  # List nodes via API
pvesh get /nodes/<node>/status    # Node resource status

# Backup (vzdump)
vzdump <vmid> --mode snapshot --storage <storage>
vzdump --all --compress zstd

リファレンスファイル

タスクに応じて必要なものを読み込みます。

トピックファイル読み込むタイミング
VM と LXCvm-lxc.md仮想化方式を選ぶとき
Docker ホスティングdocker-hosting.mdProxmox 上で Docker を実行するとき
ネットワークnetworking.mdブリッジ、VLAN、SDN、ファイアウォールを扱うとき
ストレージstorage.mdストレージバックエンド、コンテンツタイプを扱うとき
Cloud-initcloud-init-templates.mdcloud-init で VM をプロビジョニングするとき
クラスタリングclustering.mdHA、クォーラム、フェンシングを扱うとき
バックアップbackup.mdvzdump のモード、復元を扱うとき
CLI ツールcli-tools.mdqm、pct、pvecm、pvesh コマンドを使うとき
トラブルシューティングtroubleshooting.mdよくあるエラー、診断を扱うとき
自動化ツールautomation-tools.mdTerraform／Ansible との連携を行うとき

検証チェックリスト

VM／コンテナをデプロイする前に確認してください。

  • クラスタの状態が正常（pvecm status）
  • ノードのリソースが利用可能（CPU、RAM、ディスク）
  • ストレージにアクセスでき、マウントされている
  • ネットワークブリッジが正しく設定されている
  • VLAN タグがネットワーク設計と一致している
  • リソース割り当てがノードの上限内に収まっている
  • HA の設定が正しい（有効にしている場合）
  • バックアップスケジュールが設定されている
  • 命名規則に従っている

VM と LXC のクイック選択ガイド

要素VM を使用LXC を使用
OSWindows、BSD、任意の OSLinux のみ
分離カーネルを完全に分離カーネルを共有
パフォーマンス良好より良好（軽量）
起動遅い高速
密度低い高い
複雑さあらゆるワークロードシンプルなサービス

ホームラボネットワークの VLAN

VLAN用途Proxmox ブリッジ
5管理（Web UI、API、SSH）vmbr5
1信頼済みネットワークvmbr0
11ストレージ（NFS／Ceph、MTU 9000）vmbr11
12高速転送vmbr12

コメント

Markdown 対応