Где лежит и кто пишет
/etc/pve/qemu-server/111.conf машина 111 на этом узле
/etc/pve/lxc/201.conf контейнер 201 — устроен так же
/etc/pve/nodes/pve1/qemu-server/ настоящее место; /etc/pve/qemu-server — ссылка на каталог своего узла
/etc/pve — файловая система pmxcfs, общая для узлов кластера. Файл можно читать и править редактором, но
проще и безопаснее qm set 111 --memory 4096: команда проверяет значения и правильно обходится с
работающей машиной. qm config 111 печатает то же, что в файле, без снимков. Ключи в файле Proxmox
держит по алфавиту, поэтому порядок ниже — тот же.
Ниже — машина web1 из шаблона cloud-init («Шаблон VM с cloud-init») с одним снимком.
Конфиг
agent: enabled=1Связь с гостевым агентом: через него Proxmox корректно выключает машину, видит её адреса и замораживает файловую систему на время бэкапа. Сам агент ставится внутри гостя («Гостевой агент»).
boot: order=scsi0С какого диска грузиться. Список через ;: order=scsi0;ide2;net0 — сначала диск, потом CD, потом сеть.
ciuser: example-userПользователь, которого cloud-init создаст при первой загрузке, с sudo без пароля.
cores: 2
cpu: hostЯдра и тип процессора. host — гость видит процессор хоста целиком: быстрее всего, но живая миграция — только на такой же процессор. Без строки cpu: тип по умолчанию — x86-64-v2-AES, его понимает любой процессор с 2010-х.
по умолчанию:cpu x86-64-v2-AEScores 1
ide2: local-lvm:vm-111-cloudinit,media=cdrom,size=4M
ipconfig0: ip=10.0.0.11/24,gw=10.0.0.1Диск cloud-init: CD-ROM на 4 МБ, Proxmox пишет на него пользователя, ключи и сеть. Пересоздаётся при каждом запуске машины из строк ci*, ipconfig*, nameserver, sshkeys.
memory: 2048Память в МиБ — максимум, который увидит гость. Без balloon: минимум равен максимуму, но драйвер balloon всё равно работает и показывает Proxmox, сколько гость использует.
по умолчанию:memory 512
meta: creation-qemu=11.0.3,ctime=1792984476
name: web1
nameserver: 1.1.1.1 9.9.9.9Служебное: версия QEMU и время создания машины. По creation-qemu Proxmox выбирает умолчания, которые нельзя менять у старых машин без риска для гостя.
net0: virtio=BC:24:11:5E:0A:11,bridge=vmbr0Сетевая карта: модель VirtIO, MAC и мост. BC:24:11 — префикс MAC, закреплённый за Proxmox. Здесь же бывают tag=20 (VLAN), firewall=1, link_down=1 (кабель выдернут), rate=10 (предел в МБ/с).
ostype: l26Тип гостевой ОС: l26 — Linux с ядром 2.6 и новее, win11 — Windows 11. От него зависят умолчания: часы, драйверы, таймеры Hyper-V для Windows.
parent: cleanПоследний снимок, от которого идёт текущее состояние. Сами снимки — разделами в конце файла.
scsi0: local-lvm:vm-111-disk-0,discard=on,size=30G
scsihw: virtio-scsi-singleДиск: том vm-111-disk-0 на local-lvm, 30 ГиБ. discard=on — освобождённое в госте место возвращается в тонкий пул («Discard у диска»). Сюда же дописывают iothread=1 (свой поток ввода-вывода диска), ssd=1 (гость видит SSD), backup=0 (не бэкапить).
serial0: socketКонсоль через последовательный порт вместо экрана — так её ждут облачные образы. В интерфейсе это консоль xterm.js, в shell хоста — qm terminal 111.
smbios1: uuid=5ade58c1-a526-4307-9df4-63af1ca1579eИдентификаторы машины: UUID для SMBIOS — гость видит его как серийный номер платы, — и vmgenid, который меняется при откате снимка: по нему Windows и контроллеры домена понимают, что их «вернули в прошлое».
sshkeys: ssh-ed25519%20AAAAC3Nza…%20example-user%40laptop%0A
vga: serial0
vmgenid: ad11b406-3076-4031-aca6-dda9956c1de8Ключи SSH для cloud-init — в URL-кодировке: пробел записан как %20, перевод строки — %0A. Править руками неудобно, поэтому qm set 111 --sshkeys файл.pub.
[clean]
agent: enabled=1
boot: order=scsi0
…
description: Ubuntu 24.04 после первой загрузки
snaptime: 1792985517Снимок clean: копия конфига на момент снимка и время в секундах Unix. Диски снимка хранит хранилище, в файле только описание. vmstate (если снимок с памятью) — том с содержимым памяти.
balloon: 1024Минимум памяти для balloon: в покое гость отдаёт хосту всё сверх 1024 МиБ, под нагрузкой забирает обратно до memory.
onboot: 1
startup: order=2,up=30Автозапуск после загрузки хоста и порядок: машина 2-й в очереди, следующая стартует через 30 с после неё. Роутер в машине — order=1.
bios: ovmf
efidisk0: local-lvm:vm-111-disk-1,efitype=4m,pre-enrolled-keys=1,size=4M
machine: q35
tpmstate0: local-lvm:vm-111-disk-2,size=4M,version=v2.0UEFI вместо SeaBIOS: нужен для Windows 11 и проброса видеокарты. efidisk0 хранит переменные UEFI, tpmstate0 — виртуальный TPM 2.0, q35 — чипсет с шиной PCIe.
hostpci0: 0000:01:00.0,pcie=1Проброс устройства PCIe — видеокарты или контроллера — целиком в машину. Хост его больше не видит; машину с таким устройством нельзя мигрировать на ходу.
lock: backupМетка блокировки: пока идёт бэкап, снимок или клонирование. Осталась после сбоя — qm unlock 111.
Если не работает
Поменяли память или процессор у работающей машины — внутри всё по-старому
- Причина
- Часть настроек на ходу не меняется. Proxmox пишет их в раздел
[PENDING]конфига, и применяются они при следующем запуске процесса машины. Перезагрузка изнутри гостя процесс не перезапускает. - Делаем
qm pending 111показывает, что ждёт применения. Применяемqm reboot 111или выключением и запуском из Proxmox.
Правка файла руками пропала или машина пишет parse error
- Причина
- Опечатка в ключе или значении: строку, которую Proxmox не понял, он пропускает и пишет ошибку в лог.
- Делаем
- Правим через
qm set— он проверяет значения. После ручной правки —qm config 111: в выводе ошибки разбора видны сразу.
Машину нельзя запустить: VM is locked (snapshot)
- Причина
- В конфиге осталась строка
lock: snapshot(илиbackup,clone) от операции, которая оборвалась. - Делаем
- Убеждаемся в Tasks, что операция не идёт, и снимаем:
qm unlock 111. Строкаlock:уйдёт из файла.
Linux в машине пишет Fatal glibc error: CPU does not support x86-64-v3
- Причина
- Строки
cpu:в конфиге нет — значит тип по умолчаниюx86-64-v2-AES, без AVX2, а система собрана под x86-64-v3 (RHEL 10 и его клоны). - Делаем
qm set 111 --cpu x86-64-v3или--cpu host, если процессор хоста умеет AVX2 («Железо под Proxmox»).
Как проверить
qm config 111 # то же, что в файле, без разделов снимков
qm pending 111 # текущие значения и те, что ждут перезапуска
qm showcmd 111 --pretty # командная строка kvm, которую Proxmox соберёт из конфига
qm cloudinit dump 111 user # что cloud-init получит: пользователь, ключи
qm showcmd — самая честная проверка: в нём видно, с какими устройствами и опциями машина
запустится на деле. Конфиг описывает желаемое, а эта команда — то, что получит QEMU.