Настройка PBS и структура datastore для нескольких хостов

Введение

Proxmox Backup Server предоставляет централизованное дедуплицированное хранилище резервных копий для узлов Proxmox VE, Linux-клиентов, виртуальных машин, контейнеров и резервных копий хостов. В этом руководстве вы выполните первоначальную настройку Proxmox Backup Server, создадите PBS datastore на отдельном диске, настроите обновления и SMTP-уведомления, а также организуете резервные копии с нескольких хостов с помощью пространств имен datastore вместо ручных папок или нескольких небольших datastore. Получившаяся схема Proxmox PBS также подготовит вашу среду к последующим задачам восстановления резервных копий Proxmox, включая восстановление резервной копии VM, file-level restore, granular restore и сценарии data recovery Proxmox.

Целевая аудитория: системные администраторы среднего уровня.
Оценочное время выполнения: от 45 до 75 минут.
Итоговая цель: к концу этого руководства у вас будет datastore Proxmox Backup Server на выделенном хранилище, настроенные репозитории обновлений, включенные email-уведомления и доступ к пространствам имен для каждого хоста, управляемый с помощью ACL.

Предварительные требования

Перед началом убедитесь, что у вас есть следующее:

• Установленный Proxmox Backup Server 4.x, доступный через веб-интерфейс по адресу https://<PBS_HOSTNAME_OR_IP>:8007.
• Root-доступ или эквивалентный административный доступ к хосту Proxmox Backup Server.
• Один отдельный диск для хранилища резервных копий, обозначенный как <DATA_DISK>, например sdb или nvme1n1.
• Сетевая доступность от каждого хоста Proxmox VE или backup-клиента к PBS-хосту по TCP-порту 8007.
• Данные SMTP-сервера для уведомлений, включая хост, порт, адрес отправителя, пользователя для аутентификации и пароль или пароль приложения.
• Один или несколько хостов Proxmox VE или backup-клиентов, которые будут использовать PBS datastore.

В этом руководстве используются следующие placeholders:

• <PBS_HOSTNAME_OR_IP>: DNS-имя или IP-адрес Proxmox Backup Server.
• <DATA_DISK>: имя диска без /dev/, например sdb.
• <DATA_PARTITION>: путь к разделу, например /dev/sdb1.
• <DATASTORE_NAME>: имя datastore, например main-backup.
• <NAMESPACE_NAME>: имя пространства имен для одного хоста или клиента, например pve-node-01.
• <PBS_USER>: имя пользователя PBS, например pve-node-01.
• <TOKEN_NAME>: имя API-токена, например backup.
• <TOKEN_SECRET>: секрет API-токена, сгенерированный PBS.
• <STORAGE_ID>: storage ID в Proxmox VE, например pbs-main.

Шаг 1: Проверьте версию PBS и схему дисков

Войдите в shell Proxmox Backup Server как root.

Проверьте установленную версию PBS:

proxmox-backup-manager versions

Ожидаемый результат: команда выводит версии установленных пакетов Proxmox Backup Server.

Выведите список локальных дисков:

lsblk -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINTS,MODEL

Ожидаемый результат: вы можете определить системный диск и отдельный диск хранилища. Не используйте диск, на котором находится операционная система PBS.

Шаг 2: Настройте no-subscription репозиторий

Свежая установка PBS обычно включает enterprise-репозиторий. Используйте его только при наличии активной подписки Proxmox. Для лабораторной, оценочной или непроизводственной среды без подписки отключите enterprise-репозиторий и включите PBS no-subscription репозиторий.

Откройте файл enterprise-репозитория:

nano /etc/apt/sources.list.d/pbs-enterprise.sources

Отключите enterprise-репозиторий, добавив:

Enabled: false

Ожидаемый результат: APT больше не пытается использовать репозиторий, доступный только по подписке.

Создайте или отредактируйте файл репозитория Proxmox:

nano /etc/apt/sources.list.d/proxmox.sources

Добавьте PBS no-subscription репозиторий для установок PBS 4.x на базе Debian 13 Trixie:

Types: deb
URIs: http://download.proxmox.com/debian/pbs
Suites: trixie
Components: pbs-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

Обновите метаданные пакетов:

apt update

Ожидаемый результат: APT обновляет индексы пакетов без ошибок 401 Unauthorized от enterprise.proxmox.com.

Обновите установленные пакеты:

apt full-upgrade

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

reboot

Шаг 3: Подготовьте отдельный диск для datastore

PBS хранит данные datastore внутри каталога на поддерживаемой файловой системе Linux. Используйте ext4, xfs или zfs для хранилища datastore. Выберите одну из следующих схем хранения.

Вариант A: Создайте директорию datastore на XFS или ext4

Используйте этот вариант для простого datastore на одном диске. XFS является хорошим вариантом по умолчанию для больших наборов резервных копий. ext4 также поддерживается, если в ней используются обычные настройки directory links.

Удалите старые сигнатуры с диска:

apt install parted
wipefs -a /dev/<DATA_DISK>

Создайте новую таблицу разделов GPT и один раздел:

parted -s /dev/<DATA_DISK> \
  mklabel gpt \
  mkpart primary 1MiB 100%

Ожидаемый результат: на диске есть один новый раздел.

Обновите таблицу разделов в ядре:

partprobe /dev/<DATA_DISK>

Отформатируйте раздел в XFS:

mkfs.xfs -f <DATA_PARTITION>

Используйте ext4 вместо XFS только если это ваш локальный стандарт:

mkfs.ext4 -F <DATA_PARTITION>

Создайте точку монтирования:

mkdir -p /mnt/datastore/<DATASTORE_NAME>

Получите UUID раздела:

blkid <DATA_PARTITION>

Ожидаемый вывод:

<DATA_PARTITION>: UUID="<FILESYSTEM_UUID>" BLOCK_SIZE="4096" TYPE="xfs"

Добавьте mount в /etc/fstab:

nano /etc/fstab

Для XFS добавьте эту строку:

UUID=<FILESYSTEM_UUID> /mnt/datastore/<DATASTORE_NAME> xfs defaults,noatime 0 2

Для ext4 добавьте эту строку:

UUID=<FILESYSTEM_UUID> /mnt/datastore/<DATASTORE_NAME> ext4 defaults,noatime 0 2

Смонтируйте путь datastore:

systemctl daemon-reload
mount -a

Проверьте mount:

df -h /mnt/datastore/<DATASTORE_NAME>

Ожидаемый результат: команда показывает новый диск, смонтированный в /mnt/datastore/<DATASTORE_NAME>.

Вариант B: Создайте datastore на LVM

Используйте этот вариант, если вам нужно управление логическими томами для диска datastore.

Удалите старые сигнатуры с диска:

wipefs -a /dev/<DATA_DISK>

Создайте physical volume, volume group и logical volume:

pvcreate /dev/<DATA_DISK>
vgcreate pbs-vg /dev/<DATA_DISK>
lvcreate -n <DATASTORE_NAME> -l 100%FREE pbs-vg

Ожидаемый результат: LVM создает /dev/pbs-vg/<DATASTORE_NAME>.

Отформатируйте logical volume в XFS:

mkfs.xfs -f /dev/pbs-vg/<DATASTORE_NAME>

Создайте точку монтирования:

mkdir -p /mnt/datastore/<DATASTORE_NAME>

Добавьте mount в /etc/fstab:

nano /etc/fstab

Добавьте эту строку:

/dev/pbs-vg/<DATASTORE_NAME> /mnt/datastore/<DATASTORE_NAME> xfs defaults,noatime 0 2

Смонтируйте путь datastore:

mount -a

Проверьте mount:

df -h /mnt/datastore/<DATASTORE_NAME>

Ожидаемый результат: logical volume смонтирован в /mnt/datastore/<DATASTORE_NAME>.

Вариант C: Создайте ZFS pool и datastore

Используйте этот вариант, если вам нужны возможности ZFS, такие как checksumming, snapshots, compression, mirrors или RAIDZ. ZFS лучше всего использовать с прямым доступом к дискам, а не поверх аппаратного RAID, который скрывает состояние дисков от операционной системы.

Удалите старые сигнатуры с диска:

wipefs -a /dev/<DATA_DISK>

Создайте однодисковый ZFS pool и добавьте его как PBS datastore:

proxmox-backup-manager disk zpool create <DATASTORE_NAME> \
  --devices <DATA_DISK> \
  --raidlevel single \
  --compression lz4 \
  --add-datastore true

Ожидаемый результат: PBS создает ZFS pool и регистрирует datastore с тем же именем.

Проверьте pool:

zpool status <DATASTORE_NAME>

Ожидаемый результат: pool находится в состоянии online, а диск отображается внутри него.

Если вы использовали этот вариант ZFS с --add-datastore true, пропустите шаг 4 и перейдите к шагу 5.

Шаг 4: Создайте PBS datastore

Задайте владельца каталога datastore для backup-сервисов PBS:

chown backup:backup /mnt/datastore/<DATASTORE_NAME>
chmod 750 /mnt/datastore/<DATASTORE_NAME>

Создайте конфигурацию datastore:

proxmox-backup-manager datastore create \
  <DATASTORE_NAME> \
  /mnt/datastore/<DATASTORE_NAME>

Ожидаемый результат: PBS регистрирует каталог как datastore.

Выведите список datastore:

proxmox-backup-manager datastore list

Ожидаемый результат: <DATASTORE_NAME> появляется в списке datastore.

Покажите сведения о datastore:

proxmox-backup-manager datastore show <DATASTORE_NAME>

Ожидаемый результат: PBS показывает путь datastore и текущие параметры datastore.

Шаг 5: Настройте prune, garbage collection и verification

Настройте retention и garbage collection после создания datastore. Prune удаляет устаревшие backup indexes согласно правилам хранения. Garbage collection удаляет неиспользуемые chunks после того, как prune сделает их неиспользуемыми.

Настройте базовый retention, ежедневный prune, garbage collection и verification для новых резервных копий:

proxmox-backup-manager datastore update <DATASTORE_NAME> \
  --gc-schedule 'Sun 03:00' \
  --verify-new true

proxmox-backup-manager prune-job create prune-<DATASTORE_NAME> \
  --store <DATASTORE_NAME> \
  --schedule daily \
  --keep-daily 7 \
  --keep-weekly 4 \
  --keep-monthly 6 \
  --comment 'Default retention for <DATASTORE_NAME>'

Ожидаемый результат: PBS сохраняет политику retention для datastore и планирует cleanup tasks.

Покажите обновленную конфигурацию datastore:

proxmox-backup-manager datastore show <DATASTORE_NAME>

Ожидаемый результат: вывод содержит настройки prune, garbage collection и retention.

Шаг 6: Настройте SMTP-уведомления

Настройте уведомления до того, как начнете полагаться на backup-сервер. Это поможет вам обнаруживать failed backups, ошибки garbage collection, verification failures и доступные обновления пакетов.

В веб-интерфейсе PBS откройте Configuration > Notifications.

Создайте notification target:

1. Нажмите Add.
2. Выберите SMTP.
3. Введите имя target, например smtp-main.
4. Укажите SMTP-сервер, порт, username, password, encryption mode, sender address и recipient address.
5. Сохраните target.

Ожидаемый результат: PBS сохраняет SMTP notification target.

Создайте matcher для важных событий PBS:

1. Откройте Configuration > Notifications > Notification Matchers.
2. Создайте matcher с именем admin-mail.
3. Выберите созданный SMTP target.
4. Настройте match для событий datastore, system, verification, garbage collection и package update.
5. Сохраните matcher.

Ожидаемый результат: PBS направляет подходящие уведомления в SMTP target.

Отправьте тестовое уведомление из notification target, если веб-интерфейс предлагает тестовое действие.

Ожидаемый результат: почтовый ящик получателя получает тестовое email-сообщение от PBS.

Шаг 7: Создайте пользователей и API-токены для backup-клиентов

Используйте отдельного пользователя PBS и API-токен для каждого хоста Proxmox VE, кластера Proxmox VE или standalone backup-клиента. Это упрощает ротацию учетных данных и позволяет задавать узкие права для каждого namespace.

Создайте пользователя PBS для одного хоста или клиента:

proxmox-backup-manager user create <PBS_USER>@pbs \
  --comment "Backup identity for <NAMESPACE_NAME>"

Ожидаемый результат: PBS создает учетную запись пользователя. Установите пароль в веб-интерфейсе в Configuration > Access Control > User Management, если пользователю нужен интерактивный вход.

Сгенерируйте API-токен:

proxmox-backup-manager user generate-token \
  <PBS_USER>@pbs \
  <TOKEN_NAME> \
  --comment "Backup token for <NAMESPACE_NAME>"

Вы также можете сгенерировать токен в веб-интерфейсе под пунктом Configuration > Access Control > API Token.

Ожидаемый результат: PBS выводит секрет API-токена один раз. Сразу скопируйте его и сохраните в безопасном месте. Позже получить тот же секрет повторно нельзя.

Шаг 8: Создайте namespace для каждого хоста или клиента

PBS namespaces организуют backup groups внутри одного datastore. Используйте отдельный namespace для каждого хоста Proxmox VE, кластера Proxmox VE или standalone-клиента вместо создания папок внутри datastore.

Создайте namespace для одного хоста или клиента:

proxmox-backup-client namespace create <NAMESPACE_NAME> \
  --repository root@pam@localhost:<DATASTORE_NAME>

Ожидаемый результат: PBS создает namespace внутри <DATASTORE_NAME>.

Выведите список namespaces:

proxmox-backup-client namespace list \
  --repository root@pam@localhost:<DATASTORE_NAME>

Ожидаемый результат: вывод содержит <NAMESPACE_NAME>.

Создайте дополнительные namespaces для других хостов или клиентов:

proxmox-backup-client namespace create pve-node-02 \
  --repository root@pam@localhost:<DATASTORE_NAME>

proxmox-backup-client namespace create linux-client-01 \
  --repository root@pam@localhost:<DATASTORE_NAME>

Ожидаемый результат: у каждого хоста или клиента есть отдельный namespace в одном datastore.

Шаг 9: Предоставьте каждому клиенту доступ только к его namespace

Предоставьте API-токену доступ только к его собственному namespace path. Формат ACL path: /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME>.

Предоставьте backup access токену:

proxmox-backup-manager acl update \
  /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME> \
  DatastoreBackup \
  --auth-id '<PBS_USER>@pbs'

proxmox-backup-manager acl update \
  /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME> \
  DatastoreBackup \
  --auth-id '<PBS_USER>@pbs!<TOKEN_NAME>'

Ожидаемый результат: токен может создавать резервные копии и восстанавливать принадлежащие ему резервные копии в этом namespace, но не может управлять всем datastore.

Выведите ACL entries:

proxmox-backup-manager acl list

Ожидаемый результат: список ACL содержит токен и namespace-specific path.

Шаг 10: Подключите хост Proxmox VE к namespace

На хосте Proxmox VE добавьте PBS storage через веб-интерфейс или с помощью pvesm.

Чтобы использовать веб-интерфейс, откройте Datacenter > Storage > Add > Proxmox Backup Server и введите эти значения:

• ID: <STORAGE_ID>.
• Server: <PBS_HOSTNAME_OR_IP>.
• Datastore: <DATASTORE_NAME>.
• Namespace: <NAMESPACE_NAME>.
• Username: <PBS_USER>@pbs!<TOKEN_NAME>.
• Password: <TOKEN_SECRET>.
• Fingerprint: отпечаток сертификата PBS, если интерфейс его запрашивает.

Ожидаемый результат: Proxmox VE добавляет namespace PBS datastore как backup storage.

Чтобы использовать командную строку на хосте Proxmox VE, добавьте storage:

pvesm add pbs <STORAGE_ID> \
  --server <PBS_HOSTNAME_OR_IP> \
  --datastore <DATASTORE_NAME> \
  --namespace <NAMESPACE_NAME> \
  --username '<PBS_USER>@pbs!<TOKEN_NAME>' \
  --password '<TOKEN_SECRET>'

Ожидаемый результат: Proxmox VE создает storage entry, указывающую на правильный PBS namespace.

Проверьте состояние storage:

pvesm status

Ожидаемый результат: <STORAGE_ID> отображается как доступный.

Шаг 11: Создайте тестовую резервную копию VM

На хосте Proxmox VE создайте небольшую тестовую резервную копию VM в PBS storage. Замените <VMID> на ID виртуальной машины или контейнера. Это подтверждает, что backup jobs Proxmox VE могут писать в namespace до того, как вы начнете полагаться на это storage для планирования disaster recovery Proxmox.

vzdump <VMID> \
  --storage <STORAGE_ID> \
  --mode snapshot

Ожидаемый результат: backup task завершается успешно и загружает backup data в namespace.

В веб-интерфейсе PBS откройте Datastore > <DATASTORE_NAME>. Выберите namespace <NAMESPACE_NAME>.

Ожидаемый результат: вы видите новую backup group и backup snapshot внутри namespace.

Шаг 12: Проверьте просмотр резервных копий и готовность к восстановлению

После завершения первой резервной копии проверьте, что PBS может просматривать VM backups внутри namespace. Это не полный restore test, но он проверяет организацию, которая позже поддерживает restore from backup PBS operations, Proxmox PBS restore procedures, Proxmox backup restore tasks и доступ к VM backup из правильного namespace.

В веб-интерфейсе PBS откройте Datastore > <DATASTORE_NAME>, выберите <NAMESPACE_NAME> и откройте backup group, созданную в шаге 11.

Ожидаемый результат: PBS показывает backup snapshots, сохраненные в namespace для этого хоста или клиента.

Выберите один backup snapshot и просмотрите доступные restore actions.

Ожидаемый результат: PBS показывает restore options, которые можно использовать позже для VM backup restore, restore from VM backup и data restoration Proxmox procedures.

Проверка

Проверьте, что datastore существует:

proxmox-backup-manager datastore list

Ожидаемый результат: <DATASTORE_NAME> появляется в списке datastore.

Проверьте mount:

findmnt /mnt/datastore/<DATASTORE_NAME>

Ожидаемый результат: путь datastore смонтирован с отдельного диска, logical volume или ZFS pool.

Проверьте доступ к namespace:

proxmox-backup-manager user permissions \
  '<PBS_USER>@pbs!<TOKEN_NAME>' \
  --path /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME>

Ожидаемый результат: токен имеет Datastore.Backup на своем namespace path.

Проверьте, что резервные копии отображаются в namespace:

proxmox-backup-client snapshots \
  --repository root@pam@localhost:<DATASTORE_NAME> \
  --ns <NAMESPACE_NAME>

Ожидаемый результат: команда выводит snapshots для выбранного namespace.

Проверьте, что вы можете просматривать VM backups в namespace через веб-интерфейс PBS.

Ожидаемый результат: вы можете открыть backup group и увидеть snapshots для выбранного хоста или клиента. Это подтверждает, что namespace готов для последующих workflows file-level restore, granular restore и restore individual files.

Выполните ручную проверку статуса garbage collection:

proxmox-backup-manager garbage-collection status <DATASTORE_NAME>

Ожидаемый результат: PBS выводит статус garbage collection для datastore.

Почему стоит использовать namespaces вместо отдельных datastore

Namespaces являются предпочтительным механизмом организации, когда несколько хостов или клиентов используют один общий физический backup storage pool.

Они дают следующие преимущества:

• Один общий chunk store для лучшей дедупликации между похожими виртуальными машинами и хостами.
• Одно место для настройки политик retention, verification и garbage collection.
• Четкое разделение в веб-интерфейсе PBS без неподдерживаемых ручных папок.
• Namespace-specific ACL paths для клиентского доступа по принципу least privilege.
• Простое масштабирование при добавлении новых хостов Proxmox VE или Linux-клиентов.
• Меньше объектов datastore для мониторинга и обслуживания.

Используйте отдельные datastore, когда вам нужно отдельное физическое хранилище, разные backup media, разные performance tiers, разные административные владельцы или строгое разделение расписаний retention и garbage collection.

Откат изменений

Чтобы удалить один namespace ACL у токена, используйте веб-интерфейс PBS в Configuration > Access Control > Permissions и удалите ACL entry для /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME>.

Чтобы удалить API-токен:

proxmox-backup-manager user delete-token <PBS_USER>@pbs <TOKEN_NAME>

Ожидаемый результат: PBS отзывает токен.

Чтобы удалить пользователя PBS:

proxmox-backup-manager user remove <PBS_USER>@pbs

Ожидаемый результат: PBS удаляет учетную запись пользователя.

Чтобы удалить конфигурацию datastore без удаления backup data:

proxmox-backup-manager datastore remove <DATASTORE_NAME>

Ожидаемый результат: PBS удаляет datastore из своей конфигурации, но underlying directory остается на диске.

Чтобы удалить mount для datastore на базе XFS, ext4 или LVM, отредактируйте /etc/fstab, удалите строку datastore и размонтируйте путь:

umount /mnt/datastore/<DATASTORE_NAME>

Ожидаемый результат: путь datastore больше не смонтирован.

Чтобы удалить ZFS pool после удаления или миграции всех нужных резервных копий:

zpool export <DATASTORE_NAME>

Ожидаемый результат: ZFS экспортирует pool. Позже его можно импортировать с помощью zpool import <DATASTORE_NAME>, если это потребуется.

Устранение неполадок

APT показывает 401 Unauthorized для enterprise-репозитория

Причина: enterprise-репозиторий включен без действующей подписки.
Исправление: отключите /etc/apt/sources.list.d/pbs-enterprise.sources с помощью Enabled: false, добавьте no-subscription репозиторий и снова выполните apt update.

Создание datastore завершается ошибкой на неподдерживаемой файловой системе

Причина: путь datastore находится на файловой системе, которая не поддерживает требуемую структуру каталогов, или файловая система была создана с несовместимыми параметрами.
Исправление: используйте xfs, ext4 или zfs. Избегайте ext3 и избегайте конфигураций ext4 с отключенным dir_nlink.

Mount datastore исчезает после перезагрузки

Причина: /etc/fstab отсутствует, содержит неправильный UUID или указывает на неправильное устройство.
Исправление: выполните blkid <DATA_PARTITION>, исправьте UUID в /etc/fstab, затем выполните mount -a.

Клиент видит неправильный namespace

Причина: клиентская storage configuration использует неправильный namespace или имеет ACLs на корне datastore.
Исправление: удалите broad ACLs с /datastore/<DATASTORE_NAME>, предоставьте права только на /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME> и подтвердите, что storage entry Proxmox VE использует правильный namespace.

Тестовое SMTP-письмо не приходит

Причина: SMTP authentication, TLS settings, sender policy или firewall rules настроены неправильно.
Исправление: проверьте SMTP host, port, encryption mode, username, password, sender address, recipient address и outbound network access с PBS.

Резервное копирование работает, но garbage collection не освобождает место сразу

Причина: garbage collection удаляет только chunks, на которые больше нет ссылок после того, как prune удалил backup indexes. PBS также сохраняет safety windows, чтобы не удалить chunks, которые все еще могут использоваться.
Исправление: проверьте настройки prune, запустите garbage collection или дождитесь его выполнения и просмотрите task logs datastore.

Заключение и следующие шаги

Вы настроили Proxmox Backup Server для первоначального production-style использования: обновления направляются через правильный репозиторий, уведомления используют SMTP, backup storage находится на отдельном диске, а несколько хостов разделены с помощью namespaces и namespace-specific ACLs. Такая структура сохраняет один эффективный PBS datastore и при этом дает каждому хосту Proxmox VE или клиенту собственную контролируемую backup area.

В качестве следующих шагов настройте scheduled backup jobs на каждом хосте Proxmox VE, добавьте verification jobs для сохраненных резервных копий, задокументируйте процесс granular restore и restore individual files, протестируйте file-level restore и полное восстановление VM, а также рассмотрите remote sync или tape backup для off-site protection.

Версия документа: 1.0
Последнее обновление: Май 2026
Владелец: Команда технической документации