Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

Anleitungen

Schritt-für-Schritt-Anleitungen, um Ihren eigenen Server, Gameserver und Ihre Website einzurichten und zu betreiben – vom Team, das unsere Infrastruktur in Istanbul betreibt.

Discord Bot

Discord-Bot 24/7 auf dem VDS online halten: PM2, systemd und NSSM

26 August 2026 12 Min. Lesezeit Aktualisiert:
Diesen Beitrag teilen

Ein Discord-Bot ist nur so lange online, wie der Node.js-Prozess läuft, der ihn ausführt; schließt sich das Terminal, bricht die Verbindung ab oder stürzt der Prozess ab, geht auch der Bot offline. In dieser Anleitung erfahren Sie, wie Sie den Bot auf einem VDS betreiben, ihn unter Linux mit PM2 oder systemd und unter Windows mit NSSM oder dem Task Scheduler (Aufgabenplanung) über Abstürze und Neustarts hinweg am Laufen halten, ihn aktualisieren, Fehler beheben und seinen Ressourcenverbrauch überwachen. Das Schreiben von Bot-Code behandeln wir hier nicht; dazu lesen Sie die Anleitung Discord-Bot mit Discord.js v14 von Grund auf erstellen.

Bevor Sie beginnen

  • Server: Ein VDS mit Linux (Ubuntu/Debian) oder Windows Server. Die Discord-Bot-VDS-Pakete bieten 4 CPUs, 2–4 GB RAM und 30–40 GB NVMe-Speicher. Die IP-Adresse und das erste Administratorpasswort finden Sie auf der Dienstdetailseite im Kundenbereich und in der Aktivierungs-E-Mail.
  • Verbindung: Mit Linux verbinden Sie sich per SSH (Port 22), mit Windows per Remotedesktop (RDP, Port 3389). Die Schritte finden Sie in den Anleitungen SSH-Verbindung mit PuTTY und Verbindung zu einem Windows-VDS per RDP.
  • Bot-Projekt: Ein Ordner, der auf Ihrem eigenen Computer bereits lauffähig ist und package.json und package-lock.json enthält. In den Beispielen ist die Einstiegsdatei index.js. Kopieren Sie den Ordner node_modules nicht mit; er wird auf dem Server neu installiert. Weitere Themen finden Sie auf der Seite Discord-Bot-Anleitungen.
  • Token: Das Bot-Token (Zugangsschlüssel) ist das Passwort Ihres Bots. Schreiben Sie es nicht in Ihren Code, sondern legen Sie es in der Datei .env Ihres Projektordners als Zeile DISCORD_TOKEN=... ab und geben Sie es niemals weiter. Wird das Token bekannt, setzen Sie es im Discord Developer Portal zurück; das alte Token funktioniert dann nicht mehr.
  • Node.js-Version: Verwenden Sie die als LTS (Long Term Support, Langzeitunterstützung) gekennzeichnete Version; welche Mindestversion Ihre Bibliothek benötigt, steht in deren Dokumentation.

Schritt 1: Node.js unter Linux installieren

Es ist sicherer, den Bot unter einem eigenen Benutzer statt als root auszuführen: Eine Schwachstelle im Code kann dann nicht den gesamten Server betreffen. Legen Sie zuerst einen Benutzer namens bot an und wechseln Sie zu ihm:

sudo useradd -m -s /bin/bash bot
sudo -i -u bot

Option A – nvm (empfohlen für PM2): nvm (Node Version Manager) installiert Node.js pro Benutzer, benötigt kein sudo und erleichtert den Wechsel zwischen Versionen. Als Benutzer bot angemeldet:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
source ~/.bashrc
nvm install --lts
node -v

Option B – NodeSource-Repository (praktisch für systemd): Installiert Node.js systemweit; der Dateipfad ändert sich beim Versions-Upgrade nicht. Führen Sie die Befehle mit einem Konto mit sudo-Rechten aus:

curl -fsSL https://deb.nodesource.com/setup_lts.x -o nodesource_setup.sh
sudo -E bash nodesource_setup.sh
sudo apt install -y nodejs
which node

Bei RPM-basierten Distributionen wie AlmaLinux lautet die Skript-URL https://rpm.nodesource.com/setup_lts.x und der Installationsbefehl sudo yum install -y nodejs.

Schritt 2: Bot-Dateien übertragen und manuell testen

Holen Sie das Projekt per Git oder kopieren Sie es mit einem SFTP-Client (WinSCP, FileZilla) in den Ordner /home/bot/discord-bot. Installieren Sie dann die Abhängigkeiten und starten Sie den Bot einmal manuell:

cd ~/discord-bot
chmod 600 .env
npm ci --omit=dev
node --env-file=.env index.js

npm ci hält sich exakt an die Versionen in package-lock.json, löscht ein vorhandenes node_modules-Verzeichnis und führt eine saubere Installation durch; --omit=dev überspringt Entwicklungsabhängigkeiten. --env-file liest die Datei .env relativ zum aktuellen Arbeitsverzeichnis ein und lädt ihre Werte in process.env (Node.js 20.6 und neuer). Wenn Ihr Bot config.json verwendet, genügt node index.js. Sobald der Bot als online angezeigt wird, beenden Sie ihn mit Ctrl+C und gehen zum dauerhaften Betrieb über.

Schritt 3: Mit PM2 rund um die Uhr (24/7) betreiben

PM2 ist ein Prozessmanager, der einen abgestürzten Prozess automatisch neu startet, Logs führt und Ihre Anwendungen beim Hochfahren des Servers wieder startet. Installieren Sie ihn als Benutzer bot und erstellen Sie eine Konfigurationsdatei:

npm install pm2@latest -g
cd ~/discord-bot
pm2 init simple

Ersetzen Sie den Inhalt der erzeugten Datei ecosystem.config.js durch Folgendes:

module.exports = {
  apps: [{
    name: "discord-bot",
    script: "./index.js",
    cwd: "/home/bot/discord-bot",
    node_args: "--env-file=.env",
    max_memory_restart: "400M",
    exp_backoff_restart_delay: 100,
    time: true
  }]
}

max_memory_restart startet den Bot neu, wenn der Speicherverbrauch 400 MB überschreitet; wählen Sie einen Wert deutlich über dem normalen Verbrauch Ihres Bots. exp_backoff_restart_delay beginnt die Wartezeit zwischen aufeinanderfolgenden Abstürzen bei 100 ms und erhöht sie schrittweise; time: true setzt einen Zeitstempel an den Anfang jeder Logzeile. Starten Sie den Bot, prüfen Sie seinen Status und richten Sie den automatischen Start beim Booten ein:

pm2 start ecosystem.config.js
pm2 list
pm2 logs discord-bot --lines 50
pm2 startup
pm2 save

Als Benutzer bot ausgeführt, installiert pm2 startup selbst nichts, sondern gibt eine Zeile der Form sudo env PATH=... pm2 startup systemd -u bot --hp /home/bot aus. Geben Sie exit ein, um zu Ihrem Konto mit sudo-Rechten (z. B. root) zurückzukehren, führen Sie diese Zeile dort aus und wechseln Sie dann mit sudo -i -u bot zurück. pm2 save speichert die aktuelle Prozessliste, und diese Liste wird beim Booten wiederhergestellt. Wiederholen Sie den Befehl, wann immer Sie Anwendungen hinzufügen oder entfernen. Details finden Sie in der PM2-Startup-Dokumentation.

Logs sammeln sich unter ~/.pm2/logs an. Damit die Festplatte nicht vollläuft, installieren Sie das Modul für die Logrotation; mit diesen Einstellungen wird eine Datei rotiert, sobald sie 10 MB überschreitet, und die letzten 7 Dateien werden aufbewahrt:

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 10M
pm2 set pm2-logrotate:retain 7

Schritt 4: Alternativ einen systemd-Dienst einrichten

Wenn Sie kein zusätzliches Werkzeug möchten, erledigt systemd, der Dienstmanager von Linux, dieselbe Aufgabe. Die Zeile ExecStart benötigt den vollständigen Pfad zu node; da der nvm-Pfad von der Version abhängt, eignet sich für diese Methode die NodeSource-Installation besser. Vergleichen Sie den Pfad /usr/bin/node im Beispiel mit der Ausgabe von which node und legen Sie mit sudo die Datei /etc/systemd/system/discord-bot.service an:

[Unit]
Description=Discord botu
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=bot
WorkingDirectory=/home/bot/discord-bot
ExecStart=/usr/bin/node --env-file=.env index.js
Restart=on-failure
RestartSec=5
MemoryMax=600M

[Install]
WantedBy=multi-user.target

Aktivieren und starten Sie den Dienst und verfolgen Sie dann das Log:

sudo systemctl daemon-reload
sudo systemctl enable --now discord-bot
systemctl status discord-bot
sudo journalctl -u discord-bot -f

Restart=on-failure ist der Wert, den die systemd-Dokumentation für lang laufende Dienste empfiehlt: Der Prozess wird neu gestartet, wenn er mit einem Exit-Code ungleich null endet oder durch ein unerwartetes Signal beendet wird. Lässt sich der Speicherverbrauch nicht unter dem Limit MemoryMax halten, beendet der Out-of-Memory-Mechanismus (OOM) des Kernels den Prozess, und der Dienst startet neu. Betreiben Sie denselben Bot nicht gleichzeitig unter PM2 und systemd; sonst starten zwei Instanzen, und jeder Befehl wird doppelt beantwortet.

Schritt 5: Node.js und ein NSSM-Dienst auf einem Windows-VDS

Laden Sie den LTS-Windows-Installer (.msi) von der Seite nodejs.org/en/download herunter und installieren Sie ihn mit den Standardeinstellungen; node.exe landet im Ordner C:\Program Files\nodejs. Prüfen Sie die Installation in einer neuen Eingabeaufforderung („Command Prompt“) mit node -v, kopieren Sie das Projekt in den Ordner C:\bots\discord-bot und testen Sie es mit den Befehlen aus Schritt 2.

PM2 läuft zwar unter Windows, doch pm2 startup unterstützt Windows nicht; daher ist es einfacher, den Bot mit NSSM als Windows-Dienst einzurichten. Die Seite nssm.cc/download empfiehlt für Windows 10 Creators Update und neuer die Vorabversion 2.24-101; laden Sie daher diese Version herunter. Legen Sie die 64-Bit-Datei nssm.exe aus dem Archiv im Ordner C:\nssm ab; verschieben oder löschen Sie diese Datei nicht mehr, nachdem der Dienst installiert ist. In einer als Administrator geöffneten Eingabeaufforderung:

cd C:\nssm
mkdir C:\bots\discord-bot\logs
nssm install DiscordBot "C:\Program Files\nodejs\node.exe" --env-file=.env index.js
nssm set DiscordBot AppDirectory C:\bots\discord-bot
nssm set DiscordBot Start SERVICE_AUTO_START
nssm set DiscordBot AppStdout C:\bots\discord-bot\logs\bot.log
nssm set DiscordBot AppStderr C:\bots\discord-bot\logs\bot.log
nssm set DiscordBot AppRotateFiles 1
nssm set DiscordBot AppRotateOnline 1
nssm set DiscordBot AppRotateBytes 10485760
nssm set DiscordBot AppRestartDelay 5000
nssm start DiscordBot
nssm status DiscordBot

AppDirectory ist die wichtigste Einstellung: Bleibt sie leer, verwendet NSSM den Ordner des Programms (den Ordner von node.exe) als Startverzeichnis, und .env und index.js werden nicht gefunden. Beendet sich die Anwendung, startet NSSM sie standardmäßig neu; AppRestartDelay sorgt für eine Pause von 5 Sekunden zwischen zwei Versuchen. Ausgaben und Fehler werden in dieselbe Datei bot.log geschrieben, die bei 10 MB rotiert wird.

Mit dem Task Scheduler (ohne zusätzliche Software)

Wenn Sie NSSM nicht installieren möchten, können Sie PowerShell als Administrator öffnen und eine Aufgabe anlegen, die beim Systemstart ausgeführt wird:

$a = New-ScheduledTaskAction -Execute "C:\Program Files\nodejs\node.exe" -Argument "--env-file=.env index.js" -WorkingDirectory "C:\bots\discord-bot"
$t = New-ScheduledTaskTrigger -AtStartup
$s = New-ScheduledTaskSettingsSet -ExecutionTimeLimit (New-TimeSpan -Seconds 0) -RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1)
Register-ScheduledTask -TaskName "DiscordBot" -Action $a -Trigger $t -Settings $s -User "NT AUTHORITY\SYSTEM" -RunLevel Highest
Start-ScheduledTask -TaskName "DiscordBot"

-ExecutionTimeLimit muss null sein: Mit dem Standardwert beendet der Task Scheduler die Aufgabe nach 72 Stunden, und der Bot schaltet sich alle drei Tage ab. Bei dieser Methode wird die Konsolenausgabe nicht gespeichert, und die Anzahl der Wiederholungsversuche ist durch -RestartCount begrenzt; für einen Bot, der dauerhaft laufen muss, ist NSSM die bessere Wahl.

Schritt 6: Den Bot sicher aktualisieren

Der Ablauf eines Updates ist immer gleich: Code holen, Abhängigkeiten installieren, Prozess neu starten, Log prüfen. Unter Linux mit PM2:

cd ~/discord-bot
git pull
npm ci --omit=dev
pm2 restart discord-bot
pm2 logs discord-bot --lines 30

Bei systemd lautet der Neustartbefehl sudo systemctl restart discord-bot; unter Windows nssm restart DiscordBot. Wenn Sie ecosystem.config.js geändert haben, führen Sie pm2 delete ecosystem.config.js und pm2 start ecosystem.config.js aus, damit die neuen Einstellungen greifen, und speichern Sie die Liste anschließend erneut mit pm2 save. Automatische Backups sind im VDS-Dienst nicht enthalten; sichern Sie vor dem Update eine Kopie des Projektordners und der Datei .env. Die Kopien können Sie per SFTP an den Cloud-Backup-Speicher senden.

Wenn Sie Node.js mit nvm aktualisieren, müssen globale Pakete einschließlich PM2 auf die neue Version übertragen und das Startskript neu erzeugt werden:

nvm install --reinstall-packages-from=current 'lts/*'
nvm alias default 'lts/*'
pm2 update
pm2 unstartup
pm2 startup

Die letzten beiden Befehle geben jeweils eine sudo-Zeile aus; führen Sie diese der Reihe nach in Ihrem privilegierten Konto aus und speichern Sie die Liste dann erneut mit pm2 save.

Schritt 7: Speicher- und CPU-Auslastung überwachen

Im Kundenbereich (hanhosting.com → „Anmelden“ → „Meine Dienste“ → betreffender VDS) stellt der Bereich Live-Auslastung die Nutzung von CPU, RAM, Festplatte und Netzwerk grafisch dar. Steigt die RAM-Kurve über Stunden an, ohne dass der Bot neu startet, liegt der Verdacht auf ein Speicherleck nahe; ist die CPU dauerhaft voll ausgelastet, enthält der Code möglicherweise eine Schleife oder übermäßig viele Anfragen. Zur Prüfung direkt auf dem Server:

pm2 monit
pm2 show discord-bot
free -h

pm2 monit zeigt die CPU- und Speichernutzung pro Prozess in Echtzeit an; pm2 show listet die Anzahl der Neustarts und den Speicherort der Logdateien auf. Unter Windows sehen Sie sich im Task-Manager die Zeile node.exe an. Die Ursache finden Sie mithilfe der Anleitung Hohe CPU- und RAM-Auslastung.

Entsprechende Einstellungen der Methoden im Vergleich

Dieselbe Aufgabe in jeder der vier Methoden:

AufgabePM2systemdNSSMTask Scheduler
Neustart bei Absturzautorestart (standardmäßig aktiv)Restart=on-failureAppExit Default Restart (Standard)-RestartCount (begrenzte Wiederholungen)
Verzögerung zwischen Versuchenrestart_delay, exp_backoff_restart_delayRestartSec (Standard 100 ms)AppRestartDelay-RestartInterval
Start beim Bootenpm2 startup + pm2 savesystemctl enableStart SERVICE_AUTO_START-AtStartup
ArbeitsverzeichniscwdWorkingDirectoryAppDirectory-WorkingDirectory
Speicherlimitmax_memory_restartMemoryMax——
Logspm2 logs, ~/.pm2/logsjournalctl -uAppStdout, AppStderrNicht gespeichert

Häufige Fehler

  • pm2: command not found in einer neuen SSH-Sitzung: Mit nvm installierte Node.js- und PM2-Versionen sind nur für den Benutzer sichtbar, der sie installiert hat; ein für den Benutzer bot installiertes PM2 wird in einer root-Sitzung nicht gefunden. Wechseln Sie zum richtigen Benutzer (sudo -i -u bot) und führen Sie bei Bedarf source ~/.bashrc aus.
  • Der Bot kommt nach einem Neustart des Servers nicht zurück: Entweder wurde die von pm2 startup ausgegebene Zeile nicht ausgeführt oder pm2 save wurde vergessen. Um die gespeicherte Liste manuell wiederherzustellen, verwenden Sie pm2 resurrect.
  • An invalid token was provided.: Das Token ist falsch, wurde zurückgesetzt oder .env wird nicht eingelesen. Prüfen Sie das Arbeitsverzeichnis (cwd, WorkingDirectory, AppDirectory); der Pfad für --env-file wird relativ zu diesem Ordner aufgelöst.
  • Used disallowed intents: Die privilegierten Intents, die Ihr Code anfordert, wurden im Developer Portal nicht aktiviert. Aktivieren Sie auf der Seite „Bot“ Ihrer Anwendung im Abschnitt „Privileged Gateway Intents“ die Schalter für diejenigen der Optionen „Presence Intent“, „Server Members Intent“ und „Message Content Intent“, die Sie verwenden.
  • EACCES: permission denied: Wenn Sie die Dateien als root kopiert haben, korrigieren Sie die Eigentümerschaft: sudo chown -R bot:bot /home/bot/discord-bot.
  • status=203/EXEC oder 200/CHDIR unter systemd: 203 bedeutet, dass der node-Pfad in ExecStart falsch oder nicht zugänglich ist; 200 bedeutet, dass systemd nicht in den Ordner WorkingDirectory wechseln konnte.
  • PM2 zeigt den Status errored an oder die Zahl der Neustarts steigt ständig: Der Bot stürzt direkt nach dem Start ab. Suchen Sie mit pm2 logs discord-bot --lines 100 den ersten Fehler, beheben Sie ihn und führen Sie pm2 restart discord-bot aus.
  • Der NSSM-Dienst wird als Paused angezeigt: Während NSSM vor einem Neustart wartet, zeigt es den Dienst als pausiert an. Befindet sich der Dienst häufig in diesem Zustand, stürzt der Bot immer wieder ab; die Ursache steht in der Datei bot.log.

Häufig gestellte Fragen

Soll ich PM2 oder systemd verwenden?

Wenn Sie mehrere Bots mit einem einzigen Befehl verwalten und Logs sowie Ressourcenverbrauch bequem im Blick behalten möchten, ist PM2 die praktische Wahl. Wenn Sie lieber mit der Dienstverwaltung des Betriebssystems arbeiten, ohne zusätzliche Werkzeuge zu installieren, reicht systemd aus.

Kann ich mehr als einen Bot auf demselben VDS betreiben?

Ja. Verwenden Sie für jeden Bot einen eigenen Ordner und eine eigene .env-Datei; fügen Sie in PM2 dem Array apps einen neuen Eintrag hinzu oder legen Sie für jeden Bot einen eigenen Dienst an. Behalten Sie die gesamte RAM-Nutzung im Live-Auslastungsdiagramm des Kundenbereichs im Blick.

Muss ich für den Bot einen Port in der Firewall öffnen?

Nein. Der Bot baut selbst eine ausgehende Verbindung zum Gateway-Server von Discord auf und wartet nicht auf eingehende Verbindungen. Wenn Sie auf demselben Server ein Webpanel oder einen Webhook-Listener betreiben, öffnen Sie nur diesen Port in der Firewall des Betriebssystems; Details finden Sie in der Anleitung Erste Sicherheitseinstellungen auf dem VDS.

Ich kann mich nicht per SSH verbinden. Wie prüfe ich den Bot?

Über die VNC-Konsole im Kundenbereich erreichen Sie den Bildschirm des Servers direkt im Browser, auch wenn SSH oder RDP nicht funktionieren. Melden Sie sich dort an und prüfen Sie den Status mit pm2 list oder systemctl status discord-bot. Reagiert der Server nicht, nutzen Sie im Kundenbereich die Aktion „Neu starten“; sind die Autostart-Einstellungen korrekt, kommt der Bot von selbst wieder online.

Verwandte Anleitungen

Kommentare0

Noch keine Kommentare

Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.

Diskutieren Sie mit

Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.

Keinen Beitrag verpassen

Erhalten Sie unsere neuesten Tutorials, Anleitungen und Produktneuigkeiten direkt in Ihr Postfach.

Sie haben unseren Newsletter abonniert.