NodeJSVeröffentlicht am 15. Dezember 20259 Min. Lesezeit

Einen Discord-Bot (discord.js) auf OuiPanel hosten

Diese Anleitung zeigt, wie Sie einen Discord-Bot mit discord.js (JavaScript, Node.js) auf einem Node.js-Server von OuiHeberg hosten, den Sie in OuiPanel verwalten. Der Bot läuft dauerhaft auf dem Server, auch wenn Ihr Computer aus ist. Sie brauchen einen im Discord Developer Portal erstellten Bot, seinen Token und die Dateien des Bots (index.js, package.json…).


Den Bot bei Discord erstellen

Sie haben Ihren Bot und seinen Token schon? Dann springen Sie zum nächsten Abschnitt.

Die Anwendung erstellen

  1. Öffnen Sie das Discord Developer Portal und melden Sie sich mit Ihrem Discord-Konto an.

  2. Klicken Sie auf New Application.

  3. Geben Sie Ihrer Anwendung einen Namen, zum Beispiel „Mein Bot“, akzeptieren Sie die Bedingungen und klicken Sie auf Create.

Fenster Create an application im Discord Developer Portal mit dem Feld Name

Den Bot erstellen

Klicken Sie im linken Menü auf Bot. Neue Anwendungen haben ihren Bot bereits. Erscheint die Schaltfläche Add Bot, klicken Sie darauf und bestätigen Sie im Fenster mit Yes, do it!

Den Token abrufen

  1. Klicken Sie im Bereich Bot auf Reset Token.

  2. Bestätigen Sie und kopieren Sie den angezeigten Token.

Der Token ist wie ein Passwort. Wer ihn hat, kann Ihren Bot steuern. Geben Sie ihn nie weiter und legen Sie ihn nie in öffentlichen Code (GitHub usw.).

Die Intents aktivieren

Scrollen Sie im Bereich Bot zu Privileged Gateway Intents und aktivieren Sie die nötigen Intents.

IntentNutzen
PRESENCE INTENTOptional
SERVER MEMBERS INTENTOptional
MESSAGE CONTENT INTENTErforderlich, um Nachrichteninhalte zu lesen

Bereich Privileged Gateway Intents im Discord Developer Portal mit den drei Schaltern

Ohne MESSAGE CONTENT INTENT kann Ihr Bot keine Nachrichteninhalte lesen, und ein Befehl wie !ping bleibt ohne Antwort.

Den Bot auf Ihren Discord-Server einladen

  1. Klicken Sie im linken Menü auf OAuth2 › URL Generator.

  2. Haken Sie unter Scopes bot und applications.commands an.

  3. Wählen Sie unter Bot Permissions die nötigen Berechtigungen, oder Administrator für alle.

  4. Kopieren Sie die unten erzeugte URL, öffnen Sie sie und laden Sie den Bot auf Ihren Discord-Server ein.

Feld Generated URL der Seite OAuth2 mit dem Einladungslink des Bots


Die Dateien des Bots vorbereiten

Dateistruktur

Ihr Bot sollte diese Struktur haben.

MeinBot/
├── index.js         ← Hauptdatei (oder bot.js, main.js...)
├── package.json     ← npm-Abhängigkeiten
├── .env             ← Bot-Token (auf dem Server erstellt)
├── commands/        ← (Optional) Ordner für Befehle
└── events/          ← (Optional) Ordner für Ereignisse

Die Datei package.json

Legen Sie eine Datei package.json mit den Abhängigkeiten discord.js und dotenv an.

{
  "name": "mein-discord-bot",
  "version": "1.0.0",
  "description": "Mein Discord-Bot",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "discord.js": "^14.14.1",
    "dotenv": "^16.3.1"
  }
}

Passen Sie "main": "index.js" an den Namen Ihrer Hauptdatei an (bot.js, main.js usw.).

Die Hauptdatei (index.js)

Legen Sie Ihre Hauptdatei an. Sie lädt den Token mit dotenv.

// Umgebungsvariablen aus .env laden
require('dotenv').config();

const { Client, GatewayIntentBits } = require('discord.js');

// Discord-Client erstellen
const client = new Client({
    intents: [
        GatewayIntentBits.Guilds,
        GatewayIntentBits.GuildMessages,
        GatewayIntentBits.MessageContent
    ]
});

// Ereignis: Bot bereit
client.once('ready', () => {
    console.log(`Bot verbunden als ${client.user.tag}`);
});

// Ereignis: Nachricht erhalten
client.on('messageCreate', message => {
    if (message.author.bot) return;
    
    // Prefix aus .env verwenden (optional)
    const prefix = process.env.PREFIX || '!';
    
    if (message.content === `${prefix}ping`) {
        message.reply('Pong!');
    }
});

// Fehlerbehandlung
process.on('unhandledRejection', error => {
    console.error('Unerwarteter Fehler:', error);
});

client.on('error', error => {
    console.error('Discord-Fehler:', error);
});

// Mit dem Token aus .env verbinden
client.login(process.env.DISCORD_TOKEN);

Die Zeile require('dotenv').config(); muss die erste Zeile Ihrer Datei sein.


Die Dateien zu OuiPanel hochladen

Der Dateimanager hat keine Upload-Schaltfläche. Dateien werden per Drag-and-drop gesendet.

  1. Melden Sie sich unter dash.ouipanel.com bei OuiPanel an und öffnen Sie Ihren Node.js-Server.

  2. Klicken Sie im Seitenmenü auf Dateimanager.

  3. Löschen Sie gegebenenfalls die Standarddateien.

  4. Ziehen Sie index.js, package.json und Ihre Ordner (commands/, events/…) von Ihrem Computer auf die Seite.

  5. Sobald die Ebene „Dateien hier ablegen“ erscheint, lassen Sie los.

Jede so gesendete Datei ist auf 100 MB begrenzt.

Ebene Dateien hier ablegen während eines Drag-and-drop im Dateimanager

Laden Sie Ihre Datei .env nicht hoch. Sie erstellen sie im nächsten Schritt direkt auf dem Server.

Per SFTP

Für viele Dateien oder Dateien über 100 MB nutzen Sie SFTP. Verbinden Sie sich mit FileZilla, ziehen Sie den gesamten Inhalt Ihres Bot-Ordners hinüber und prüfen Sie, ob alles angekommen ist. Die Anleitung Per SFTP mit FileZilla verbinden erklärt die Verbindung.


Die Datei .env erstellen

Schreiben Sie Ihren Token nie direkt in den Code. Legen Sie auf dem Server eine Datei .env an.

  1. Klicken Sie im Dateimanager, im Stammverzeichnis, auf Datei erstellen.

  2. Geben Sie im Fenster „Neue Datei erstellen“ unter Dateiname .env ein, mit dem Punkt am Anfang, und klicken Sie auf Datei erstellen.

  3. Klicken Sie auf .env, um die Datei im Editor zu öffnen, und fügen Sie den Inhalt unten ein.

  4. Ersetzen Sie ihr_token_hier durch Ihren Token und klicken Sie auf Speichern.

# Token des Discord-Bots
DISCORD_TOKEN=ihr_token_hier

# Präfix der Befehle (optional)
PREFIX=!

Beispiel mit einem echten Token:

DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
PREFIX=!
  • Keine Leerzeichen um das =.

  • Keine Anführungszeichen um die Werte.

  • Geben Sie diese Datei nie weiter.

Dateimanager im Stammverzeichnis eines Node.js-Servers mit index.js, package.json und package-lock.json

So sieht die fertige Struktur auf dem Server aus.

Stammverzeichnis des Servers/
├── .env              ← Enthält DISCORD_TOKEN
├── index.js          ← Ihr Code
├── package.json      ← Abhängigkeiten
└── node_modules/     ← (automatisch erstellt)

Hauptdatei und Node.js-Version festlegen

OuiPanel muss wissen, welche Datei beim Start ausgeführt wird. Auf einem Node.js-Server ist das eine Servervariable.

  1. Öffnen Sie Konfiguration › Servereinstellungen.

  2. Prüfen Sie in der Karte Serverstart die Systemversion. Die Liste bietet Node.js 12, 14 und alle Versionen von 16 bis 26. Version 24, die LTS-Version, passt zu discord.js.

  3. Tragen Sie in der Karte Umgebungsvariablen den Namen Ihrer Datei unter Hauptdatei ein (Hauptdatei; die Variablennamen erscheinen auf Französisch).

  4. Klicken Sie auf das Häkchen rechts neben dem Feld (Speichern).

Ihre HauptdateiWert von Hauptdatei
index.jsindex.js
bot.jsbot.js
main.jsmain.js
src/index.jssrc/index.js
app.jsapp.js

Dieselbe Karte bietet Zusätzliche Node-Pakete und Zu deinstallierende Node-Pakete, um npm-Pakete hinzuzufügen oder zu entfernen (Namen durch Leerzeichen getrennt). Das Feld Zusätzliche Argumente übergibt Optionen an Node.js.

Einstellungen eines Node.js-Servers mit der Version Nodejs 24 und der Variable Hauptdatei

Der Name muss genau Ihrer Datei entsprechen, einschließlich Groß- und Kleinschreibung.


Den Bot starten und testen

Den Server starten

Klicken Sie im Seitenmenü auf Konsole und dann auf Starten. Beim Start installiert der Server die Abhängigkeiten aus package.json mit npm install und führt dann Ihre Datei aus.

> npm install
added 45 packages in 3s

> node index.js
Bot verbunden als MeinBot#1234

Auf Discord prüfen

Die Konsole sollte diese Zeile anzeigen.

Bot verbunden als MeinBot#1234
  1. Öffnen Sie Discord. Ihr Bot erscheint online, mit einem grünen Punkt.

  2. Testen Sie den Befehl !ping. Der Bot antwortet „Pong!“.


Aus einem Git-Repository bereitstellen

Ihr Code liegt auf GitHub, GitLab, Bitbucket oder Codeberg? Die Seite Bereitstellung holt das Repository und installiert die Abhängigkeiten für Sie, statt dass Sie Dateien von Hand hochladen.

  1. Klicken Sie im Seitenmenü auf Bereitstellung.

  2. Füllen Sie im Block Repository verknüpfen die Felder Repository-Adresse und Branch aus.

  3. Wählen Sie unter Zugriff auf das Repository Öffentliches Repository oder eine der beiden Optionen für private Repositorys (Deploy-Schlüssel oder Zugriffstoken).

  4. Haken Sie Bei jedem Push auf den Branch bereitstellen an, wenn Sie automatische Updates möchten, und klicken Sie auf Speichern.

  5. Klicken Sie auf Jetzt bereitstellen.

Jede Bereitstellung startet den Server neu, der während der Installation der Abhängigkeiten angehalten bleibt. Schlägt die Installation fehl, startet die vorherige Version wieder. Nicht von Git verfolgte Dateien wie Ihre .env bleiben erhalten. Vor der ersten Bereitstellung erstellt das Panel ein Backup des Servers.

Seite Git-Bereitstellung mit Repository verknüpfen, Repository-Adresse, Branch und Zugriff auf das Repository

Für ein privates Repository wird der Deploy-Schlüssel empfohlen. Das Panel erzeugt einen eigenen Schlüssel für den Server, den Sie dem Repository mit Lesezugriff hinzufügen.


Mehrere Bots mit einem einzigen Angebot starten

Ein Node.js-Server führt beim Start eine einzige Datei aus. Damit mehrere Bots mit demselben Angebot laufen, kann diese Datei ein Startskript sein, das jeden Bot in einem eigenen Prozess startet. Stürzt ein Bot ab, laufen die anderen weiter. Alle teilen sich den Arbeitsspeicher und den Prozessor des Angebots.

  1. Laden Sie die Dateien Ihrer Bots in das Stammverzeichnis des Servers hoch, zum Beispiel bot1.js und bot2.js.

  2. Fassen Sie die Abhängigkeiten aller Bots in der Datei package.json im Stammverzeichnis zusammen.

  3. Geben Sie in der Datei .env dem Token jedes Bots einen eigenen Namen, etwa DISCORD_TOKEN_1 und DISCORD_TOKEN_2. Lassen Sie jeden Bot seinen eigenen Token lesen, zum Beispiel mit client.login(process.env.DISCORD_TOKEN_1).

  4. Erstellen Sie im Stammverzeichnis eine Datei launcher.js mit dem folgenden Inhalt und passen Sie die Liste bots an.

  5. Öffnen Sie Konfiguration › Servereinstellungen, tragen Sie launcher.js unter Fichier principal (Hauptdatei) ein und klicken Sie auf das Häkchen (Speichern).

  6. Klicken Sie in der Konsole auf Neu starten.

// Startet jeden Bot in einem eigenen Prozess
const { spawn } = require('child_process');
const readline = require('readline');

// Die Dateien Ihrer Bots, im Stammverzeichnis des Servers
const bots = ['bot1.js', 'bot2.js'];

for (const file of bots) {
  const child = spawn(process.execPath, [file]);

  // Zeigt jede Zeile des Bots in der Konsole an, mit seinem Namen davor
  readline.createInterface({ input: child.stdout })
    .on('line', (line) => console.log(`[${file}] ${line}`));
  readline.createInterface({ input: child.stderr })
    .on('line', (line) => console.error(`[${file}] ${line}`));

  child.on('exit', (code) => console.log(`[${file}] gestoppt (Code ${code})`));
}

In der Konsole beginnt jede Zeile mit dem Namen des Bots, der sie schreibt, zum Beispiel [bot1.js] Bot verbunden als MeinBot#1234. Wenn ein Bot stoppt, zeigt das Startskript seinen Exit-Code an.

Das Startskript startet einen gestoppten Bot nicht neu. Starten Sie dazu den Server neu.


Fehlerbehebung

Der Bot startet nicht

FehlerLösung
Cannot find module 'discord.js'Prüfen Sie package.json und starten Sie neu.
Cannot find module 'dotenv'Fügen Sie dotenv zu package.json hinzu.
Error: Cannot find module './index.js'Falscher Wert in der Variable Hauptdatei.
ENOENT: no such file or directoryDie angegebene Datei existiert nicht.

Token-Fehler

FehlerLösung
An invalid token was providedPrüfen Sie den Token in .env.
TOKEN_INVALIDErzeugen Sie den Token im Discord Developer Portal neu.
Used disallowed intentsAktivieren Sie die Intents im Discord Developer Portal.

Der Bot liest keine Nachrichten

UrsacheLösung
MESSAGE CONTENT INTENT deaktiviertAktivieren Sie es im Discord Developer Portal.
Falsche Intents im CodeFügen Sie GatewayIntentBits.MessageContent hinzu.

Die Datei .env wird nicht gelesen

UrsacheLösung
dotenv fehltPrüfen Sie, ob es in package.json steht.
require an der falschen Stellerequire('dotenv').config(); muss die erste Zeile sein.
Falscher DateinameDie Datei muss genau .env heißen.

npm install schlägt fehl

FehlerLösung
package.json not foundPrüfen Sie, ob die Datei im Stammverzeichnis liegt.
ERESOLVE unable to resolveAktualisieren Sie die Versionen in package.json.

Bewährte Vorgehensweisen

Die Datei .env schützen

EmpfohlenZu vermeiden
.env nur auf dem Server aufbewahren.env weitergeben
.env direkt in OuiPanel erstellen.env vom eigenen Computer hochladen
.env in die .gitignore aufnehmen.env auf GitHub committen

Empfohlene .gitignore für Ihr Projekt:

# Umgebungsvariablen
.env

# Node modules
node_modules/

Sicherheit und Leistung

  • Geben Sie Ihren Token nie weiter und erzeugen Sie ihn neu, falls er bekannt wird.

  • Legen Sie die .env direkt auf dem Server an.

  • Aktivieren Sie nur die nötigen Intents.

  • Fangen Sie Fehler mit try/catch ab und schreiben Sie Logs zur Fehlersuche.

Einen größeren Bot strukturieren

Für einen besser strukturierten Bot trennen Sie Befehle und Ereignisse.

MeinBot/
├── index.js              ← Einstiegspunkt
├── package.json
├── .env                  ← Auf dem Server erstellt
├── commands/
│   ├── ping.js
│   ├── help.js
│   └── info.js
├── events/
│   ├── ready.js
│   └── messageCreate.js
└── config.json           ← Nicht sensible Konfiguration

Brauchen Sie Hilfe?

Eröffnen Sie ein Ticket über Tickets › Ticket öffnen oder über die Kachel Support kontaktieren unten auf der Seite Ihres Servers im Kundenbereich. Sie können Ihre Frage auch auf dem Discord von OuiHeberg stellen.

War dieser Artikel hilfreich?

421 Aufrufe
Diesen Artikel teilen
Node.js
Node.js-Hosting benötigt?

Stellen Sie Ihre Node.js-Anwendungen mit unserem optimierten Hosting und dediziertem Support bereit.

Angebote ansehen →

Verwandte Artikel