GeekIt

Proxmox(qm/pct)命令速查

qm 虚拟机与 pct 容器的查看配置、生命周期、创建克隆、磁盘与迁移、快照、备份恢复与报错排查等 177 条命令

共 177 条命令 · 11 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
pveversion -v查看 PVE 与内核、QEMU、LXC 的完整版本
pvecm status查看集群名称、节点数与 quorum 状态
pvecm nodes列出集群全部节点及其状态
pvesm status查看各存储的容量、已用与可用空间
pvesm list local-lvm列出某存储上的卷与所属虚拟机
ha-manager status查看 HA 资源与节点健康状态
cat /etc/pve/qemu-server/100.conf虚拟机配置落盘位置,改前先备份
cat /etc/pve/lxc/101.conf容器配置落盘位置
ls /etc/pve/nodes查看各节点下的虚拟机与容器清单
journalctl -u pveproxy -n 100Web 界面异常时看 pveproxy 日志
pvesh get /nodes用 API 方式查询节点信息,便于脚本化
全部命令需 root 或 sudo普通用户没有 /etc/pve 权限
命令 / 片段说明复制
qm list列出全部虚拟机、状态、内存与磁盘占用
qm status 100查看单个虚拟机运行状态
qm config 100输出虚拟机全部配置项
qm config 100 --current 1显示当前生效值(含默认值),排障很有用
qm pending 100查看尚未生效的待应用配置改动
qm showcmd 100 --pretty查看实际生成的 qemu 命令行,定位启动参数问题
qm cloudinit dump 100 user查看生成的 cloud-init user-data
qm set 100 --memory 4096 --cores 4修改内存与 CPU 核数
qm set 100 --name web-prod修改虚拟机名称
qm set 100 --net0 virtio,bridge=vmbr0修改网卡模型与桥接
qm set 100 --delete net1删除指定配置项
qm set 100 --onboot 1 --startup order=2设置开机自启与启动顺序
qm set 100 --protection 1开启保护,防止误删
qm set 100 --description "用途:网关"写备注,比记在脑子里靠谱
qm guest cmd 100 ping通过 guest agent 执行内置命令
qm guest exec 100 -- df -h通过 agent 在虚拟机内跑命令
qm guest passwd 100 root通过 agent 修改 root 密码
qm agent 100 network-get-interfaces获取虚拟机内部网卡与 IP
命令 / 片段说明复制
qm start 100启动虚拟机
qm stop 100强制停止,等价断电,慎用
qm shutdown 100优雅关机,会走 ACPI
qm shutdown 100 --timeout 120 --forceStop超时后强制停止,避免卡死
qm reboot 100优雅重启
qm reset 100强制复位
qm suspend 100挂起到磁盘,释放资源
qm resume 100从挂起状态恢复
qm wait 100 --timeout 300等待任务完成,脚本里做同步
qm unlock 100解除卡住的锁,先确认没有正在跑的任务
qm destroy 100删除虚拟机定义,磁盘可能残留
qm destroy 100 --purge连同磁盘与配置一起删除,不可恢复
qm sendkey 100 ctrl-alt-delete发送按键,远程重启卡住的系统
qm terminal 100连接串口控制台,退出用 Ctrl+O
qm vncproxy 100打开 VNC 代理,图形界面排障用
qm monitor 100进入 QEMU monitor,可查 info block 等信息
命令 / 片段说明复制
qm create 200 --name web01 --memory 2048 --cores 2 --net0 virtio,bridge=vmbr0最小创建命令,先建空壳再挂盘
qm create 200 --name web01 --scsi0 local-lvm:32 --ide2 local:iso/debian.iso,media=cdrom --boot order=scsi0带系统盘与安装镜像的完整创建
qm create 200 --name db --memory 8192 --cores 4 --sockets 2 --cpu host指定 CPU 类型,性能与迁移兼容需权衡
qm create 200 --name web --agent 1 --ostype l26开启 agent 并指定系统类型
qm importdisk 200 /root/debian.qcow2 local-lvm导入外部镜像为未挂载磁盘,再用 qm set 挂上
qm set 200 --scsi0 local-lvm:vm-200-disk-0把导入的磁盘挂到虚拟机
qm importovf 200 /root/app.ovf local-lvm从 OVF/OVA 导入虚拟机
qm template 100把虚拟机转成模板,之后只能克隆
qm clone 100 201 --name web02 --full完整克隆(复制磁盘),可独立修改
qm clone 100 201 --name web02链接克隆,省空间但依赖模板
qm clone 100 201 --name web02 --storage local-zfs克隆时指定目标存储
qm clone 100 201 --name web02 --pool prod克隆到指定资源池,便于权限隔离
qm set 201 --memory 4096 --cores 4克隆后按需调整规格
cloud-init 需先挂 cloudinit 设备qm set 100 --ide2 local-lvm:cloudinit
qm set 100 --ciuser ops --sshkeys ~/.ssh/id_rsa.pub注入用户与 SSH 公钥,实现开箱即用
qm set 100 --ipconfig0 ip=10.0.0.50/24,gw=10.0.0.1静态 IP 由 cloud-init 下发
qm cloudinit update 100改完 cloud-init 配置后重新生成镜像
qm template 后不要再改配置模板被链接克隆依赖,改动会影响所有克隆
命令 / 片段说明复制
qm resize 100 scsi0 +10G在线扩容磁盘,虚拟机内还需扩文件系统
qm resize 100 scsi0 50G直接指定目标大小,只能增不能减
qm rescan 100重新扫描磁盘,识别手工挂上的卷
qm disk rescan --vmid 100新版写法,等价上一条
qm move-disk 100 scsi0 local-zfs --delete把磁盘迁到其他存储并删除源
qm disk move 100 scsi0 local-zfs --delete新版子命令写法
qm set 100 --scsi1 local-lvm:20新增一块 20G 数据盘
qm set 100 --delete scsi1移除数据盘配置,卷可能残留需手工删
lvremove /dev/pve/vm-100-disk-1清理残留的 LVM 卷,操作前务必确认路径
qm migrate 100 pve02 --online在线迁移到另一节点
qm migrate 100 pve02 --online --with-local-disks本地盘一起迁移
qm migrate 100 pve02 --online --targetstorage local-zfs迁移同时换存储
qm migrate 100 pve02 --online --bwlimit 50限制迁移带宽(KiB/s),避免打满网络
qm migrate 100 pve02 --offline关机迁移,最稳但会中断业务
迁移前确认两节点存储同名可用共享存储或 with-local-disks,否则会失败
qm status 100 --verbose查看更详细的运行信息
命令 / 片段说明复制
qm snapshot 100 pre-upgrade --description "升级前"创建快照并写说明
qm listsnapshot 100列出快照树、父级关系与时间
qm rollback 100 pre-upgrade回滚到快照,当前数据会丢失
qm delsnapshot 100 pre-upgrade删除快照,释放空间
qm snapshot 100 snap1 --vmstate 1带内存状态,回滚后可继续运行
快照对 raw/LVM 有额外空间开销LVM 快照按改动量占用,长期保留会撑爆存储
快照不是备份快照与原盘在同一存储上,磁盘或存储损坏会一起丢
qm terminal 100串口控制台,需虚拟机配置串口并开启 console
qm terminal 100 --escape 0x1d自定义退出字符
qm vncproxy 100 --generate-password生成一次性 VNC 密码
qm monitor 100 后执行 info block查看磁盘设备与后端镜像对应关系
qm monitor 100 后执行 info snapshots查看块设备层快照信息
解锁卡住的任务先 qm status 看 lock 字段,再 qm unlock
命令 / 片段说明复制
pct list列出全部 LXC 容器与状态
pct status 101查看容器状态
pct config 101输出容器配置
pct start 101启动容器
pct stop 101强制停止容器
pct shutdown 101优雅关机
pct shutdown 101 --timeout 60 --forceStop超时强停,避免卡住
pct reboot 101重启容器
pct suspend 101挂起容器
pct resume 101恢复容器
pct create 101 local:vztmpl/debian-12-standard_amd64.tar.zst --hostname web --memory 1024 --cores 2 --rootfs local-lvm:8创建容器,模板需先下载
pct create 101 local:vztmpl/debian-12.tar.zst --hostname web --net0 name=eth0,bridge=vmbr0,ip=dhcp使用 DHCP 配置网络
pct create 101 local:vztmpl/debian-12.tar.zst --hostname web --features nesting=1,keyctl=1开启嵌套特性,容器内跑 Docker 需要
pct clone 101 102 --hostname web02克隆容器
pct clone 101 102 --hostname web02 --full完整克隆,独立于源容器
pct template 101转为模板供批量克隆
pct migrate 101 pve02 --restart迁移容器,重启式生效
pct destroy 101删除容器及其磁盘
pct enter 101进入容器 shell,等价 lxc-attach
pct exec 101 -- df -h在容器内执行单条命令
pct exec 101 -- systemctl restart nginx批量运维容器内的服务
pct push 101 ./app.conf /etc/app.conf把宿主机文件推入容器
pct pull 101 /var/log/app.log ./app.log从容器拉文件到宿主机
pct unlock 101解除容器的卡死锁
命令 / 片段说明复制
pct resize 101 rootfs +5G扩容根盘,容器内文件系统通常自动扩展
pct resize 101 mp0 100G扩容挂载点磁盘
pct move-volume 101 rootfs local-zfs --delete把根盘迁到其他存储
pct set 101 --memory 2048 --cores 4调整容器资源
pct set 101 --swap 512 --cpulimit 2限制 CPU 使用与交换分区
pct set 101 --net0 name=eth0,bridge=vmbr0,ip=10.0.0.51/24,gw=10.0.0.1改成静态 IP
pct set 101 --mp0 local-lvm:50,mountoptions=noatime新增挂载点并调挂载参数
pct snapshot 101 snap1 --description "升级前"创建容器快照
pct listsnapshot 101列出快照
pct rollback 101 snap1回滚快照
pct delsnapshot 101 snap1删除快照
pct fstrim 101回收容器磁盘未使用块,节省存储
pct fsck 101检查容器文件系统,需先停止
pct restore 101 /var/lib/vz/dump/vzdump-lxc-101.tar.zst --storage local-lvm从备份恢复容器,可指定新 ID
pveam update && pveam available --section system更新并查看可下载的系统模板
pveam download local debian-12-standard_amd64.tar.zst下载模板到 local 存储
pveam list local查看已下载的模板
pct 快照基于存储能力LVM-thin 与 ZFS 支持较好,目录存储受限
命令 / 片段说明复制
vzdump 100 --storage backup --mode snapshot --compress zstd单机备份,snapshot 模式不停机
vzdump 100 101 --storage backup --mode suspend批量备份,suspend 会短暂挂起
vzdump --all --storage backup --mode snapshot --mailnotification failure全量备份,仅失败时发邮件
qmrestore /var/lib/vz/dump/vzdump-qemu-100-xxx.vma.zst 200 --storage local-lvm恢复虚拟机到新 ID,避免覆盖生产
cat /etc/pve/storage.cfg查看存储配置,权限与内容类型都在这
pvesm add dir backup --path /mnt/backup --content backup新增备份存储
pvesm set backup --content backup,iso调整存储允许的内容类型
pvesm remove backup删除存储配置(不删数据)
pvecm status集群 quorum 异常时先看它
systemctl restart pve-cluster集群文件系统异常时的重启操作,会造成短暂不可用
pvecm expected 1单节点应急恢复 quorum,事后必须还原
ha-manager config查看 HA 资源配置
cron 里跑 vzdump 要带 --quiet避免邮件被日志刷爆
备份要定期做恢复演练没验证过的备份等于没有备份
命令 / 片段说明复制
qm list && pvesm status日常巡检第一步:虚拟机清单与存储余量
qm config 100 --current | grep -E "memory|cores|net0"快速核对关键配置
qm clone 9000 300 --name app01 --full && qm set 300 --memory 4096 && qm start 300模板化交付一条龙
qm snapshot 100 pre-change && qm set 100 --cores 8 && qm reboot 100改配置前留快照,出问题一键回滚
qm resize 100 scsi0 +20G && qm guest exec 100 -- growpart /dev/sda 1扩容磁盘后进系统扩分区
vzdump 100 --storage backup --mode snapshot && qmrestore ... 999先备份再演练恢复,验证备份可用
pct exec 101 -- systemctl status nginx容器批量巡检的典型用法
pct push 101 app.tar.gz /root/ && pct exec 101 -- tar xzf /root/app.tar.gz -C /opt发布文件到容器并解包
qm migrate 100 pve02 --online --with-local-disks --bwlimit 100维护窗口前迁移业务,限速避免影响其他节点
for id in $(qm list | awk "NR>1 {print $1}"); do echo "== $id"; qm status $id; done批量巡检所有虚拟机状态
命令 / 片段说明复制
VM 100 is running - stop it first运行中不允许的操作,先 shutdown
CT 101 is locked (backup)有任务在跑,等或 pct unlock 前先确认
storage does not support content type存储未允许该内容类型,检查 storage.cfg
no space left on device存储满,先删快照或清理备份
permission denied - could not access /etc/pve非 root 或无集群文件系统挂载
Unable to create image: no such volume group存储名写错或 LVM 卷组不存在
bridge vmbr0 does not exist网桥未创建,先在节点网络里建桥
volume does not exist卷已删或 ID 写错,用 pvesm list 核对
migration aborted网络、存储或 CPU 类型不兼容,看任务日志详情
timeout waiting for lock锁未释放,排查残留任务进程
agent not running虚拟机未装或未启用 qemu-guest-agent
kvm: -drive file=...: Could not open卷被占用或权限问题,检查是否被其他 VM 挂载
resize 报 only grow supported磁盘只能扩不能缩,缩容需重建
clone 报模板正在使用链接克隆依赖模板,先迁移或转完整克隆
quorum 丢失导致无法操作集群节点失联,先恢复网络或临时 pvecm expected
备份任务卡在 99%多为存储写入慢或网络抖动,检查存储健康
Web 界面 500 但命令行正常重启 pveproxy 与 pvestatd
任务日志位置/var/log/pve/tasks/ 下按任务 ID 查看完整输出

运维常用组合

模板化交付虚拟机qm clone 9000 300 --name app01 --full → qm set 300 --memory 4096 --cores 4 → qm set 300 --ipconfig0 ip=10.0.0.60/24,gw=10.0.0.1 → qm start 300
在线扩容qm resize 100 scsi0 +20G → qm guest exec 100 -- growpart /dev/sda 1 → qm guest exec 100 -- resize2fs /dev/sda1 → df -h 确认
升级前保护vzdump 100 --storage backup --mode snapshot → qm snapshot 100 pre-upgrade "升级前" → 升级 → 异常时 qm rollback 100 pre-upgrade
节点维护迁移qm migrate 100 pve02 --online --with-local-disks --bwlimit 100 → pct migrate 101 pve02 --restart → 确认业务正常后再维护节点
容器批量运维pct list | awk "NR>1 {print $1}" | xargs -I{} sh -c "echo == {}; pct exec {} -- systemctl is-active nginx"
存储巡检pvesm status → 清理无用卷 pvesm list local-lvm → 删旧快照 qm listsnapshot → 检查备份留存策略

实战要点

1. 改配置先做快照

qm snapshot 几秒钟,回滚也是几秒钟,比事后排查便宜得多

2. 虚拟机用 qm,容器用 pct

两套命令结构相似,掌握一套即可迁移记忆

3. 模板只读不改

链接克隆依赖模板,改模板会影响所有克隆出来的机器

4. 扩容分两步

qm resize 只扩块设备,分区与文件系统要进系统用 growpart + resize2fs

5. 备份不等于快照

vzdump 才是可离线恢复的备份,快照仍在同一存储上

6. 任务日志是第一现场

/var/log/pve/tasks 里有完整输出,Web 界面只给摘要

共 177 条 Proxmox 命令 · 示例中的 ID、存储与 IP 请替换为实际环境

关于Proxmox(qm/pct)命令速查

在线 Proxmox VE(PVE)命令速查手册,按基础与环境、qm 查看与配置、qm 生命周期、qm 创建克隆与 cloud-init、qm 磁盘与迁移、qm 快照与控制台、pct 容器管理、存储备份与集群、实战组合、常见报错与排查等 10 类场景整理 170 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 pveversion -v 与 pvecm status/nodes 与 pvesm status/list 与 ha-manager status 与 /etc/pve/qemu-server 与 /etc/pve/lxc 配置文件、qm list 与 qm status/config/pending/cloudinit dump 与 qm showcmd 与 qm start/stop/shutdown/reboot/reset/suspend/resume 与 qm create 的 --name/--memory/--cores/--sockets/--net0 virtio,bridge=vmbr0/--scsi0 local-lvm:32/--ide2 local:iso/--boot order 与 qm set 的 --memory/--cores/--net0/--delete 与 qm clone --full 与 qm template 与 qm migrate --online 与 qm destroy --purge、qm resize scsi0 +10G 与 qm importdisk 与 qm importovf 与 qm move-disk 与 qm disk rescan 与 qm rescan、qm snapshot/listsnapshot/rollback/delsnapshot 与 qm terminal 与 qm monitor 与 qm vncproxy 与 qm sendkey 与 qm agent network-get-interfaces 与 qm guest exec 与 qm guest passwd 与 qm unlock 与 qm wait,以及 pct list/status/config/start/stop/shutdown/reboot/suspend/resume 与 pct create 的 --hostname/--memory/--cores/--rootfs/--net0 name=eth0,bridge=vmbr0,ip=dhcp 与 pct clone 与 pct template 与 pct destroy 与 pct migrate --restart 与 pct resize rootfs +5G 与 pct set 与 pct enter 与 pct exec 与 pct push/pull 与 pct fstrim 与 pct fsck 与 pct move-volume 与 pct restore 与 pct unlock、pveam update/available/download/list 与 vzdump --mode snapshot --compress zstd 与 qmrestore/restore 恢复,还有 VM is running、CT is locked、storage does not support...、no space left on device、permission denied、Unable to create image、bridge vmbr0 does not exist、volume does not exist、migration aborted、timeout waiting for lock、agent not running 等报错排查。适用于 PVE 集群上虚拟机与容器的批量创建与巡检、模板与克隆标准化交付、磁盘在线扩容、快照回滚与备份恢复、跨节点迁移与 HA 排查、存储容量与卷管理,以及虚拟化运维与云计算工程师面试复习。

核心能力

  • 涵盖 pveversion -v 与 pvecm status/nodes 与 pvesm status/list 与 ha-manager status 与 /etc/pve/qemu-server 与 /etc/pve/lxc 配置文件、qm list 与 qm status/config/pending/cloudinit dump 与 qm showcmd 与 qm start/stop/shutdown/reboot/reset/suspend/resume 与 qm create 的 --name/--memory/--cores/--sockets/--net0 virtio,bridge=vmbr0/--scsi0 local-lvm:32/--ide2 local:iso/--boot order 与 qm set 的 --memory/--cores/--net0/--delete 与 qm clone --full 与 qm template 与 qm migrate --online 与 qm destroy --purge、qm resize scsi0 +10G 与 qm importdisk 与 qm importovf 与 qm move-disk 与 qm disk rescan 与 qm rescan、qm snapshot/listsnapshot/rollback/delsnapshot 与 qm terminal 与 qm monitor 与 qm vncproxy 与 qm sendkey 与 qm agent network-get-interfaces 与 qm guest exec 与 qm guest passwd 与 qm unlock 与 qm wait,以及 pct list/status/config/start/stop/shutdown/reboot/suspend/resume 与 pct create 的 --hostname/--memory/--cores/--rootfs/--net0 name=eth0,bridge=vmbr0,ip=dhcp 与 pct clone 与 pct template 与 pct destroy 与 pct migrate --restart 与 pct resize rootfs +5G 与 pct set 与 pct enter 与 pct exec 与 pct push/pull 与 pct fstrim 与 pct fsck 与 pct move-volume 与 pct restore 与 pct unlock、pveam update/available/download/list 与 vzdump --mode snapshot --compress zstd 与 qmrestore/restore 恢复,还有 VM is running、CT is locked、storage does not support...、no space left on device、permission denied、Unable to create image、bridge vmbr0 does not exist、volume does not exist、migration aborted、timeout waiting for lock、agent not running 等报错排查

适用场景

适用于 PVE 集群上虚拟机与容器的批量创建与巡检、模板与克隆标准化交付、磁盘在线扩容、快照回滚与备份恢复、跨节点迁移与 HA 排查、存储容量与卷管理,以及虚拟化运维与云计算工程师面试复习。Proxmox(qm/pct)命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Proxmox(qm/pct)命令速查是免费的吗?需要注册或安装吗?
Proxmox(qm/pct)命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Proxmox(qm/pct)命令速查支持哪些功能?
涵盖 pveversion -v 与 pvecm status/nodes 与 pvesm status/list 与 ha-manager status 与 /etc/pve/qemu-server 与 /etc/pve/lxc 配置文件、qm list 与 qm status/config/pending/cloudinit dump 与 qm showcmd 与 qm start/stop/shutdown/reboot/reset/suspend/resume 与 qm create 的 --name/--memory/--cores/--sockets/--net0 virtio,bridge=vmbr0/--scsi0 local-lvm:32/--ide2 local:iso/--boot order 与 qm set 的 --memory/--cores/--net0/--delete 与 qm clone --full 与 qm template 与 qm migrate --online 与 qm destroy --purge、qm resize scsi0 +10G 与 qm importdisk 与 qm importovf 与 qm move-disk 与 qm disk rescan 与 qm rescan、qm snapshot/listsnapshot/rollback/delsnapshot 与 qm terminal 与 qm monitor 与 qm vncproxy 与 qm sendkey 与 qm agent network-get-interfaces 与 qm guest exec 与 qm guest passwd 与 qm unlock 与 qm wait,以及 pct list/status/config/start/stop/shutdown/reboot/suspend/resume 与 pct create 的 --hostname/--memory/--cores/--rootfs/--net0 name=eth0,bridge=vmbr0,ip=dhcp 与 pct clone 与 pct template 与 pct destroy 与 pct migrate --restart 与 pct resize rootfs +5G 与 pct set 与 pct enter 与 pct exec 与 pct push/pull 与 pct fstrim 与 pct fsck 与 pct move-volume 与 pct restore 与 pct unlock、pveam update/available/download/list 与 vzdump --mode snapshot --compress zstd 与 qmrestore/restore 恢复,还有 VM is running、CT is locked、storage does not support...、no space left on device、permission denied、Unable to create image、bridge vmbr0 does not exist、volume does not exist、migration aborted、timeout waiting for lock、agent not running 等报错排查。
Proxmox(qm/pct)命令速查适合哪些场景使用?
适用于 PVE 集群上虚拟机与容器的批量创建与巡检、模板与克隆标准化交付、磁盘在线扩容、快照回滚与备份恢复、跨节点迁移与 HA 排查、存储容量与卷管理,以及虚拟化运维与云计算工程师面试复习。