高效的PVE运维指南：Proxmox VE命令行从入门到实战

1
pveversion -v    # 版本及所有组件版本（贴论坛问题时必备）
2
qm list          # 列出所有 VM：VMID / 名称 / 状态 / 内存 / 引导盘 / 磁盘使用
3
qm status 100    # 单个 VM 状态（running / stopped）
4
qm config 100    # 查看 VM 完整配置（CPU/内存/磁盘/网络/引导顺序）

1
qm start 100             # 开机
2
qm stop 100              # 强制停止（等同拔电源，不建议日常用）
3
qm shutdown 100          # 优雅关机（发 ACPI 电源键，推荐）
4
qm shutdown 100 --timeout 300   # 300 秒内没关掉就强停
5
qm reboot 100            # 重启
6
qm suspend 100           # 挂起（暂停，占用内存）
7
qm resume 100            # 恢复
8
qm wait 100              # 阻塞等待 VM 状态变化（脚本里用）

1
qm guest cmd 100 get-fsinfo    # 查看分区/文件系统信息（含使用率！）
2
qm guest exec 100 -- df -h     # 在 VM 内执行任意命令
3
qm guest exec 100 -- bash -c 'systemctl restart nginx'

1
qm set 100 --cores 4 --memory 4096          # 改 CPU 核数、内存（可在线，需 balloon）
2
qm set 100 --sockets 1 --cpu host           # CPU 类型
3
qm set 100 --net0 virtio,bridge=vmbr0       # 网络（网卡类型必须一致才能热插拔）
4
qm set 100 --boot order=scsi0               # 引导顺序
5
qm set 100 --scsi0 vm-data:100/vm-100-disk-0.qcow2,discard=on,ssd=1
6
qm set 100 --ide2 vm-iso:iso/debian.iso,media=cdrom   # 挂载安装镜像
7
qm unset 100 --ide2                         # 移除某个参数
8
qm set 100 --description '我的测试机'        # 备注
9
qm set 100 --ostype l26                     # 系统类型（l26=Linux 6.x, win11=Windows 11）

1
# 最小化创建
2
qm create 105 --name myvm --memory 2048 --cores 2 --net0 virtio,bridge=vmbr0
3

4
# 完整参数创建
5
qm create 105 \
6
  --name web-server \
7
  --memory 4096 \
8
  --cores 4 \
9
  --cpu host \
10
  --machine q35 \
11
  --scsi0 vm-data:105/vm-105-disk-0.qcow2,size=50G,discard=on \
12
  --ide2 vm-iso:iso/debian-12.iso,media=cdrom \
13
  --net0 virtio,bridge=vmbr0 \
14
  --ostype l26 \
15
  --boot order=scsi0 \
16
  --onboot 1            # 宿主机开机时自动启动

1
qm clone 103 104 --name debian-clone --full   # 完整克隆（独立磁盘，推荐）
2
qm clone 103 104 --name debian-clone          # 链接克隆（依赖母盘，仅支持 qcow2）
3
qm template 104                               # 把 VM 转为模板（用 --full 克隆模板更佳）

1
qm destroy 105                     # 删除 VM 配置
2
qm destroy 105 --purge             # 同时删除备份和配置项
3
qm destroy 105 --destroy-unreferenced-disks   # 连未引用的磁盘一起删

1
qm migrate 100 node2 --online      # 在线迁移（同集群，虚拟机不关机）
2
qm migrate 100 node2               # 离线迁移
3
qm move-disk 100 scsi0 --storage node2-vmdata --delete   # 只迁移磁盘

1
pvesm status                # 所有存储：类型/容量/已用/可用
2
pvesm list vm-data          # 该存储上的所有镜像（VMID/卷名/大小/格式）
3
pvesm alloc vm-data 105 vm-105-disk-1 10G    # 手动分配一块 10G 磁盘
4
pvesm free vm-data 105/vm-105-disk-1         # 释放磁盘

1
qm resize 100 scsi0 +10G     # 在线扩容 +10G（无需关机）
2
qm resize 100 scsi0 100G     # 扩到固定 100G

1
# ① 创建空 VM（记住 VMID）
2
qm create 105 --name imported-vm --memory 2048 --cores 2 --net0 virtio,bridge=vmbr0
3

4
# ② 导入磁盘（--format 可指定 qcow2 或 raw）
5
qm importdisk 105 /mnt/vm-storage/images/incoming/debian.qcow2 vm-data --format qcow2
6

7
# ③ 挂载到 SCSI 控制器
8
qm set 105 --scsi0 vm-data:105/vm-105-disk-0.qcow2,discard=on,ssd=1
9

10
# ④ 设置引导顺序并启动
11
qm set 105 --boot order=scsi0
12
qm start 105

1
scp user@192.168.1.50:/backup/debian.qcow2 /mnt/vm-storage/images/incoming/
2
rsync -avP user@192.168.1.50:/backup/debian.qcow2 /mnt/vm-storage/images/incoming/

1
# 单个 VM
2
qm backup 100 --storage pve-config --mode snapshot --compress zstd
3

4
# 所有 VM + 容器
5
vzdump --all --storage pve-config --mode snapshot --compress zstd
6

7
# 排除某些 VM
8
vzdump --all --exclude 101,102 --storage pve-config

1
# 恢复到原 VMID
2
qm restore 100 /mnt/pve-config/dump/vzdump-qemu-100-2026_08_08-*.vma.zst
3

4
# 恢复到新 VMID（测试恢复用，强烈建议定期演练）
5
qmrestore /mnt/pve-config/dump/vzdump-qemu-100-2026_08_08-*.vma.zst 199 --storage vm-data

1
crontab -e
2
# 每天凌晨 2:00 备份所有 VM 到 pve-config，保留最近 3 份
3
0 2 * * * vzdump --all --storage pve-config --mode snapshot --compress zstd \
4
  --prune-backups 'keep-last=3' >> /var/log/vzdump.log 2>&1

1
crontab -e
2
# 每天 23:00 优雅关机（300 秒超时后强停）
3
0 23 * * * qm shutdown 102 --timeout 300 || qm stop 102
4
# 每天 08:00 开机
5
0 8 * * * qm start 102
6
# 每周日 03:00 重启
7
0 3 * * 0 qm reboot 102

1
# 关掉所有运行中的 VM（先优雅，后强停）
2
for id in $(qm list | awk '$3=="running"{print $1}'); do
3
  qm shutdown "$id" --timeout 300 || qm stop "$id"
4
done
5

6
# 启动所有已存在的 VM
7
for id in $(qm list | awk 'NR>1{print $1}'); do qm start "$id"; done

1
systemctl daemon-reload && systemctl enable --now vm-shutdown.timer
2
systemctl list-timers    # 查看所有计划

1
//file: /etc/crontab（root）
2

3
30 22 * * * vzdump --vmid 102 --storage pve-config --mode snapshot --compress zstd --prune-backups 'keep-last=7'
4
0  23 * * * qm shutdown 102 --timeout 300 || qm stop 102
5
0   8 * * * qm start 102

1
pvs / pvscan / pvdisplay    # 物理卷：哪块盘、多大、属于哪个 VG
2
vgs / vgscan / vgdisplay    # 卷组：总容量 / 剩余空间
3
lvs / lvscan / lvdisplay    # 逻辑卷：名字、大小、状态
4
lvs -a                      # 连快照、thin 子卷一起显示

1
# 创建：物理盘 -> PV -> VG -> LV
2
pvcreate /dev/sdb
3
vgcreate vm-storage /dev/sdb
4
lvcreate -L 100G -n vm-105-disk-0 vm-storage
5
lvcreate -l 100%FREE -n vm-105-disk-0 vm-storage   # 用掉全部剩余空间
6

7
# 扩容（顺序：PV -> VG -> LV -> 文件系统）
8
pvresize /dev/sdb                    # 物理盘扩容后刷新 PV
9
vgextend vm-storage /dev/sdc         # 加一块盘进 VG
10
lvextend -L +10G vm-storage/vm-105-disk-0    # LV +10G
11
lvextend -r -L +10G vm-storage/vm-105-disk-0 # -r 自动扩文件系统
12
resize2fs /dev/vm-storage/vm-105-disk-0      # ext4 手动扩
13

14
# 缩容（⚠️ 先缩文件系统，再缩 LV，顺序反了会损坏数据）
15
lvreduce -L -10G vm-storage/vm-105-disk-0
16

17
# 删除 / 快照
18
lvremove vm-storage/vm-105-disk-1
19
lvcreate -s -L 10G -n snap1 vm-storage/vm-105-disk-0   # 快照（PVE 备份底层）

1
pvesm add lvm vm-storage --vgname vm-storage   # 把卷组注册为 PVE 存储
2
pvesm status
3
# VM 磁盘会以 /dev/vm-storage/vm-<vmid>-disk-N 形式出现

1
# 查看镜像信息（关键：格式、实际占用、backing file）
2
qemu-img info debian.qcow2
3

4
# 创建
5
qemu-img create -f qcow2 debian.qcow2 50G
6
qemu-img create -f raw disk.img 50G
7

8
# 格式转换
9
qemu-img convert -f qcow2 -O raw debian.qcow2 disk.raw
10
qemu-img convert -f qcow2 -O qcow2 -c src.qcow2 dst.qcow2   # -c 压缩
11

12
# 扩容
13
qemu-img resize debian.qcow2 +10G
14

15
# qcow2 内置快照
16
qemu-img snapshot -l debian.qcow2      # 列出
17
qemu-img snapshot -c snap1 debian.qcow2# 创建
18
qemu-img snapshot -a snap1 debian.qcow2# 回滚
19
qemu-img snapshot -d snap1 debian.qcow2# 删除
20

21
# 检查 / 差量镜像
22
qemu-img check debian.qcow2
23
qemu-img create -f qcow2 -b base.qcow2 overlay.qcow2   # 差量镜像（overlay）
24
qemu-img rebase -b base.qcow2 overlay.qcow2            # 重设 backing file

1
qm monitor 100    # 进入 VM 的 QEMU monitor

1
info status        # 运行状态
2
info block         # 磁盘设备及状态
3
info cpus          # vCPU 情况
4
info balloon       # 内存气球
5
savevm snap1       # 系统级快照
6
loadvm snap1       # 恢复快照
7
system_reset       # 复位
8
system_powerdown   # 发关机信号
9
quit               # 退出 monitor

1
tail -f /var/log/pve/tasks/active     # 当前运行的任务
2
tail -f /var/log/syslog | grep qm     # QEMU 相关日志
3
journalctl -u pveproxy -f             # Web 界面相关
4
cat /var/log/pve/tasks/index           # 历史任务列表

1
qm status 100 --verbose    # 含 CPU/内存实时数据
2
top -p $(qm status 100 --verbose | grep pid | awk '{print $2}')  # 看 QEMU 进程
3
ps aux | grep qemu         # 所有 qemu 进程及完整命令行