PBS-Einrichtung & Datastore-Layout für mehrere Hosts

Einleitung

Proxmox Backup Server bietet zentralen, deduplizierten Backup-Speicher für Proxmox-VE-Nodes, Linux-Clients, virtuelle Maschinen, Container und Host-Backups. In diesem Tutorial schließen Sie die Ersteinrichtung von Proxmox Backup Server ab, erstellen einen PBS-Datastore auf einer separaten Festplatte, konfigurieren Updates und SMTP-Benachrichtigungen und organisieren Backups mehrerer Hosts mit Datastore-Namespaces statt mit manuellen Ordnern oder mehreren kleinen Datastores. Das resultierende Proxmox-PBS-Layout bereitet Ihre Umgebung außerdem auf spätere Aufgaben zur Wiederherstellung von Proxmox-Backups vor, darunter die Wiederherstellung von VM-Backups, die Wiederherstellung auf Dateiebene, die granulare Wiederherstellung und Workflows zur Datenwiederherstellung mit Proxmox.

Zielgruppe: Systemadministratoren mit mittleren Vorkenntnissen.
Geschätzte Dauer: 45 bis 75 Minuten.
Ziel: Am Ende dieses Tutorials verfügen Sie über einen Proxmox-Backup-Server-Datastore auf dediziertem Speicher, konfigurierte Update-Repositories, aktivierte E-Mail-Benachrichtigungen und eine per ACLs gesteuerte Namespace-Zugriffskontrolle pro Host.

Voraussetzungen

Stellen Sie vor dem Start sicher, dass Folgendes vorhanden ist:

• Proxmox Backup Server 4.x ist installiert und über die Weboberfläche unter https://<PBS_HOSTNAME_OR_IP>:8007 erreichbar.
• Root-Zugriff oder gleichwertiger administrativer Zugriff auf den Proxmox-Backup-Server-Host.
• Eine separate Festplatte für den Backup-Speicher, bezeichnet als <DATA_DISK>, zum Beispiel sdb oder nvme1n1.
• Netzwerkverbindung von jedem Proxmox-VE-Host oder Backup-Client zum PBS-Host über TCP-Port 8007.
• SMTP-Serverdaten für Benachrichtigungen, einschließlich Host, Port, Absenderadresse, Authentifizierungsbenutzer und Passwort oder App-Passwort.
• Ein oder mehrere Proxmox-VE-Hosts oder Backup-Clients, die den PBS-Datastore verwenden werden.

In diesem Tutorial werden folgende Platzhalter verwendet:

• <PBS_HOSTNAME_OR_IP>: DNS-Name oder IP-Adresse des Proxmox Backup Servers.
• <DATA_DISK>: Festplattenname ohne /dev/, zum Beispiel sdb.
• <DATA_PARTITION>: Partitionspfad, zum Beispiel /dev/sdb1.
• <DATASTORE_NAME>: Datastore-Name, zum Beispiel main-backup.
• <NAMESPACE_NAME>: Namespace-Name für einen Host oder Client, zum Beispiel pve-node-01.
• <PBS_USER>: PBS-Benutzername, zum Beispiel pve-node-01.
• <TOKEN_NAME>: Name des API-Tokens, zum Beispiel backup.
• <TOKEN_SECRET>: Von PBS erzeugtes Geheimnis des API-Tokens.
• <STORAGE_ID>: Proxmox-VE-Speicher-ID, zum Beispiel pbs-main.

Schritt 1: PBS-Version und Festplattenlayout prüfen

Melden Sie sich als root an der Shell des Proxmox Backup Servers an.

Prüfen Sie die installierte PBS-Version:

proxmox-backup-manager versions

Erwartetes Ergebnis: Der Befehl gibt die installierten Paketversionen von Proxmox Backup Server aus.

Listen Sie die lokalen Festplatten auf:

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

Erwartetes Ergebnis: Sie können die Systemfestplatte und die separate Speicherfestplatte identifizieren. Verwenden Sie nicht die Festplatte, die das PBS-Betriebssystem enthält.

Schritt 2: No-Subscription-Repository konfigurieren

Eine frische PBS-Installation aktiviert in der Regel das Enterprise-Repository. Verwenden Sie es nur, wenn Sie über ein aktives Proxmox-Abonnement verfügen. Deaktivieren Sie für ein Labor, eine Evaluierung oder eine Nicht-Produktionsumgebung ohne Abonnement das Enterprise-Repository und aktivieren Sie das PBS-No-Subscription-Repository.

Öffnen Sie die Datei des Enterprise-Repositorys:

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

Deaktivieren Sie das Enterprise-Repository, indem Sie Folgendes hinzufügen:

Enabled: false

Erwartetes Ergebnis: APT versucht nicht mehr, das nur mit Abonnement nutzbare Repository zu verwenden.

Erstellen oder bearbeiten Sie die Proxmox-Repository-Datei:

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

Fügen Sie das PBS-No-Subscription-Repository für PBS-4.x-Installationen auf Basis von Debian 13 Trixie hinzu:

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

Aktualisieren Sie die Paketmetadaten:

apt update

Erwartetes Ergebnis: APT aktualisiert die Paketindizes ohne Fehler 401 Unauthorized von enterprise.proxmox.com.

Aktualisieren Sie die installierten Pakete:

apt full-upgrade

Erwartetes Ergebnis: PBS installiert verfügbare Updates aus den konfigurierten Repositories. Starten Sie neu, wenn das Upgrade einen neuen Kernel oder kritische Systempakete installiert.

reboot

Schritt 3: Separate Festplatte für den Datastore vorbereiten

PBS speichert Datastore-Daten in einem Verzeichnis auf einem unterstützten Linux-Dateisystem. Verwenden Sie für den Datastore-Speicher ext4, xfs oder zfs. Wählen Sie eines der folgenden Speicherlayouts.

Option A: Verzeichnis-Datastore auf XFS oder ext4 erstellen

Verwenden Sie diese Option für einen einfachen Datastore auf einer einzelnen Festplatte. XFS ist eine gute Standardwahl für große Backup-Datenbestände. ext4 wird ebenfalls unterstützt, sofern es normale Einstellungen für Verzeichnis-Links verwendet.

Entfernen Sie alte Signaturen von der Festplatte:

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

Erstellen Sie eine neue GPT-Partitionstabelle und eine Partition:

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

Erwartetes Ergebnis: Die Festplatte besitzt eine neue Partition.

Aktualisieren Sie die Partitionstabelle des Kernels:

partprobe /dev/<DATA_DISK>

Formatieren Sie die Partition mit XFS:

mkfs.xfs -f <DATA_PARTITION>

Verwenden Sie ext4 anstelle von XFS nur, wenn dies Ihrem lokalen Standard entspricht:

mkfs.ext4 -F <DATA_PARTITION>

Erstellen Sie den Einhängepunkt:

mkdir -p /mnt/datastore/<DATASTORE_NAME>

Ermitteln Sie die UUID der Partition:

blkid <DATA_PARTITION>

Erwartete Ausgabe:

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

Tragen Sie das Einhängen in /etc/fstab ein:

nano /etc/fstab

Fügen Sie für XFS diese Zeile hinzu:

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

Fügen Sie für ext4 diese Zeile hinzu:

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

Hängen Sie den Datastore-Pfad ein:

systemctl daemon-reload
mount -a

Überprüfen Sie das Einhängen:

df -h /mnt/datastore/<DATASTORE_NAME>

Erwartetes Ergebnis: Der Befehl zeigt die neue Festplatte, eingehängt unter /mnt/datastore/<DATASTORE_NAME>.

Option B: Datastore auf LVM erstellen

Verwenden Sie diese Option, wenn Sie für die Datastore-Festplatte eine Verwaltung über Logical Volumes wünschen.

Entfernen Sie alte Signaturen von der Festplatte:

wipefs -a /dev/<DATA_DISK>

Erstellen Sie ein Physical Volume, eine Volume-Gruppe und ein Logical Volume:

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

Erwartetes Ergebnis: LVM erstellt /dev/pbs-vg/<DATASTORE_NAME>.

Formatieren Sie das Logical Volume mit XFS:

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

Erstellen Sie den Einhängepunkt:

mkdir -p /mnt/datastore/<DATASTORE_NAME>

Tragen Sie das Einhängen in /etc/fstab ein:

nano /etc/fstab

Fügen Sie diese Zeile hinzu:

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

Hängen Sie den Datastore-Pfad ein:

mount -a

Überprüfen Sie das Einhängen:

df -h /mnt/datastore/<DATASTORE_NAME>

Erwartetes Ergebnis: Das Logical Volume ist unter /mnt/datastore/<DATASTORE_NAME> eingehängt.

Option C: ZFS-Pool und Datastore erstellen

Verwenden Sie diese Option, wenn Sie ZFS-Funktionen wie Prüfsummen, Snapshots, Kompression, Mirrors oder RAIDZ benötigen. ZFS sollte am besten mit direktem Festplattenzugriff betrieben werden, nicht auf Hardware-RAID, das den Zustand der Festplatten vor dem Betriebssystem verbirgt.

Entfernen Sie alte Signaturen von der Festplatte:

wipefs -a /dev/<DATA_DISK>

Erstellen Sie einen ZFS-Pool mit einer einzelnen Festplatte und fügen Sie ihn als PBS-Datastore hinzu:

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

Erwartetes Ergebnis: PBS erstellt einen ZFS-Pool und registriert einen Datastore mit demselben Namen.

Überprüfen Sie den Pool:

zpool status <DATASTORE_NAME>

Erwartetes Ergebnis: Der Pool ist online und die Festplatte wird darunter angezeigt.

Wenn Sie diese ZFS-Option mit --add-datastore true verwendet haben, überspringen Sie Schritt 4 und fahren Sie mit Schritt 5 fort.

Schritt 4: PBS-Datastore erstellen

Legen Sie den Besitzer des Datastore-Verzeichnisses für die PBS-Backup-Dienste fest:

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

Erstellen Sie die Datastore-Konfiguration:

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

Erwartetes Ergebnis: PBS registriert das Verzeichnis als Datastore.

Listen Sie die Datastores auf:

proxmox-backup-manager datastore list

Erwartetes Ergebnis: <DATASTORE_NAME> erscheint in der Datastore-Liste.

Zeigen Sie die Datastore-Details an:

proxmox-backup-manager datastore show <DATASTORE_NAME>

Erwartetes Ergebnis: PBS zeigt den Datastore-Pfad und die aktuellen Datastore-Optionen an.

Schritt 5: Prune, Garbage Collection und Verifizierung konfigurieren

Konfigurieren Sie Aufbewahrung (Retention) und Garbage Collection nach dem Erstellen des Datastores. Prune entfernt abgelaufene Backup-Indizes gemäß den Aufbewahrungsregeln. Die Garbage Collection entfernt nicht referenzierte Chunks, nachdem Prune sie unbenutzt gemacht hat.

Konfigurieren Sie grundlegende Aufbewahrung, tägliches Prune, Garbage Collection und die Verifizierung neuer Backups:

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>'

Erwartetes Ergebnis: PBS speichert die Aufbewahrungsrichtlinie des Datastores und plant Bereinigungsaufgaben.

Zeigen Sie die aktualisierte Datastore-Konfiguration an:

proxmox-backup-manager datastore show <DATASTORE_NAME>

Erwartetes Ergebnis: Die Ausgabe enthält Einstellungen für Prune, Garbage Collection und Aufbewahrung.

Schritt 6: SMTP-Benachrichtigungen konfigurieren

Konfigurieren Sie Benachrichtigungen, bevor Sie sich auf den Backup-Server verlassen. So erfahren Sie von fehlgeschlagenen Backups, Fehlern bei der Garbage Collection, Verifizierungsfehlern und verfügbaren Paket-Updates.

Öffnen Sie in der PBS-Weboberfläche Configuration > Notifications.

Erstellen Sie ein Benachrichtigungsziel:

1. Klicken Sie auf Add.
2. Wählen Sie SMTP.
3. Geben Sie einen Zielnamen ein, zum Beispiel smtp-main.
4. Legen Sie SMTP-Server, Port, Benutzername, Passwort, Verschlüsselungsmodus, Absenderadresse und Empfängeradresse fest.
5. Speichern Sie das Ziel.

Erwartetes Ergebnis: PBS speichert das SMTP-Benachrichtigungsziel.

Erstellen Sie einen Matcher für wichtige PBS-Ereignisse:

1. Öffnen Sie Configuration > Notifications > Notification Matchers.
2. Erstellen Sie einen Matcher mit dem Namen admin-mail.
3. Wählen Sie das zuvor erstellte SMTP-Ziel aus.
4. Erfassen Sie Ereignisse zu Datastore, System, Verifizierung, Garbage Collection und Paket-Updates.
5. Speichern Sie den Matcher.

Erwartetes Ergebnis: PBS leitet passende Benachrichtigungen an das SMTP-Ziel weiter.

Senden Sie eine Testbenachrichtigung über das Benachrichtigungsziel, sofern die Weboberfläche die Testaktion anbietet.

Erwartetes Ergebnis: Das Empfängerpostfach erhält eine Test-E-Mail von PBS.

Schritt 7: Benutzer und API-Tokens für Backup-Clients erstellen

Verwenden Sie für jeden Proxmox-VE-Host, jeden Proxmox-VE-Cluster und jeden eigenständigen Backup-Client einen eigenen PBS-Benutzer und ein eigenes API-Token. Das erleichtert die Rotation von Zugangsdaten und ermöglicht schmale Berechtigungen pro Namespace.

Erstellen Sie einen PBS-Benutzer für einen Host oder Client:

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

Erwartetes Ergebnis: PBS erstellt das Benutzerkonto. Legen Sie in der Weboberfläche unter Configuration > Access Control > User Management ein Passwort fest, wenn der Benutzer sich interaktiv anmelden soll.

Erzeugen Sie ein API-Token über die CLI:

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

Sie können das Token auch in der Weboberfläche unter Configuration > Access Control > API Token erzeugen.

Erwartetes Ergebnis: PBS gibt das Geheimnis des API-Tokens nur einmal aus. Kopieren Sie es sofort und bewahren Sie es sicher auf. Dasselbe Geheimnis lässt sich später nicht erneut abrufen.

Schritt 8: Für jeden Host oder Client einen Namespace erstellen

PBS-Namespaces organisieren Backup-Gruppen innerhalb eines Datastores. Verwenden Sie einen Namespace pro Proxmox-VE-Host, Proxmox-VE-Cluster oder eigenständigem Client, statt manuelle Ordner im Datastore-Pfad anzulegen.

Erstellen Sie einen Namespace für einen Host oder Client:

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

Erwartetes Ergebnis: PBS erstellt den Namespace innerhalb von <DATASTORE_NAME>.

Listen Sie die Namespaces auf:

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

Erwartetes Ergebnis: Die Ausgabe enthält <NAMESPACE_NAME>.

Erstellen Sie weitere Namespaces für andere Hosts oder Clients:

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>

Erwartetes Ergebnis: Jeder Host und jeder Client hat einen eigenen Namespace im selben Datastore.

Schritt 9: Jedem Client nur Zugriff auf seinen Namespace gewähren

Gewähren Sie dem API-Token nur Zugriff auf den Pfad seines eigenen Namespaces. Das Format des ACL-Pfads lautet /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME>.

Gewähren Sie dem Token Backup-Zugriff:

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>'

Erwartetes Ergebnis: Das Token kann in diesem Namespace Backups erstellen und die ihm gehörenden Backups wiederherstellen, aber nicht den gesamten Datastore verwalten.

Listen Sie die ACL-Einträge auf:

proxmox-backup-manager acl list

Erwartetes Ergebnis: Die ACL-Liste enthält das Token und den namespacespezifischen Pfad.

Schritt 10: Proxmox-VE-Host mit dem Namespace verbinden

Fügen Sie auf dem Proxmox-VE-Host den PBS-Speicher über die Weboberfläche oder mit pvesm hinzu.

Öffnen Sie für die Weboberfläche Datacenter > Storage > Add > Proxmox Backup Server und geben Sie diese Werte ein:

• ID: <STORAGE_ID>.
• Server: <PBS_HOSTNAME_OR_IP>.
• Datastore: <DATASTORE_NAME>.
• Namespace: <NAMESPACE_NAME>.
• Username: <PBS_USER>@pbs!<TOKEN_NAME>.
• Password: <TOKEN_SECRET>.
• Fingerprint: Fingerprint des PBS-Zertifikats, falls die Oberfläche danach fragt.

Erwartetes Ergebnis: Proxmox VE fügt den PBS-Datastore-Namespace als Backup-Speicher hinzu.

Fügen Sie den Speicher für die Kommandozeile auf dem Proxmox-VE-Host so hinzu:

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>'

Erwartetes Ergebnis: Proxmox VE erstellt einen Speichereintrag, der auf den richtigen PBS-Namespace verweist.

Prüfen Sie den Speicherstatus:

pvesm status

Erwartetes Ergebnis: <STORAGE_ID> wird als verfügbar angezeigt.

Schritt 11: Test-VM-Backup erstellen

Erstellen Sie auf dem Proxmox-VE-Host ein kleines Test-VM-Backup auf den PBS-Speicher. Ersetzen Sie <VMID> durch die ID einer virtuellen Maschine oder eines Containers. Dadurch wird bestätigt, dass Proxmox-VE-Backup-Jobs in den Namespace schreiben können, bevor Sie sich bei der Disaster-Recovery-Planung mit Proxmox auf den Speicher verlassen.

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

Erwartetes Ergebnis: Die Backup-Aufgabe wird erfolgreich abgeschlossen und lädt Backup-Daten in den Namespace hoch.

Öffnen Sie in der PBS-Weboberfläche Datastore > <DATASTORE_NAME>. Wählen Sie den Namespace <NAMESPACE_NAME> aus.

Erwartetes Ergebnis: Sie sehen die neue Backup-Gruppe und den neuen Backup-Snapshot im Namespace.

Schritt 12: Backup-Browsing und Wiederherstellungsbereitschaft bestätigen

Bestätigen Sie nach Abschluss des ersten Backups, dass PBS VM-Backups im Namespace durchsuchen kann. Dies ist kein vollständiger Wiederherstellungstest, aber es verifiziert die Organisation, die später Wiederherstellungsvorgänge aus Backups in PBS, Proxmox-PBS-Wiederherstellungsverfahren, Proxmox-Backup-Wiederherstellungsaufgaben und den Zugriff auf VM-Backups aus dem richtigen Namespace unterstützt.

Öffnen Sie in der PBS-Weboberfläche Datastore > <DATASTORE_NAME>, wählen Sie <NAMESPACE_NAME> aus und öffnen Sie die in Schritt 11 erstellte Backup-Gruppe.

Erwartetes Ergebnis: PBS zeigt die unter dem Namespace gespeicherten Backup-Snapshots für diesen Host oder Client an.

Wählen Sie einen Backup-Snapshot aus und prüfen Sie die verfügbaren Wiederherstellungsaktionen.

Erwartetes Ergebnis: PBS zeigt Wiederherstellungsoptionen an, die später für die Wiederherstellung von VM-Backups, die Wiederherstellung aus einem VM-Backup und Verfahren zur Datenwiederherstellung mit Proxmox genutzt werden können.

Überprüfung

Prüfen Sie, ob der Datastore existiert:

proxmox-backup-manager datastore list

Erwartetes Ergebnis: <DATASTORE_NAME> erscheint in der Datastore-Liste.

Überprüfen Sie das Einhängen:

findmnt /mnt/datastore/<DATASTORE_NAME>

Erwartetes Ergebnis: Der Datastore-Pfad ist von der separaten Festplatte, vom Logical Volume oder vom ZFS-Pool eingehängt.

Überprüfen Sie den Namespace-Zugriff:

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

Erwartetes Ergebnis: Das Token besitzt Datastore.Backup auf seinem Namespace-Pfad.

Prüfen Sie, ob Backups im Namespace erscheinen:

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

Erwartetes Ergebnis: Der Befehl listet die Snapshots des ausgewählten Namespaces auf.

Prüfen Sie, ob Sie VM-Backups im Namespace über die PBS-Weboberfläche durchsuchen können.

Erwartetes Ergebnis: Sie können die Backup-Gruppe öffnen und die Snapshots des ausgewählten Hosts oder Clients sehen. Damit ist bestätigt, dass der Namespace bereit ist für spätere Workflows zur Wiederherstellung auf Dateiebene, zur granularen Wiederherstellung und zur Wiederherstellung einzelner Dateien.

Führen Sie eine manuelle Statusprüfung der Garbage Collection durch:

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

Erwartetes Ergebnis: PBS gibt den Status der Garbage Collection für den Datastore aus.

Warum Namespaces statt separater Datastores verwenden

Namespaces sind der bevorzugte Organisationsmechanismus, wenn mehrere Hosts oder Clients einen physischen Backup-Speicherpool gemeinsam nutzen.

Sie bieten folgende Vorteile:

• Ein gemeinsamer Chunk-Store für bessere Deduplizierung über ähnliche virtuelle Maschinen und Hosts hinweg.
• Ein zentraler Ort zur Konfiguration von Aufbewahrungs-, Verifizierungs- und Garbage-Collection-Richtlinien.
• Klare Trennung in der PBS-Weboberfläche ohne nicht unterstützte manuelle Ordner.
• Namespacespezifische ACL-Pfade für Client-Zugriff nach dem Prinzip der minimalen Rechte.
• Einfachere Skalierung, wenn Sie weitere Proxmox-VE-Hosts oder Linux-Clients hinzufügen.
• Weniger Datastore-Objekte, die überwacht und gewartet werden müssen.

Verwenden Sie separate Datastores, wenn Sie getrennten physischen Speicher, unterschiedliche Backup-Medien, unterschiedliche Performance-Stufen, unterschiedliche administrative Zuständigkeiten oder eine strikte Trennung von Aufbewahrungs- und Garbage-Collection-Zeitplänen benötigen.

Änderungen rückgängig machen

Um den ACL-Eintrag eines Namespaces für ein Token zu entfernen, verwenden Sie die PBS-Weboberfläche unter Configuration > Access Control > Permissions und entfernen Sie den ACL-Eintrag für /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME>.

So löschen Sie ein API-Token:

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

Erwartetes Ergebnis: PBS widerruft das Token.

So entfernen Sie einen PBS-Benutzer:

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

Erwartetes Ergebnis: PBS entfernt das Benutzerkonto.

So entfernen Sie einen Prune-Job:

proxmox-backup-manager prune-job remove prune-<DATASTORE_NAME>

Erwartetes Ergebnis: PBS entfernt den Prune-Job.

So entfernen Sie eine Datastore-Konfiguration, ohne Backup-Daten zu löschen:

proxmox-backup-manager datastore remove <DATASTORE_NAME>

Erwartetes Ergebnis: PBS entfernt den Datastore aus seiner Konfiguration, das zugrunde liegende Verzeichnis bleibt jedoch auf der Festplatte erhalten.

Um das Einhängen eines Datastores auf Basis von XFS, ext4 oder LVM zu entfernen, bearbeiten Sie /etc/fstab, entfernen Sie die Datastore-Zeile und hängen Sie den Pfad aus:

umount /mnt/datastore/<DATASTORE_NAME>

Erwartetes Ergebnis: Der Datastore-Pfad ist nicht mehr eingehängt.

So entfernen Sie einen ZFS-Pool, nachdem alle benötigten Backups gelöscht oder migriert wurden:

zpool export <DATASTORE_NAME>

Erwartetes Ergebnis: ZFS exportiert den Pool. Importieren Sie ihn bei Bedarf später mit zpool import <DATASTORE_NAME>.

Fehlerbehebung

APT zeigt 401 Unauthorized für das Enterprise-Repository

Ursache: Das Enterprise-Repository ist ohne gültiges Abonnement aktiviert.
Lösung: Deaktivieren Sie /etc/apt/sources.list.d/pbs-enterprise.sources mit Enabled: false, fügen Sie das No-Subscription-Repository hinzu und führen Sie apt update erneut aus.

Die Datastore-Erstellung schlägt auf einem nicht unterstützten Dateisystem fehl

Ursache: Der Datastore-Pfad liegt auf einem Dateisystem, das das erforderliche Verzeichnislayout nicht unterstützt, oder das Dateisystem wurde mit inkompatiblen Optionen erstellt.
Lösung: Verwenden Sie xfs, ext4 oder zfs. Vermeiden Sie ext3 und ext4-Konfigurationen mit deaktiviertem dir_nlink.

Der Datastore-Einhängepunkt verschwindet nach einem Neustart

Ursache: /etc/fstab fehlt, enthält die falsche UUID oder verweist auf das falsche Gerät.
Lösung: Führen Sie blkid <DATA_PARTITION> aus, korrigieren Sie die UUID in /etc/fstab und führen Sie anschließend mount -a aus.

Ein Client sieht den falschen Namespace

Ursache: Die Speicherkonfiguration des Clients verwendet den falschen Namespace oder es bestehen ACLs auf der Datastore-Wurzel.
Lösung: Entfernen Sie breit gefasste ACLs von /datastore/<DATASTORE_NAME>, vergeben Sie Berechtigungen nur auf /datastore/<DATASTORE_NAME>/<NAMESPACE_NAME> und prüfen Sie, ob der Proxmox-VE-Speichereintrag den richtigen Namespace verwendet.

Die SMTP-Test-E-Mail kommt nicht an

Ursache: SMTP-Authentifizierung, TLS-Einstellungen, Absenderrichtlinie oder Firewall-Regeln sind falsch.
Lösung: Prüfen Sie SMTP-Host, Port, Verschlüsselungsmodus, Benutzername, Passwort, Absenderadresse, Empfängeradresse und den ausgehenden Netzwerkzugriff von PBS.

Backups funktionieren, aber die Garbage Collection gibt nicht sofort Speicherplatz frei

Ursache: Die Garbage Collection entfernt nur Chunks, die nicht mehr referenziert werden, nachdem Prune die Backup-Indizes entfernt hat. PBS hält außerdem Sicherheitsfenster ein, um Chunks nicht zu löschen, die möglicherweise noch verwendet werden.
Lösung: Prüfen Sie die Prune-Einstellungen, führen Sie die Garbage Collection aus oder warten Sie darauf, und sehen Sie sich die Task-Protokolle des Datastores an.

Fazit und nächste Schritte

Sie haben Proxmox Backup Server für den ersten produktionsnahen Einsatz konfiguriert: Updates laufen über das richtige Repository, Benachrichtigungen nutzen SMTP, der Backup-Speicher liegt auf einer separaten Festplatte, und mehrere Hosts sind durch Namespaces und namespacespezifische ACLs voneinander getrennt. Diese Struktur erhält einen effizienten PBS-Datastore und gibt zugleich jedem Proxmox-VE-Host und jedem Client einen eigenen, kontrollierten Backup-Bereich.

Als nächste Schritte konfigurieren Sie geplante Backup-Jobs auf jedem Proxmox-VE-Host, fügen Verifizierungs-Jobs für gespeicherte Backups hinzu, dokumentieren Ihren Prozess zur granularen Wiederherstellung und zur Wiederherstellung einzelner Dateien, testen die Wiederherstellung auf Dateiebene und vollständige VM-Wiederherstellungen und ziehen Remote Sync oder Tape-Backup für den externen Schutz in Betracht.

Dokumentversion: 1.0
Zuletzt aktualisiert: Mai 2026
Verantwortlich: Team für technische Dokumentation