basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    КонфигHomelabProxmox

    Конфиг виртуальной машины Proxmox по строкам: /etc/pve/qemu-server/111.conf

    Машина в Proxmox — текстовый файл /etc/pve/qemu-server/<номер>.conf: процессор, память, диски, сеть, cloud-init и снимки, по строке на настройку. Его пишут интерфейс и qm set, а читать полезно самим: по нему видно, что машина получит при следующем запуске, где лежат её диски и что попадёт в бэкап.

    Где лежит и кто пишет

    /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») с одним снимком.

    Конфиг

    /etc/pve/qemu-server/111.conf
    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.0

    UEFI вместо 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.