Product SiteDocumentation Site

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

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

Примечание

VMID < 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 для создания и изменения конфигурации либо выполнять эти действия через веб-интерфейс.
При создании снимка ВМ её конфигурация на момент создания сохраняется в том же конфигурационном файле в отдельном разделе. Например, после создания снимка «snapshot» файл конфигурации будет выглядеть следующим образом:
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
Свойство parent используется для хранения родительских и дочерних отношений между снимками, а snaptime содержит отметку времени создания снимка (в формате Unix epoch).