Proxmox CLI 명령어 치트시트

자주 사용하는 Proxmox VE CLI 명령어 모음.

자주 사용하는 Proxmox VE CLI 명령어 모음.

[!warning] 운영 주의 qm destroy, pct destroy, shutdown, reboot 같은 명령은 VM/컨테이너나 노드 상태를 즉시 바꾼다. 운영 대상에서는 백업과 대상 ID를 먼저 확인한다.

노드 관리

# 노드 상태 확인
pveperf

# 노드 정보
pvesh get /nodes

# 서비스 상태
systemctl status pveproxy pvedaemon pvestatd

# 노드 재부팅
reboot

# 노드 종료
shutdown -h now

VM 관리 (qm)

# VM 목록
qm list

# VM 시작/중지/재부팅
qm start <vmid>
qm stop <vmid>
qm reboot <vmid>
qm shutdown <vmid>
qm reset <vmid>      # 강제 재시작

# VM 생성 (템플릿에서 클론)
qm clone <template_vmid> <new_vmid> --name <name> --full

# VM 삭제
qm destroy <vmid>

# VM 설정 변경
qm set <vmid> --memory 2048
qm set <vmid> --cores 2
qm set <vmid> --net0 virtio,bridge=vmbr0

# VM 스냅샷
qm snapshot <vmid> <snapshot_name>
qm rollback <vmid> <snapshot_name>
qm delsnapshot <vmid> <snapshot_name>

# 콘솔 접속
qm console <vmid>

LXC 컨테이너 관리 (pct)

# 컨테이너 목록
pct list

# 컨테이너 시작/중지
pct start <ctid>
pct stop <ctid>
pct reboot <ctid>

# 컨테이너 생성
pct create <ctid> <template> --hostname <name> --storage <storage>

# 컨테이너 삭제
pct destroy <ctid>

# 컨테이너 진입
pct enter <ctid>

# 컨테이너 설정 변경
pct set <ctid> --memory 512
pct set <ctid> --cores 1

# 컨테이너 백업
pct backup <ctid> <storage>

스토리지 관리

# 스토리지 목록
pvesm status

# ZFS 풀 상태
zpool status
zpool list

# ZFS 데이터셋 목록
zfs list

# 디스크 사용량
df -h

# 스토리지 추가
pvesm add <type> <id> --path <path>

네트워크 관리

# 네트워크 인터페이스
ip addr
ip route

# 브리지 설정
cat /etc/network/interfaces

# 방화벽 규칙
iptables -L -v -n

# VLAN 인터페이스
ip link add link eth0 name eth0.10 type vlan id 10

백업 및 복구

# VM 백업
vzdump <vmid> --storage <backup_storage>

# 모든 VM 백업
vzdump --all --storage <backup_storage>

# 백업 복원
qmrestore <backup_file> <vmid>
pct restore <backup_file> <ctid>

# PBS 연결 확인
proxmox-backup-client list --repository <user>@<pbs_host>:<datastore>

클러스터 관리

# 클러스터 상태
pvecm status

# 클러스터 노드 목록
pvecm nodes

# 클러스터 생성
pvecm create <cluster_name>

# 클러스터 조인
pvecm add <existing_node_ip>

# Ceph 상태
ceph -s
ceph osd status

유틸리티

# 로그 확인
journalctl -u pveproxy -f

# 작업 큐
pvesh get /cluster/tasks

# API 토큰 생성
pveum user token add <user>@<realm> <token_name>

# 방화벽 설정
nano /etc/pve/local/host.fw

# SSL 인증서 갱신
pvenode cert set <cert_file> <key_file>

빠른 참조

작업	명령어
VM 시작	`qm start <vmid>`
VM 중지	`qm stop <vmid>`
VM 스냅샷	`qm snapshot <vmid> <name>`
VM 롤백	`qm rollback <vmid> <snapshot>`
CT 시작	`pct start <ctid>`
CT 진입	`pct enter <ctid>`
백업	`vzdump <vmid>`
복원	`qmrestore <file> <vmid>`
노드 상태	`pveperf`
스토리지	`pvesm status`

Proxmox CLI 명령어 치트시트

노드 관리

VM 관리 (qm)

LXC 컨테이너 관리 (pct)

스토리지 관리

네트워크 관리

백업 및 복구

클러스터 관리

유틸리티

빠른 참조

관련 노트