mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
- BORG_RSH, the Borg SSH wizard and attached jobs match the code - Restore path classes name the right examples and when each path is written
231 lines
16 KiB
JSON
231 lines
16 KiB
JSON
{
|
|
"meta": {
|
|
"title": "Glossar - Backup & Restore | ProxMenux",
|
|
"description": "Begriffe des ProxMenux-Sicherungs- und Wiederherstellungssystems: Verschlüsselung, Schlüsseldatei, Passphrase, Wiederherstellungsumschlag, PBS, Chunks, rootfs, Manifest, Ausführungsprozess und Ergänzung zwischen Kernel-Versionen.",
|
|
"ogTitle": "Backup & Restore Glossar | ProxMenux",
|
|
"ogDescription": "Klare Definitionen für das Vokabular, das in der ProxMenux-Backup- und Wiederherstellungsdokumentation verwendet wird.",
|
|
"twitterTitle": "Backup & Restore Glossar | ProxMenux",
|
|
"twitterDescription": "Passphrase, Keyfile, Recovery-Umschlag, Rootfs, Manifest, PBS, Brocken — alle an einer Stelle definiert."
|
|
},
|
|
"header": {
|
|
"title": "Glossar",
|
|
"description": "Begriffe, die in der Backup- und Wiederherstellungsdokumentation mit ihrer Definition verwendet werden.",
|
|
"section": "Sicherung und Wiederherstellung"
|
|
},
|
|
"intro": {
|
|
"body": "Begriffe werden nach Themen gruppiert. Jeder Eintrag gibt den Begriff und eine kurze Definition."
|
|
},
|
|
"groups": [
|
|
{
|
|
"title": "Verschlüsselung und Key Recovery",
|
|
"intro": "Vokabular für den PBS-Verschlüsselungsblock. Es beinhaltet zwei verschiedene Geheimnisse: eine binäre Schlüsseldatei und eine geschriebene Passphrase.",
|
|
"entries": [
|
|
{
|
|
"id": "passphrase-recuperacion",
|
|
"term": "Wiederherstellungspassphrase",
|
|
"def": "Textkennwort, das der Benutzer auswählt, um den <a href=\"#sobre-recuperacion\">Wiederherstellungsumschlag </a> zu schützen. Es wird zweimal mit einer Übereinstimmungsprüfung aufgefordert und wird nur verwendet, um den Umschlag zu verschlüsseln und zu entschlüsseln, wenn die Schlüsseldatei jemals wiederhergestellt werden muss. <strong>Es ist nicht die Passphrase, die die Schlüsseldatei selbst entsperrt</strong> und wird niemals an PBS gesendet. Während eines normalen Backups verlässt es niemals den Host."
|
|
},
|
|
{
|
|
"id": "clave-cifrado",
|
|
"term": "Keyfile (Verschlüsselungsschlüssel)",
|
|
"def": "Schlüsseldatei, mit der proxmox-backup-client die <a href=\"#chunk\">Chunks</a> vor dem Hochladen zu PBS verschlüsselt. Ohne passenden Schlüssel sind verschlüsselte Daten nicht lesbar. ProxMenux speichert sie unter <code>/usr/local/share/proxmenux/pbs-key.conf</code> mit Modus <code>600</code>. Schützen Sie sie; der <a href=\"#sobre-recuperacion\">Wiederherstellungsumschlag</a> dient ihrer Wiederherstellung bei Verlust."
|
|
},
|
|
{
|
|
"id": "contrasena-keyfile",
|
|
"term": "Keyfile Passphrase (KDF Passphrase)",
|
|
"def": "Optionale Passphrase, die die Keyfile selbst tragen kann, im Unterschied zur <a href=\"#passphrase-recuperacion\">Recovery Passphrase</a>. Es existiert nur, wenn die Keyfile mit <code>--kdf scrypt</code> erstellt wurde (normalerweise eine importierte Keyfile). Ohne sie kann die Keyfile nicht für die Verwendung entsperrt werden. ProxMenux behält es in verschlüsselter Form auf dem Host, so dass geplante Backups ohne interaktive Eingabeaufforderung ausgeführt werden können."
|
|
},
|
|
{
|
|
"id": "sobre-recuperacion",
|
|
"term": "Wiederherstellungsumschlag",
|
|
"def": "Das <a href=\"#clave-cifrado\">keyfile</a> ist in eine zusätzliche Schicht eingewickelt: Es ist mit der <a href=\"#passphrase-recuperacion\">Wiederherstellungspassphrase</a> unter Verwendung von <a href=\"#aes-256-cbc\">AES-256-CBC</a> und <a href=\"#pbkdf2\">PBKDF2</a> verschlüsselt, bevor es den Host verlässt. Es wird auf PBS als <code>-keyrecovery</code>-Gruppe hochgeladen. Ohne die Passphrase ist der Umschlag undurchsichtig: Wenn Sie ihn von PBS herunterladen, wird die Schlüsseldatei nicht angezeigt."
|
|
},
|
|
{
|
|
"id": "cifrado-cliente",
|
|
"term": "Clientseitige Verschlüsselung",
|
|
"def": "Verschlüsselungsmodell, bei dem Daten auf dem Quellhost verschlüsselt werden, bevor sie hochgeladen werden. PBS empfängt und speichert immer nur Geheimtext; nicht einmal ein PBS-Administrator mit Datenspeicherzugriff kann ihn ohne die Schlüsseldatei lesen. ProxMenux baut auf diesem Modell auf und fügt den <a href=\"#sobre-recuperacion\">Wiederherstellungsumschlag</a> hinzu."
|
|
},
|
|
{
|
|
"id": "kdf-none",
|
|
"term": "--kdf none",
|
|
"def": "Option auf <code>proxmox-backup-client key create</code>, die eine Schlüsseldatei ohne angehängte Passphrase erzeugt. Die Keyfile kann direkt ohne Aufforderung verwendet werden, was für geplante Aufträge, die unbeaufsichtigt ausgeführt werden, unerlässlich ist. Dies ist, was ProxMenux standardmäßig verwendet, wenn eine neue Keyfile erzeugt wird."
|
|
},
|
|
{
|
|
"id": "kdf-scrypt",
|
|
"term": "--kdf scrypt",
|
|
"def": "Option auf <code>proxmox-backup-client key create</code>, die eine Schlüsseldatei erzeugt, die durch eine <a href=\"#contrasena-keyfile\">keyfile-Passphrase</a> geschützt ist. Jede Verwendung der Keyfile erfordert das Entsperren mit dieser Passphrase. ProxMenux akzeptiert diese Art von Keyfile beim Import und speichert die Passphrase verschlüsselt, so dass geplante Backups immer noch unbeaufsichtigt ausgeführt werden können."
|
|
},
|
|
{
|
|
"id": "aes-256-cbc",
|
|
"term": "AES-256-CBC",
|
|
"def": "Standardsymmetrische Chiffre. ProxMenux verwendet es (über <code>openssl enc -aes-256-cbc</code>), um die <a href=\"#clave-cifrado\">Schlüsseldatei</a> mit der <a href=\"#passphrase-recuperacion\">Wiederherstellungspassphrase</a> zu wickeln und die <a href=\"#sobre-recuperacion\">Umschlag</a> zu produzieren."
|
|
},
|
|
{
|
|
"id": "pbkdf2",
|
|
"term": "PBKDF2",
|
|
"def": "Kryptografische Funktion, die eine vom Menschen typisierte Passphrase in einen für die Verschlüsselung geeigneten binären Schlüssel verwandelt. Es verlangsamt Brute-Force-Versuche, indem es viele Iterationen anwendet. ProxMenux verwendet es mit 600 000 Iterationen und einem Zufallssalz bei der Verschlüsselung des Recovery-Umschlags."
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Backup-Struktur",
|
|
"intro": "Begriffe, die beschreiben, was sich in einem Backup befindet, unabhängig vom Zielort.",
|
|
"entries": [
|
|
{
|
|
"id": "rootfs",
|
|
"term": "rootfs / Root-Dateisystem",
|
|
"def": "Dateibasierte Kopie des Dateisystems des Quellhosts, erstellt mit <code>rsync</code> nach dem <a href=\"#perfil-defecto\">Standardprofil</a> und zusätzlichen <a href=\"#rutas-personalizadas\">eigenen Pfaden</a>. Kein vollständiges Datenträgerabbild: Kopiert werden nur Pfade mit Konfiguration oder Zustand, die Proxmox nicht selbst wiederherstellen kann."
|
|
},
|
|
{
|
|
"id": "manifiesto",
|
|
"term": "Manifest (manifest.json)",
|
|
"def": "Strukturiertes JSON-Dokument zur Beschreibung des Quell-Hosts zum Backup-Zeitpunkt: Hardware, Storage, Kernel, ProxMenux-installierte Komponenten und Inventar von VMs und LXCs. Es wird von sechs unabhängigen Erfassungsroutinen produziert. Der Wiederherstellungsfluss verwendet ihn, um Quelle und Ziel zu vergleichen."
|
|
},
|
|
{
|
|
"id": "staging",
|
|
"term": "Stagingverzeichnis",
|
|
"def": "Temporäres Verzeichnis, in dem ProxMenux die drei Blöcke (rootfs, Metadaten und Manifest) zusammenstellt, bevor sie verpackt und zum Zielort hochgeladen werden. Es wird automatisch entfernt, wenn das Backup beendet ist, auch bei Abbruch."
|
|
},
|
|
{
|
|
"id": "perfil-defecto",
|
|
"term": "Standardprofil",
|
|
"def": "Kuratierte Reihe von Pfaden, die ProxMenux standardmäßig in jedem Backup kopiert. Umfasst PVE-Konfiguration, Netzwerk, SSH, Kernel, apt, ProxMenux Tools und mehr. Es ist im Code definiert und auf der Seite <em>Wie es funktioniert</em> dokumentiert."
|
|
},
|
|
{
|
|
"id": "rutas-personalizadas",
|
|
"term": "Benutzerdefinierte Pfade",
|
|
"def": "Zusätzliche Pfade, die der Benutzer zusätzlich zum <a href=\"#perfil-defecto\">default-Profil</a> hinzufügt. Entweder persistent (gespeichert in <code>backup-extra-paths.txt</code>) oder per Run (im Custom-Modus ausgewählt)."
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Ziele und Speicher",
|
|
"intro": "Begriffe, die an den Ort gebunden sind, an dem das Backup landet - PBS-Server, lokales Archiv oder Borg-Repository - und wie PBS die Daten organisiert.",
|
|
"entries": [
|
|
{
|
|
"id": "repositorio-pbs",
|
|
"term": "PBS-Repository",
|
|
"def": "Kombination von Proxmox Backup Server + <a href=\"#datastore\">datastore</a> + Benutzer, der das Backup erhält. Identifiziert durch den String <code>user@realm@host:datastore</code>. Ein einzelner PBS-Server kann mehrere Repositories hosten."
|
|
},
|
|
{
|
|
"id": "datastore",
|
|
"term": "Datenspeicher",
|
|
"def": "Konkreter Datenspeicher auf einem PBS-Server für Sicherungen und ihre Chunks. Er liegt auf einem Dateisystem des PBS-Servers und besitzt eigene Berechtigungen und Richtlinien."
|
|
},
|
|
{
|
|
"id": "chunk",
|
|
"term": "Chunk/Chunk-Deduplizierung",
|
|
"def": "PBS teilt jedes Backup in Blöcke variabler Größe auf, identifiziert jedes Stück durch seinen Hash und speichert jedes Stück nur einmal, auch wenn es in vielen verschiedenen Backups erscheint. Dies bedeutet, dass aufeinanderfolgende Backups desselben Hosts - oder über ähnliche Hosts - sehr wenig zusätzlichen Speicherplatz benötigen."
|
|
},
|
|
{
|
|
"id": "fingerprint",
|
|
"term": "Fingerabdruck",
|
|
"def": "Kryptografischer Fingerabdruck des PBS-Servers TLS Zertifikat. Der Client kann überprüfen, ob er mit dem vorgesehenen Server spricht, ohne sich auf eine öffentliche Zertifizierungsstelle zu verlassen. ProxMenux leitet sie über die Umgebungsvariable <code>PBS_FINGERPRINT</code> an <code>proxmox-backup-client</code> weiter."
|
|
},
|
|
{
|
|
"id": "grupo-copia",
|
|
"term": "Backup-Gruppe",
|
|
"def": "Logischer Container innerhalb von PBS, unter dem sich aufeinanderfolgende Backups desselben Assets ansammeln. Jedes neue Backup teilt die Deduplizierung mit früheren in derselben Gruppe. ProxMenux verwendet zwei Gruppen pro Host, wenn die Verschlüsselung aktiviert ist: eine für das Host-Backup und eine mit einem <code>-keyrecovery</code>-Suffix für den <a href=\"#sobre-recuperacion\">Wiederherstellungsumschlag</a>."
|
|
},
|
|
{
|
|
"id": "backup-id",
|
|
"term": "Backup-ID",
|
|
"def": "Name der <a href=\"#grupo-copia\">backup-Gruppe</a>. ProxMenux ist standardmäßig <code>hostcfg-HOSTNAME</code> und lässt den Benutzer es vor dem Hochladen bearbeiten; nicht unterstützte Zeichen werden automatisch entfernt."
|
|
},
|
|
{
|
|
"id": "pxar",
|
|
"term": ".pxar",
|
|
"def": "PBS-natives Archivformat für Verzeichnisse. Es verhält sich wie ein für die Chunk-Deduplizierung optimierter tar-Archiv: Anstatt eine undurchsichtige Datei zu speichern, zerlegt PBS seinen Inhalt in wiederverwendbare Chunks."
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Ausführung und Terminplanung",
|
|
"intro": "Begriffe, die vom ProxMenux-Planed-Jobs-System verwendet werden.",
|
|
"entries": [
|
|
{
|
|
"id": "runner",
|
|
"term": "Ausführungsprozess",
|
|
"def": "Das <code>run_scheduled_backup.sh</code>-Script, das ein geplantes Backup ausführt. Es liest die Job-Konfiguration, startet das passende Backend (Local, PBS oder Borg), wendet nach Erfolg die Aufbewahrungsregeln an und sendet die konfigurierten Benachrichtigungen."
|
|
},
|
|
{
|
|
"id": "trabajo-programado",
|
|
"term": "Geplanter Auftrag",
|
|
"def": "Beharrliche Konfiguration eines wiederkehrenden Backups. Behält Ziel, Anmeldeinformationen, Verschlüsselung, Zeitplan und Aufbewahrung. Lebt bei <code>/var/lib/proxmenux/backup-jobs/<id>.env</code>."
|
|
},
|
|
{
|
|
"id": "modo-adjunto",
|
|
"term": "Anhängemodus",
|
|
"def": "Auftrag ohne eigenen Timer. Ein job-end-Hook von PVE-<code>vzdump</code> startet ihn nach Gastsicherungen bei passendem Zielspeicher. Der gewählte Elternauftrag liefert Speicher und Aufbewahrung, die bei jedem Lauf erneut aus dem Elternauftrag gelesen wird; der Hook vergleicht aber Speicher statt Auftrags-ID. Auch andere Aufgaben desselben Speichers können ihn auslösen. Nur Local und PBS."
|
|
},
|
|
{
|
|
"id": "timer-systemd",
|
|
"term": "Systemd Timer",
|
|
"def": "Standard-systemd-Mechanismus, der einen Befehl in einem Kalender auslöst. ProxMenux erstellt einen Timer pro <em>unabhängigem</em> geplanten Job; <a href=\"#modo-adjunto\">attach-mode</a> Jobs verwenden keinen Timer, sie laufen über den PVE-Skript-Hook."
|
|
},
|
|
{
|
|
"id": "retencion",
|
|
"term": "Aufbewahrung (keep-last, keep-daily…)",
|
|
"def": "Richtlinie, die entscheidet, welche älteren Backups aufbewahrt und welche beschnitten werden sollen. Definiert pro Auftrag mit Parametern wie <code>keep-last</code>, <code>keep-daily</code>, <code>keep-weekly</code>, <code>keep-monthly</code>. Wird vom Ausführungsprozess nach jedem erfolgreichen Backup angewendet."
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Wiederherstellen",
|
|
"intro": "Terme aus dem Wiederherstellungsfluss.",
|
|
"entries": [
|
|
{
|
|
"id": "restauracion-universal",
|
|
"term": "Universale Wiederherstellung",
|
|
"def": "Der ProxMenux-Wiederherstellungsfluss extrahiert nicht nur das Dateisystem: Er liest das Manifest, um Unterschiede zwischen Quelle und Ziel zu erkennen, reproduziert die Systemkonfiguration und führt die Installateure für die ProxMenux-verwalteten Komponenten erneut aus. Ziel ist es, den Quellhost zu reproduzieren, nicht nur das Archiv."
|
|
},
|
|
{
|
|
"id": "hidratacion",
|
|
"term": "Ergänzung zwischen Kernel-Versionen (Hydration)",
|
|
"def": "Wiederherstellungsschritt, der die eigene Quellkonfiguration (IOMMU-Parameter, VFIO-Geräte-IDs, eigene Anpassungen und GRUB-Schlüssel) in die frische Boot-Konfiguration des Ziels übernimmt, ohne kernelgebundene Quelldateien unverändert zu kopieren. Läuft, wenn der Zielkernel neuer als der der Sicherung ist."
|
|
},
|
|
{
|
|
"id": "cross-kernel",
|
|
"term": "Kernübergreifende Wiederherstellung",
|
|
"def": "Wiederherstellung, bei der der Zielkernel vom Quellkernel abweicht und meist neuer ist. Der <a href=\"#hidratacion\">Ergänzungsschritt</a> verhindert die Übernahme von Dateien, die mit dem Zielkernel inkompatibel sind."
|
|
},
|
|
{
|
|
"id": "instalador-postboot",
|
|
"term": "Installateur nach dem Booten",
|
|
"def": "Komponenten, die nach dem ersten Booten des wiederhergestellten Hosts neu installiert wurden (NVIDIA-Treiber, Coral TPU-Treiber, AMD GPU-Tools, Intel GPU-Tools). Jeder Installer läuft gegen den Kernel des Ziels, so dass der wiederhergestellte Host nicht davon abhängt, ob der Kernel der Quelle vorhanden ist."
|
|
},
|
|
{
|
|
"id": "compatibility-check",
|
|
"term": "Kompatibilitätsprüfung",
|
|
"def": "Vergleich zwischen dem Quellenmanifest und dem Zustand des Ziels, den ProxMenux zu Beginn der Wiederherstellung durchführt. Es entscheidet, welche Teile wortwörtlich kopiert werden, welche Hydratation benötigen und welche von einem Installateur neu erstellt werden."
|
|
},
|
|
{
|
|
"id": "equipo-recien-instalado",
|
|
"term": "Frische Installation",
|
|
"def": "Host nur von Grund auf neu installiert, ohne lokale <a href=\"#clave-cifrado\">Schlüsseldatei</a>. Um ein verschlüsseltes Backup wiederherzustellen, muss zunächst die Schlüsseldatei aus der <a href=\"#sobre-recuperacion\">Wiederherstellungsumschlag</a>, die auf PBS gespeichert ist, mit der <a href=\"#passphrase-recuperacion\">Wiederherstellungspassphrase</a> wiederhergestellt werden."
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"whereNext": {
|
|
"heading": "Wo als nächstes",
|
|
"items": [
|
|
{
|
|
"label": "Wie es funktioniert",
|
|
"href": "/docs/backup-restore/how-it-works",
|
|
"tail": "- wo das Rootfs-, Manifest- und Anwendungsinventar in ein Backup passt."
|
|
},
|
|
{
|
|
"label": "Proxmox-Backup-Server-Ziel",
|
|
"href": "/docs/backup-restore/destinations/pbs",
|
|
"tail": "- wobei clientseitige Verschlüsselung, Keyfile, Recovery-Passphrase und Envelope ausführlich dokumentiert sind."
|
|
},
|
|
{
|
|
"label": "Wiederherstellung",
|
|
"href": "/docs/backup-restore/restoring",
|
|
"tail": " — Wiederherstellungsablauf und Verwendung des Manifests."
|
|
}
|
|
]
|
|
}
|
|
}
|