basforge

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

    EN
    МануалHomelabProxmox

    Бэкапы в Proxmox: задание vzdump на каждую ночь, хранение копий и проверка восстановления

    Встроенный vzdump каждую ночь копирует гостей целиком — диски и конфиг — на отдельный диск или NAS, а правило хранения удаляет лишнее: 7 ежедневных, 4 недельных, 6 месячных копий. Машины не останавливаются, гостевой агент замораживает файловую систему на время снимка. Бэкап, из которого ни разу не восстанавливали, не считается: последний шаг — восстановление в новую машину.

    Что получится

    куда         хранилище nas-backup — NAS по NFS, или второй диск хоста
    когда        каждый день в 03:00, все гости
    как          режим snapshot, сжатие zstd, гости не останавливаются
    хранение     7 ежедневных, 4 недельных, 6 месячных копий
    уведомление  письмо, если задание упало
    проверено    машина восстановлена в новую 901, загрузилась, данные на месте

    Бэкап vzdump — это гость целиком: все диски и его конфиг. Восстанавливается он на любой хост Proxmox — хоть на свежеустановленный после смерти старого. Конфиги самого хоста (/etc/network/interfaces, хранилища, пользователи) в бэкапы гостей не входят: хост проще поставить заново («Установка Proxmox») и вернуть на него гостей.

    Шаги

    1. Выбираем, куда класть бэкапы

      Бэкап на том же диске, что и гости, переживёт только ошибку в госте, но не смерть диска. Поэтому куда-то ещё:

      • NAS — Datacenter › Storage › Add › NFS (или SMB/CIFS), Content — VZDump backup file.
      • Второй диск хоста — узел › Disks › Directory › Create Directory, Content — VZDump backup file.

      Как подключить хранилище — «Хранилища Proxmox». Дальше в примере NFS-хранилище nas-backup:

      pvesm add nfs nas-backup --server 10.0.0.20 --export /volume1/proxmox --content backup
      pvesm status                       # nas-backup  nfs  active
    2. Создаём задание

      Datacenter › Backup › Add:

      Поле Ставим Почему
      Storage nas-backup не тот диск, где гости
      Schedule 03:00 каждый день в 3 ночи; формат — календарь systemd: sat 02:00, mon..fri 22:30
      Selection mode All новые гости попадут в бэкап сами; исключения — Exclude selected
      Mode Snapshot без остановки гостей
      Compression ZSTD быстрее gzip и lzo при сравнимом сжатии, использует несколько ядер
      Notification ошибки письмо или другое уведомление, если задание упало («Установка Proxmox», шаг про уведомления)

      Вкладка Retention — сколько копий хранить (следующий шаг). Вкладка Note Template — подпись к копии, по умолчанию {{guestname}}: в списке бэкапов видно имя гостя, а не только номер.

      Задание ложится в /etc/pve/jobs.cfg:

      vzdump: backup-7f3a9c21-1d2e
              schedule 03:00
              all 1
              compress zstd
              enabled 1
              mode snapshot
              notes-template {{guestname}}
              prune-backups keep-daily=7,keep-monthly=6,keep-weekly=4
              storage nas-backup
    3. Задаём хранение

      Retention: Keep Daily 7, Keep Weekly 4, Keep Monthly 6. Как это считается:

      • Правила идут по порядку: last, hourly, daily, weekly, monthly, yearly. Каждое оставляет последнюю копию за свой период — день, неделю (с понедельника по воскресенье), месяц.
      • Следующее правило смотрит только на копии старше тех, что уже оставило предыдущее.
      • При ежедневном бэкапе получается: 7 последних дней, ещё 4 недели до них и ещё 6 месяцев до них — до 17 копий на гостя, история примерно на 7 месяцев назад.

      Лишнее удаляется после каждого запуска задания. Копию, которую удалять нельзя, — перед обновлением или большой правкой — помечаем Protected в списке бэкапов хранилища: правила хранения её не трогают.

      Хранение можно задать и у хранилища (Datacenter › Storage › Edit › Backup Retention), но правило задания важнее — держим его в одном месте, у задания.

    4. Исключаем то, что бэкапить не нужно

      Диск машины с медиатекой на 2 ТБ каждую ночь копировать незачем — его бэкапят иначе или не бэкапят вовсе. У диска машины снимаем галку Backup (Hardware › диск › Edit) или делаем то же командой:

      qm set 101 --scsi1 local-lvm:vm-101-disk-1,backup=0

      Строку диска для команды берём из qm config 101: backup=0 дописывается к ней, остальное — как было. У точки монтирования контейнера — то же, backup=0.

    5. Запускаем первый раз руками

      В списке заданий — Run now. В консоли то же для одного гостя:

      vzdump 101 --storage nas-backup --mode snapshot --compress zstd

      Внизу интерфейса, в Tasks, двойной щелчок по задаче открывает лог. В конце должно быть Finished Backup of VM 101 и Backup job finished successfully. Если у машины работает гостевой агент, в логе есть заморозка файловой системы — issuing guest-agent 'fs-freeze' command и fs-thaw после снимка («Гостевой агент»).

      Файл появится на хранилище в dump/:

      vzdump-qemu-101-2026_10_31-03_00_02.vma.zst     машина: диски и конфиг
      vzdump-lxc-201-2026_10_31-03_01_15.tar.zst      контейнер: файлы корня и конфиг
    6. Восстанавливаем в новую машину

      Проверяем бэкап восстановлением, и не поверх рабочей машины, а рядом, под новым номером:

      qmrestore /mnt/pve/nas-backup/dump/vzdump-qemu-101-2026_10_31-03_00_02.vma.zst 901 \
        --storage local-lvm --unique 1
      qm set 901 --name web1-restore-test
      qm config 901 | grep net0          # net0: virtio=BC:24:11:…,bridge=vmbr0

      --unique 1 даёт копии новые MAC-адреса. Адрес внутри гостя прежний, поэтому до проверки отключаем сеть: в интерфейсе у сетевой карты машины 901 — Disconnect, в консоли — дописываем link_down=1 к строке net0.

      Запускаем qm start 901, входим через консоль, смотрим данные: база открывается, файлы на месте. Потом удаляем: qm destroy 901. Контейнер восстанавливается так же: pct restore 902 /mnt/pve/nas-backup/dump/vzdump-lxc-201-….tar.zst --storage local-lvm --unique 1.

    Когда переходить на Proxmox Backup Server

    vzdump каждый раз пишет гостя целиком: у машины с диском 50 ГБ каждую ночь читается весь диск, а на хранилище ложится новый архив размером с её сжатые данные. Proxmox Backup Server (PBS) хранит копии кусками и одинаковые куски — один раз:

    • Дедупликация. Если за день в машине меняется немного, семь ежедневных копий занимают чуть больше одной: почти все куски повторяются.
    • Инкременты. Пока машина работает, QEMU помечает изменённые блоки (dirty bitmap), и следующий бэкап читает только их: минуты вместо часа. После остановки машины карта теряется, и следующий бэкап читает диск целиком, но передаёт всё равно только новые куски.
    • Файлы из бэкапа — достаются по одному, без восстановления всей машины.
    • Проверка. Задания Verify перечитывают куски и сверяют контрольные суммы.

    PBS ставят на отдельную машину или хотя бы на отдельные диски: бэкап на том же железе, что и гости, умирает вместе с ним. Переходить имеет смысл, когда гостей больше десятка или диски — сотни гигабайт.

    Если не работает

    Задание падает: storage 'nas-backup' is not online

    Причина
    NAS спит, выключен или недоступен по сети в момент бэкапа; Proxmox проверяет хранилище перед стартом.
    Делаем
    Расписание NAS и бэкапа согласуем, в NAS выключаем сон дисков на это время. Проверка с хоста: pvesm status — у хранилища active.

    В логе контейнера: mode failure - some volumes do not support snapshots, дальше trying 'suspend' mode instead

    Причина
    Режим snapshot у контейнера требует, чтобы все его тома лежали на хранилище со снимками. Том на каталоге или каталог хоста (bind mount) этому мешают.
    Делаем
    Тома контейнера — на LVM-thin или ZFS. Том, который бэкапить не нужно, помечаем backup=0 у точки монтирования.

    Во время бэкапа машина тормозит, база в ней отвечает секундами

    Причина
    В режиме snapshot запись гостя в ещё не скопированный блок ждёт, пока этот блок уйдёт в бэкап. Медленный NAS тормозит запись в машине.
    Делаем
    Fleecing (с 8.2): у задания Advanced › Fleecing Storage — быстрый локальный local-lvm. Блоки сначала копируются туда, и гость не ждёт сеть.

    Старые бэкапы не удаляются, место на NAS кончается

    Причина
    У задания не задано хранение, а у хранилища стоит keep-all=1 — правило «хранить всё».
    Делаем
    Retention у задания: Keep Daily 7, Keep Weekly 4, Keep Monthly 6. Лишнее удалится после следующего запуска; сразу — Prune Group у хранилища.

    Машину не запустить и не изменить: VM 101 is locked (backup)

    Причина
    Бэкап оборвался — перезагрузили хост или упал NAS, — и блокировка осталась.
    Делаем
    Убеждаемся, что бэкап правда не идёт (Tasks внизу интерфейса), и снимаем блокировку: qm unlock 101, у контейнера — pct unlock 201.

    После восстановления машина сеет конфликт адресов с оригиналом

    Причина
    Копия получила тот же MAC и тот же адрес, что и работающая машина.
    Делаем
    Восстанавливаем с --unique 1 — новые MAC, — и до проверки держим сеть выключенной: link_down=1 у net0.

    Как проверить

    pvesh get /cluster/backup --output-format yaml      # задание есть: schedule, storage, prune-backups
    pvesm list nas-backup --content backup              # копии каждого гостя

    На следующее утро после первой ночи — в Datacenter › Backup задание с Next Run на сегодня, в Tasks — успешная задача Backup Job, на хранилище — по копии на гостя. Через неделю в списке у каждого гостя 7 копий, а не больше: хранение работает. И главное — машина 901 из бэкапа загрузилась и в ней наши данные.