안녕하세요! 🚀 가상화 환경 구축과 관리에 관심이 많으신가요? 그렇다면 Proxmox Virtual Environment(VE)는 강력하고 유연한 솔루션이 될 수 있습니다. Proxmox VE는 웹 인터페이스를 통해 대부분의 작업을 손쉽게 처리할 수 있지만, 진정한 전문가가 되기 위해서는 터미널(CLI) 명령어를 숙지하는 것이 필수적입니다.
CLI 명령어는 작업의 자동화, 문제 해결, 원격 관리, 그리고 특정 고급 설정에 접근할 때 엄청난 효율성을 제공합니다. 이 글에서는 Proxmox VE 환경을 관리하는 데 있어 가장 중요하고 자주 사용되는 30가지 터미널 명령어를 자세한 설명과 예시를 곁들여 소개해 드리겠습니다. 이 가이드를 통해 Proxmox VE를 더욱 능숙하게 다룰 수 있게 될 것입니다!
💡 Proxmox VE 터미널 접속 방법
Proxmox VE 서버에 명령어를 입력하기 위해서는 SSH 클라이언트(PuTTY, MobaXterm, OpenSSH 등)를 사용하여 서버에 접속하거나, Proxmox VE 웹 인터페이스에서 해당 노드를 선택한 후 “Shell” 기능을 이용할 수 있습니다. 기본 로그인 계정은 root이며, 설치 시 설정한 비밀번호를 사용합니다.
섹션 1: 가상 머신(VM) 관리 명령어 🖥️
Proxmox VE의 핵심인 가상 머신을 제어하는 가장 기본적인 명령어들입니다.
-
qm list- 설명: 현재 Proxmox VE 노드에 생성된 모든 가상 머신(VM)의 목록과 상태를 보여줍니다. VMID, 이름, 상태, CPU 사용량, 메모리 사용량 등을 한눈에 확인할 수 있습니다.
- 예시:
qm list - 결과:
VMID NAME STATUS MEM(MB) CPU(%) NETIN(MB) NETOUT(MB) DISKREAD(MB) DISKWRITE(MB) 100 ubuntu running 2048 0.01 123.45 67.89 500 1200 101 centos stopped 0 0.00 0.00 0.00 0 0
-
qm start- 설명: 지정된 VMID의 가상 머신을 시작합니다.
- 예시:
qm start 100
-
qm stop- 설명: 지정된 VMID의 가상 머신을 강제로 종료합니다. 이는 전원 버튼을 길게 눌러 끄는 것과 유사하며, 데이터 손실의 위험이 있을 수 있습니다.
- 예시:
qm stop 100
-
qm shutdown- 설명: 지정된 VMID의 가상 머신에 운영체제 종료 신호를 보내어 안전하게 종료시킵니다. 일반적으로
stop보다 권장됩니다. - 예시:
qm shutdown 100
- 설명: 지정된 VMID의 가상 머신에 운영체제 종료 신호를 보내어 안전하게 종료시킵니다. 일반적으로
-
qm reset- 설명: 지정된 VMID의 가상 머신을 재시작합니다. 이는 물리적 서버의 리셋 버튼을 누르는 것과 같습니다.
- 예시:
qm reset 100
-
qm destroy- 설명: 지정된 VMID의 가상 머신과 모든 관련 파일을 영구적으로 삭제합니다. 주의: 이 작업은 되돌릴 수 없습니다.
- 예시:
qm destroy 100
-
qm config- 설명: 지정된 VMID의 가상 머신에 대한 현재 설정을 상세하게 보여줍니다. CPU, 메모리, 디스크, 네트워크 등 모든 구성 정보를 확인할 수 있습니다.
- 예시:
qm config 100
-
qm clone- 설명: 기존 가상 머신을 복제하여 새로운 가상 머신을 생성합니다. VMID를 직접 지정할 수 있습니다.
- 예시:
qm clone 100 102
-
qm migrate- 설명: 클러스터 환경에서 가상 머신을 다른 노드로 마이그레이션(이동)합니다.
- 예시:
qm migrate 100 proxmox-node2
섹션 2: 컨테이너(CT/LXC) 관리 명령어 📦
LXC(Linux Containers)는 가상 머신보다 가볍고 빠르며, 운영체제 수준의 가상화를 제공합니다.
-
pct list- 설명: 현재 Proxmox VE 노드에 생성된 모든 컨테이너(CT/LXC)의 목록과 상태를 보여줍니다. VMID, 이름, 상태, IP 주소 등을 확인할 수 있습니다.
- 예시:
pct list
-
pct start- 설명: 지정된 CTID의 컨테이너를 시작합니다.
- 예시:
pct start 200
-
pct stop- 설명: 지정된 CTID의 컨테이너를 강제로 종료합니다.
- 예시:
pct stop 200
-
pct shutdown- 설명: 지정된 CTID의 컨테이너에 종료 신호를 보내어 안전하게 종료시킵니다.
- 예시:
pct shutdown 200
-
pct destroy- 설명: 지정된 CTID의 컨테이너와 모든 관련 파일을 영구적으로 삭제합니다. 주의: 이 작업은 되돌릴 수 없습니다.
- 예시:
pct destroy 200
-
pct exec- 설명: 컨테이너 내에서 명령어를 실행합니다. 컨테이너에 직접 접속하지 않고도 내부 명령을 실행할 때 유용합니다.
- 예시:
pct exec 200 apt update pct exec 200 ls -la /var/www/html
섹션 3: 스토리지 및 템플릿 관리 명령어 💾
가상 머신 및 컨테이너의 디스크 이미지와 템플릿을 관리하는 명령어입니다.
-
pvesm list- 설명: Proxmox VE에 등록된 모든 스토리지의 목록을 보여줍니다. ID, 유형, 상태, 사용 가능한 공간 등을 확인할 수 있습니다.
- 예시:
pvesm list
-
pvesm status- 설명: 각 스토리지의 현재 상태 및 사용량을 더욱 상세하게 보여줍니다.
- 예시:
pvesm status
-
pveam available- 설명: Proxmox VE 공식 템플릿 서버에서 다운로드 가능한 컨테이너 템플릿 목록을 보여줍니다.
- 예시:
pveam available
-
pveam download- 설명: 지정된 스토리지에 컨테이너 템플릿을 다운로드합니다.
pveam available명령어를 통해 확인한 템플릿 이름을 사용합니다. - 예시:
pveam download local ubuntu-20.04-standard_20.04-1_amd64.tar.gz
- 설명: 지정된 스토리지에 컨테이너 템플릿을 다운로드합니다.
섹션 4: 클러스터 관리 명령어 🌳
여러 Proxmox VE 노드를 묶어 하나의 클러스터로 운영할 때 사용하는 명령어입니다.
-
pvecm status- 설명: 현재 클러스터의 상태, 노드 수, 쿼럼 상태 등을 보여줍니다. 클러스터가 정상적으로 작동하는지 확인할 때 필수적입니다.
- 예시:
pvecm status
-
pvecm nodes- 설명: 클러스터에 속한 모든 노드의 목록을 보여줍니다.
- 예시:
pvecm nodes
-
pvecm add- 설명: 기존 클러스터에 새로운 노드를 추가하는 명령입니다. 이 명령은 대상 노드에서 실행해야 하며, 이미 존재하는 클러스터의 IP 주소를 지정합니다. (클러스터 가입 과정은 다소 복잡하여 추가적인 설정이 필요합니다.)
- 예시:
# 새 노드에서 실행 pvecm add 192.168.1.10 --ring0_addr 192.168.1.10 # 클러스터IP와 새 노드 IP
섹션 5: 네트워크 및 시스템 정보 명령어 🌐
Proxmox VE 서버 자체의 네트워크 설정 및 시스템 정보를 확인하는 데 사용됩니다. (이들은 Proxmox 특정 명령은 아니지만, PVE 관리 시 매우 자주 사용됩니다.)
-
ip a- 설명: 현재 서버의 모든 네트워크 인터페이스와 할당된 IP 주소를 보여줍니다. 네트워크 문제 해결에 매우 유용합니다.
- 예시:
ip a
-
cat /etc/network/interfaces- 설명: Proxmox VE 서버의 네트워크 설정 파일 내용을 출력합니다. 네트워크 브리지(vmbr0 등) 및 IP 설정 등을 확인할 수 있습니다.
- 예시:
cat /etc/network/interfaces
-
pveversion -v- 설명: 현재 Proxmox VE 서버에 설치된 Proxmox 관련 패키지의 버전 정보를 상세하게 보여줍니다. 문제 발생 시 버전 정보를 제공할 때 유용합니다.
- 예시:
pveversion -v
-
df -h- 설명: 파일 시스템의 디스크 공간 사용량을 사람이 읽기 쉬운 형태로 보여줍니다. 스토리지 용량 관리에 필수적입니다.
- 예시:
df -h
섹션 6: 백업 및 복구 명령어 🛡️
가상 머신 및 컨테이너의 데이터를 보호하고 복구하는 중요한 명령어입니다.
-
vzdump- 설명: 지정된 VMID 또는 CTID의 가상 머신/컨테이너를 백업합니다. 다양한 옵션(
--storage,--mode,--compress등)을 통해 백업 방식을 제어할 수 있습니다. -
예시:
# VMID 100을 기본 스토리지에 백업 vzdump 100 # VMID 100을 "backup_storage"에 suspend 모드로 압축하여 백업 vzdump 100 --storage backup_storage --mode suspend --compress zstd
- 설명: 지정된 VMID 또는 CTID의 가상 머신/컨테이너를 백업합니다. 다양한 옵션(
-
qmrestore- 설명:
vzdump로 생성된 백업 파일(.vma.zst,.tar.gz등)을 사용하여 가상 머신을 복원합니다. 새로운 VMID를 지정하여 복원할 수 있습니다. - 예시:
# local 스토리지에 있는 백업 파일 덤프를 VMID 103으로 복원 qmrestore /var/lib/vz/dump/vzdump-qemu-100-2023-10-27_10_00_00.vma.zst 103 - 참고: 컨테이너 복구는
pct restore명령어를 사용합니다.
- 설명:
섹션 7: 시스템 유지보수 및 문제 해결 명령어 🛠️
Proxmox VE 서버 자체를 최신 상태로 유지하고, 문제가 발생했을 때 진단하는 데 사용됩니다.
-
apt update && apt upgrade -y- 설명: Proxmox VE 서버의 패키지 목록을 업데이트하고, 설치된 모든 패키지를 최신 버전으로 업그레이드합니다.
-y옵션은 모든 질문에 “예”로 자동 응답합니다. 업그레이드 전 중요 데이터 백업 및 스냅샷 생성을 강력히 권장합니다. - 예시:
apt update && apt upgrade -y
- 설명: Proxmox VE 서버의 패키지 목록을 업데이트하고, 설치된 모든 패키지를 최신 버전으로 업그레이드합니다.
-
journalctl -f- 설명: 시스템 로그를 실시간으로 출력합니다. 문제 발생 시 원인을 파악하거나, 특정 서비스의 동작을 모니터링할 때 매우 유용합니다.
Ctrl+C로 종료합니다. - 예시:
journalctl -f - 팁: 특정 서비스의 로그만 보려면
journalctl -f -u pveproxy와 같이-u옵션을 사용할 수 있습니다.
- 설명: 시스템 로그를 실시간으로 출력합니다. 문제 발생 시 원인을 파악하거나, 특정 서비스의 동작을 모니터링할 때 매우 유용합니다.
결론 🎉
Proxmox VE는 강력한 기능을 제공하며, CLI 명령어는 이러한 기능들을 최대한 활용할 수 있는 열쇠입니다. 이 30가지 명령어는 Proxmox VE 관리의 시작점이자 핵심 도구이며, 일상적인 유지보수, 문제 해결, 그리고 고급 설정에 이르는 다양한 상황에서 여러분의 생산성을 크게 향상시킬 것입니다.
처음에는 모든 명령어를 외우기 어려울 수 있지만, 꾸준히 사용하고 실습하다 보면 자연스럽게 익숙해질 것입니다. 공식 Proxmox VE 문서를 참고하거나, 커뮤니티에서 질문하며 더 깊이 있는 지식을 습득하는 것도 좋은 방법입니다.
이제 터미널을 열고, 여러분의 Proxmox VE 환경을 마스터하는 여정을 시작해보세요! 궁금한 점이 있다면 언제든지 댓글로 남겨주세요. 💡 G
mummer