Héberger un bot Discord 24h/24 sur un VPS

Un bot Discord lancé sur votre ordinateur se déconnecte dès que vous l'éteignez, et vos membres voient sa pastille passer au gris. Sur un VPS, il reste connecté jour et nuit, redémarre seul après une erreur et ne dépend plus de votre connexion. Ce guide va de la création du bot à sa mise en service permanente, en Python avec discord.py, avec l'équivalent pour discord.js.

1. Créer le bot dans le portail développeur

1. Ouvrez le portail développeur de Discord et créez une application.
2. Dans l'onglet Bot, générez le jeton (« Reset Token ») et copiez-le. Il ne sera plus affiché : gardez-le comme un mot de passe.
3. Toujours dans Bot, n'activez les intents privilégiés que si vous en avez besoin. Message Content n'est utile que pour lire le texte des messages ; un bot à commandes slash s'en passe.
4. Dans OAuth2, générez un lien d'invitation avec les scopes bot et applications.commands, et seulement les permissions nécessaires. Ouvrez-le pour ajouter le bot à votre serveur.

2. Préparer le VPS

Sur un VPS Debian ou Ubuntu, connecté en root, installez Python et créez un utilisateur dédié : le bot ne doit jamais tourner en root.

apt update && apt install -y python3 python3-venv
adduser --disabled-password --gecos "" bot
su - bot
mkdir monbot && cd monbot
python3 -m venv venv
venv/bin/pip install discord.py

3. Le premier bot

Créez bot.py. Ce bot répond à la commande slash /ping :

import os
import discord
from discord import app_commands
intents = discord.Intents.default()
client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)
@tree.command(name="ping", description="Vérifie que le bot répond")
async def ping(interaction: discord.Interaction):
    await interaction.response.send_message("pong")
@client.event
async def on_ready():
    await tree.sync()
    print(f"Connecté en tant que {client.user}")
client.run(os.environ["DISCORD_TOKEN"])

Testez-le une première fois à la main :

DISCORD_TOKEN="VOTRE_JETON" venv/bin/python bot.py

La commande peut mettre quelques minutes à apparaître dans Discord après la première synchronisation. Arrêtez ensuite le bot avec Ctrl+C.

4. Le faire tourner en continu avec systemd

De retour en root, placez le jeton dans un fichier lisible uniquement par root :

install -m 600 /dev/null /etc/monbot.env
echo 'DISCORD_TOKEN=VOTRE_JETON' > /etc/monbot.env

Créez /etc/systemd/system/monbot.service :

[Unit]
Description=Bot Discord
After=network-online.target
Wants=network-online.target
[Service]
User=bot
WorkingDirectory=/home/bot/monbot
EnvironmentFile=/etc/monbot.env
ExecStart=/home/bot/monbot/venv/bin/python bot.py
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target

systemctl daemon-reload
systemctl enable --now monbot
journalctl -u monbot -f     # journal en direct

Le bot redémarre désormais après une erreur et après un redémarrage du VPS. Après une modification du code : systemctl restart monbot.

5. Avec discord.js

La méthode est la même en Node.js : installez une version LTS récente de Node.js, puis npm install discord.js dans le dossier du bot. Dans le service, remplacez la ligne ExecStart par ExecStart=/usr/bin/node index.js. PM2 est une alternative courante à systemd pour les projets Node.js.

6. Ports, intents et erreurs fréquentes

• Aucun port à ouvrir : le bot se connecte lui-même à Discord. Gardez le pare-feu fermé, sauf si vous ajoutez un site ou un tableau de bord.
• Erreur sur les intents privilégiés au démarrage : l'intent demandé dans le code n'est pas activé dans le portail, ou l'inverse.
• Le bot ne voit pas le texte des messages : c'est l'intent Message Content. Préférez les commandes slash, qui n'en ont pas besoin.
• Au-delà de 2 500 serveurs, Discord impose le sharding : discord.py le gère avec AutoShardedClient.

7. Quel VPS selon votre bot

Un même VPS peut héberger plusieurs bots, avec un service et un jeton par bot. Voir notre page VPS pour bot Discord. Vous développez aussi pour Telegram ? Lisez Héberger un bot Telegram sur un VPS.

Questions fréquentes