basforge

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

    EN
    ШпаргалкаHomelabProxmox

    Proxmox на каждый день: qm, pct, pvesm, vzdump и логи

    Команды для Shell узла от root. qm управляет машинами, pct — контейнерами, pvesm — хранилищами, vzdump — бэкапами; всё, что делает веб-интерфейс, доступно и здесь. Гостя называем номером: 101, а не именем.

    Что за хост

    Команда Что делает
    pveversion -v версии пакетов Proxmox и работающее ядро
    pvesm status хранилища: тип, занято, свободно
    pveperf быстрый замер процессора и FSYNCS/SECOND диска
    proxmox-boot-tool kernel list установленные ядра и какое загрузится
    systemctl status pveproxy pvedaemon pve-cluster службы интерфейса, API и /etc/pve
    pvesh get /nodes/pve1/status то же, что Summary узла, текстом

    Машины

    Команда Что делает
    qm list все машины: номер, имя, состояние
    qm start 101 запустить
    qm shutdown 101 выключить через гостя: ACPI или агент
    qm stop 101 выдернуть питание
    qm reboot 101 перезапуск с ожидающими правками конфига
    qm config 101 конфиг машины («Конфиг VM Proxmox»)
    qm set 101 --memory 4096 поменять настройку
    qm terminal 101 последовательная консоль, выход — Ctrl+O
    qm disk resize 101 scsi0 +10G увеличить диск; уменьшить нельзя
    qm disk move 101 scsi0 local-zfs перенести диск на другое хранилище
    qm disk import 101 disk.qcow2 local-lvm чужой диск в машину, появится как Unused
    qm clone 9000 112 --name web2 --full полный клон шаблона
    qm template 9000 машину — в шаблон, обратно нельзя
    qm destroy 101 --purge удалить, убрать из бэкапов и HA
    qm unlock 101 снять зависшую блокировку

    Через гостевой агент

    Команда Что делает
    qm guest cmd 101 ping агент на связи — пустой вывод
    qm guest cmd 101 network-get-interfaces адреса машины изнутри
    qm guest exec 101 -- df -h / команда в госте без SSH
    qm guest cmd 101 fsfreeze-status заморожена ли файловая система
    qm guest passwd 101 example-user сменить пароль пользователя в госте

    Контейнеры

    Команда Что делает
    pct list все контейнеры
    pct enter 201 shell root внутри, без сети и пароля
    pct exec 201 -- apt update команда в контейнере с хоста
    pct start 201, pct shutdown 201 запустить, выключить
    pct config 201 конфиг контейнера
    pct set 201 -memory 1024 поменять настройку
    pct resize 201 rootfs +4G увеличить корень
    pct push 201 ./app.conf /etc/app.conf файл с хоста в контейнер
    pct pull 201 /var/log/syslog ./syslog файл из контейнера на хост
    pct set 201 -mp0 /srv/share,mp=/srv/share каталог хоста в контейнер
    pct unlock 201 снять зависшую блокировку

    Шаблоны контейнеров

    Команда Что делает
    pveam update обновить список шаблонов
    pveam available --section system системы: Debian, Ubuntu, Alpine…
    pveam download local debian-13-standard_13.6-1_amd64.tar.zst скачать шаблон
    pveam list local что уже скачано

    Снимки

    Команда Что делает
    qm snapshot 101 before-upgrade снимок машины
    qm snapshot 101 before-upgrade --vmstate 1 снимок вместе с памятью
    qm listsnapshot 101 дерево снимков
    qm rollback 101 before-upgrade откатить к снимку
    qm delsnapshot 101 before-upgrade удалить снимок
    pct snapshot 201 clean то же у контейнера: pct listsnapshot, pct rollback, pct delsnapshot

    Бэкапы

    Команда Что делает
    vzdump 101 --storage nas-backup --mode snapshot --compress zstd бэкап одной машины сейчас
    vzdump --all 1 --storage nas-backup бэкап всех гостей узла
    pvesm list nas-backup --content backup копии на хранилище
    qmrestore <архив> 901 --unique 1 восстановить машину под новым номером
    pct restore 902 <архив> --unique 1 восстановить контейнер
    pvesh get /cluster/backup задания бэкапа

    Хранилища и диски

    Команда Что делает
    pvesm list local-lvm тома на хранилище: диски гостей
    lvs pve/data заполнение тонкого пула: Data%, Meta%
    zpool status -x пулы ZFS: all pools are healthy или что сломано
    zfs list -o name,used,avail,compressratio наборы данных ZFS и сжатие
    arc_summary -s arc сколько памяти у кэша ZFS
    smartctl -a /dev/sda здоровье и износ диска
    lsblk -o NAME,SIZE,MODEL,SERIAL диски и их серийные номера

    Сеть

    Команда Что делает
    ip -br addr адреса на мостах и картах
    ifreload -a применить /etc/network/interfaces
    bridge link кто в каком мосте
    bridge vlan show теги VLAN на портах мостов
    pve-network-interface-pinning generate закрепить имена сетевых карт
    pve-firewall status включён ли фаервол Proxmox

    Обновление и логи

    Команда Что делает
    apt update && apt full-upgrade обновить хост, не apt upgrade
    pve8to9 --full проверка перед переходом с 8 на 9
    journalctl -b -p warning предупреждения и ошибки с загрузки
    journalctl -u pveproxy --since "1 hour ago" лог веб-интерфейса
    tail -f /var/log/pve/tasks/active задачи, которые идут сейчас
    pvenode task list --limit 20 последние задачи узла

    Кластер

    Команда Что делает
    pvecm status кворум и голоса узлов
    pvecm nodes узлы кластера
    qm migrate 101 pve2 --online машину на другой узел без остановки
    pct migrate 201 pve2 --restart контейнер на другой узел с перезапуском