GeekIt

virsh(KVM)命令速查

连接与查询、生命周期、快照、磁盘与存储池、网络网桥、CPU 内存调整、设备与 XML、迁移备份与报错排查等 167 条命令

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

命令 / 片段说明复制
virsh --version查看 virsh 版本,与 libvirtd 版本通常一致
virsh --help查看全部子命令,命令非常多
virsh help list查看某个子命令的用法
apt install libvirt-daemon-system libvirt-clients virtinstDebian/Ubuntu 安装服务端 + 客户端 + 建机工具
yum install libvirt libvirt-client virt-installRHEL/CentOS 系安装
systemctl enable --now libvirtd启动并设置开机自启
systemctl status libvirtd确认服务状态,连不上先看它
virsh uri查看当前默认连接 URI
virsh -c qemu:///system list --all系统级连接,管理本机全部虚拟机
virsh -c qemu:///session list --all用户级连接,只能管理当前用户的虚拟机
virsh -c qemu+ssh://root@10.0.0.5/system list --all远程管理其他宿主机
virsh version查看运行中 libvirt 与 QEMU 的版本
virsh nodeinfo查看宿主机的 CPU、内存与 NUMA 概要
virsh sysinfo查看宿主机硬件与 BIOS 信息
export LIBVIRT_DEFAULT_URI=qemu:///system固定默认连接,省去每次写 -c
普通用户需加入 libvirt 组否则只能连 session,看不到系统虚拟机
命令 / 片段说明复制
virsh list --all列出全部虚拟机,含未启动的
virsh list --state-running只列出运行中的
virsh list --state-shutoff --name只输出关机虚拟机的名字,便于脚本处理
virsh dominfo web01查看 UUID、内存、vCPU、自启动与状态
virsh domstate web01只看运行状态,脚本判断用
virsh domstate web01 --reason附带状态原因,排查崩溃关机有用
virsh domid web01查看运行时域 ID,关机为 -
virsh domuuid web01查看 UUID,迁移与备份时用于唯一标识
virsh vcpuinfo web01查看每个 vCPU 的状态与绑定的物理核
virsh domblklist web01列出磁盘设备与后端镜像路径
virsh domblklist web01 --details显示设备类型、目标与后端文件
virsh domiflist web01列出网卡、类型、源网络与 MAC
virsh domifaddr web01 --source agent通过 guest agent 取虚拟机 IP
virsh domifaddr web01 --source arp没有 agent 时用 ARP 表反查 IP
virsh domstats web01输出 CPU、内存、磁盘、网络的运行统计
virsh domstats --list-active查看所有活动域的统计项名称
virsh dumpxml web01导出虚拟机完整 XML 定义
virsh dumpxml web01 > web01.xml备份 XML,改配置前必做
virsh desc web01查看虚拟机描述信息
virsh dommemstat web01查看内存使用明细,判断是否该扩容
命令 / 片段说明复制
virsh start web01启动虚拟机
virsh start web01 --console启动后直接连控制台
virsh shutdown web01发送 ACPI 关机信号,优雅关闭
virsh shutdown web01 --mode acpi显式指定 ACPI 模式
virsh shutdown web01 --mode agent通过 guest agent 关机,需要装 qemu-guest-agent
virsh destroy web01强制断电,等价拔电源,慎用
virsh reboot web01优雅重启
virsh reset web01强制复位,不做关机流程
virsh suspend web01暂停,CPU 停止调度
virsh resume web01恢复暂停的虚拟机
virsh autostart web01设置宿主机启动时自动开机
virsh autostart --disable web01取消自启动
virsh console web01连串口控制台,退出用 Ctrl+]
virsh send-key web01 KEY_LEFTCTRL KEY_ALT KEY_DELETE发送组合键,模拟 CAD 重启
virsh define web01.xml从 XML 定义(注册)虚拟机
virsh create web01.xml临时创建并启动,销毁后定义消失
virsh undefine web01删除定义,磁盘文件默认保留
virsh undefine web01 --remove-all-storage连同磁盘一起删除,不可恢复,先确认
virsh undefine web01 --nvramUEFI 虚拟机需加 --nvram 才能删干净
virsh save web01 /data/web01.save把运行状态保存到文件,可随时恢复
virsh restore /data/web01.save从保存状态恢复运行
virsh managedsave web01关机时保存运行状态,下次 start 自动恢复
命令 / 片段说明复制
virsh snapshot-create-as web01 snap-20261104 "升级前"创建快照并写描述
virsh snapshot-create-as web01 snap1 --disk-only --atomic只做磁盘快照,速度快,不含内存
virsh snapshot-create-as web01 snap1 --quiesce冻结文件系统后再快照,需 guest agent
virsh snapshot-create-as web01 snap1 --memspec file=/data/mem.save同时保存内存状态,恢复后可继续运行
virsh snapshot-list web01列出快照名、创建时间与状态
virsh snapshot-info web01 snap1查看快照详情与所属父级
virsh snapshot-revert web01 snap1回滚到指定快照,当前数据会丢失
virsh snapshot-revert web01 snap1 --running回滚并直接启动
virsh snapshot-delete web01 snap1删除快照,合并回滚链
virsh snapshot-current web01查看当前所处的快照位置
raw 格式磁盘不支持内部快照改用 qcow2,或用外部快照方案
快照不是备份镜像损坏或磁盘故障时会一起丢,重要数据仍要独立备份
快照链过长会拖慢 IO定期 blockcommit 合并到基础镜像
命令 / 片段说明复制
virsh pool-list --all列出全部存储池与状态
virsh pool-info default查看池容量、已用与可用空间
virsh vol-list default列出池内卷(磁盘文件)
virsh vol-create-as default data.img 20G --format qcow2创建 20G qcow2 磁盘卷
virsh vol-info --pool default data.img查看卷容量、分配量与格式
virsh vol-resize --pool default data.img 40G扩容卷,扩容前确认文件系统支持在线扩展
virsh vol-delete --pool default data.img删除卷文件,不可恢复
virsh vol-clone --pool default data.img data-copy.img克隆卷,快速复制系统盘
virsh attach-disk web01 /data/data.qcow2 vdb --targetbus virtio --persistent热插磁盘,--persistent 写入配置
virsh detach-disk web01 vdb --persistent卸载磁盘,注意先确认数据已落盘
virsh blockresize web01 vda 40G在线扩容磁盘设备,虚拟机内还需扩文件系统
virsh domblkinfo web01 vda查看设备容量、分配与物理块大小
virsh blockjob web01 vda --bandwidth 50 --live给块任务限速,避免迁移占满磁盘
virsh blockcommit web01 vda --active --pivot合并快照链,回收空间
virsh blockpull web01 vda --wait把后备链数据拉入当前镜像
qemu-img info /data/web01.qcow2查看镜像格式、虚拟大小与实际占用
qemu-img resize /data/web01.qcow2 +20G离线扩容,扩容前需关机
qemu-img convert -O qcow2 src.raw dst.qcow2格式转换,raw 转 qcow2 后可省空间
qemu-img check /data/web01.qcow2检查镜像一致性
virsh pool-define-as / pool-build / pool-start / pool-autostart新建存储池的标准四步
命令 / 片段说明复制
virsh net-list --all列出 libvirt 网络与活动状态
virsh net-info default查看网桥名、网段与自启动配置
virsh net-dumpxml default导出网络定义,含 DHCP 与转发设置
virsh net-start default启动网络,重启宿主机后常见它没起来
virsh net-autostart default设置网络随 libvirtd 自动启动
virsh net-define net.xml从 XML 定义新网络
virsh net-destroy default立即停止网络,会断掉虚拟机通信
virsh net-undefine default删除网络定义
virsh net-update default add ip-dhcp-host "<host mac=52:54:00:xx ip=10.0.0.50/>" --live --config为固定 MAC 分配固定 IP
virsh domiflist web01确认虚拟机使用哪个网络与 MAC
virsh attach-interface web01 network default --model virtio --persistent热插网卡
virsh detach-interface web01 network --mac 52:54:00:aa:bb:cc --persistent按 MAC 卸载网卡
virsh iface-list查看宿主机物理接口
brctl show查看网桥与挂载的接口
ip -br link show master virbr0查看默认 NAT 网桥下的接口
brctl addbr br0 && ip link set br0 up手工建网桥,桥接模式的基础步骤
桥接模式需在 XML 中写 type=bridge与 NAT 的 type=network 区分开
命令 / 片段说明复制
virsh setmem web01 4G --live --config热调整内存,需气球设备支持,只能降不能超上限
virsh setmaxmem web01 8G --config调整最大内存,通常需关机后生效
virsh setvcpus web01 4 --live --config热增 vCPU,减少通常不被支持
virsh setvcpus web01 8 --maximum --config设置 vCPU 上限,为后续热加留余量
virsh vcpuinfo web01确认 vCPU 数量与绑定关系
virsh vcpupin web01 0 2把 vCPU0 绑定到物理核 2
virsh vcpupin web01 --live --config vcpu 0-3批量绑定,注意与 NUMA 布局对齐
virsh emulatorpin web01 4-5绑定模拟器线程,减少对其他业务的干扰
virsh numatune web01 --mode strict --nodeset 0NUMA 绑定,数据库类业务常用
virsh memtune web01 --hard-limit 4G --live设置内存硬限制
virsh blkiotune web01 --weight 500调整磁盘 IO 权重
virsh schedinfo web01 --set cpu_shares=2048调整 CPU 调度权重
virsh domstats web01 --cpu-total查看 CPU 时间占用,评估加压效果
热调整失败先看机器类型老 machine type 与旧 QEMU 对热插拔支持有限
命令 / 片段说明复制
virsh edit web01直接编辑 XML,保存时自动校验
EDITOR=vim virsh edit web01指定编辑器,避免默认 nano 不顺手
virsh dumpxml web01 > web01.xml && virsh define web01.xml导出改完再定义,适合脚本化批量改
virsh attach-device web01 disk.xml --persistent按 XML 片段添加设备
virsh detach-device web01 disk.xml --persistent按 XML 片段移除设备
virsh update-device web01 disk.xml --live更新已有设备属性
virsh change-media web01 sda /data/ubuntu.iso --insert挂载 ISO 到光驱
virsh change-media web01 sda --eject弹出光驱
virsh domblklist web01先确认光驱的 target 名(sda/sr0)
virsh qemu-agent-command web01 "{\"execute\":\"guest-info\"}"直接调用 guest agent,验证通道是否可用
virsh set-user-password web01 root NewPass --password通过 agent 改密码,需 guest agent 支持
virsh domfsfreeze web01 --mountpoint /data冻结文件系统,备份前保证一致性
virsh domfsthaw web01解冻文件系统
改 XML 前先备份define 校验通过不代表业务可用,出问题好回滚
命令 / 片段说明复制
virsh migrate --live web01 qemu+ssh://10.0.0.6/system在线迁移到另一台宿主机
virsh migrate --live --persistent --undefinesource web01 qemu+ssh://10.0.0.6/system迁移后保留定义并删除源端定义
virsh migrate --live --copy-storage-all web01 qemu+ssh://10.0.0.6/system共享存储不可用时的块迁移
virsh migrate --offline web01 qemu+ssh://10.0.0.6/system关机迁移,最稳妥
virsh migrate-setspeed web01 500限制迁移带宽(MiB/s),避免影响业务
virsh domjobinfo web01查看迁移/备份进度与剩余数据量
virsh domjobabort web01中止正在进行的迁移任务
virsh dump web01 /data/web01.core --memory-only导出内存转储,用于崩溃分析
virsh backup-begin web01 --backupxml backup.xml --domainxml domain.xml增量备份(新版特性),需 qemu 支持
virsh domfsfreeze + dumpxml + 磁盘快照 + domfsthaw一致性备份的标准动作序列
virsh dompmsuspend web01 --target mem让虚拟机进入待机,节省资源
迁移失败先查主机名解析两台宿主机需能互相解析并免密 SSH
CPU 特性不一致会导致迁移失败在 XML 中统一 CPU model 或使用 host-passthrough 前先评估
命令 / 片段说明复制
error: failed to connect to the hypervisorlibvirtd 未运行或连接 URI 不对
error: Failed to connect socket to '/var/run/libvirt/libvirt-sock'服务未启动或无权限,systemctl start libvirtd 并加组
error: Failed to get domain web01名称写错或不在当前连接,用 list --all 核对
error: Requested operation is not valid: domain is already active已运行还执行 start,先 shutdown 或改用 restart
error: operation failed: domain is not running对关机虚拟机执行在线操作
error: internal error: ... Permission deniedSELinux/AppArmor 拦截,检查安全上下文与策略
error: Cannot access storage file ... Permission denied镜像目录权限或 SELinux 标签不对,qemu 用户读不到
error: unsupported configuration: ...机器类型、固件或设备组合不被当前 QEMU 支持
error: Cannot get interface MTU on 'br0'网桥不存在或未启动,先建桥再启动虚拟机
error: network default is not activevirsh net-start default 并设置 autostart
error: Timed out during operation关机/迁移超时,检查 agent 与网络带宽
error: this function is not supported by the connection driver会话模式或后端驱动不支持该操作
snapshot-create 报磁盘格式不支持raw 盘不支持内部快照,转 qcow2
error: Domain snapshot not found快照名写错,用 snapshot-list 核对
error: Failed to undefine domain存在快照或 NVRAM,加 --nvram 或先删快照
console 进不去或退不出XML 需配置 serial console,退出按 Ctrl+]
虚拟机启动后立即 shut off看 /var/log/libvirt/qemu/web01.log 找真实原因
磁盘 IO 极慢检查 cache 模式、快照链长度与宿主机磁盘负载

运维常用组合

日常巡检virsh list --all → virsh domstats --list-active 逐项看 → virsh dommemstat 看内存 → df -h 看存储池余量
升级前快照virsh snapshot-create-as web01 pre-upgrade "升级前" --quiesce → 升级 → 异常时 virsh snapshot-revert web01 pre-upgrade
磁盘扩容virsh blockresize web01 vda 40G → 进入虚拟机 growpart /dev/vda 1 → resize2fs /dev/vda1 → df -h 确认
新增数据盘virsh vol-create-as default data.img 100G --format qcow2 → virsh attach-disk web01 /var/lib/libvirt/images/data.img vdb --targetbus virtio --persistent
在线迁移virsh migrate-setspeed web01 500 → virsh migrate --live --persistent --undefinesource web01 qemu+ssh://10.0.0.6/system → virsh domjobinfo 观察进度
克隆一台新机器virsh dumpxml web01 > new.xml → 改 name/uuid/mac/磁盘路径 → qemu-img convert 复制磁盘 → virsh define new.xml → virsh start new

实战要点

1. 改配置先备份 XML

dumpxml 存一份再 define,出错能快速回滚到可用配置

2. 关机优先 shutdown

destroy 等于拔电源,只在卡死时使用,且要接受数据风险

3. 快照不等于备份

快照与原盘同在一台机器,磁盘故障会一起丢,重要数据要异地备份

4. 扩容要两步

先 blockresize 扩设备,再进虚拟机扩文件系统,缺一步都不生效

5. 默认网络记得自启动

net-autostart 没设置时,宿主机重启后虚拟机会失去网络

6. 日志是第一现场

启动失败先看 /var/log/libvirt/qemu/<域名>.log,比盲猜快得多

共 167 条 virsh 命令 · 示例中的域名、路径与 IP 请替换为实际环境

关于virsh(KVM)命令速查

在线 virsh(libvirt/KVM)命令速查手册,按安装与连接、查看与信息、生命周期管理、快照、磁盘与存储池、网络与网桥、CPU 内存与 IO 调整、设备与 XML 编辑、迁移与备份、常见报错与排查等 10 类场景整理 160 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 virsh --version 与 uri/version/nodeinfo/sysinfo 与 -c qemu:///system、qemu:///session、qemu+ssh://root@host/system 远程连接、apt install libvirt-daemon-system libvirt-clients virtinst 与 systemctl enable --now libvirtd、list --all 与 --state-running 与 dominfo/domstate/domid/domuuid/vcpuinfo/domblklist/domiflist/domifaddr --source agent/domstats/dumpxml/desc、start 与 shutdown --mode acpi 与 destroy/reboot/reset/suspend/resume/autostart/undefine --remove-all-storage 与 define/create/save/restore/managedsave/send-key/console、snapshot-create-as --disk-only --atomic --quiesce 与 snapshot-list/-info/-revert/-delete 与 raw 盘限制、vol-list/vol-create-as/vol-info/vol-delete/vol-clone/vol-resize 与 attach-disk/detach-disk --targetbus virtio --persistent 与 blockresize/domblkinfo/blockjob/blockcommit/blockpull 与 qemu-img info/resize/convert、net-list/net-info/net-dumpxml/net-start/net-autostart/net-define/net-destroy/net-undefine/net-update 与 attach-interface/detach-interface --model virtio 与 iface-list 与 brctl show/ip link、setmem/setmaxmem/setvcpus --live --config 与 vcpupin/emulatorpin/numatune/memtune/blkiotune/schedinfo、edit 与 attach-device/detach-device/update-device/change-media --insert、migrate --live --persistent --undefinesource --copy-storage-all 与 migrate-setspeed/domjobinfo/domjobabort/backup-begin/dump/domfsfreeze/domfsthaw/dompmsuspend,以及 failed to connect to the hypervisor、Failed to connect socket、domain is already active、Failed to get domain、domain is not running、Permission denied(SELinux/AppArmor)、Cannot access storage file、unsupported configuration、Cannot get interface MTU、Timed out during operation、this function is not supported by the connection driver、snapshot 不支持 raw、Domain snapshot not found、undefine 失败需 --nvram、network default is not active 等报错排查。适用于宿主机上虚拟机的创建启停与巡检、快照回滚与磁盘扩容、网桥与 NAT 网络配置、CPU 内存热调整、XML 备份与批量变更、在线迁移与故障定位,以及虚拟化运维与云计算工程师面试复习。

核心能力

  • 涵盖 virsh --version 与 uri/version/nodeinfo/sysinfo 与 -c qemu:///system、qemu:///session、qemu+ssh://root@host/system 远程连接、apt install libvirt-daemon-system libvirt-clients virtinst 与 systemctl enable --now libvirtd、list --all 与 --state-running 与 dominfo/domstate/domid/domuuid/vcpuinfo/domblklist/domiflist/domifaddr --source agent/domstats/dumpxml/desc、start 与 shutdown --mode acpi 与 destroy/reboot/reset/suspend/resume/autostart/undefine --remove-all-storage 与 define/create/save/restore/managedsave/send-key/console、snapshot-create-as --disk-only --atomic --quiesce 与 snapshot-list/-info/-revert/-delete 与 raw 盘限制、vol-list/vol-create-as/vol-info/vol-delete/vol-clone/vol-resize 与 attach-disk/detach-disk --targetbus virtio --persistent 与 blockresize/domblkinfo/blockjob/blockcommit/blockpull 与 qemu-img info/resize/convert、net-list/net-info/net-dumpxml/net-start/net-autostart/net-define/net-destroy/net-undefine/net-update 与 attach-interface/detach-interface --model virtio 与 iface-list 与 brctl show/ip link、setmem/setmaxmem/setvcpus --live --config 与 vcpupin/emulatorpin/numatune/memtune/blkiotune/schedinfo、edit 与 attach-device/detach-device/update-device/change-media --insert、migrate --live --persistent --undefinesource --copy-storage-all 与 migrate-setspeed/domjobinfo/domjobabort/backup-begin/dump/domfsfreeze/domfsthaw/dompmsuspend,以及 failed to connect to the hypervisor、Failed to connect socket、domain is already active、Failed to get domain、domain is not running、Permission denied(SELinux/AppArmor)、Cannot access storage file、unsupported configuration、Cannot get interface MTU、Timed out during operation、this function is not supported by the connection driver、snapshot 不支持 raw、Domain snapshot not found、undefine 失败需 --nvram、network default is not active 等报错排查

适用场景

适用于宿主机上虚拟机的创建启停与巡检、快照回滚与磁盘扩容、网桥与 NAT 网络配置、CPU 内存热调整、XML 备份与批量变更、在线迁移与故障定位,以及虚拟化运维与云计算工程师面试复习。virsh(KVM)命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

virsh(KVM)命令速查是免费的吗?需要注册或安装吗?
virsh(KVM)命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
virsh(KVM)命令速查支持哪些功能?
涵盖 virsh --version 与 uri/version/nodeinfo/sysinfo 与 -c qemu:///system、qemu:///session、qemu+ssh://root@host/system 远程连接、apt install libvirt-daemon-system libvirt-clients virtinst 与 systemctl enable --now libvirtd、list --all 与 --state-running 与 dominfo/domstate/domid/domuuid/vcpuinfo/domblklist/domiflist/domifaddr --source agent/domstats/dumpxml/desc、start 与 shutdown --mode acpi 与 destroy/reboot/reset/suspend/resume/autostart/undefine --remove-all-storage 与 define/create/save/restore/managedsave/send-key/console、snapshot-create-as --disk-only --atomic --quiesce 与 snapshot-list/-info/-revert/-delete 与 raw 盘限制、vol-list/vol-create-as/vol-info/vol-delete/vol-clone/vol-resize 与 attach-disk/detach-disk --targetbus virtio --persistent 与 blockresize/domblkinfo/blockjob/blockcommit/blockpull 与 qemu-img info/resize/convert、net-list/net-info/net-dumpxml/net-start/net-autostart/net-define/net-destroy/net-undefine/net-update 与 attach-interface/detach-interface --model virtio 与 iface-list 与 brctl show/ip link、setmem/setmaxmem/setvcpus --live --config 与 vcpupin/emulatorpin/numatune/memtune/blkiotune/schedinfo、edit 与 attach-device/detach-device/update-device/change-media --insert、migrate --live --persistent --undefinesource --copy-storage-all 与 migrate-setspeed/domjobinfo/domjobabort/backup-begin/dump/domfsfreeze/domfsthaw/dompmsuspend,以及 failed to connect to the hypervisor、Failed to connect socket、domain is already active、Failed to get domain、domain is not running、Permission denied(SELinux/AppArmor)、Cannot access storage file、unsupported configuration、Cannot get interface MTU、Timed out during operation、this function is not supported by the connection driver、snapshot 不支持 raw、Domain snapshot not found、undefine 失败需 --nvram、network default is not active 等报错排查。
virsh(KVM)命令速查适合哪些场景使用?
适用于宿主机上虚拟机的创建启停与巡检、快照回滚与磁盘扩容、网桥与 NAT 网络配置、CPU 内存热调整、XML 备份与批量变更、在线迁移与故障定位,以及虚拟化运维与云计算工程师面试复习。