Product SiteDocumentation Site

⁠30.7. Файлы конфигурации ВМ

Файлы конфигурации ВМ хранятся в кластерной файловой системе PVE в каталоге /etc/pve/qemu-server/. Имя файла соответствует идентификатору ВМ: <VMID>.conf. Файлы доступны на всех узлах кластера благодаря механизму репликации конфигурации в кластерной файловой системе.

Примечание

Идентификаторы ВМ меньше 100 зарезервированы для внутренних целей. Идентификаторы ВМ должны быть уникальными в пределах кластера.
Пример файла конфигурации:
boot: order=scsi0;net0
cores: 1
cpu: x86-64-v2-AES
efidisk0: local-lvm:vm-100-disk-2,efitype=4m,pre-enrolled-keys=1,size=4M
memory: 2048
meta: creation-qemu=9.1.2,ctime=1746532273
name: NewVM
net0: virtio=BC:24:11:40:5F:C3,bridge=vmbr0,firewall=1
numa: 0
ostype: l26
scsi0: local-lvm:vm-100-disk-0,size=52G
scsihw: virtio-scsi-single
smbios1: uuid=cafd8016-03d3-4514-8d6f-5f4e353e5936
sockets: 1
spice_enhancements: foldersharing=1
unused0: local-lvm:vm-100-disk-1
unused1: newCIFS:100/vm-100-disk-0.qcow2
usb0: host=090c:1000
usb1: spice
usb2: spice
usb3: host=346d:5678
vga: qxl
vmgenid: 31f7faef-4014-453b-ba8d-801e5634cc08
Файлы конфигурации используют простой формат пар «ключ–значение», разделённых двоеточием. Пустые строки игнорируются, а строки, начинающиеся с символа #, считаются комментариями. Пример:
OPTION: value
Для изменения конфигурации ВМ рекомендуется использовать команду qm или веб-интерфейс PVE. При ручном редактировании файла конфигурации для применения изменений требуется перезапуск ВМ.
При создании снимка PVE сохраняет конфигурацию ВМ на момент создания снимка в отдельной секции того же файла конфигурации. Например, после создания снимка snapshot файл будет содержать секцию [snapshot] с параметрами ВМ на момент создания снимка. Свойство parent используется для хранения связей между снимками, а snaptime содержит время создания снимка в формате Unix time (количество секунд с начала эпохи Unix):
boot: order=scsi0;net0
…
parent: snapshot
…
vmgenid: 31f7faef-4014-453b-ba8d-801e5634cc08

[snapshot]
boot: order=scsi0;net0
cores: 1
cpu: x86-64-v2-AES
efidisk0: local-lvm:vm-100-disk-2,efitype=4m,pre-enrolled-keys=1,size=4M
memory: 2048
meta: creation-qemu=9.1.2,ctime=1746532273
name: NewVM
net0: virtio=BC:24:11:40:5F:C3,bridge=vmbr0,firewall=1
numa: 0
ostype: l26
parent: first
runningcpu: qemu64,+aes,enforce,+kvm_pv_eoi,+kvm_pv_unhalt,+pni,+popcnt,+sse4.1,+sse4.2,+ssse3
runningmachine: pc-i440fx-9.1+pve0
scsi0: local-lvm:vm-100-disk-0,size=52G
scsihw: virtio-scsi-single
smbios1: uuid=cafd8016-03d3-4514-8d6f-5f4e353e5936
snaptime: 1746609190
sockets: 1
spice_enhancements: foldersharing=1
usb0: host=090c:1000
usb1: spice
usb2: spice
usb3: host=346d:5678
vga: qxl
vmgenid: 31f7faef-4014-453b-ba8d-801e5634cc08
vmstate: local-lvm:vm-100-state-snapshot