Proxmox VE(가상화 환경)를 효율적으로 관리하려면 CLI(명령줄 인터페이스) 활용이 필수입니다! 🖥️ 웹 인터페이스로 못 하는 작업을 해결하고, 자동화 스크립트를 작성할 때 유용한 핵심 명령어 30가지를 카테고리별로 정리했습니다.
🛠️ I. 시스템 관리 명령어
Proxmox 호스트 자체를 관리하는 명령어
-
pveversion
- 설명: Proxmox 버전 및 패키지 정보 확인
- 예시:
pveversion -v
pve-manager: 7.4-3 (running version) pve-kernel-5.15: 7.4-1 ...
-
apt update && apt upgrade
- 설명: 패키지 업데이트 및 업그레이드 (Debian 기반)
- 팁:
apt dist-upgrade # 커널 업그레이드 포함
-
systemctl
- 설명: 서비스 관리
- 예시:
systemctl restart pve-cluster # 클러스터 서비스 재시작
-
reboot
/shutdown now
- 설명: 시스템 재부팅 및 종료
- 주의:
shutdown -h 22:00 # 오후 10시에 예약 종료
-
pvecm status
- 설명: 클러스터 상태 확인
- 출력 예:
Cluster name: PROXMOX_CLUSTER Config Version: 5 ...
-
pvecm add NODE_IP
- 설명: 기존 클러스터에 노드 추가
- 사전 조건:
ssh-keygen -f "/etc/pve/priv/authorized_keys" # SSH 키 설정
-
pveam update
- 설명: VM/컨테이너 템플릿 목록 갱신
- 연계 명령:
pveam available --section system # 사용 가능한 템플릿 보기
💻 II. 가상머신(QEMU/KVM) 관리
VM 생성/제어 관련 명령어
-
qm list
- 설명: 모든 VM 목록 출력
- 예시 출력:
VMID NAME STATUS MEM(MB) BOOTDISK(GB) 101 Ubuntu-Server running 4096 50.00
-
qm create VMID
- 설명: 새 VM 생성
- 예시:
qm create 200 --name "CentOS-VM" --memory 2048 --cores 2
-
qm start VMID
/qm stop VMID
- 설명: VM 시작/정지
- 옵션:
qm shutdown 101 --timeout 60 # 60초 대기 후 강제 종료
-
qm destroy VMID
- 설명: VM 완전 삭제
- 주의:
qm destroy 101 --purge # 디스크 파일까지 제거
-
qm config VMID
- 설명: VM 설정 확인
- 활용:
qm config 101 | grep disk # 디스크 정보만 필터링
-
qm snapshot VMID SNAP_NAME
- 설명: 스냅샷 생성
- 예시:
qm snapshot 101 "Before-Update"
-
qm rollback VMID SNAP_NAME
- 설명: 스냅샷 복원
- 주의:
qm rollback 101 "Before-Update" # VM이 정지 상태여야 함
-
qm migrate VMID TARGET_NODE
- 설명: VM 실시간 마이그레이션
- 조건:
qm migrate 101 proxmox-node2 # 클러스터 환경 필요
📦 III. 컨테이너(LXC) 관리
LXC 컨테이너 제어 명령어
-
pct list
- 설명: 컨테이너 목록 출력
- 예시:
pct list -verbose # 자세한 정보 포함
-
pct create CTID TEMPLATE
- 설명: 새 컨테이너 생성
- 예시:
pct create 102 local:vztmpl/ubuntu-22.04-standard_22.04-1_amd64.tar.zst
-
pct start CTID
/pct stop CTID
- 설명: 컨테이너 시작/정지
- 옵션:
pct stop 102 --skiplock # 잠금 무시하고 강제 종료
-
pct enter CTID
- 설명: 컨테이너 콘솔 접속
- 팁:
pct enter 102 # 종료는 `exit` 입력
-
pct set CTID --OPTION VALUE
- 설명: 설정 변경
- 예시:
pct set 102 --memory 1024 # 메모리 1GB로 변경
💾 IV. 스토리지 관리
저장소 및 디스크 관련 명령어
-
pvesm status
- 설명: 스토리지 상태 확인
- 출력 예:
Name Type Status Total Used local dir active 492.00 GB 150.00 GB
-
pvesm add TYPE STORAGE_ID
- 설명: 새 스토리지 추가
- 예시 (NFS):
pvesm add nfs NFS_STORE --server 192.168.1.50 --export /mnt/nfs
-
df -h
- 설명: 디스크 사용량 확인 (Linux 기본 명령)
- 연계 명령:
df -h /var/lib/vz # 특정 경로 모니터링
-
lsblk
- 설명: 블록 장치 목록 표시
- 예시:
lsblk -o NAME,SIZE,FSTYPE,MOUNTPOINT
-
zfs list
- 설명: ZFS 풀/데이터셋 정보 확인
- 활용:
zfs list -t snapshot # ZFS 스냅샷 목록
🌐 V. 네트워크 관리
네트워크 설정 및 진단
-
ip addr show
- 설명: 네트워크 인터페이스 정보 확인
- 대체 명령:
ifconfig # 레거시 도구 (ifupdown2 설치 필요)
-
pvesh set /nodes/NODE/network --OPTIONS
- 설명: 네트워크 설정 변경
- 예시 (본딩 생성):
pvesh set /nodes/proxmox/network -bond0 slaves=enp3s0,enp4s0
-
tcpdump -i vmbr0
- 설명: 네트워크 트래픽 덤프
- 팁:
tcpdump -i vmbr0 port 22 # SSH 트래픽만 캡처
🗂️ VI. 백업 및 복구
데이터 보호 명령어
-
vzdump VMID
- 설명: VM/컨테이너 백업
- 옵션:
vzdump 101 --mode snapshot --storage BACKUP_STORE
-
qmrestore BACKUP_FILE VMID
- 설명: 백업 파일로 복원
- 예시:
qmrestore vzdump-qemu-101-2024.tar.zst 201 # 새 VMID(201)로 복원
🎯 마무리 팁
- 모든 명령어는 root 권한 필요:
sudo -i
로 전환 후 실행 - API 활용:
pvesh
명령어로 REST API 직접 호출 가능pvesh get /cluster/resources # 자원 사용량 JSON 출력
- 위험 명령어 주의:
qm destroy
,pct destroy
는 복구 불가능! - 도움말 보기:
qm --help
처럼--help
옵션으로 매뉴얼 확인
Proxmox CLI는 자동화의 핵심 🔑입니다. 이 30개 명령어만 익혀도 서버 관리 효율이 200% 올라갑니다! 🚀 D