植え替えするルート

植え替えするルート

植え替えするルートの記録

メニュー 役割 主な設定
Hardware 仮想ハードウェアの構成 CPU、メモリ、ディスク、NIC、BIOS、TPM
Options VMの運用動作の設定 自動起動、起動順序、Guest Agent、Hotplug
Firewall ネットワークアクセスの制御 In/Outルール、IPSet、Security Group
Permissions リソース管理権限の制御 User、Group、Role、ACL、Pool

本ドキュメントはVMを対象としています。メニューや詳細オプションは、Proxmox VEのバージョンによって異なる場合があります。

Hardware

操作パス:Datacenter → Node → VM → Hardware

CPUとメモリ

項目 説明
Memory VMに割り当てるメモリ
Ballooning Guestメモリの動的な調整
Minimum Memory Ballooning適用時の最小メモリ
Sockets / Cores 仮想CPUの構成。vCPU数はSockets × Cores
CPU Type Guestに公開するCPUモデル
CPU Limit 最大CPU使用量の制限
CPU Units CPU競合時の相対的な優先度
NUMA CPU・メモリトポロジーの反映

一般的なLinux VMでは、Sockets: 1を基本として必要なコアを割り当てます。DBやメモリを多用するサービスでは、固定メモリを優先して検討します。

CPU Typeは、性能とマイグレーション互換性の両方を考慮して選択します。

CPU Type 検討基準
host 現在のノードのCPU機能を活用する
互換性モデル 異なるCPUを使用するノード間での移動を考慮する

CPUの世代やメーカーが異なるクラスタでは、host設定によってライブマイグレーションが制限される場合があります。

メモリの過剰割り当てはOOMやSwapの増加につながる可能性があるため、慎重に適用します。CPU・メモリのHotplugでは、Guest OSの対応状況も確認する必要があります。

BIOSとMachine Type

項目 特徴
SeaBIOS Legacy BIOSによる起動
OVMF UEFIによる起動、Secure Bootなどを検討可能
i440fx 既存VMとの互換性を重視
q35 PCIeベースのデバイス構成

新規VMでは、OSとデバイスの要件に合わせて組み合わせを決定します。Windows 11、UEFI、PCIe Passthroughを使用する環境では、OVMFとq35を検討します。

既存VMのBIOSやMachine Typeを変更すると、起動やデバイス認識に影響する場合があるため、クローン環境で先に検証します。

ディスク

一般的なLinux VMでは、VirtIO SCSI single + SCSI Disk構成を優先して検討します。WindowsではVirtIOドライバーが必要になる場合があります。

項目 説明
Storage / Size ディスクの保存先と容量
Cache ディスクキャッシュのポリシー
Discard GuestのTRIM・Discard要求の転送
IO Thread ディスクI/O処理のスレッド分離
SSD Emulation GuestにSSDとして表示
Backup / Replicate バックアップ・レプリケーションの対象に含めるか

Cacheは、性能だけでなく、電源保護、Flushの保証、ストレージポリシー、障害時に許容できるデータ損失の範囲を考慮して決定します。Write back (unsafe)は運用環境では避けます。

Discardは、対応するストレージでの領域回収に活用します。Linux GuestのTRIMタイマーは、次のコマンドで確認します。

systemctl status fstrim.timer

IO Threadは、I/Oの多いサービスで性能を検証してから適用します。

CD/DVD、EFI Disk、TPM

デバイス 用途
CD/DVD Drive OSインストール・VirtIOドライバー・復旧用ISOの接続
EFI Disk OVMFのUEFI変数と起動情報の保存
TPM State 仮想TPMの状態の保存

OSのインストール後はISOを取り外し、OSディスクを起動優先順位の先頭に設定します。

EFI DiskとTPM Stateは、バックアップ・復元・クローン・マイグレーション時の影響も確認します。

ネットワーク

項目 説明
Bridge VM NICを接続する仮想ネットワーク
Model VirtIO、E1000などのNICモデル
VLAN Tag VMに適用するVLAN ID
Firewall 対象NICにVM Firewallを適用するか
Rate Limit 帯域幅の制限
MTU / Multiqueue パケットサイズとマルチキューの設定

一般的なLinux VMでは、VirtIO NICを優先して検討します。Windowsでは別途ドライバーが必要になる場合があります。

net0
├── Bridge: vmbr1
├── Model: VirtIO
├── VLAN Tag: 20
└── Firewall: Enabled

VLANを使用する場合は、BridgeのVLAN-aware設定、スイッチのTrunk、VLAN構成、ルーティング・Firewallポリシーをあわせて確認します。

USB・PCI Passthrough

USB・PCI Passthroughは、ドングル、GPU、NIC、HBAなどの物理デバイスをVMへ直接接続する際に使用します。

PCI Passthroughでは、IOMMUへの対応と設定、デバイスグループ、Host・Guestのドライバーを確認する必要があります。物理デバイスへの依存によってマイグレーションやHAが制限される場合があるため、復旧手順まで検討します。

Options

操作パス:Datacenter → Node → VM → Options

主なオプション

オプション 説明
Name VMの表示名
Start at boot ノード起動後の自動起動
Start/Shutdown Order 起動・終了の順序と待機設定
OS Type Guest OSの種類
Boot Order 起動デバイスの順序
Hotplug 稼働中のデバイス・リソース変更
Protection 誤操作による削除の防止
QEMU Guest Agent HostとGuest間の管理通信
KVM hardware virtualization ハードウェア仮想化の使用
ACPI 電源管理と正常終了のインターフェース
Tags / Description 分類と運用情報の記録

自動起動と起動順序

自動起動は、サービスの依存関係とリソース使用量を考慮して設定します。すべてのVMを同時に起動すると、CPU・メモリ・ディスクI/Oが集中する可能性があります。

起動順序の例
1. DNS・NTP
2. Database
3. Application

VMの起動とアプリケーションの準備完了は異なります。依存するサービスの状態は、別途Health Checkやリトライ処理で確認します。

OSのインストール後は、Boot OrderをOSディスク優先に整理します。

qm set 401 --boot order=scsi0

Hotplug

Hotplugは、稼働中のVMのディスク、NIC、USB、CPU、メモリなどを変更する機能です。

Proxmox側の設定だけでなく、Guest OSの対応状況も確認する必要があります。CPU・メモリの縮小は、VMを正常終了してから変更する方法を優先して検討します。

Protection

重要なVMでは、Protectionを使用して誤操作による削除を防ぎます。

qm set 601 --protection 1

Protectionは、バックアップ、最小権限、変更承認手順の代わりにはなりません。

QEMU Guest Agent

Guest Agentは、IP・OS情報の取得、正常終了、ファイルシステムのFreeze/Thawなどに使用します。

Proxmox側のオプション有効化と、Guest内へのインストールの両方が必要です。

# Proxmox Host
qm set 401 --agent enabled=1
# Debian / Ubuntu Guest
sudo apt update
sudo apt install -y qemu-guest-agent

# Rocky / AlmaLinux / RHEL Guest
sudo dnf install -y qemu-guest-agent

Guest内でAgentの実行状態を確認します。

systemctl status qemu-guest-agent

Hostでは、次のコマンドで応答を確認します。

qm agent 401 ping

その他のオプション

  • KVMとACPIは、一般的なVMでは有効のまま使用します。
  • Freeze CPU at startupは、デバッグなどの特殊用途でなければデフォルト値を維持します。
  • Tablet、SPICE、VGAは、GUI・コンソールの使用方法に合わせて設定します。
  • SMBIOSのUUID・Serialの変更は、ライセンスと資産管理に影響する場合があります。

VM名とタグは、チーム内の標準ルールを決めて使用します。Descriptionには役割・担当者・IP・バックアップポリシーを記録しますが、パスワード、Token、Private Keyは保存しません。

Firewall

Firewallは、ネットワークトラフィックを制御します。

領域 主な対象
Datacenter クラスタ共通のポリシーと再利用ルール
Node Proxmox Hostの管理・サービス通信
VM / CT Guestに出入りするトラフィック

適用前の確認

Firewallを変更する前に、管理者アクセスと必須通信を確認します。

  • SSH・Web UIの管理経路
  • クラスタ・ストレージ・バックアップ通信
  • DNS・NTP・監視
  • VMのサービスポート
  • iDRAC・iLO・IPMIなどの緊急用コンソール

VM Firewallを使用する際は、DatacenterとVMの有効化設定、および対象NICのFirewallオプションを確認します。Node自体を保護するポリシーは、別途検討します。

qm config 401 | grep '^net'
net0: virtio=BC:24:11:AA:BB:CC,bridge=vmbr1,firewall=1,tag=20

基本ポリシーとルール

InputはVMへ入るトラフィック、OutputはVMから出るトラフィックの基本ポリシーです。

ポリシーの例
Input Policy: DROP
Output Policy: ACCEPT

Inboundをデフォルトで遮断する場合は、必要なアクセスのみを許可します。

方向 アクション 送信元の例 対象
IN ACCEPT 管理ネットワーク TCP 22
IN ACCEPT サービスネットワーク TCP 443
IN ACCEPT アプリケーションネットワーク TCP 5432
IN ACCEPT 監視ネットワーク TCP 9100、ICMP

OutputもDROPに設定する場合は、DNS、NTP、パッケージリポジトリ、認証、監視など、必要な通信を先に把握する必要があります。

共通ルールの管理

機能 用途
Alias IP・ネットワークへの名前付け
IPSet 複数のIP・CIDRのグループ化
Security Group 複数のルールをまとめて再利用

共通の管理アクセスと監視ルールはSecurity Groupにまとめ、VMごとの重複設定を減らします。

適用後の点検

ルールの順序、IP・ポート、NIC Firewall、VLAN・ルーティング、Guest内のFirewallを確認します。遮断の原因は、Web UIのFirewall → Logで調べます。

VM Firewallの設定ファイルは、次のパスに保存されます。

/etc/pve/firewall/<VMID>.fw

Permissions

Permissionsは、ユーザーと自動化アカウントによるProxmoxリソースの管理権限を制御します。

構成要素 意味
User ログイン・API呼び出しの主体
Group ユーザーのグループ
Role 個別権限であるPrivilegeの集合
ACL ユーザー・グループへRoleを付与するルール
Path 権限の適用範囲
Pool リソースをまとめて管理する単位
Propagate 下位リソースへ権限を継承するか

ユーザーと認証

ユーザーIDは<username>@<realm>形式です。

Realm 認証方式
pam Linux PAM
pve Proxmox独自のユーザーDB
LDAP / AD / OIDC 外部認証との連携

複数の管理者でroot@pamを共有するのではなく、個人アカウントとグループを使用します。管理者ログインには2FAを適用し、リカバリーコードと緊急アクセス手順を準備します。

RoleとPath

Role 主な用途
Administrator 全体の管理権限
PVEVMAdmin VM・コンテナ管理
PVEVMUser 制限されたVM利用
PVEAuditor 読み取り専用の参照
Custom Role 必要なPrivilegeのみを組み合わせる

Roleの実際の権限は、運用中のバージョンで確認します。

Path 適用範囲
/ Datacenter全体
/vms/<VMID> 特定のVM・コンテナ
/pool/<POOL> 特定のPool
/storage/<STORAGE> 特定のStorage
/nodes/<NODE> 特定のNode

全体のパスである/へ強い権限を付与すると、影響範囲が大きくなります。可能な限り、Poolや個別リソースに限定します。

Poolに基づく権限分離

チーム・サービスごとにPoolを作成し、グループへ権限を付与すると、管理範囲を分けやすくなります。

グループ Path Role
プラットフォームチーム /pool/platform-prod PVEVMAdmin
開発チーム /pool/dev-team-a 権限を限定したCustom Role
監査チーム / PVEAuditor

参照・コンソール・電源制御のみが必要な場合は、次のようなCustom Roleを検討します。

pveum role add PVEDevVMOperator \
  -privs "VM.Audit VM.Console VM.PowerMgmt"

Snapshot、Clone、ディスク拡張、バックアップ復元などについては、必要な作業に合わせて追加の権限を検討します。

API Token

自動化には、個人のパスワードではなく、用途別のアカウントとAPI Tokenを使用します。

  • 必要なPool・Storage・VMのパスへ権限を限定する
  • SecretはVaultやCI/CD Secretに保管する
  • 使用目的・担当者・有効期限を記録する
  • 未使用Tokenの廃止と定期的な権限点検を行う

PermissionsとFirewallの違い

区分 Permissions Firewall
制御対象 ユーザー・アカウントの管理操作 ネットワークトラフィック
例 VMの起動・終了・設定変更 SSH・HTTPS接続の許可
主な手段 Role、ACL、Path Rule、IPSet、Security Group

VMのコンソール権限があっても、SSHが遮断されていれば、SSHによるネットワーク接続はできません。逆に、SSHを許可しても、Proxmox上のVM管理権限が付与されるわけではありません。

運用チェックリスト

  • □ CPU・メモリ・ディスクがサービス要件に合っているか
  • □ CPU TypeとPassthroughがマイグレーション・HAポリシーに合っているか
  • □ BIOS・Machine Type・ディスク設定を検証したか
  • □ Bridge・VLAN・NIC Firewallの設定は正しいか
  • □ インストールISOとBoot Orderを整理したか
  • □ 自動起動の順序とサービスの準備完了状態を区別しているか
  • □ Guest AgentがHostとGuestの両方で構成されているか
  • □ 重要なVMにProtectionとバックアップを適用したか
  • □ Firewall変更前に管理経路と必須通信を確保したか
  • □ 個人アカウント・グループ・Poolを基準に最小権限を付与したか
  • □ 管理者の2FAとAPI Tokenの管理手順があるか
  • □ Descriptionや自動化コードに認証情報を残していないか

参考資料

 

 

Perplexityを使用して翻訳した文書です。翻訳の過程で、誤訳や表現上不十分な箇所が含まれている可能性があります。韓国語で作成された原文は、以下のURLからご確認いただけます。