getting-started
Erste Schritte
Richten Sie Ihren ersten benutzerdefinierten Bot ein, verbinden Sie einen Discord-Server und verifizieren Sie Mitglieder in weniger als 10 Minuten. Diese Anleitung führt Sie durch jeden Schritt von Null bis zu einem funktionierenden Verifizierungslink.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen: einen Discord-Account, Eigentums- oder Administratorrechte auf dem Discord-Server, den Sie schützen möchten, und einen RestoreHub-Account (melden Sie sich auf restorehub.net mit Discord, Google, GitHub, Apple oder E-Mail/Passwort an).
Restore Hub arbeitet nach dem Custom-Bot-Modell. Anstatt einen gemeinsamen Bot hinzuzufügen, den Tausende von Servern verwenden, erstellen Sie Ihre eigene Discord-Anwendung und geben Restore Hub die Anmeldedaten. Das bedeutet, dass Ihre Mitglieder Ihren Bot-Namen und Avatar sehen, nicht unseren.
Tipp: Sie können mit dem kostenlosen Tarif beginnen. Kostenlose Konten umfassen 1 benutzerdefinierten Bot, 2 Server, 3 Backups und Kernverifizierung. Premium-Funktionen wie VPN-Erkennung, Alt-Erkennung und die Firewall erfordern ein Upgrade.
Schritt 1 - Erstellen einer Discord-Anwendung
Jeder Restore Hub-Bot startet als Standard-Discord-Anwendung. Sie erstellen ihn im Discord-Entwicklerportal und übergeben dann die Anmeldedaten an Restore Hub.
- Öffnen Sie das Entwicklerportal - Navigieren Sie in Ihrem Browser zu https://discord.com/developers/applications. Melden Sie sich mit Ihrem Discord-Konto an, wenn Sie dazu aufgefordert werden.
- Erstellen Sie eine neue Anwendung - Klicken Sie auf die Schaltfläche "Neue Anwendung" in der oberen rechten Ecke. Geben Sie ihm einen Namen (dies wird der Anzeigename des Bots auf Ihrem Server sein) und akzeptieren Sie die Nutzungsbedingungen für Discord-Entwickler.
- Kopieren Sie die Anwendungs-(Mandanten-)ID - Auf der Seite "Allgemeine Informationen" finden Sie das Feld Anwendungs-ID. Klicken Sie auf "Kopieren" und speichern Sie diese irgendwo - Sie werden sie in Kürze in Restore Hub einfügen.
- Kopieren Sie den öffentlichen Schlüssel - Kopieren Sie unter "Allgemeine Informationen" den öffentlichen Schlüssel. Restore Hub verwendet diesen, um zu überprüfen, ob die eingehenden Interaktions-Payloads wirklich von Discord stammen.
- Erzeugen des Client-Geheimnisses - Navigieren Sie zum Abschnitt "OAuth2" in der linken Seitenleiste. Klicken Sie unter "Client-Informationen" auf "Geheimnis zurücksetzen" und bestätigen Sie. Kopieren Sie das Geheimnis sofort - Discord zeigt es nur einmal an.
- Erstellen Sie den Bot-Benutzer und kopieren Sie das Token - Navigieren Sie zu "Bot" in der linken Seitenleiste. Klicken Sie auf "Token zurücksetzen" und bestätigen Sie. Kopieren Sie das Bot-Token und bewahren Sie es sicher auf. Dieses Token gibt Ihnen die volle Kontrolle über den Bot, also geben Sie es niemals öffentlich weiter.
- Privilegierte Absichten aktivieren - Scrollen Sie auf der Bot-Seite nach unten zu "Privileged Gateway Intents". Aktivieren Sie "Server Members Intent" (erforderlich für das Ziehen von Mitgliedern und Backups) und "Message Content Intent" (erforderlich für Nachrichten-Backups). Klicken Sie auf "Änderungen speichern".
Warnung: Ihr Bot-Token und Ihr Client-Geheimnis sind sensible Anmeldedaten. Fügen Sie sie niemals in Discord-Nachrichten, öffentliche Repos oder Screenshots ein. Restore Hub verschlüsselt sie im Ruhezustand mit AES-256 und zeigt sie nach der Ersteinrichtung niemals an.
Schritt 2 - Festlegen der OAuth2-Redirect-URI
Bei Discord müssen Sie die genaue URL, zu der die Benutzer nach der Autorisierung mit OAuth2 weitergeleitet werden, auf eine Whitelist setzen. Restore Hub benötigt diese Konfiguration, damit die Überprüfung funktioniert.
- Zu OAuth2-Redirects navigieren - Gehen Sie im Entwicklerportal zu OAuth2 → Allgemein. Scrollen Sie nach unten zu "Redirects".
- Hinzufügen der Rückruf-URL des Restore Hub - Klicken Sie auf "Umleitung hinzufügen" und geben Sie ein: https://restorehub.net/api/callback. Wenn Sie eine benutzerdefinierte Domäne verwenden möchten (z. B. verify.ihredomain.com), fügen Sie auch https://verify.yourdomain.com/api/callback hinzu. Klicken Sie auf "Änderungen speichern".
https://restorehub.net/api/callbackTipp: Sie können mehrere URIs für die Umleitung hinzufügen. Fügen Sie sowohl den restorehub.net-Rückruf als auch alle benutzerdefinierten Domain-Rückrufe hinzu, die Sie verwenden möchten.
Schritt 3 - Fügen Sie Ihren Bot zum Restore Hub hinzu
Nachdem Sie nun Ihre Discord-Anwendung konfiguriert haben, bringen Sie die Anmeldedaten mithilfe des 5-stufigen Bot-Einrichtungsassistenten in Restore Hub ein.
- Öffnen Sie die Seite Benutzerdefinierte Bots - Melden Sie sich bei restorehub.net an. Klicken Sie in der Dashboard-Seitenleiste auf "Benutzerdefinierte Bots" und dann auf "Bot hinzufügen".
- Fügen Sie Ihre Anmeldedaten ein (Assistent Schritt 1 von 5) - Geben Sie das Bot-Token, die Client-ID, das Client-Geheimnis, den öffentlichen Schlüssel und die Redirect-URI ein. Restore Hub validiert jedes Feld in Echtzeit.
- Konfigurieren Sie den Interaktions-Endpunkt (Assistent Schritt 2 von 5) - RestoreHub generiert eine eindeutige Interaktions-Endpunkt-URL für Ihren Bot (z. B. https://restorehub.net/api/interactions/{botId}). Der Assistent gibt Ihnen diese URL und weist Sie an, sie im Discord-Entwicklerportal unter Allgemeine Informationen → Interaktionsendpunkt-URL einzufügen. Discord sendet einen Verifizierungs-Ping - RestoreHub antwortet automatisch. Sobald Discord ein grünes Häkchen anzeigt, fahren Sie fort.
- Legen Sie Ihre Verifizierungs-URL fest (Assistent Schritt 3 von 5) - Wählen Sie zwischen einer Slug-basierten URL (restorehub.net/s/your-community) oder einer benutzerdefinierten Domain (verify.yourdomain.com). Slugs sind sofort verfügbar; benutzerdefinierte Domänen erfordern einen CNAME-Eintrag (siehe Dokument Benutzerdefinierte Domänen).
- Zu einem Server einladen (Assistent Schritt 4 von 5) - Der Assistent generiert einen OAuth2-Einladungslink mit den richtigen Berechtigungen (Rollen verwalten, Mitglieder kicken, Kanäle ansehen, Nachrichtenverlauf lesen). Klicken Sie auf "Zum Server einladen", wählen Sie Ihren Discord-Server aus der Dropdown-Liste und autorisieren Sie ihn.
- Konfigurieren Sie die Servereinstellungen (Assistent Schritt 5 von 5) - Wählen Sie die Rolle "Verifiziert", die Mitglieder nach bestandener Verifizierung erhalten. Legen Sie optional einen Protokollkanal für Verifizierungsereignisse fest, aktivieren Sie Captcha, legen Sie das Mindestalter des Kontos fest und schalten Sie die Sicherheitsfunktionen um.
Schritt 4 - Teilen Sie den Verifizierungslink
Ihr Bot ist jetzt live. Geben Sie die Verifizierungs-URL an Ihre Mitglieder weiter. Sie können sie in einem Channel posten, in Ihre Serverbeschreibung aufnehmen oder den Schrägstrich-Befehl /verify-embed verwenden, um eine Schaltfläche in einen beliebigen Channel einzubetten.
Wenn ein Mitglied auf den Link klickt, wird es zu Ihrer benutzerdefinierten Verifizierungsseite weitergeleitet. Sie klicken auf "Verifizieren", autorisieren sich mit Discord OAuth2 (und gewähren Identitäts-, E-Mail-, Gilden- und Gildenbeitrittsbereiche) und erhalten automatisch die verifizierte Rolle auf Ihrem Server.
Tipp: Verwenden Sie den Befehl /verify-embed (Premium+), um eine saubere Verifizierungseinbettung mit einer Schaltfläche direkt in einem Discord-Kanal zu posten. Mitglieder klicken auf die Schaltfläche und werden auf die Verifizierungsseite weitergeleitet.
Was sich hinter den Kulissen abspielt
Restore Hub-Bots verwenden den HTTP-basierten Interaktions-Endpunkt von Discord und nicht das traditionelle WebSocket-Gateway. Dies ist ein wichtiger architektonischer Unterschied, der sich auf das Verhalten des Bots auswirkt.
Beim Gateway-Ansatz unterhält ein Bot eine dauerhafte WebSocket-Verbindung zu Discord und empfängt jedes Ereignis in Echtzeit (Nachrichten, Reaktionen, Beitritte von Mitgliedern usw.). Dies erfordert eine ständig aktive Infrastruktur und zeigt einen grünen/gelben/roten Statuspunkt neben dem Bot in der Mitgliederliste an.
Bei der Interaktions-Endpunkt-Methode (die Restore Hub verwendet) sendet Discord nur dann HTTP-POST-Anfragen an die Endpunkt-URL Ihres Bots, wenn ein Benutzer einen Slash-Befehl oder eine Schaltflächeninteraktion auslöst. Es besteht keine dauerhafte Verbindung. Der Bot erscheint in der Mitgliederliste ohne einen Statuspunkt - sauber und professionell.
Alle anderen Vorgänge (Zuweisung von Rollen, Abrufen von Mitgliedern, Erstellen von Backups, Kicken von Mitgliedern) werden über die REST-API von Discord unter Verwendung des Bot-Tokens ausgeführt. Das bedeutet, dass Restore Hub auf Tausende von Bots skalieren kann, ohne Tausende von WebSocket-Verbindungen zu unterhalten.
Die Grenzen des Plans auf einen Blick
| Feature | Kostenlos | Premium | Business | Enterprise |
|---|---|---|---|---|
| Server | 2 | 10 | 50 | Unbegrenzt |
| Benutzerdefinierte Bots | 1 | 5 | 25 | Unbegrenzt |
| Sicherungen | 3 | 10 | 30 | 50 |
| Nachrichten/Backup | 50 | 200 | 500 | 2.000 |
| Pull-Abklingzeit | 6 Stunden | 1 Stunde | 15 min | Keine |
| VPN-Erkennung | Nein | Ja | Ja | Ja |
| Alt-Erkennung | Nein | Ja | Ja | Ja |
| Firewall | Nein | Ja | Ja | Ja |
| Anti-Nuke | Nein | Nein | Ja | Ja | |
| Anti-Raid | Nein | Nein | Ja | Ja |
| Benutzerdefinierte Domäne | Nein | Nein | Ja | Ja |
| Geplante Backups | Nein | Ja | Ja | Ja |
| Slash-Befehle | Nein | Ja | Ja | Ja |
| Teamverwaltung | Nein | Nein | Ja | Ja |
| API-Ratenbegrenzung | 20/10s | 50/10s | 100/10s | 200/10s |Nächste Schritte
- Lesen Sie das Dokument Benutzerdefinierte Bots, um zu verstehen, wie HTTP-Interaktionen funktionieren und welche Berechtigungen Ihr Bot benötigt.
- Lesen Sie die Verifizierungsdokumentation, um mehr über jede Sicherheitsüberprüfung im Verifizierungsablauf zu erfahren.
- Lesen Sie das Sicherheitsdokument, um VPN-Erkennung, Alt-Erkennung, Firewall-Regeln, Anti-Nuke und Anti-Raid zu aktivieren.
- Lesen Sie das Dokument Backups, um Server-Snapshots und geplante Backups einzurichten.
- Lesen Sie das Dokument Member Pulling, um zu erfahren, wie Sie verifizierte Mitglieder zwischen Servern verschieben können.
- Lesen Sie das Dokument Benutzerdefinierte Domains, wenn Sie verify.ihredomain.com anstelle einer Slug-URL verwenden möchten.
- Lesen Sie das REST API-Dokument, wenn Sie Restore Hub in Ihre eigenen Tools oder Dashboards integrieren möchten.