"🖥️ virsh — Libvirt Shell"

If you like this project, consider supporting me on Buy Me a Coffee ☕️

tags:

• virtualization
• sysadmin

• linux

  🖥️ virsh — Libvirt Shell Cheatsheet

Description

virsh is the command-line management tool for libvirt, the standard virtualization API for Linux. It provides a consistent interface to manage KVM/QEMU, Xen, LXC, and other hypervisors. With virsh you can create, configure, monitor, and control virtual machines, storage pools, virtual networks, snapshots, and more — all from the terminal.

Alternatives / Альтернативы:

• virt-manager — GUI frontend for libvirt / Графический интерфейс для libvirt
• Cockpit — Web-based server management with VM plugin / Веб-интерфейс управления серверами
• Proxmox VE — Full-featured web UI on KVM/QEMU + libvirt / Полнофункциональный веб-интерфейс
• oVirt — Enterprise virtualization management / Корпоративное управление виртуализацией

Common use cases / Типичные сценарии:

• Automated VM provisioning and lifecycle management / Автоматизация развёртывания и управления ВМ
• Remote hypervisor administration over SSH / Удалённое управление гипервизором через SSH
• Snapshot-based rollback and backup / Откат и бэкап на основе снимков
• Live and offline migration between hosts / Живая и оффлайн-миграция между хостами
• Storage pool and volume management / Управление пулами хранилищ и томами
• Virtual network and bridge configuration / Настройка виртуальных сетей и мостов

[!NOTE] virsh is actively maintained as part of the libvirt project. It is the recommended CLI for scripted and manual VM management on KVM/QEMU hosts. For GUI-based alternatives, see virt-manager (local), Cockpit (web), Proxmox VE, or oVirt. virsh активно поддерживается как часть проекта libvirt. Рекомендуется для CLI-управления ВМ на KVM/QEMU хостах. Для GUI-альтернатив см. virt-manager (локально), Cockpit (веб), Proxmox VE, oVirt.

Installation & Configuration

Install virsh / Установка virsh

Debian / Ubuntu

sudo apt install -y libvirt-clients  # Install virsh client / Установить клиент virsh
sudo apt install -y libvirt-daemon-system  # Install libvirt daemon / Установить демон libvirt
sudo apt install -y qemu-kvm bridge-utils virtinst  # Full stack / Полный стек

RHEL / CentOS / AlmaLinux

sudo dnf install -y libvirt  # Install libvirt package / Установить пакет libvirt
sudo dnf install -y qemu-kvm  # Install QEMU/KVM / Установить QEMU/KVM

Enable Libvirt Daemon

sudo systemctl enable --now libvirtd   # Enable and start / Включить и запустить
sudo systemctl status libvirtd         # Check status / Проверить статус

Verify Installation

virsh version                          # Show virsh and libvirt version / Версия virsh и libvirt
virsh capabilities                     # Hypervisor capabilities / Возможности гипервизора
sudo virt-host-validate                # Validate host configuration / Валидация конфигурации хоста

Sample Output:

virsh version
Compiled against library: libvirt 9.0.0
Using library: libvirt 9.0.0
Using API: QEMU 9.0.0
Running hypervisor: QEMU 8.2.0

Add User to libvirt Group

sudo usermod -aG libvirt <USER>        # Add user to libvirt group / Добавить в группу libvirt
sudo usermod -aG kvm <USER>            # Add to kvm group / Добавить в группу kvm
newgrp libvirt                          # Apply without logout / Применить без перелогина

Configuration Paths

• Libvirt daemon: /etc/libvirt/libvirtd.conf
• QEMU config: /etc/libvirt/qemu.conf
• VM definitions: /etc/libvirt/qemu/<VM_NAME>.xml
• Default storage pool: /var/lib/libvirt/images/
• Default network: /etc/libvirt/qemu/networks/default.xml

Remote Connection Modes / Режимы удалённого подключения

Unix Socket (Local / Локально)

virsh connect qemu:///system            # Local system connection / Локальное подключение к системе

SSH (Recommended / Рекомендуемый)

virsh connect qemu+ssh://root@<HOST>/system  # SSH connection / Подключение через SSH

[!TIP] SSH is the most secure remote connection method. It uses existing SSH key authentication and encrypts all traffic. No additional ports need to be opened. SSH — самый безопасный метод удалённого подключения. Использует аутентификацию по SSH-ключам и шифрует весь трафик. Дополнительные порты открывать не нужно.

TLS (Encrypted / Шифрование)

virsh connect qemu+tls://<HOST>/system  # TLS connection / Подключение через TLS

[!WARNING] TLS requires proper PKI certificates on both client and server. Incorrect certificate setup can lead to connection failures or security vulnerabilities. TLS требует корректных PKI-сертификатов на клиенте и сервере. Неправильная настройка сертификатов может привести к сбоям подключения или уязвимостям.

TCP (Unencrypted / Без шифрования)

virsh connect qemu+tcp://<HOST>/system  # TCP connection / Подключение через TCP

[!CAUTION] TCP connections are unencrypted. Never use TCP over untrusted networks. It requires explicit enabling in /etc/libvirt/libvirtd.conf (listen_tcp = 1) and is disabled by default for security. TCP-подключения не шифруются. Никогда не используйте TCP в ненадёжных сетях. Требует явного включения в /etc/libvirt/libvirtd.conf (listen_tcp = 1) и отключён по умолчанию в целях безопасности.

Default Ports

Log Locations

• Libvirt daemon: /var/log/libvirt/libvirtd.log
• Per-VM QEMU logs: /var/log/libvirt/qemu/<VM_NAME>.log
• Journal: journalctl -u libvirtd

Core Management (VM Lifecycle)

List VMs / Список ВМ

virsh list                             # List running VMs / Список запущенных ВМ
virsh list --all                       # List all VMs / Список всех ВМ
virsh list --inactive                  # List stopped VMs / Список остановленных ВМ
virsh list --autostart                 # List autostart VMs / Список ВМ с автозапуском
virsh list --state-running             # Filter by running state / Фильтр по состоянию running
virsh list --state-shutoff             # Filter by stopped state / Фильтр по состоянию shutoff

Sample Output:

 Id   Name            State
--------------------------------
 1    ubuntu2204      running
 2    centos9         running
 3    win11           shutoff

Start VM / Запуск ВМ

virsh start <VM_NAME>                  # Start VM / Запустить ВМ
virsh start <VM_NAME> --paused         # Start in paused state / Запустить в приостановленном состоянии
virsh start <VM_NAME> --autoboot       # Start if set autostart / Запустить если включён автозапуск

Shutdown VM / Выключение ВМ

virsh shutdown <VM_NAME>               # Graceful ACPI shutdown / Мягкое выключение через ACPI
virsh shutdown <VM_NAME> --mode acpi   # ACPI shutdown (default) / Выключение через ACPI (по умолчанию)
virsh shutdown <VM_NAME> --mode agent  # Guest agent shutdown / Выключение через гостевой агент

[!TIP] virsh shutdown sends an ACPI signal or uses the guest agent. The VM may take time to shut down. If it doesn't shut down within a timeout, use virsh destroy as a last resort. virsh shutdown отправляет ACPI-сигнал или использует гостевой агент. ВМ может занять время на выключение. Если не выключается — используйте virsh destroy как крайнюю меру.

Reboot VM / Перезагрузка ВМ

virsh reboot <VM_NAME>                 # Graceful reboot / Мягкая перезагрузка

Pause / Resume / Приостановка / Возобновление

virsh suspend <VM_NAME>                # Pause VM (freeze processes) / Приостановить ВМ (заморозить процессы)
virsh resume <VM_NAME>                 # Resume paused VM / Возобновить приостановленную ВМ

Force Stop / Принудительное выключение

virsh destroy <VM_NAME>                # Force kill VM (DANGER) / Принудительное завершение ВМ (ОПАСНО)

[!CAUTION] virsh destroy is equivalent to pulling the power cord on a physical machine. It does not shut down the guest OS cleanly. Use only when virsh shutdown fails. Data loss is possible. virsh destroy эквивалентен выдергиванию кабеля питания из физической машины. Не выполняет корректное завершение работы гостевой ОС. Используйте только когда virsh shutdown не работает. Возможна потеря данных.

Delete VM / Удаление ВМ

virsh destroy <VM_NAME>                # Force stop first / Сначала принудительно остановить
virsh undefine <VM_NAME>               # Remove VM definition / Удалить определение ВМ
virsh undefine <VM_NAME> --remove-all-storage  # Delete VM + all disks / Удалить ВМ и все диски
virsh undefine <VM_NAME> --nvram       # For UEFI VMs / Для UEFI ВМ (удалить NVRAM)
virsh undefine <VM_NAME> --storage vda  # Delete specific disk / Удалить конкретный диск

[!WARNING] --remove-all-storage permanently deletes all attached disk images. This is irreversible. Always verify your VM name and backup important data before running this command. --remove-all-storage безвозвратно удаляет все подключённые образы дисков. Это необратимо. Всегда проверяйте имя ВМ и делайте бэкап важных данных перед выполнением.

Autostart / Автозапуск

virsh autostart <VM_NAME>              # Enable autostart / Включить автозапуск
virsh autostart --disable <VM_NAME>    # Disable autostart / Отключить автозапуск

Define / Redefine / Определение / Переопределение

virsh define <VM_NAME>.xml             # Define VM from XML / Определить ВМ из XML
virsh define /dev/stdin < <MODIFIED_XML>  # Define from stdin / Определить из stdin

VM Information & Inspection

VM Details / Детали ВМ

virsh dominfo <VM_NAME>                # VM information / Информация о ВМ
virsh domid <VM_NAME>                  # Get VM numeric ID / Получить числовой ID ВМ
virsh domname <ID>                     # Get VM name from ID / Получить имя ВМ по ID
virsh domstate <VM_NAME>               # VM power state / Состояние питания ВМ
virsh domuuid <VM_NAME>                # Get VM UUID / Получить UUID ВМ

Sample Output of virsh dominfo:

Id:             1
Name:           ubuntu2204
UUID:           a1b2c3d4-e5f6-7890-abcd-ef1234567890
OS Type:        hvm
State:          running
CPU(s):         4
CPU time:       123.45s
Max memory:     8388608 KiB
Used memory:    4194304 KiB
Persistent:     yes
Autostart:      disable
Managed save:   no
Security model: selinux
Security DOI:   0

Block Devices / Блочные устройства

virsh domblklist <VM_NAME>             # List block devices / Список блочных устройств
virsh domblkinfo <VM_NAME> <DISK>      # Disk details / Детали диска
virsh domblkstat <VM_NAME> <DISK>      # Disk I/O stats / Статистика ввода-вывода диска

Sample Output of virsh domblklist:

 Target   Source
------------------------------------------------
 vda      /var/lib/libvirt/images/ubuntu2204.qcow2
 hdc      -

Network Interfaces / Сетевые интерфейсы

virsh domiflist <VM_NAME>              # List network interfaces / Список сетевых интерфейсов
virsh domifstat <VM_NAME> <INTERFACE>  # Interface stats / Статистика интерфейса
virsh domifaddr <VM_NAME>              # Guest IP addresses (requires agent) / IP-адреса гостя (нужен агент)

Sample Output of virsh domiflist:

 Interface   Type     Source       Model       MAC
-------------------------------------------------------
 vnet0       bridge   br0          virtio      52:54:00:ab:cd:ef

CPU & Memory / Процессор и память

virsh vcpuinfo <VM_NAME>               # vCPU mapping to physical CPUs / Маппинг vCPU на физические CPU
virsh vcpucount <VM_NAME>              # vCPU counts / Количество vCPU
virsh dommemstat <VM_NAME>             # Memory statistics / Статистика памяти

Full XML Dump / Полный XML дамп

virsh dumpxml <VM_NAME>                # Full XML definition / Полное XML-определение
virsh dumpxml <VM_NAME> > <VM_NAME>.xml  # Save to file / Сохранить в файл
virsh dumpxml <VM_NAME> --inactive     # Inactive config (persistent) / Неактивная конфигурация
virsh dumpxml <VM_NAME> --update-cap   # Update to current capabilities / Обновить до текущих возможностей

Console Access & Interaction

Serial Console / Серийная консоль

virsh console <VM_NAME>                # Connect to serial console / Подключиться к серийной консоли

[!TIP] To exit the serial console, press Ctrl+ ]. The guest must have a serial console configured (e.g., console=ttyS0 in kernel boot parameters). Для выхода из серийной консоли нажмите Ctrl+ ]. В госте должна быть настроена серийная консоль (например, console=ttyS0 в параметрах загрузки ядра).

Graphical Console / Графическая консоль

virt-viewer <VM_NAME>                  # GUI console viewer / Графический просмотр консоли
virt-viewer <VM_NAME> --connect qemu+ssh://root@<HOST>/system  # Remote console / Удалённая консоль

SPICE Console / SPICE консоль

remote-viewer spice://<HOST>:5900      # Connect via SPICE / Подключиться через SPICE

VNC Console / VNC консоль

remote-viewer vnc://<HOST>:5900        # Connect via VNC / Подключиться через VNC

Send Keys / Отправка клавиш

virsh send-key <VM_NAME> KEY_ENTER     # Send Enter key / Отправить клавишу Enter
virsh send-key <VM_NAME> KEY_LEFTCTRL KEY_LEFTALT KEY_DELETE  # Ctrl+Alt+Del / Отправить Ctrl+Alt+Del

Guest Agent Commands / Команды гостевого агента

virsh qemu-agent-command <VM_NAME> '{"execute":"guest-info"}'          # Get guest info / Информация о госте
virsh qemu-agent-command <VM_NAME> '{"execute":"guest-sync","arguments":{"id":12345}}'  # Sync / Синхронизация
virsh qemu-agent-command <VM_NAME> '{"execute":"guest-shutdown","arguments":{"mode":"powerdown"}}'  # Shutdown / Выключение
virsh qemu-agent-command <VM_NAME> '{"execute":"guest-exec","arguments":{"path":"/bin/true"}}'  # Run command / Запустить команду
virsh qemu-agent-command <VM_NAME> '{"execute":"guest-ping"}'          # Ping agent / Пинг агента
virsh qemu-agent-command <VM_NAME> '{"execute":"guest-info"}' | python3 -m json.tool  # Pretty print / Красивый вывод

[!NOTE] Guest agent commands require qemu-guest-agent installed and running inside the VM. These commands execute within the guest OS. Команды гостевого агента требуют установленного и запущенного qemu-guest-agent внутри ВМ. Эти команды выполняются внутри гостевой ОС.

QEMU Monitor (HMP/QMP) / Монитор QEMU

virsh qemu-monitor-command <VM_NAME> --hmp "info status"       # HMP status / Статус через HMP
virsh qemu-monitor-command <VM_NAME> --hmp "info block"        # Block devices / Блочные устройства
virsh qemu-monitor-command <VM_NAME> --hmp "info cpus"         # CPU info / Информация о CPU
virsh qemu-monitor-command <VM_NAME> --hmp "info registers"    # CPU registers / Регистры CPU
virsh qemu-monitor-command <VM_NAME> --hmp "screendump <FILE>.ppm"  # Screenshot / Снимок экрана
virsh qemu-monitor-command <VM_NAME> --hmp "migrate <URI>"     # Migrate via HMP / Миграция через HMP
virsh qemu-monitor-command <VM_NAME> --qmp '{"execute":"query-status"}'  # QMP query / Запрос через QMP
virsh qemu-monitor-command <VM_NAME> --qmp '{"execute":"query-blockstats"}'  # Block stats / Статистика блоков
virsh qemu-monitor-command <VM_NAME> --qmp '{"execute":"human-monitor-command","arguments":{"command-line":"info status"}}'  # QMP→HMP bridge / Мост QMP→HMP

[!WARNING] qemu-monitor-command bypasses libvirt's abstraction layer. Use it only when virsh commands cannot accomplish the task. Improper use can corrupt VM state. qemu-monitor-command обходит слой абстракции libvirt. Используйте только когда команды virsh не помогают. Неправильное использование может повредить состояние ВМ.

Resource Management

CPU / Процессор

virsh setvcpus <VM_NAME> 4 --config    # Set vCPUs (next boot) / Установить vCPU (при следующей загрузке)
virsh setvcpus <VM_NAME> 4 --live      # Hot-add/remove vCPU / Добавить/удалить vCPU на лету
virsh setvcpus <VM_NAME> 2 --maximum --config  # Set max vCPUs / Установить макс. vCPU

Memory / Память

virsh setmaxmem <VM_NAME> 8G --config  # Set max RAM (next boot) / Установить макс. RAM (при следующей загрузке)
virsh setmem <VM_NAME> 4G --live       # Hot-change RAM / Изменить RAM на лету
virsh setmem <VM_NAME> 4G --config     # Set RAM (next boot) / Установить RAM (при следующей загрузке)
virsh dommemstat <VM_NAME>             # Show memory statistics / Показать статистику памяти

[!CAUTION] You cannot set memory larger than max memory. Always call setmaxmem before setmem if you need to increase beyond the current maximum. Нельзя установить память больше максимальной. Всегда вызывайте setmaxmem перед setmem, если нужно увеличить сверх текущего максимума.

Device Hotplug / Подключение устройств на лету

virsh attach-device <VM_NAME> <DEVICE>.xml --live  # Attach device (live) / Подключить устройство (на лету)
virsh detach-device <VM_NAME> <DEVICE>.xml --live  # Detach device (live) / Отключить устройство (на лету)
virsh attach-disk <VM_NAME> /path/to/disk.qcow2 vdb --subdriver qcow2 --live  # Attach disk / Подключить диск
virsh detach-disk <VM_NAME> vdb --live              # Detach disk / Отключить диск
virsh attach-interface <VM_NAME> bridge br1 --model virtio --live  # Attach NIC / Подключить сетевую карту
virsh detach-interface <VM_NAME> bridge --live      # Detach NIC / Отключить сетевую карту

CPU Pinning & NUMA / Привязка CPU и NUMA

virsh vcpupin <VM_NAME> 0 0 --live      # Pin vCPU 0 to pCPU 0 / Привязать vCPU 0 к pCPU 0
virsh vcpupin <VM_NAME> --current       # Show current pinning / Показать текущую привязку
virsh vcpupin <VM_NAME> 0-3 0-3 --live  # Pin vCPU range / Привязать диапазон vCPU
virsh numatune <VM_NAME> --memnodes 0-1 --memorymode preferred --live  # NUMA memory policy / NUMA-политика памяти
virsh numatune <VM_NAME> --memorymode strict --memorynode 0 --live     # Strict NUMA / Строгий NUMA
virsh dominfo <VM_NAME> | grep numa     # Show NUMA topology / Показать топологию NUMA

[!TIP] CPU pinning improves latency consistency for latency-sensitive workloads (databases, trading). Pair with NUMA-aware memory policy to avoid cross-node access penalties. Привязка CPU улучшает согласованность задержек для нагрузок, чувствительных к latency (базы данных, трейдинг). Сочетайте с NUMA-политикой памяти для избежания штрафов кросс-узлового доступа.

I/O Threads / Потоки ввода-вывода

virsh qemu-monitor-command <VM_NAME> --hmp "info block" 2>/dev/null | grep iothread  # Check iothreads / Проверить iothreads

I/O Thread XML configuration (via virsh edit <VM_NAME>):

<!-- Add iothreadids / Добавить iothreadids -->
<iothreadids>
  <iothread id='1'/>
  <iothread id='2'/>
</iothreadids>

<!-- Assign iothread to disk / Назначить iothread диску -->
<disk type='file' device='disk'>
  <driver name='qemu' type='qcow2' iothread='1'/>
  <source file='/var/lib/libvirt/images/<VM_NAME>.qcow2'/>
  <target dev='vda' bus='virtio'/>
</disk>

[!NOTE] I/O threads are configured via XML (not a direct virsh command). Use virsh edit <VM_NAME> to add iothreadids and assign iothread attributes to disk controllers or individual disks. I/O threads настраиваются через XML (не прямой командой virsh). Используйте virsh edit <VM_NAME> для добавления iothreadids и назначения атрибутов iothread дискам или контроллерам.

Storage Management

Storage Pools / Пулы хранилищ

virsh pool-list --all                  # List all storage pools / Список всех пулов хранилищ
virsh pool-list --all --details        # Detailed pool list / Детальный список пулов
virsh pool-info <POOL>                 # Pool information / Информация о пуле
virsh pool-define-as <POOL> dir --target /data/images/  # Define directory pool / Определить пул каталога
virsh pool-build <POOL>                # Build pool structure / Создать структуру пула
virsh pool-start <POOL>                # Start pool / Запустить пул
virsh pool-destroy <POOL>              # Stop and delete pool / Остановить и удалить пул
virsh pool-undefine <POOL>             # Remove pool definition / Удалить определение пула
virsh pool-autostart <POOL>            # Enable autostart / Включить автозапуск
virsh pool-autostart --disable <POOL>  # Disable autostart / Отключить автозапуск

Create NFS Pool / Создание NFS пула

virsh pool-define-as nfs-pool netfs --source-host <NFS_SERVER> --source-path /export/images --target /var/lib/libvirt/images/  # Define NFS pool / Определить NFS пул
virsh pool-build nfs-pool              # Build pool / Создать пул
virsh pool-start nfs-pool              # Start pool / Запустить пул
virsh pool-autostart nfs-pool          # Autostart / Автозапуск

Volumes / Тома

virsh vol-list <POOL>                  # List volumes in pool / Список томов в пуле
virsh vol-info <VOL> --pool <POOL>     # Volume details / Детали тома
virsh vol-create-as <POOL> <VOL> 20G  # Create 20G volume / Создать том 20G
virsh vol-create-as <POOL> <VOL> 20G --format qcow2  # Create qcow2 volume / Создать qcow2 том
virsh vol-delete <VOL> --pool <POOL>  # Delete volume / Удалить том
virsh vol-resize <VOL> 30G --pool <POOL>  # Resize volume / Изменить размер тома

Disk Image Operations / Операции с образами дисков

qemu-img create -f qcow2 <DISK>.qcow2 20G   # Create 20G disk / Создать диск 20G
qemu-img info <DISK>.qcow2                   # Show image info / Информация об образе
qemu-img resize <DISK>.qcow2 +10G            # Grow disk / Увеличить диск на 10G
qemu-img convert -f raw -O qcow2 <SRC>.raw <DST>.qcow2  # Convert format / Конвертировать формат
qemu-img snapshot -l <DISK>.qcow2            # List internal snapshots / Список внутренних снимков
qemu-img snapshot -c <SNAP_NAME> <DISK>.qcow2  # Create internal snapshot / Создать внутренний снимок

[!WARNING] Shrinking a qcow2 image is dangerous and can corrupt data. Always grow, never shrink without a full backup. Уменьшение образа qcow2 опасно и может повредить данные. Всегда увеличивайте, никогда не уменьшайте без полного бэкапа.

Block Device Operations / Операции с блочными устройствами

virsh domblkinfo <VM_NAME> <DISK>       # Block device info / Информация о блочном устройстве
virsh domblkstat <VM_NAME> <DISK>       # Block I/O statistics / Статистика ввода-вывода
virsh domblklist <VM_NAME> --details    # List all disks with details / Список всех дисков с деталями

# Block commit — merge overlay into backing file / Блочное слияние — слить overlay в backing-файл
virsh blockcommit <VM_NAME> <DISK> --base <BASE>.qcow2 --top <TOP>.qcow2 --active --wait
virsh blockcommit <VM_NAME> <DISK> --base <BASE>.qcow2 --top <TOP>.qcow2 --wait  # Commit & pivot / Слить и переключить

# Block copy — copy disk to new file (live) / Блочное копирование — скопировать диск в новый файл (на лету)
virsh blockcopy <VM_NAME> <DISK> <NEW_PATH>.qcow2 --wait --pivot  # Copy & pivot / Копировать и переключить
virsh blockcopy <VM_NAME> <DISK> <NEW_PATH>.qcow2 --wait          # Copy without pivot / Копировать без переключения

# Block resize — grow disk online / Изменение размера блока — увеличить диск онлайн
virsh blockresize <VM_NAME> <DISK> 30G --live

Sample virsh domblkinfo output:

Capacity:       21474836480
Physical:       21474836480
Allocation:     1073741824
Virtual size:   21474836480

[!TIP] blockcommit --active keeps the VM running during the merge (dirty block tracking). Use --pivot to switch to the new top image after copy completes. Always snapshot before block operations. blockcommit --active поддерживает работу ВМ во время слияния (отслеживание изменённых блоков). Используйте --pivot для переключения на новый верхний образ после завершения копирования. Всегда создавайте снимок перед блочными операциями.

Networking

Virtual Networks / Виртуальные сети

virsh net-list --all                   # List all networks / Список всех сетей
virsh net-list --all --details         # Detailed network list / Детальный список сетей
virsh net-info <NETWORK>               # Network details / Детали сети
virsh net-dumpxml <NETWORK>            # Network XML / XML сети
virsh net-start <NETWORK>              # Start network / Запустить сеть
virsh net-destroy <NETWORK>            # Stop network / Остановить сеть
virsh net-autostart <NETWORK>          # Enable autostart / Включить автозапуск
virsh net-autostart --disable <NETWORK>  # Disable autostart / Отключить автозапуск
virsh net-dhcp-leases <NETWORK>        # Active DHCP leases / Активные DHCP аренды

Create Virtual Network / Создание виртуальной сети

virsh net-define-as isolated-net isolated --bridge virbr1  # Define isolated network / Определить изолированную сеть
virsh net-start isolated-net           # Start network / Запустить сеть
virsh net-autostart isolated-net       # Autostart / Автозапуск

Attach/Detach NIC / Подключение/отключение сетевой карты

virsh attach-interface <VM_NAME> network default --model virtio --live  # Attach NIC to network / Подключить НИС к сети
virsh detach-interface <VM_NAME> network --live  # Detach NIC / Отключить НИС

Bridge Networking / Сетевой мост

/etc/netplan/01-netcfg.yaml (Ubuntu/Netplan)

network:
  version: 2
  renderer: networkd
  ethernets:
    enp0s3:
      dhcp4: false
  bridges:
    br0:
      interfaces: [enp0s3]
      dhcp4: true

sudo netplan apply  # Apply bridge config / Применить конфигурацию моста

[!TIP] Bridge networking gives VMs direct access to the physical LAN, making them appear as separate hosts. NAT (default) is simpler but isolates VMs behind the host. Сетевой мост даёт ВМ прямой доступ к физической LAN, делая их видимыми как отдельные хосты. NAT (по умолчанию) проще, но изолирует ВМ за хостом.

Snapshots & Checkpoints

Snapshot Operations / Операции со снимками

virsh snapshot-list <VM_NAME>          # List all snapshots / Список всех снимков
virsh snapshot-list <VM_NAME> --tree   # Tree view of snapshots / Древовидный вид снимков
virsh snapshot-info <VM_NAME> <SNAP>   # Snapshot details / Детали снимка
virsh snapshot-create <VM_NAME> <SNAP>.xml  # Create from XML / Создать из XML
virsh snapshot-create-as <VM_NAME> <SNAP_NAME> "Description"  # Create named snapshot / Создать именованный снимок
virsh snapshot-revert <VM_NAME> <SNAP> # Revert to snapshot / Откат к снимку
virsh snapshot-delete <VM_NAME> <SNAP> # Delete snapshot / Удалить снимку
virsh snapshot-current <VM_NAME>       # Show current snapshot / Показать текущий снимок
virsh snapshot-num <VM_NAME>           # Count snapshots / Подсчёт снимков

Sample Output of virsh snapshot-list:

 Name              Creation Time             State
--------------------------------------------------------------
 pre-update        2024-01-15 10:30:00 +0000 running
 post-update       2024-02-20 14:15:00 +0000 shutoff

Snapshot XML Example / Пример XML снимка

<domainsnapshot>
  <name>pre-update</name>
  <description>Snapshot before system update</description>
  <memory snapshot="internal"/>  <!-- Include RAM / Включить RAM -->
  <disks>
    <disk name='vda' snapshot='internal'/>
  </disks>
</domainsnapshot>

Checkpoint Operations / Операции с контрольными точками

virsh checkpoint-list <VM_NAME>         # List all checkpoints / Список всех контрольных точек
virsh checkpoint-list <VM_NAME> --tree  # Tree view / Древовидный вид
virsh checkpoint-info <VM_NAME> <CKPT>  # Checkpoint details / Детали контрольной точки
virsh checkpoint-create-as <VM_NAME> <CKPT_NAME> "Description"  # Create named checkpoint / Создать именованную точку
virsh checkpoint-create-as <VM_NAME> <CKPT_NAME> "Desc" --reuse / --no-shutdown  # Advanced options / Расширенные опции
virsh checkpoint-revert <VM_NAME> <CKPT> # Revert to checkpoint / Откат к контрольной точке
virsh checkpoint-delete <VM_NAME> <CKPT> # Delete checkpoint / Удалить контрольную точку
virsh checkpoint-current <VM_NAME>      # Show current checkpoint / Показать текущую точку
virsh checkpoint-dumpxml <VM_NAME> <CKPT>  # Checkpoint XML / XML контрольной точки
virsh domcheckpoint-set <VM_NAME> <CKPT_NAME>  # Set checkpoint name / Установить имя контрольной точки
virsh domcheckpoint-get <VM_NAME>       # Get checkpoint metadata / Получить метаданные контрольной точки

Sample virsh checkpoint-list output:

 Name             Creation Time             State
------------------------------------------------------------------
 pre-update       2024-01-15 10:30:00 +0000 running
 post-update      2024-02-20 14:15:00 +0000 shutoff

[!NOTE] Checkpoints are similar to snapshots but also capture guest memory state. They require the QEMU guest agent for full memory capture. Use --no-shutdown for faster (but less consistent) checkpoints. Контрольные точки похожи на снимки, но также сохраняют состояние памяти гостя. Требуют QEMU guest agent для полного захвата памяти. Используйте --no-shutdown для более быстрых (но менее согласованных) контрольных точек.

Migration

Live Migration (Running VM) / Живая миграция (запущенная ВМ)

virsh migrate <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Live migrate / Живая миграция
virsh migrate --live <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Explicit live / Явно live
virsh migrate --persistent <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Make persistent on dest / Сделать постоянной на цели
virsh migrate --suspend <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Suspend after migration / Приостановить после миграции
virsh migrate --abort-on-error <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Abort on error / Прервать при ошибке
virsh migrate --unsafe <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Allow unsafe options / Разрешить небезопасные опции

[!TIP] Live migration moves a running VM to another host with minimal downtime. The VM continues to run during migration. Requires shared or identical storage, and compatible CPU features on both hosts. Живая миграция переносит запущенную ВМ на другой хост с минимальным простоем. ВМ продолжает работать во время миграции. Требует общего или идентичного хранилища и совместимых возможностей CPU на обоих хостах.

Offline Migration (Stopped VM) / Оффлайн миграция (остановленная ВМ)

virsh migrate <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Offline migrate (VM must be off) / Оффлайн миграция (ВМ должна быть выключена)
virsh migrate --offline <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Explicit offline / Явно offline
virsh migrate --offline --persistent <VM_NAME> qemu+ssh://<DEST_HOST>/system  # Persistent on dest / Постоянная на цели

[!NOTE] Offline migration moves the VM definition and disk images. No downtime is needed since the VM is already off. Ensure sufficient disk space on the destination. Оффлайн миграция переносит определение ВМ и образы дисков. Простой не требуется, так как ВМ уже выключена. Убедитесь в достаточном месте на диске на целевом хосте.

Migration Options / Опции миграции

Check Migration Progress / Проверка прогресса миграции

virsh domjobinfo <VM_NAME>             # Migration job info / Информация о задаче миграции
virsh domjobabort <VM_NAME>            # Abort migration / Прервать миграцию

Templates & Cloning

Create VM Template from Running VM / Создание шаблона ВМ из запущенной ВМ

virsh shutdown <VM_NAME>               # Graceful shutdown / Мягкое выключение
virsh dumpxml <VM_NAME> > template.xml # Export XML definition / Экспорт XML-определения
# Edit template.xml: remove UUID, MAC, name / Редактировать template.xml: удалить UUID, MAC, имя
virsh define template.xml              # Define template VM / Определить шаблонную ВМ
virsh autostart --disable template     # Disable autostart for template / Отключить автозапуск шаблона

[!TIP] Set autostart=disable on template VMs to prevent them from booting accidentally. Templates should be kept in a clean, unconfigured state. Отключите автозапуск на шаблонных ВМ, чтобы предотвратить случайную загрузку. Шаблоны должны поддерживаться в чистом, не настроенном состоянии.

Clone VM from Template / Клонирование ВМ из шаблона

virt-clone --original <TEMPLATE> --name <NEW_VM> --auto-clone  # Clone with auto-generated disk / Клонировать с автогенерацией диска
virt-clone --original <TEMPLATE> --name <NEW_VM> --file /var/lib/libvirt/images/<NEW_VM>.qcow2  # Clone to specific path / Клонировать в указанный путь
virt-clone --original <TEMPLATE> --name <NEW_VM> --file /var/lib/libvirt/images/<NEW_VM>.qcow2 --preserve  # Preserve original / Сохранить оригинал

[!CAUTION] virt-clone requires the source VM to be shut off. Cloning a running VM will fail. Always shut down the template before cloning. virt-clone требует, чтобы исходная ВМ была выключена. Клонирование запущенной ВМ завершится ошибкой. Всегда выключайте шаблон перед клонированием.

Customize Cloned VM / Настройка клонированной ВМ

virt-customize -a /var/lib/libvirt/images/<NEW_VM>.qcow2 --hostname <NEW_HOSTNAME>  # Set hostname / Установить имя хоста
virt-customize -a /var/lib/libvirt/images/<NEW_VM>.qcow2 --ssh-inject root:file:/root/.ssh/id_rsa.pub  # Inject SSH key / Внедрить SSH-ключ
virt-customize -a /var/lib/libvirt/images/<NEW_VM>.qcow2 --selinux-relabel  # Relabel SELinux / Переметить SELinux

XML Editing & Device Management

Edit VM XML / Редактирование XML ВМ

virsh edit <VM_NAME>                   # Edit VM XML in default editor / Редактировать XML ВМ в редакторе по умолчанию
virsh edit <VM_NAME> --skip-validation  # Skip XML validation / Пропустить валидацию XML

[!TIP] virsh edit opens the XML in your default editor (usually vi). Always make a backup before editing. Use --skip-validation only when you need to fix invalid XML. virsh edit открывает XML в редакторе по умолчанию (обычно vi). Всегда делайте бэкап перед редактированием. Используйте --skip-validation только когда нужно исправить невалидный XML.

Example: Add a New Disk / Пример: добавление нового диска

virsh dumpxml <VM_NAME> > vm.xml       # Backup XML / Бэкап XML
# Edit vm.xml, add within <devices>:
#   <disk type='file' device='disk'>
#     <driver name='qemu' type='qcow2'/>
#     <source file='/var/lib/libvirt/images/data.qcow2'/>
#     <target dev='vdb' bus='virtio'/>
#   </disk>
virsh define vm.xml                    # Apply changes / Применить изменения

Example: Change CPU Count / Пример: изменение количества CPU

virsh setvcpus <VM_NAME> 8 --config    # Set to 8 vCPUs (next boot) / Установить 8 vCPU (при следующей загрузке)
virsh setvcpus <VM_NAME> 8 --live      # Hot-change (if supported) / Изменить на лету (если поддерживается)

Example: Set Memory Limit / Пример: установка лимита памяти

virsh setmaxmem <VM_NAME> 16G --config # Set max memory / Установить макс. память
virsh setmem <VM_NAME> 8G --config     # Set current memory / Установить текущую память

Update Devices / Обновление устройств

virsh update-device <VM_NAME> <DEVICE>.xml --live  # Update device on the fly / Обновить устройство на лету

Security & Access Control

SELinux / SELinux

chcon -t svirt_image_t /path/to/disk.qcow2           # Set correct SELinux label / Установить правильную метку SELinux
restorecon -Rv /var/lib/libvirt/images/               # Restore SELinux context / Восстановить контекст SELinux
getenforce                                         # Check SELinux mode / Проверить режим SELinux
sudo setenforce 0                                  # Set permissive (temporary) / Установить разрешающий (временно)
sudo setenforce 1                                  # Set enforcing (permanent) / Установить принудительный (постоянно)

sVirt (Mandatory Access Control) / sVirt (управление обязательного доступа)

virsh dominfo <VM_NAME> | grep -i security           # Show VM security model / Показать модель безопасности ВМ

[!NOTE] sVirt uses SELinux (or DAC) to confine each VM process, preventing VMs from accessing host files or other VMs' resources. This is critical for multi-tenant environments. sVirt использует SELinux (или DAC) для изоляции каждого процесса ВМ, предотвращая доступ ВМ к файлам хоста или ресурсам других ВМ. Это критически важно для мультитенантных сред.

User Access Control / Управление доступом пользователей

/etc/libvirt/libvirtd.conf

unix_sock_group = "libvirt"           # Grant access to libvirt group / Предоступить доступ группе libvirt
unix_sock_ro_perms = "0777"           # Read-only socket permissions / Права только для чтения
unix_sock_rw_perms = "0770"           # Read-write socket permissions / Права чтения-записи
auth_unix_ro = "none"                 # No auth for read-only / Без аутентификации для чтения
auth_unix_rw = "polkit"              # Polkit for read-write / Polkit для чтения-записи

[!CAUTION] Using auth_unix_ro = "none" and auth_unix_rw = "none" disables authentication. Only use in isolated environments. For production, use polkit. Использование auth_unix_ro = "none" и auth_unix_rw = "none" отключает аутентификацию. Используйте только в изолированных средах. В продакшене используйте polkit.

Host & Hypervisor Info

System Information / Информация о системе

virsh nodeinfo                        # Host system info (CPU, memory, NUMA) / Информация о хосте (CPU, память, NUMA)
virsh capabilities                    # Hypervisor capabilities / Возможности гипервизора
virsh sysinfo                         # SMBIOS/DMI system info / Информация SMBIOS/DMI системы

Sample Output of virsh nodeinfo:

CPU model:           x86_64
CPU(s):              16
CPU frequency:       3600 MHz
CPU socket(s):       1
Core(s) per socket:  8
Thread(s) per core:  2
NUMA cell(s):        1
Memory size:         32768 MiB

Hypervisor Capabilities / Возможности гипервизора

virsh capabilities | grep -i kvm      # Check KVM support / Проверить поддержку KVM

Advanced Operations

Managed Save / Управляемое сохранение

virsh managedsave <VM_NAME>            # Save VM state to disk / Сохранить состояние ВМ на диск
virsh managedsave-remove <VM_NAME>     # Remove saved state / Удалить сохранённое состояние
virsh managedsave-dumpxml <VM_NAME>    # Dump saved state XML / Выгрузить XML сохранённого состояния
virsh start <VM_NAME> --from-saved    # Start from saved state / Запустить из сохранённого состояния

Statistics & Monitoring / Статистика и мониторинг

virsh domstats <VM_NAME>               # Domain statistics / Статистика домена
virsh domstats <VM_NAME> --vcpu        # vCPU stats only / Статистика vCPU
virsh domstats <VM_NAME> --disk        # Disk stats only / Статистика дисков
virsh domstats <VM_NAME> --interface   # Network stats only / Статистика сети
virsh domstats <VM_NAME> --memory      # Memory stats only / Статистика памяти
virsh domstats <VM_NAME> --state       # State only / Только состояние
virsh domstats <VM_NAME> --list-active # All active domains / Все активные домены
virsh domstats <VM_NAME> --list-all     # All domains / Все домены

# Host-level statistics / Статистика уровня хоста
virsh nodecpustats                     # Host CPU statistics / Статистика CPU хоста
virsh nodecpustats --cpu 0             # CPU 0 stats / Статистика CPU 0
virsh nodecpuinfo                      # Host CPU info / Информация о CPU хоста
virsh nodecpumap                       # Host CPU map / Карта CPU хоста
virsh nodeinfo                         # Host node info / Информация об узле
virsh node-memory-stats                # Host memory statistics / Статистика памяти хоста

# Memory & device stats / Статистика памяти и устройств
virsh dommemstat <VM_NAME>             # Memory statistics / Статистика памяти
virsh domblkstat <VM_NAME> <DISK>      # Disk I/O statistics / Статистика ввода-вывода диска
virsh domifstat <VM_NAME> <IFACE>      # Network interface stats / Статистика сетевого интерфейса
virsh domjobinfo <VM_NAME>             # Current job info (migration etc.) / Инфо о текущей задаче (миграция и т.д.)
virsh domjobabort <VM_NAME>            # Abort current job / Прервать текущую задачу

Sample virsh domstats <VM_NAME> output:

Domain: '<VM_NAME>'
  state:running
  cpu.time:123456789
  balloon.current:4194304
  balloon.actual:4194304
  disk.path:/var/lib/libvirt/images/<VM_NAME>.qcow2
  disk.read.bytes:1048576
  disk.read.reqs:10
  disk.write.bytes:2097152
  disk.write.reqs:20

CPU Feature Control / Управление функциями CPU

virsh cpu-baseline <CPU_MODEL>.xml --connect qemu:///system  # Baseline CPU features / Базовые функции CPU
virsh cpu-features <VM_NAME> --pretty    # VM CPU features / Функции CPU ВМ
virsh cpu-models                       # List CPU models / Список моделей CPU
virsh domcapabilities                  # Host hypervisor capabilities / Возможности гипервизора хоста
virsh domcapabilities --arch <ARCH>    # Capabilities for specific arch / Возможности для конкретной архитектуры
virsh domcapabilities --machine <MACHINE>  # Capabilities for machine type / Возможности для типа машины

Sample virsh domcapabilities output:

<domCapabilities>
  <guest supported='yes'>
    <os_type>hvm</os_type>
    <arch name='x86_64'>
      <machine canonical='pc-q35-8.2'>pc-q35-8.2</machine>
      ...
    </arch>
  </guest>
</domCapabilities>

Guest Administration / Администрирование гостя

# Set guest user password (requires qemu-guest-agent) / Установить пароль пользователя гостя (требует qemu-guest-agent)
virsh set-user-password <VM_NAME> <USERNAME> --password
virsh set-user-password <VM_NAME> <USERNAME> --password <SECRET_PASSWORD>
virsh set-user-password <VM_NAME> <USERNAME> --crypted <HASH>  # Crypted password / Шифрованный пароль

# Guest info via agent / Информация о госте через агент
virsh guestinfo <VM_NAME>              # All guest info / Вся информация о госте
virsh guestinfo <VM_NAME> --user       # User info only / Только информация о пользователе
virsh guestinfo <VM_NAME> --os         # OS info only / Только информация об ОС
virsh guestinfo <VM_NAME> --disk       # Disk info only / Только информация о дисках
virsh guestinfo <VM_NAME> --iface      # Interface info only / Только информация об интерфейсах
virsh guestinfo <VM_NAME> --hostname   # Hostname only / Только имя хоста

# TRIM/Discard (fstrim) / TRIM/Discard (fstrim)
virsh domfstrim <VM_NAME>              # Issue TRIM to guest / Отправить TRIM гостю
virsh domfstrim <VM_NAME> --min 1      # Min free space for TRIM / Мин. свободное место для TRIM

[!CAUTION] set-user-password and guestinfo require qemu-guest-agent installed and running inside the VM. If the agent is not available, these commands will fail. set-user-password и guestinfo требуют установленного и запущенного qemu-guest-agent внутри ВМ. Если агент недоступен, эти команды завершатся ошибкой.

VM Lifecycle Summary / Сводка жизненного цикла ВМ

Trigger Crash Dump / Запуск аварийного дампа

virsh crashdump <VM_NAME> --trigger  # Trigger crash dump (if configured) / Запустить аварийный дамп (если настроено)

Freeze/Thaw Filesystem / Заморозка/разморозка ФС

virsh domfsfreeze <VM_NAME>           # Freeze guest filesystem (for consistent snapshots) / Заморозить ФС гостя
virsh domfsthaw <VM_NAME>             # Thaw guest filesystem / Разморозить ФС гостя

[!TIP] Use virsh domfsfreeze before creating a snapshot to ensure filesystem consistency. Always call virsh domfsthaw afterwards, even if snapshot creation fails. Используйте virsh domfsfreeze перед созданием снимка для обеспечения согласованности файловой системы. Всегда вызывайте virsh domfsthaw после, даже если создание снимка завершилось неудачно.

Domstate Codes / Коды состояний

virsh domstate <VM_NAME>               # Raw state / Необработанное состояние
virsh domstate <VM_NAME> --reason      # State with reason / Состояние с причиной

State Codes / Коды состояний: | Code | Description (EN / RU) | | :--- | :--- | | running | VM is running / ВМ работает | | idle | VM is idle (waiting for I/O) / ВМ в ожидании (ввода-вывода) | | paused | VM is paused / ВМ приостановлена | | shutdown | VM is shutting down / ВМ выключается | | shut off | VM is off / ВМ выключена | | crashed | VM has crashed / ВМ аварийно завершилась | | suspended | VM is suspended (e.g., by PM) / ВМ приостановлена (напр., управлением питанием) |

State Reason Codes / Коды причин состояний

Troubleshooting

Common Issues / Типичные проблемы

"error: failed to get connection driver" / Ошибка: не удалось получить драйвер подключения

virsh -c qemu:///system list           # Test connection / Проверить подключение
sudo systemctl status libvirtd        # Check daemon status / Проверить статус демона
sudo systemctl restart libvirtd       # Restart daemon / Перезапустить демон

"error: Cannot check QEMU binary /libvirt/qemu/bin/qemu-system-x86_64" / Ошибка: не удалось проверить бинарник QEMU

which qemu-system-x86_64              # Check if QEMU is installed / Проверить установку QEMU
sudo apt install qemu-kvm             # Install QEMU (Debian/Ubuntu) / Установить QEMU (Debian/Ubuntu)
sudo dnf install qemu-kvm             # Install QEMU (RHEL/CentOS) / Установить QEMU (RHEL/CentOS)

"error: Unable to open /dev/kvm" / Ошибка: Unable to open /dev/kvm

ls -la /dev/kvm                       # Check KVM device / Проверить устройство KVM
sudo modprobe kvm_intel               # Load Intel KVM module / Загрузить модуль KVM Intel
sudo modprobe kvm_amd                 # Load AMD KVM module / Загрузить модуль KVM AMD
sudo usermod -aG kvm <USER>           # Add user to kvm group / Добавить пользователя в группу kvm

"error: internal error: Failed to initialize a valid firewall backend" / Ошибка: Failed to initialize firewall backend

sudo apt install ebtables bridge-utils  # Install required packages (Debian/Ubuntu) / Установить пакеты (Debian/Ubuntu)
sudo dnf install ebtables bridge-utils  # Install required packages (RHEL/CentOS) / Установить пакеты (RHEL/CentOS)
sudo systemctl restart libvirtd         # Restart after install / Перезапустить после установки

"error: cannot create/read/write pid file /var/run/libvirt/libvirtd.pid" / Ошибка: Cannot create/read/write pid file

sudo mkdir -p /var/run/libvirt         # Create directory / Создать каталог
sudo chown root:root /var/run/libvirt  # Set ownership / Установить владельца

VM Won't Start / ВМ не запускается

virsh domstate <VM_NAME>               # Check state / Проверить состояние
virsh dumpxml <VM_NAME>                # Inspect XML config / Проверить XML-конфигурацию
journalctl -u libvirtd -n 50           # Check daemon logs / Проверить логи демона
cat /var/log/libvirt/qemu/<VM_NAME>.log  # Check QEMU logs / Проверить логи QEMU

Networking Issues / Проблемы с сетью

virsh net-list --all --state-running   # Check active networks / Проверить активные сети
virsh net-info default                 # Check default network / Проверить сеть по умолчанию
ip addr show virbr0                    # Check bridge interface / Проверить интерфейс моста
sudo iptables -L -n                    # Check firewall rules / Проверить правила файрвола

Storage Issues / Проблемы с хранилищем

virsh pool-list --all --state-running  # Check active pools / Проверить активные пулы
virsh pool-info <POOL>                 # Pool details / Детали пула
df -h                                  # Check disk space / Проверить место на диске
ls -la /var/lib/libvirt/images/        # Check images directory / Проверить каталог образов

Comparison Tables

Internal vs External Snapshots / Внутренние vs внешние снимки

Live vs Offline Migration / Живая vs оффлайн миграция

Quick Reference Cards

VM Lifecycle Commands / Команды жизненного цикла ВМ

virsh list --all                    # List all VMs / Список всех ВМ
virsh start <VM>                    # Start / Запустить
virsh shutdown <VM>                 # Graceful shutdown / Мягкое выключение
virsh destroy <VM>                  # Force stop / Принудительная остановка
virsh reboot <VM>                   # Reboot / Перезагрузка
virsh suspend <VM>                  # Pause / Приостановка
virsh resume <VM>                   # Resume / Возобновление
virsh undefine <VM>                 # Remove definition / Удалить определение
virsh autostart <VM>                # Enable autostart / Включить автозапуск
virsh autostart --disable <VM>      # Disable autostart / Отключить автозапуск
virsh dumpxml <VM>                  # Export XML / Экспорт XML
virsh edit <VM>                     # Edit XML / Редактирование XML
virsh console <VM>                  # Serial console / Серийная консоль
virsh dominfo <VM>                  # VM info / Информация о ВМ

Storage Commands / Команды хранилища

virsh pool-list --all               # List pools / Список пулов
virsh pool-info <POOL>              # Pool info / Информация о пуле
virsh pool-start <POOL>             # Start pool / Запустить пул
virsh pool-destroy <POOL>           # Destroy pool / Уничтожить пул
virsh vol-list <POOL>               # List volumes / Список томов
virsh vol-create-as <POOL> <VOL> 20G  # Create volume / Создать том

Network Commands / Команды сети

virsh net-list --all                # List networks / Список сетей
virsh net-info <NET>                # Network info / Информация о сети
virsh net-start <NET>               # Start network / Запустить сеть
virsh net-destroy <NET>             # Stop network / Остановить сеть
virsh net-dhcp-leases <NET>         # DHCP leases / DHCP аренды

Snapshot & Checkpoint Commands / Команды снимков и контрольных точек

virsh snapshot-list <VM>            # List snapshots / Список снимков
virsh snapshot-create-as <VM> <NAME> "desc"  # Create snapshot / Создать снимок
virsh snapshot-revert <VM> <NAME>   # Revert / Откатить
virsh snapshot-delete <VM> <NAME>   # Delete / Удалить
virsh snapshot-current <VM>         # Current snapshot / Текущий снимок

virsh checkpoint-list <VM>          # List checkpoints / Список контрольных точек
virsh checkpoint-create-as <VM> <NAME> "desc"  # Create checkpoint / Создать контрольную точку
virsh checkpoint-revert <VM> <NAME> # Revert checkpoint / Откат к контрольной точке
virsh checkpoint-delete <VM> <NAME> # Delete checkpoint / Удалить контрольную точку
virsh checkpoint-current <VM>       # Current checkpoint / Текущая контрольная точка

CPU & NUMA Commands / Команды CPU и NUMA

virsh vcpupin <VM> <VCPU> <PCPU> --live  # Pin vCPU to pCPU / Привязать vCPU к pCPU
virsh vcpupin <VM> --current             # Show pinning / Показать привязку
virsh numatune <VM> --memnodes 0-1 --memorymode preferred --live  # NUMA memory policy / NUMA-политика
virsh setvcpus <VM> <N> --live           # Hot-change vCPU / Изменить vCPU на летu
virsh dominfo <VM> | grep numa           # NUMA topology / Топология NUMA

Statistics & Monitoring Commands / Команды статистики и мониторинга

virsh domstats <VM>                 # Domain statistics / Статистика домена
virsh domstats <VM> --list-active   # All active domains / Все активные домены
virsh nodecpustats                  # Host CPU stats / Статистика CPU хоста
virsh nodeinfo                      # Host node info / Информация об узле
virsh dommemstat <VM>               # Memory stats / Статистика памяти
virsh domblkstat <VM> <DISK>        # Disk I/O stats / Статистика диска
virsh domjobinfo <VM>               # Current job info / Инфо о текущей задаче

Block Operations / Блочные операции

virsh domblkinfo <VM> <DISK>        # Block device info / Инфо о блочном устройстве
virsh domblklist <VM> --details     # List all disks / Список всех дисков
virsh blockcommit <VM> <DISK> --base <BASE> --top <TOP> --active --wait  # Commit / Слить
virsh blockcopy <VM> <DISK> <PATH> --wait --pivot  # Copy & pivot / Копировать и переключить
virsh blockresize <VM> <DISK> <SIZE> --live        # Resize disk / Изменить размер диска

Guest Administration Commands / Команды администрирования гостя

virsh set-user-password <VM> <USER> --password  # Set password / Установить пароль
virsh guestinfo <VM>                 # All guest info / Вся информация о госте
virsh guestinfo <VM> --os            # OS info only / Только информация об ОС
virsh guestinfo <VM> --hostname      # Hostname only / Только имя хоста
virsh domfstrim <VM>                 # TRIM/TRIM discard / TRIM/Discard
virsh qemu-monitor-command <VM> --hmp "info status"  # HMP status / Статус через HMP
virsh qemu-agent-command <VM> '{"execute":"guest-info"}'  # Agent info / Инфо агента

Migration Commands / Команды миграции

virsh migrate <VM> qemu+ssh://<HOST>/system  # Migrate / Мигрировать
virsh migrate --live <VM> qemu+ssh://<HOST>/system  # Live migrate / Живая миграция
virsh domjobinfo <VM>               # Migration progress / Прогресс миграции
virsh domjobabort <VM>              # Abort migration / Прервать миграцию

One-Line Patterns / Однострочные шаблоны

# List all running VMs / Список всех запущенных ВМ
virsh list --state-running --name

# Start all stopped VMs / Запустить все остановленные ВМ
virsh list --inactive --name | xargs -I{} virsh start {}

# Show all VM IPs (requires guest agent) / Показать все IP ВМ (нужен гостевой агент)
for vm in $(virsh list --name); do echo "$vm: $(virsh domifaddr $vm 2>/dev/null | awk 'NR>2{print $4}')"; done

# Bulk snapshot creation / Массовое создание снимков
for vm in $(virsh list --name); do virsh snapshot-create-as $vm "backup-$(date +%Y%m%d)" "Daily backup"; done

# Show VM disk usage / Показать использование дисков ВМ
for vm in $(virsh list --name); do echo "$vm:"; virsh domblkinfo $vm vda 2>/dev/null | grep -E "Capacity|Allocation"; done

Logrotate Configuration

Libvirt Logrotate / Настройка logrotate для libvirt

/etc/logrotate.d/libvirt-qemu

/var/log/libvirt/qemu/*.log {
    weekly
    rotate 4
    compress
    delaycompress
    missingok
    notifempty
    create 0640 libvirt-qemu kvm
    sharedscripts
    postrotate
        /usr/lib/libvirt/libvirt_lxc 2>/dev/null || true
    endscript
}

sudo logrotate -d /etc/logrotate.d/libvirt-qemu  # Test logrotate config / Тестировать конфигурацию logrotate
sudo logrotate -f /etc/logrotate.d/libvirt-qemu  # Force rotation / Принудительная ротация

Per-VM Log Configuration / Конфигурация логов для каждой ВМ

# Enable per-VM logging in libvirtd.conf / Включить логирование для каждой ВМ в libvirtd.conf
# Set in /etc/libvirt/qemu.conf:
# log_timestamp = 1
# user = "root"
# group = "kvm"

Documentation Links

Official Documentation / Официальная документация

• virsh man page — virsh command reference / Справочник команд virsh
• libvirt documentation — Official libvirt docs / Официальная документация libvirt
• libvirt.org — Project homepage / Домашняя страница проекта

Tutorials & Guides / Учебники и руководства

• KVM Virtualization — Arch Wiki KVM guide / Руководство KVM из Arch Wiki
• Ubuntu KVM Guide — Ubuntu KVM tutorial / Учебник KVM от Ubuntu
• Red Hat Virtualization — RHEL docs / Документация RHEL

Related Tools / Связанные инструменты

• virt-manager — GUI management tool / GUI инструмент управления
• Cockpit — Web management interface / Веб-интерфейс управления
• Proxmox VE — Enterprise virtualization platform / Корпоративная платформа виртуализации
• oVirt — Open-source virtualization / Open-source виртуализация