Einen Discord-Bot hosten

Um einen Discord-Bot auf Lizard (lizard.build) zu hosten, führst du ihn als Hintergrund-Worker aus. Ein Gateway-Bot baut eine ausgehende Verbindung zu Discord auf und liefert kein HTTP aus. Deploye ihn deshalb mit lizard up --port 0 (containerPort=0) und betreibe pro Bot-Token genau ein Replikat. Lizard erkennt einen Node.js-Bot an der package.json und startet ihn mit npm run start; ein Python-Bot braucht eine web:-Zeile in einem Procfile.

Teststatus: Der Beispiel-Bot läuft lokal mit discord.js 14.27.0 und beendet sich mit TokenInvalid, wenn er ein gefälschtes Token bekommt. Seinen Build-Plan haben wir mit lizardpack geprüft, dem Build-Planer, den Lizard ausführt. Diese Anleitung haben wir noch nicht von Lizard aus gegen Discord getestet; sende eine Testnachricht und prüfe die Logs, bevor du dich darauf verlässt.

Bevor du beginnst

• Ein Bot-Token. Erstelle im Discord Developer Portal eine Application, öffne Bot und klicke auf Reset Token. Halte das Token geheim: Wer es hat, steuert den Bot.
• Der Message Content Intent. Das Beispiel liest !ping, also aktiviere Message Content Intent unter Bot → Privileged Gateway Intents. Ein Bot, der nur auf Slash-Befehle antwortet, braucht ihn nicht.
• Der Bot auf einem Server. Wähle unter OAuth2 → URL Generator den Scope bot und die Berechtigungen View Channels, Send Messages und Read Message History aus, öffne dann die URL und wähle einen Server.
• Lizard CLI und ein Tarif. Installiere die CLI und führe lizard login aus. Services laufen auf Lizard Pro oder in der 7-tägigen Testphase (Karte erforderlich); siehe Preise.

Den Bot schreiben

Lege einen Ordner mit zwei Dateien an.

package.json:

{
  "name": "discord-bot",
  "private": true,
  "type": "module",
  "scripts": {
    "start": "node bot.js"
  },
  "dependencies": {
    "discord.js": "^14.27.0"
  }
}

bot.js:

import { Client, Events, GatewayIntentBits } from "discord.js";
 
const token = process.env.DISCORD_TOKEN;
if (!token) {
  console.error("DISCORD_TOKEN is not set");
  process.exit(1);
}
 
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});
 
client.once(Events.ClientReady, (ready) => {
  console.log(`Logged in as ${ready.user.tag}`);
});
 
client.on(Events.MessageCreate, async (message) => {
  if (message.author.bot) return;
  if (message.content === "!ping") {
    await message.reply("pong");
  }
});
 
client.login(token);

Führe npm install aus, um package-lock.json zu erzeugen, und lass die Lock-Datei neben package.json liegen: Mit ihr installiert Lizard per npm ci. Lege eine .gitignore mit node_modules und .env an.

Um den Bot auf deinem Rechner auszuprobieren, füge das Token ein, ohne es in einer Datei zu speichern, und starte ihn dann:

read -rs DISCORD_TOKEN && export DISCORD_TOKEN
npm start

Schreib !ping in einen Kanal, den der Bot sehen kann; er antwortet mit pong. Beende die lokale Kopie, bevor du deployst. Laufen zwei Kopien, antworten beide auf jede Nachricht.

Als Worker deployen

Im Ordner des Bots:

lizard init --name discord-bot
lizard add --service bot
read -rs DISCORD_TOKEN
lizard secrets set DISCORD_TOKEN="$DISCORD_TOKEN" --service bot
lizard up --service bot --port 0

• lizard add --service bot legt einen leeren Service an; lizard up --service bot lädt anschließend den Code hoch und deployt ihn.
• lizard secrets set speichert das Token nur auf dem Service bot. Siehe Variablen und Secrets.
• --port 0 schaltet den Worker-Modus ein: Lizard setzt kein PORT, führt keinen Port-Health-Check aus und legt keine HTTP-Route an. Der Service kann trotzdem eine onlizard.com-Domain anzeigen, dort antwortet aber nichts.

Innerhalb eines Git-Repositorys überspringt lizard up alles, was in .gitignore steht. Außerhalb von Git lädt es .env-Dateien hoch. Halte das Token daher aus Dateien in diesem Ordner heraus oder führe zuerst git init aus. Siehe Aus lokalem Code deployen.

Wenn du stattdessen git push to deploy nutzen möchtest, pushe den Ordner zu GitHub, verbinde das Repository und stelle den Service dann auf den Worker-Modus um:

lizard port 0 --service bot
lizard redeploy --service bot

Ein Replikat pro Token

Jedes Replikat öffnet mit demselben Token eine eigene Gateway-Session, und jedes antwortet auf jede Nachricht. Lass den Bot-Service deshalb bei einem Replikat. Wenn du eine neue Version eines Workers deployst, stoppt Lizard den alten Prozess, bevor es den neuen startet. Dabei ist der Bot kurz nicht erreichbar; doppelte Antworten entstehen dadurch nicht. Ein Bot auf mehr als 2.500 Servern muss das Sharding von Discord nutzen; das ist eine Änderung im Code, keine Frage von mehr Replikaten desselben Prozesses.

Python-Bots

Trage discord.py in requirements.txt ein und lege ein Procfile an:

web: python bot.py

lizardpack liest nur die web:-Zeile eines Procfiles, auch bei einem Worker, und ignoriert eine worker:-Zeile. Ohne Procfile führt es python main.py aus; ein Bot in main.py braucht also kein Procfile. Deploye mit denselben Befehlen und --port 0. Wie du die Python-Version wählst, steht unter Laufzeitversionen.

Daten in Managed Postgres speichern

Dateien, die im Container geschrieben werden, gehen beim nächsten Deployment verloren. Speichere Einstellungen, Punktestände oder Warteschlangen in Managed Postgres:

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_PRIVATE_URL}}' --service bot

Die einfachen Anführungszeichen verhindern, dass deine Shell ${{…}} auswertet; Lizard löst die Referenz beim Start des Bots auf, und die Änderung der Variable startet ihn neu. Lies process.env.DATABASE_URL mit einem Client wie pg. Schreibe Handler so, dass sie gefahrlos zweimal laufen können: Ein Neustart kann Arbeit wiederholen, die gerade lief.

Prüfen, ob es funktioniert

lizard port --service bot
lizard logs --service bot --tail 50
lizard ps

lizard port gibt worker mode aus. Im Log stehen Logged in as und der Name des Bots. Schreib dann !ping auf deinem Server und warte auf genau ein pong. Auch ein Worker, der als laufend markiert ist, braucht diese Prüfung: Der Prozess kann laufen, während Discord ihn abweist.

Häufige Probleme

Ein Bot, der nur über eine Interactions Endpoint URL auf Slash-Befehle antwortet, ist dagegen ein HTTP-Service: Deploye ihn mit einem echten Port und gib Discord seine HTTPS-URL.

Siehe auch

• Hintergrund-Worker
• Einen Telegram-Bot ausführen
• Eine Node.js-App bereitstellen
• Logs
• Limits
• discord.js-Leitfaden

Aktualisiert 12. Oktober 2026