Sichern und Wiederherstellen

Vollständige Server-Snapshots mit Kanälen, Rollen, Berechtigungen, Emojis, Stickern, Automod-Regeln, Servereinstellungen, Nachrichten und Mitgliederrollen. Planen Sie automatische Sicherungen und Wiederherstellungen auf einem beliebigen Server.

Übersicht

Restore Hub-Backups erfassen einen umfassenden Schnappschuss der Struktur und des Inhalts Ihres Discord-Servers. Im Gegensatz zu einfachen Exporten von Channel-Listen sichert Restore Hub alles, was benötigt wird, um einen Server von Grund auf neu zu erstellen - einschließlich überschriebener Berechtigungen, Automod-Regeln und (planbegrenzter) Nachrichtenhistorie.

Die Backups werden sicher in der Infrastruktur von Restore Hub gespeichert und können auf demselben oder einem völlig anderen Server wiederhergestellt werden. Das macht sie wertvoll für Disaster Recovery, Servermigration und Vorlagenerstellung.

Was wird gesichert?

Ein Restore Hub-Backup enthält die folgenden Daten, die zum Zeitpunkt der Backup-Erstellung über die REST-API von Discord erfasst werden:

• Kanäle - Alle Kanaltypen: Text, Sprache, Ankündigung, Forum, Bühne und Kategorien. Enthält Kanalname, Thema, Position, NSFW-Flagge, Geschwindigkeitslimit (Slowmode), Bitrate (Sprache), Benutzerlimit (Sprache), Standarddauer für die automatische Archivierung, verfügbare Tags (Forum) und übergeordnete Kategorie.
• Rollen - Jede Rolle auf dem Server: Name, Farbe (hex), Berechtigungs-Bitfeld, Position in der Hierarchie, Hissflagge (separat angezeigt), Erwähnungsflagge und Rollensymbol (falls vorhanden).
• Erlaubnis überschreibt - Überschreibungen von Berechtigungen für einzelne Channel-Rollen und -Mitglieder. Für jeden Kanal speichert das Backup, welche Rollen/Mitglieder bestimmte Berechtigungsüberschreibungen erlauben/verweigern.
• Emojis - Alle benutzerdefinierten Emojis: Name, animierte Flagge und CDN-URL zur Wiederherstellung. Beim Wiederherstellen werden die Emojis von der CDN-URL neu hochgeladen.
• Aufkleber - Alle benutzerdefinierten Aufkleber: Name, Beschreibung, Formattyp (PNG/APNG/Lottie), Tags und Bild-URL.
• Automod-Regeln - Alle AutoMod-Regeln: Auslösertyp, Auslöser-Metadaten (Schlüsselwortlisten, Regex-Muster, Voreinstellungen), Aktionen (Block, Alarm, Timeout), ausgenommene Rollen und ausgenommene Kanäle.
• Server-Einstellungen - Servername, Symbol-URL, Banner-URL, Splash-URL, Beschreibung, Überprüfungsstufe, Standardbenachrichtigungseinstellung, Filter für explizite Inhalte, AFK-Kanal, AFK-Timeout, Systemkanal und Systemkanalflags.
• Nachrichten - Jüngste Nachrichten aus Textkanälen (planbegrenzt). Jede Nachricht speichert: Inhalt, Autoreninformationen (ID, Benutzername, Avatar), Einbettungen, Anhang-URLs, Zeitstempel und Bearbeitungszeitstempel. Die Nachrichten werden in umgekehrter chronologischer Reihenfolge bis zum Limit des Tarifs pro Kanal erfasst.
• Rollen der Mitglieder - Eine Zuordnung der Discord-Benutzer-ID zu einem Array von Rollen-IDs. Dadurch wird aufgezeichnet, welche Mitglieder zum Zeitpunkt der Sicherung welche Rollen hatten, was die Wiederherstellung der Rollen während eines Wiederherstellungsvorgangs ermöglicht.

Tipp: Backups sind zeitpunktbezogene Snapshots. Sie erfassen den Zustand des Servers genau in dem Moment, in dem die Sicherung ausgeführt wird. Änderungen, die nach der Sicherung vorgenommen wurden, werden nicht berücksichtigt.

Erstellen eines Backups

1. Vom Dashboard aus - Navigieren Sie im Dashboard zu Ihrem Server. Klicken Sie in der Seitenleiste auf "Backups" und dann auf "Backup erstellen". Das Backup wird in eine Warteschlange gestellt und im Hintergrund vom Backup-Worker verarbeitet. Sie sehen die Statusaktualisierung in Echtzeit.
2. Von Discord (Premium+) - Verwenden Sie den Befehl /backup auf Ihrem Discord-Server. Der Bot bestätigt, dass das Backup in die Warteschlange gestellt wurde und schickt Ihnen eine Nachricht, sobald es abgeschlossen ist.
3. Über die API - Senden Sie eine POST-Anfrage an /api/v1/servers/:id/backups. Die Antwort enthält die Backup-ID und den Status "in der Warteschlange". Rufen Sie GET /api/v1/servers/:id/backups ab, um den Fortschritt zu überprüfen.

Der Backup-Worker läuft asynchron. Bei einem großen Server mit vielen Kanälen und Nachrichten kann ein Backup zwischen ein paar Sekunden und mehreren Minuten dauern. Der Worker holt alle Daten von der REST-API von Discord und beachtet dabei die Ratenbeschränkungen.

Geplante Backups (Premium+)

Ab der Premium-Version können Sie automatische Backups in regelmäßigen Abständen planen. Der Planer läuft selbstständig und erstellt Backups ohne manuelles Eingreifen.

| Einstellung | Beschreibung | Standard |
|---|---|---|
| Intervall (Tage) | Wie oft eine Sicherung erstellt wird (z. B. alle 1 Tag, alle 7 Tage) | 1 Tag |
| Max Backups | Maximale Anzahl der geplanten Backups, die beibehalten werden sollen. Ältere Sicherungen werden automatisch beschnitten. | 5 |
| Aktiv | Ob der Zeitplan derzeit ausgeführt wird | Ja |

Tipp: Auto-Pruning betrifft nur geplante Backups. Manuelle Sicherungen werden nie automatisch gelöscht. Wenn Sie 5 geplante Sicherungen haben und das Maximum bei 5 liegt, wird die älteste geplante Sicherung gelöscht, wenn eine neue erstellt wird.

Plan-Grenzen

| Plan | Max Backups | Nachrichten pro Kanal | Geplante Backups |
|---|---|---|---|
| Kostenlos | 3 | 50 | Nein |
| Premium | 10 | 200 | Ja |
| Business | 30 | 500 | Ja |
| Unternehmen | 50 | 2.000 | Ja |

Achtung! Das Nachrichtenlimit gilt pro Kanal, nicht pro Backup. Ein kostenloses Backup eines Servers mit 20 Textkanälen erfasst bis zu 50 Nachrichten aus jedem Kanal (1.000 Nachrichten insgesamt).

Wiederherstellung einer Sicherung

Bei der Wiederherstellung wird die Struktur eines Servers anhand eines Sicherungs-Snapshots wiederhergestellt. Sie können auf demselben Server wiederherstellen (um Änderungen rückgängig zu machen) oder auf einem anderen Server (zum Klonen oder Migrieren).

1. Wählen Sie die Sicherung - Gehen Sie im Dashboard zu Backups und klicken Sie auf "Wiederherstellen" für das Backup, das Sie wiederherstellen möchten. Oder verwenden Sie den Befehl /restore in Discord oder POST an /api/v1/servers/:id/backups/:backupId/restore.
2. Wählen Sie einen Zielserver - Standardmäßig wird die Sicherung auf demselben Server wiederhergestellt. Sie können optional eine andere Zielserver-ID angeben. Der Bot muss sich auf dem Zielserver befinden und über die erforderlichen Berechtigungen verfügen.
3. Auswählen, was wiederhergestellt werden soll - Sie können Folgendes selektiv wiederherstellen: Kanäle (standardmäßig aktiviert), Rollen (standardmäßig aktiviert), Überschreiben von Berechtigungen (standardmäßig aktiviert), Emojis (standardmäßig deaktiviert), Servereinstellungen (standardmäßig deaktiviert) und Mitgliederrollen (standardmäßig deaktiviert).
4. Bestätigen und ausführen - Der Wiederherstellungsauftrag wird in eine Warteschlange gestellt und vom Backup Worker verarbeitet. Restore Hub erstellt zuerst Rollen (um die Hierarchie zu etablieren), dann Kanäle mit ihren Berechtigungsüberschreibungen, dann Emojis/Aufkleber, dann Servereinstellungen.

Warnung: Beim Wiederherstellen von Kanälen werden alle vorhandenen Kanäle auf dem Zielserver gelöscht und aus der Sicherung neu erstellt. Dieser Vorgang ist destruktiv und kann nicht rückgängig gemacht werden. Die Wiederherstellung von Mitgliederrollen funktioniert nur für Mitglieder, die sich derzeit auf dem Server befinden.

Wie Restore mit Rollen-IDs umgeht

Bei der Erstellung eines Backups werden die Rollen-IDs so erfasst, wie sie zu diesem Zeitpunkt existieren. Bei der Wiederherstellung auf einem anderen Server sind diese Rollen-IDs nicht mehr vorhanden. Restore Hub behandelt dies, indem es neue Rollen mit demselben Namen, derselben Farbe und denselben Berechtigungen erstellt und dann intern alte Rollen-IDs auf neue Rollen-IDs abbildet.

Diese Rollen-ID-Zuordnung wird für Folgendes verwendet: Überschreiben von Berechtigungen (Channel-Berechtigungen referenzieren Rollen nach ID), Wiederherstellung von Mitgliederrollen (Neuzuweisung von Rollen an Mitglieder) und Überschreiben von Berechtigungen auf Channel-Ebene.

Verwendung von Backups auf verschiedenen Servern

Backups sind nicht an den Server gebunden, auf dem sie erstellt wurden. Sie können jedes Backup auf jedem Server wiederherstellen, auf dem Ihr Bot die erforderlichen Berechtigungen hat. Häufige Anwendungsfälle:

• Server-Vorlagen - Erstellen Sie eine Sicherungskopie eines perfekt konfigurierten Servers und stellen Sie diese als Ausgangspunkt auf neuen Servern wieder her.
• Migration - Sichern Sie Ihren alten Server, erstellen Sie einen neuen und stellen Sie die gesamte Struktur wieder her.
• Wiederherstellung im Katastrophenfall - Wenn Ihr Server vernichtet oder kompromittiert wurde, stellen Sie ihn mit dem letzten Backup wieder her.
• Prüfung - Stellen Sie auf einem Testserver wieder her, um mit Änderungen zu experimentieren, ohne Ihren Live-Server zu beeinträchtigen.

Der Backup-Arbeiter

Sicherungen und Wiederherstellungen laufen asynchron über einen Hintergrund-Worker (BullMQ-Job-Warteschlange). Wenn Sie eine Sicherung oder Wiederherstellung erstellen, wird ein Auftrag in die Warteschlange gestellt. Der Worker holt ihn ab, verarbeitet ihn (indem er Daten aus Discord abruft oder Ressourcen erstellt) und aktualisiert den Datensatz der Sicherung in der Datenbank.

Der Worker beachtet die REST-API-Ratenbeschränkungen von Discord. Bei großen Servern kann der Worker mehrere Minuten in Anspruch nehmen. Sie können den Fortschritt über das Dashboard überwachen, das nach Statusaktualisierungen fragt.