用 virsh 管理域、存储、网络与恢复

User (virsh / virt-manager / Cockpit)
       |
       v
  libvirt API (libvirtd / modular daemons)
       |
       v
  QEMU (userspace device emulation)
       |
       v
  KVM (kernel module, CPU/memory virtualization)

graph LR
    subgraph "Traditional Monolithic"
        V1["virsh / virt-manager"] --> L1["libvirtd / (All-in-One)"]
        L1 --> Q1["QEMU"]
        L1 --> N1["Network"]
        L1 --> S1["Storage"]
    end

    subgraph "Modern Modular"
        V2["virsh / virt-manager"] --> P2["virtproxyd / (Proxy)"]
        P2 --> QD["virtqemud / (QEMU VMs)"]
        P2 --> ND["virtnetworkd / (Networks)"]
        P2 --> SD["virtstoraged / (Storage Pools)"]
        P2 --> DD["virtnodedevd / (Host Devices)"]
        P2 --> SEC["virtsecretd / (Secrets)"]
        QD --> Q2["QEMU"]
        ND --> N2["dnsmasq"]
        SD --> S2["Storage Backend"]
    end

# 为 QEMU 驱动启用所有模块化守护进程
for drv in qemu interface network nodedev nwfilter secret storage
do
  sudo systemctl unmask virt${drv}d.service
  sudo systemctl unmask virt${drv}d{,-ro,-admin}.socket
  sudo systemctl enable virt${drv}d.service
  sudo systemctl enable virt${drv}d{,-ro,-admin}.socket
  sudo systemctl start virt${drv}d.socket
done

driver[+transport]://[username@]hostname[:port]/[path]

# 临时指定
virsh -c qemu:///system list --all
virsh -c qemu+ssh://root@198.51.100.100/system list --all

# 设置默认 URI（shell 环境变量）
export LIBVIRT_DEFAULT_URI="qemu:///system"
virsh list --all  # 此后不再需要 -c

# 单体架构
sudo systemctl restart libvirtd

# 模块化架构
sudo systemctl restart virtqemud

graph TD
    RUN[VM 运行中] -->|"virsh shutdown / (ACPI 信号, 优雅)"| STOP[正常关机]
    RUN -->|"virsh destroy / (强制断电, 拔插头)"| OFF[立即终止]
    STOP -->|"可能丢失内存数据"| OFF
    OFF -->|"virsh start"| RUN
    STOP -->|"virsh start"| RUN
    RUN -->|"virsh save <file>"| FILE[状态文件 / (保存 RAM)]
    FILE -->|"virsh restore <file>"| RUN

# 批量查看所有 VM 状态
virsh list --all

# 备份 VM 配置
virsh dumpxml win11 > ~/vm-backups/win11-$(date +%F).xml

# 从备份恢复并启动
virsh define ~/vm-backups/win11-2025-01-15.xml
virsh start win11

# 彻底删除一个 VM (包括磁盘)
virsh destroy win11
virsh undefine --remove-all-storage --nvram --snapshots-metadata win11

# 类 top 的实时监视器 (持续刷新)
virt-top --connect qemu:///system

# CPU 统计
virsh domstats --cpu-total <domain>

# 内存统计 (RSS, 缓存, swap-in/out)
virsh dommemstat <domain>

# 磁盘 I/O 统计 (rd_req, wr_req, rd_bytes, wr_bytes)
virsh domblkstat win11 vda

# 网卡 I/O 统计 (rx_bytes, tx_bytes, rx_packets, tx_packets)
virsh domifstat win11 vnet0

# 列出块设备
virsh domblklist <domain> --details

# 列出网络接口
virsh domiflist <domain>

# 宿主机信息
virsh nodeinfo        # CPU 型号、核心数、内存总量
virsh nodememstats    # 宿主机内存使用
virsh nodecpustats    # 宿主机 CPU 使用率（百分比）
virsh nodecpumap      # CPU topology map

# 获取 VM 当前资源消耗全貌
virsh dominfo win11
virsh dommemstat win11
virsh domblklist win11 --details
virsh domiflist win11

# 实时监控 (类似 top)
virt-top --connect qemu:///system

# 脚本化: 获取 VM 当前使用内存
virsh dommemstat win11 | awk '/rss/ {print $2}'

# 查看 vCPU 绑定情况
virsh vcpuinfo win11

# 创建自定义存储池
virsh pool-define-as my-vms dir --target /data/libvirt/images
virsh pool-start my-vms
virsh pool-autostart my-vms

# 创建 VM 磁盘
virsh vol-create-as my-vms archlinux.qcow2 40G --format qcow2

# 查看磁盘文件的实际路径
virsh vol-path archlinux.qcow2 --pool my-vms
# => /data/libvirt/images/archlinux.qcow2

# 扩容 VM 磁盘（注意：仅扩大虚拟磁盘，分区/文件系统需 VM 内操作）
virsh vol-resize archlinux.qcow2 60G --pool my-vms

# 克隆 VM 磁盘
virsh vol-clone archlinux.qcow2 archlinux-clone.qcow2 --pool my-vms

# 备份卷到文件
virsh vol-download archlinux.qcow2 /mnt/backup/archlinux.qcow2 --pool my-vms

# 查看 default 网络的 DHCP 分配情况
virsh net-dhcp-leases default

# 输出示例:
#  Expiry Time           MAC address         Protocol  IP address        Hostname
#  2025-06-20 14:30:00   <GENERATED_MAC_ADDRESS>   ipv4      192.0.2.100   ubuntu-server

<network>
  <name>isolated-net</name>
  <bridge name='virbr1' stp='on' delay='0'/>
  <ip address='203.0.113.1' netmask='255.255.255.0'>
    <dhcp>
      <range start='203.0.113.10' end='203.0.113.200'/>
    </dhcp>
  </ip>
</network>

# 定义并启动自定义网络
virsh net-define isolated-net.xml
virsh net-start isolated-net
virsh net-autostart isolated-net

# 1. 做危险操作前创建快照
virsh snapshot-create-as win11 --name before-driver-update \
    --description "更新显卡驱动前"

# 2. 执行操作...出问题了

# 3. 还原快照
virsh shutdown win11
virsh snapshot-revert win11 --snapshotname before-driver-update

# 4. 确认没问题后清理快照
virsh snapshot-delete win11 --snapshotname before-driver-update

# 获取 VM 的 IP 地址（需安装 qemu-guest-agent）
virsh domifaddr --source agent ubuntu-server

# 向 Windows VM 发送 Ctrl+Alt+Del
virsh send-key win11 KEY_LEFTCTRL KEY_LEFTALT KEY_DELETE

<domain type='kvm'>
  <name>demo-vm</name>                        <!-- VM 名称 -->
  <!-- 首次 define 时省略 UUID，由 libvirt 生成；更新现有 VM 则保留其 UUID。 -->
  <title>My Demo VM</title>                    <!-- 可选：可读标题 -->

  <memory unit='GiB'>8</memory>               <!-- 启动时的最大内存 -->
  <currentMemory unit='GiB'>4</currentMemory> <!-- 当前实际分配的内存 -->
  <vcpu placement='static'>4</vcpu>            <!-- vCPU 数量 -->

  <os>...</os>           <!-- 启动/固件 -->
  <features>...</features>   <!-- 虚拟化特性 -->
  <cpu>...</cpu>          <!-- CPU 模型与拓扑 -->
  <clock>...</clock>      <!-- 时钟配置 -->
  <on_poweroff>...</on_poweroff>  <!-- 关机行为 -->
  <on_reboot>...</on_reboot>      <!-- 重启行为 -->
  <on_crash>...</on_crash>        <!-- 崩溃行为 -->
  <devices>...</devices>  <!-- 所有虚拟设备 -->
</domain>

<!-- 方案 1: host-passthrough —— 尽量暴露宿主CPU特性；性能与迁移须实测 -->
<!-- 适合：同型号 CPU 集群，不需迁移 -->
<cpu mode='host-passthrough' check='none'>
  <topology sockets='1' dies='1' cores='4' threads='2'/>
</cpu>

<!-- 方案 2: host-model —— 兼容性好，可近迁移 -->
<!-- 适合：同架构但不同型号 CPU 间迁移 -->
<cpu mode='host-model' check='partial'>
  <topology sockets='1' dies='1' cores='4' threads='2'/>
</cpu>

<!-- 方案 3: 指定 CPU 模型 —— 最大兼容性，支持跨集群迁移 -->
<!-- 适合：异构集群统一运行时 -->
<cpu mode='custom' match='exact' check='full'>
  <model fallback='forbid'>EPYC-Milan</model>
  <topology sockets='1' cores='4' threads='2'/>
</cpu>

<!-- virtio 磁盘 (推荐，性能最佳) -->
<disk type='file' device='disk'>
  <driver name='qemu' type='qcow2' cache='writeback' discard='unmap'/>
  <source file='/var/lib/libvirt/images/vm-disk.qcow2'/>
  <target dev='vda' bus='virtio'/>
  <address type='pci' domain='0x0000' bus='0x04' slot='0x00' function='0x0'/>
</disk>

<!-- 原始块设备 (LVM / ZFS zvol) -->
<disk type='block' device='disk'>
  <driver name='qemu' type='raw' cache='none' io='native'/>
  <source dev='/dev/vg0/vm-disk'/>
  <target dev='vdb' bus='virtio'/>
</disk>

<!-- CD-ROM (ISO) -->
<disk type='file' device='cdrom'>
  <driver name='qemu' type='raw'/>
  <source file='/var/lib/libvirt/images/ubuntu-24.04.iso'/>
  <target dev='sdc' bus='sata'/>
  <readonly/>
</disk>

<!-- 方式 1: NAT 虚拟网络 (最常用) -->
<interface type='network'>
  <source network='default'/>
  <model type='virtio'/>
  <!-- 未指定 MAC，由 libvirt 生成；迁移现有 VM 应保留其地址。 -->
</interface>

<!-- 方式 2: Bridge 桥接 (VM 与宿主机同级) -->
<interface type='bridge'>
  <source bridge='br0'/>
  <model type='virtio'/>
</interface>

<!-- 方式 3: Macvtap (直通物理网卡，不需宿主机 bridge) -->
<interface type='direct'>
  <source dev='enp3s0' mode='bridge'/>
  <model type='virtio'/>
</interface>

<!-- SPICE (推荐, 更丰富的显示功能) -->
<graphics type='spice' autoport='yes' listen='127.0.0.1'>
  <listen type='address' address='127.0.0.1'/>
  <image compression='auto_glz'/>
  <gl enable='no'/>
</graphics>
<video>
  <model type='virtio' heads='1' primary='yes'>
    <acceleration accel3d='no'/>
  </model>
</video>

<!-- VNC (更简单, 但功能少) -->
<graphics type='vnc' port='-1' autoport='yes' listen='127.0.0.1'>
  <listen type='address' address='127.0.0.1'/>
</graphics>
<video>
  <model type='qxl' ram='65536' vram='65536' vgamem='16384' heads='1'/>
</video>

<os firmware='efi'>
  <type arch='x86_64' machine='q35'>hvm</type>
  <loader readonly='yes' type='pflash'>/usr/share/edk2/x64/OVMF_CODE.fd</loader>
  <nvram template='/usr/share/edk2/x64/OVMF_VARS.fd'>
    /var/lib/libvirt/qemu/nvram/win11_VARS.fd
  </nvram>
  <boot dev='hd'/>
</os>

<features>
  <acpi/>
  <apic/>
  <hyperv mode='custom'>
    <!-- 启用 Hyper-V enlightenments 加速 Windows -->
  </hyperv>
</features>

<!-- TPM 2.0 (Windows 11 要求) -->
<tpm model='tpm-crb'>
  <backend type='emulator' version='2.0'/>
</tpm>

#!/usr/bin/env bash
set -euo pipefail
DOMAIN="${1:?provide domain name}"
BACKUP_DIR="/path/to/backup/vms/${DOMAIN}/$(date +%F-%H%M%S)"
URI="qemu:///system"
state=$(LC_ALL=C virsh -c "$URI" domstate "$DOMAIN")
[[ "$state" == "shut off" ]] || { echo "Guest must be shut off" >&2; exit 1; }
mkdir -p "$BACKUP_DIR"
virsh -c "$URI" dumpxml --inactive "$DOMAIN" > "$BACKUP_DIR/domain.xml"
virsh -c "$URI" domblklist --inactive "$DOMAIN" --details

# 根据 XML 和 domblklist 人工核对所有 disk 源；示例只列一块文件磁盘。
# 路径、格式、空间、权限必须确认；多盘 VM 对每块盘重复并生成恢复清单。
qemu-img info --backing-chain /path/to/vm/disk.qcow2
qemu-img convert -f qcow2 -O qcow2 /path/to/vm/disk.qcow2 "$BACKUP_DIR/disk.qcow2"
qemu-img check "$BACKUP_DIR/disk.qcow2"
echo "Backup saved to: $BACKUP_DIR"

#!/bin/bash
# show-vm-ips.sh — 显示所有运行中 VM 的 IP（需 guest agent）

for vm in $(virsh list --name); do
  ip=$(virsh domifaddr --source agent "$vm" 2>/dev/null \
    | awk 'NR>2 {print $4}' | cut -d'/' -f1 | head -1)
  printf "%-20s %s\n" "$vm" "${ip:-No agent}"
done

# virt-install 一行创建 VM
virt-install --connect qemu:///system \
  --name ubuntu-server \
  --ram 4096 \
  --vcpus 4 \
  --disk path=/var/lib/libvirt/images/ubuntu-server.qcow2,size=40,format=qcow2 \
  --os-variant ubuntu24.04 \
  --network network=default \
  --graphics spice \
  --console pty,target_type=serial \
  --cdrom /var/lib/libvirt/images/ubuntu-24.04-live-server-amd64.iso \
  --boot uefi \
  --autostart \
  --noautoconsole

# 克隆 VM
virt-clone \
  --original ubuntu-server \
  --name ubuntu-test \
  --file /var/lib/libvirt/images/ubuntu-test.qcow2