프록스목스 가상화 환경(Proxmox VE)을 효율적으로 관리하려면 CLI 명령어 숙달이 필수입니다! 웹 인터페이스로 못하는 고급 작업, 자동화 스크립트 제작, 문제 해결에 강력한 도구들이니 지금 바로 익혀보세요. ⚡
⚠️ 명령어 사용 전 주의사항
- root 권한 필수:
sudo -i로 루트 전환 후 실행 - 실행 전 확인: 특히
destroy,remove명령은 복구 불가 - 백업 습관:
vzdump로 정기 백업 권장 - 탭 자동 완성:
qm [Tab]키로 명령/옵션 자동 완성
🖥️ 1. 가상 머신(VM) 관리 명령어
qm list – VM 목록 확인
qm list▶️ 실행 중인 VM/CT 전체 목록 + 자원 사용량 확인
▶️ 옵션: --type (vm/lxc/all), -o 출력 포맷 지정
qm create – VM 생성
qm create 100 --name "Ubuntu-Server" --memory 2048 --cores 2 --net0 virtio,bridge=vmbr0▶️ 필수 옵션: VMID(숫자), 이름, 메모리, 네트워크
▶️ --scsi0, --ide2 등으로 스토리지 연결
qm start / qm stop / qm reset – VM 전원 제어
qm start 101 # VM 시작
qm stop 102 # 정상 종료
qm reset 103 # 강제 재시작 (전원 버튼)qm destroy – VM 완전 삭제
qm destroy 104 --purge⚠️ --purge 옵션: 디스크까지 완전 제거
⚠️ 복구 불가! 스냅샷/백업도 함께 삭제됨
qm snapshot – 스냅샷 관리
qm snapshot 100 "before-update" # 생성
qm listsnapshot 100 # 목록
qm delsnapshot 100 snap1 # 삭제💡 --description으로 설명 추가 가능
qm clone – VM 복제
qm clone 100 200 --name "Clone-VM" --full▶️ --full: 디스크 전체 복사 (아니면 링크 복제)
▶️ 템플릿 VM 복제 시 유용
qm migrate – 라이브 마이그레이션
qm migrate 100 proxmox-node2 --online🌐 클러스터 환경에서 다른 노드로 이동
▶️ --online: 다운타임 없이 실시간 이동
qm config – VM 설정 확인
qm config 100📄 /etc/pve/qemu-server/100.conf 내용 출력
qm set – VM 설정 변경
qm set 100 --memory 4096 --cores 4⚡ 웹 UI보다 빠른 실시간 설정 변경
▶️ 메모리, CPU, 디스크 추가 등
qm monitor – QEMU 모니터 접속
qm monitor 100🔧 고급 디버깅용 (Ctrl+D로 종료)
📦 2. 컨테이너(LXC) 관리 명령어
pct list – 컨테이너 목록
pct list▶️ VM과 동일한 형식의 출력
pct create – LXC 생성
pct create 200 local:vztmpl/ubuntu-22.04-standard.tar.zst \
--storage local-lvm --hostname "MyLXC" --memory 1024▶️ 템플릿은 pveam download로 미리 다운로드
pct enter – 컨테이너 콘솔 접속
pct enter 201🖥️ SSH 없이 직접 접속 (exit로 종료)
pct set – LXC 설정 변경
pct set 200 --mp0 /mnt/share,mp=/shared▶️ 마운트 포인트, 네트워크 등 동적 변경
pct mount – 컨테이너 마운트
pct mount 200💻 호스트에서 컨테이너 파일 시스템 접근 (문제 해결용)
💾 3. 스토리지 관리 명령어
pvesm status – 스토리지 상태
pvesm status💽 모든 스토리지 유형/용량/사용량 확인
pvesm list – 저장소 내용 확인
pvesm list local-lvm📂 특정 스토리지의 VM 디스크, 백업 파일 목록
pvesm add – 새 스토리지 추가
pvesm add nfs NFS-Storage --server 192.168.1.50 --export /mnt/pve🌐 NFS, iSCSI, Ceph, 디렉토리 등 지원
🔄 4. 백업/복구 명령어
vzdump – 백업 생성
vzdump 100 --storage Backup-Storage --mode snapshot⏰ --compress (gzip/lzo), --exclude-path 옵션 유용
⏱️ 크론탭으로 자동화: crontab -e
qmrestore / pct restore – 백업 복구
qmrestore vzdump-qemu-100.vma.zst 300 --storage local-lvm♻️ 새 VMID(300)로 복구 가능
🌐 5. 네트워크 관리 명령어
pvectl set – 네트워크 설정
pvectl set /nodes/proxmox/network --delete vmbr0📡 웹 UI에서 안 보이는 고급 설정 변경
⚠️ /etc/network/interfaces 직접 편집보다 안전
🧩 6. 시스템 관리 명령어
pveversion -v – 버전 확인
pveversion -vℹ️ 커널, 패키지 버전 상세 출력
pveam update – 템플릿 업데이트
pveam update🔄 공식 저장소 Appliance 목록 동기화
pveam download – OS 템플릿 다운
pveam download local ubuntu-22.04-standard.tar.zst📥 local은 저장소 이름, 템플릿 목록: pveam available
pvecm status – 클러스터 상태
pvecm status👥 클러스터 노드, 쿼럼 정보 확인
pvecm add – 클러스터 노드 추가
pvecm add 192.168.1.10🔗 기존 클러스터에 새 노드 병합
pveceph status – Ceph 상태
pveceph status💎 Ceph 클러스터 상태 요약 (OSD, PG, 사용량)
🛠️ 7. 고급 관리 명령어
pvesh – Proxmox API 셸
pvesh get /cluster/resources🔌 REST API 직접 호출 (스크립트 자동화 핵심!)
ha-manager status – HA 상태
ha-manager status🆘 고가용성 서비스 상태 점검
qm sendkey – VM에 키보드 입력
qm sendkey 100 ret # 엔터 키 전송⌨️ 자동화 설치용 (예: Ubuntu 설치 시 Tab+Enter)
pct exec – 컨테이너 내 명령 실행
pct exec 200 -- apt update🚀 호스트에서 직접 컨테이너 명령 실행
🎯 마무리
Proxmox CLI는 웹 인터페이스의 한계를 넘어섭니다! 특히 vzdump 자동 백업, qm migrate 실시간 마이그레이션, pvesh API 자동화는 서버 관리 효율을 극대화합니다. 처음엔 복잡해 보여도 30개 명령어만 익히면 90%의 일을 CLI로 해결할 수 있습니다. 💪
> 실전 팁:
> – man qm으로 매뉴얼 확인
> – 명령어 + --help로 옵션 학습
> – /var/log/syslog 로그 확인 습관화
> – 위험한 명령어는 테스트 VM으로 먼저 실행!
명령어 한 줄이 서버 관리 시간을 시간 단축해 줍니다. 지금 터미널을 열고 qm list부터 시작해보세요! 🚀 D