Aller au contenu
Black Friday · −50 % la première facture sur les VPS Xeon avec le code BF50XEON, −30 % sur nos autres services avec BF30 · hors noms de domaine et serveurs dédiés Voir les offres
CloudFive
Se connecter

01

Pourquoi un bot s'arrête quand votre ordinateur s'éteint

Un bot Discord est un programme qui reste connecté en permanence aux serveurs de Discord. Tant qu'il tourne, il reçoit les messages et les commandes, et y répond. Dès que le programme s'arrête (ordinateur en veille, coupure de la box, fenêtre fermée), le bot apparaît hors ligne.

Pour un bot disponible jour et nuit, il faut donc une machine allumée en continu :

  • votre propre ordinateur : gratuit, mais il doit rester allumé et connecté, et le bot s'arrête à chaque redémarrage ;
  • un hébergement fait pour les bots : vous déposez votre code, il tourne en continu, sans système à administrer ;
  • un VPS : une machine entière, avec l'accès root, pour plusieurs bots, une base de données, un site ou Docker.

Un bot classique ouvre lui-même sa connexion vers Discord. Il n'a aucun port à ouvrir sur la machine, contrairement à un serveur de jeu ou à un site web.

02

Créer l'application et inviter le bot

  1. Sur le Discord Developer Portal, créez une application (New Application).
  2. Dans l'onglet Bot, choisissez un nom et un avatar, puis générez le jeton (Reset Token). Copiez-le tout de suite : Discord ne l'affiche qu'une fois.
  3. Dans OAuth2, générez le lien d'invitation avec les portées bot et applications.commands (pour les commandes slash).
  4. Cochez seulement les permissions dont le bot a besoin. Évitez Administrator : si le jeton fuit, quelqu'un aurait tous les droits sur vos serveurs.

Côté code, les deux bibliothèques les plus utilisées sont discord.js (JavaScript, sur Node.js) et discord.py (Python). Prenez celle du langage que vous connaissez : les deux couvrent les commandes slash, les boutons, les menus et les fenêtres de saisie.

03

Les intents : ce que le bot a le droit de recevoir

À la connexion, le bot déclare les intents, c'est-à-dire les familles d'événements qu'il veut recevoir : serveurs, messages, réactions, membres… Il ne reçoit rien d'autre.

Trois intents sont dits privilégiés et doivent aussi être activés dans l'onglet Bot du portail :

  • Message Content : lire le texte des messages, utile pour les anciennes commandes à préfixe (!aide). Les commandes slash n'en ont pas besoin ;
  • Server Members : les arrivées, les départs et la liste des membres ;
  • Presence : les statuts et les activités des membres.

Un intent demandé dans le code mais non coché dans le portail empêche le bot de se connecter : c'est l'erreur la plus fréquente au premier démarrage. Ne demandez que ce dont vous avez besoin : au-delà de 100 serveurs, Discord demande de vérifier le bot et de justifier chaque intent privilégié.

04

Le jeton : un mot de passe à ne jamais publier

Le jeton suffit à prendre le contrôle du bot : envoyer des messages, bannir des membres, supprimer des salons selon ses permissions. Il ne doit jamais apparaître dans le code, dans une capture d'écran ni dans un dépôt Git, même privé.

Rangez-le dans une variable d'environnement, souvent lue depuis un fichier .env placé à côté du code :

  • dans le fichier .env : DISCORD_TOKEN=votre_jeton ;
  • en Node.js : process.env.DISCORD_TOKEN, avec le paquet dotenv ou l'option --env-file des versions récentes de Node.js ;
  • en Python : os.environ["DISCORD_TOKEN"], avec le paquet python-dotenv.

Ajoutez .env au fichier .gitignore avant le premier envoi sur Git. Rangez au même endroit les autres secrets : mot de passe de la base de données, clés d'API.

Si le jeton a fuité, régénérez-le immédiatement dans le portail (Reset Token) : l'ancien cesse aussitôt de fonctionner.

05

Rester en ligne : redémarrage automatique et logs

Les bibliothèques se reconnectent seules après une coupure réseau. En revanche, si le programme plante (erreur non gérée, mémoire épuisée), il faut quelque chose pour le relancer :

  • sur un VPS Linux, un service systemd avec Restart=always relance le bot après un plantage et au démarrage de la machine ;
  • pour Node.js, pm2 fait la même chose (pm2 start index.js --name bot, puis pm2 startup et pm2 save) ;
  • dans le code, interceptez les erreurs des commandes : une commande qui échoue doit répondre « erreur », pas arrêter tout le bot.

Les logs (journaux) racontent ce qui s'est passé avant un plantage. Écrivez-y la date, la commande et l'erreur complète, jamais le jeton. Sur un VPS, journalctl ou pm2 logs les affichent ; limitez leur taille pour qu'ils ne remplissent pas le disque.

06

Où ranger les données du bot

Niveaux, avertissements, réglages par serveur : dès que le bot doit se souvenir de quelque chose, il lui faut un stockage.

  • Un fichier JSON convient pour quelques réglages, mais il se corrompt facilement si deux écritures arrivent en même temps ou si le bot s'arrête pendant l'enregistrement.
  • SQLite est une vraie base de données dans un seul fichier, sans serveur à installer : le bon point de départ.
  • MariaDB, MySQL ou PostgreSQL deviennent utiles quand plusieurs programmes partagent les données (un bot et son site, par exemple) ou quand le volume grandit.

Quel que soit le choix, sauvegardez la base régulièrement, et gardez une copie ailleurs que sur la machine du bot.

07

Mises à jour, sécurité et croissance

  • Mettez à jour la bibliothèque : Discord fait évoluer son API, et une version trop ancienne de discord.js ou de discord.py finit par ne plus fonctionner. Lisez les notes de version avant une mise à jour majeure.
  • Figez les versions : package-lock.json en Node.js, un requirements.txt avec les numéros de version en Python. Le bot se réinstalle alors à l'identique sur une autre machine.
  • Vérifiez les permissions dans le code : une commande de modération doit contrôler que la personne qui l'appelle a le droit de l'utiliser.
  • Respectez les limites de débit : les bibliothèques les gèrent, mais une boucle qui envoie des messages en rafale ralentit le bot et peut le faire bloquer.
  • Au-delà de 2 500 serveurs, Discord impose le sharding : le bot ouvre plusieurs connexions. discord.js et discord.py le gèrent tous deux.
08

Héberger votre bot chez CloudFive

L'hébergement Node.js et Python est fait pour un bot, une API ou un script qui tourne en continu, sans administrer un VPS entier :

  • Node.js ou Python au choix à la commande, mêmes paliers et mêmes prix ; le passage de l'un à l'autre se fait sur simple ticket ;
  • processeur Ryzen 9 9950X et stockage NVMe, en France, avec une protection basique incluse ;
  • en ligne en 30 secondes, sans engagement, et la console du bot se lit depuis l'espace client ;
  • le palier Développeur suffit pour un bot qui sert quelques serveurs Discord ; Avancé ajoute une base de données incluse, Expert deux bases et une sauvegarde.

Pour plusieurs bots avec leur site ou leurs outils, un VPS Ryzen donne l'accès root et une adresse IP dédiée ; le VPS Start suffit pour quelques bots Discord. Pour Docker, prenez le VPS KVM. Le guide hébergement web ou VPS aide à trancher, et sécuriser un VPS Linux donne les premiers réglages.

09

Questions fréquentes

Comment héberger un bot Discord gratuitement ?

Le plus simple est de le faire tourner sur votre ordinateur, mais il s'arrête dès que l'ordinateur s'éteint ou se met en veille. Pour un bot disponible jour et nuit, il faut une machine allumée en continu : un hébergement pour bots ou un VPS.

Faut-il ouvrir un port pour un bot Discord ?

Non. Un bot classique ouvre lui-même sa connexion vers Discord : aucun port entrant n'est nécessaire. Seuls un site web ou un point d'accès pour webhooks, s'il y en a un à côté du bot, demandent un port ouvert.

discord.js ou discord.py ?

Prenez la bibliothèque du langage que vous connaissez. discord.js fonctionne avec Node.js, discord.py avec Python ; les deux gèrent les commandes slash, les boutons et les menus.

Que faire si le jeton de mon bot a fuité ?

Régénérez-le immédiatement dans l'onglet Bot du Discord Developer Portal : l'ancien jeton cesse de fonctionner. Mettez ensuite le nouveau dans votre variable d'environnement et vérifiez que le fichier .env n'est pas suivi par Git.

Mon bot refuse de se connecter à cause des intents, pourquoi ?

Un intent privilégié (Message Content, Server Members ou Presence) est demandé dans le code sans être activé dans l'onglet Bot du portail. Cochez-le dans le portail, ou retirez-le du code s'il ne sert pas.

Assistance IA CloudFive

Une réponse tout de suite, une vraie équipe derrière.

L’IA CloudFive vous répond à toute heure, en quelques secondes. Quand elle ne sait pas, ou dès que vous le demandez, l’équipe qui administre les machines prend le relais. Pas de file d’attente à l’étranger.

  • TicketL’équipe vous répond en moins de 2 h, 7 j/7.
  • IA CloudFiveÀ toute heure, sur ia.cloudfive.fr, Discord et l’espace client.
  • DiscordL’équipe, l’IA et les autres clients, dans le salon d’entraide.
  • Vos données restent chez nousIA sur nos serveurs en France ; e-mails, IP et mots de passe masqués.
Un ticket dans l'espace client : la question d'un client sur un plugin Minecraft, la réponse de l'équipe CloudFive
Un vrai ticket dans l'espace client, répondu par l’équipe (compte de démonstration).
ESPACE CLIENT · APPLICATION

Vos serveurs.
À portée de main.

Redémarrez un serveur, suivez ses ressources en direct, réglez une facture ou ouvrez un ticket — et recevez une alerte quand quelque chose cloche.

  • État de tous vos services d'un coup d'œil
  • Attaques bloquées, trafic filtré, pic du mois
  • Notification si un serveur tombe ou une facture arrive

Application bientôt disponible · en attendant, tout se fait depuis votre navigateur sur manager.cloudfive.fr

L'application CloudFive : la liste de vos services, avec leur état
L'application CloudFive : l'accueil, état de vos services, attaques bloquées et facture à régler