Garder un bot Discord en ligne 24 h/24, 7 j/7 sur un VDS : PM2, systemd et NSSM
Un bot Discord n'est en ligne que tant que le processus Node.js qui l'exécute reste actif ; lorsque le terminal se ferme, que la connexion tombe ou que le processus plante, le bot tombe avec lui. Dans ce guide, vous apprendrez à exécuter le bot sur un VDS, à le maintenir en marche malgré les plantages et les redémarrages avec PM2 ou systemd sous Linux et avec NSSM ou le « Task Scheduler » (Planificateur de tâches) sous Windows, à le mettre à jour, à le déboguer et à surveiller sa consommation de ressources. Nous n'abordons pas ici l'écriture du code du bot ; pour cela, consultez le guide Comment créer un bot Discord à partir de zéro avec Discord.js v14.
Avant de commencer
- Serveur : un VDS sous Linux (Ubuntu/Debian) ou Windows Server. Les offres VDS pour bot Discord sont fournies avec 4 CPU, 2–4 Go de RAM et 30–40 Go de disque NVMe. L'adresse IP et le mot de passe administrateur initial figurent sur la page du service dans l'Espace client et dans l'e-mail d'activation.
- Connexion : vous vous connectez à Linux en SSH (port 22) et à Windows via le Bureau à distance (RDP, port 3389). Pour la marche à suivre, consultez les guides Se connecter à un VDS Linux en SSH : PuTTY, OpenSSH et clés SSH et Comment se connecter à un VDS Windows avec le Bureau à distance (RDP) ?.
- Projet du bot : un dossier qui fonctionne déjà sur votre propre ordinateur et qui contient
package.jsonetpackage-lock.json. Dans les exemples, le fichier d'entrée estindex.js. Ne copiez pas le dossiernode_modules; il est réinstallé sur le serveur. Les autres sujets se trouvent sur la page Guides bot Discord. - Token : le token du bot (clé d'accès) est le mot de passe de votre bot. Au lieu de l'écrire dans votre code, conservez-le dans le fichier
.envde votre dossier de projet, sous la forme d'une ligneDISCORD_TOKEN=..., et ne le communiquez jamais à personne. En cas de fuite du token, réinitialisez-le dans le Discord Developer Portal ; l'ancien token cesse alors de fonctionner. - Version de Node.js : utilisez la version marquée LTS (support à long terme) ; vérifiez dans la documentation de votre bibliothèque la version minimale qu'elle exige.
Étape 1 : installer Node.js sous Linux
Exécuter le bot sous son propre utilisateur plutôt qu'en root est plus sûr : une faille dans le code ne peut pas affecter tout le serveur. Créez d'abord un utilisateur nommé bot et basculez sur celui-ci :
sudo useradd -m -s /bin/bash bot
sudo -i -u bot
Option A – nvm (recommandée pour PM2) : nvm (Node Version Manager) installe Node.js par utilisateur, ne nécessite pas sudo et facilite le changement de version. Une fois connecté en tant qu'utilisateur bot :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
source ~/.bashrc
nvm install --lts
node -v
Option B – dépôt NodeSource (pratique pour systemd) : installe Node.js pour tout le système ; le chemin du fichier ne change pas lorsque vous mettez à jour la version. Exécutez-le depuis un compte disposant des droits sudo :
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
Sur les distributions basées sur RPM comme AlmaLinux, l'URL du script est https://rpm.nodesource.com/setup_lts.x et la commande d'installation est sudo yum install -y nodejs.
Étape 2 : transférer les fichiers du bot et tester à la main
Récupérez le projet avec Git, ou copiez-le dans le dossier /home/bot/discord-bot avec un client SFTP (WinSCP, FileZilla). Installez ensuite les dépendances et démarrez le bot une première fois à la main :
cd ~/discord-bot
chmod 600 .env
npm ci --omit=dev
node --env-file=.env index.js
npm ci respecte exactement les versions de package-lock.json, supprime tout dossier node_modules existant et effectue une installation propre ; --omit=dev ignore les dépendances de développement. --env-file lit le fichier .env par rapport au répertoire de travail courant et charge ses valeurs dans process.env (Node.js 20.6 et versions ultérieures). Si votre bot utilise config.json, node index.js suffit. Une fois le bot affiché en ligne, arrêtez-le avec Ctrl+C et passez à son exécution permanente.
Étape 3 : l'exécuter 24 h/24, 7 j/7 avec PM2
PM2 est un gestionnaire de processus qui redémarre automatiquement un processus planté, conserve les logs et relance vos applications au démarrage du serveur. Installez-le en tant qu'utilisateur bot et créez un fichier de configuration :
npm install pm2@latest -g
cd ~/discord-bot
pm2 init simple
Remplacez le contenu du fichier généré ecosystem.config.js par ce qui suit :
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 redémarre le bot lorsque la consommation de mémoire dépasse 400 Mo ; choisissez une valeur nettement supérieure à la consommation normale de votre bot. exp_backoff_restart_delay commence avec un délai de 100 ms entre des plantages successifs et l'augmente progressivement ; time: true ajoute un horodatage au début de chaque ligne de log. Démarrez le bot, vérifiez son état et configurez le lancement automatique au démarrage du serveur :
pm2 start ecosystem.config.js
pm2 list
pm2 logs discord-bot --lines 50
pm2 startup
pm2 save
Exécutée en tant qu'utilisateur bot, la commande pm2 startup n'installe rien elle-même ; elle affiche une ligne de la forme sudo env PATH=... pm2 startup systemd -u bot --hp /home/bot. Tapez exit pour revenir à votre compte disposant des droits sudo (par exemple root), exécutez-y cette ligne, puis revenez à l'utilisateur bot avec sudo -i -u bot. pm2 save enregistre la liste actuelle des processus, et c'est cette liste qui est restaurée au démarrage. Répétez la commande chaque fois que vous ajoutez ou supprimez des applications. Les détails figurent dans la documentation de PM2 sur le démarrage automatique.
Les logs s'accumulent dans ~/.pm2/logs. Pour éviter que le disque ne se remplisse, installez le module de rotation des logs ; avec ces réglages, un fichier est archivé dès qu'il dépasse 10 Mo et les 7 derniers fichiers sont conservés :
pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 10M
pm2 set pm2-logrotate:retain 7
Étape 4 : en alternative, configurer un service systemd
Si vous ne voulez pas d'outil supplémentaire, systemd, le gestionnaire de services propre à Linux, fait le même travail. La ligne ExecStart a besoin du chemin complet vers node ; comme le chemin de nvm dépend de la version, l'installation via NodeSource convient mieux à cette méthode. Comparez le chemin /usr/bin/node de l'exemple avec la sortie de which node, puis créez le fichier /etc/systemd/system/discord-bot.service avec sudo :
[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
Activez et démarrez le service, puis suivez le log :
sudo systemctl daemon-reload
sudo systemctl enable --now discord-bot
systemctl status discord-bot
sudo journalctl -u discord-bot -f
Restart=on-failure est la valeur que la documentation de systemd recommande pour les services de longue durée : le processus est redémarré s'il se termine avec un code non nul ou s'il est arrêté par un signal inattendu. Si la mémoire ne peut pas être maintenue sous la limite MemoryMax, le mécanisme de manque de mémoire (OOM) du noyau tue le processus et le service redémarre. N'exécutez pas le même bot à la fois sous PM2 et sous systemd : deux copies démarreraient et chaque commande recevrait deux réponses.
Étape 5 : Node.js et service NSSM sur un VDS Windows
Téléchargez le programme d'installation Windows LTS (.msi) depuis la page nodejs.org/en/download et installez-le avec les paramètres par défaut ; node.exe se trouve alors dans le dossier C:\Program Files\nodejs. Vérifiez l'installation avec node -v dans une nouvelle invite de commandes (« Command Prompt »), copiez le projet dans le dossier C:\bots\discord-bot et testez-le avec les commandes de l'étape 2.
PM2 fonctionne sous Windows, mais pm2 startup ne prend pas en charge Windows ; transformer le bot en service Windows avec NSSM est donc la voie la plus simple. La page nssm.cc/download recommande la préversion 2.24-101 pour Windows 10 Creators Update et les versions ultérieures : téléchargez donc cette version. Placez le fichier 64 bits nssm.exe de l'archive dans le dossier C:\nssm ; une fois le service installé, ne déplacez pas et ne supprimez pas ce fichier. Dans une invite de commandes ouverte en tant qu'administrateur :
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 est le paramètre le plus important : si vous le laissez vide, NSSM utilise le dossier du programme (celui de node.exe) comme répertoire de démarrage, et .env et index.js sont alors introuvables. Si l'application s'arrête, NSSM la redémarre par défaut ; AppRestartDelay impose 5 secondes entre deux tentatives. La sortie et les erreurs sont écrites dans le même fichier bot.log, qui est archivé (rotation) lorsqu'il atteint 10 Mo.
Avec le « Task Scheduler » (sans logiciel supplémentaire)
Si vous préférez ne pas installer NSSM, vous pouvez ouvrir PowerShell en tant qu'administrateur et créer une tâche qui s'exécute au démarrage :
$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 doit valoir zéro : avec la valeur par défaut, le « Task Scheduler » arrête la tâche au bout de 72 heures et le bot s'éteint tous les trois jours. Avec cette méthode, la sortie console n'est pas enregistrée et le nombre de tentatives est limité par -RestartCount ; pour un bot qui doit fonctionner en continu, préférez NSSM.
Étape 6 : mettre à jour le bot en toute sécurité
La séquence de mise à jour est toujours la même : récupérer le code, installer les dépendances, redémarrer le processus, vérifier le log. Sous Linux avec PM2 :
cd ~/discord-bot
git pull
npm ci --omit=dev
pm2 restart discord-bot
pm2 logs discord-bot --lines 30
Si vous utilisez systemd, la commande de redémarrage est sudo systemctl restart discord-bot ; sous Windows, c'est nssm restart DiscordBot. Si vous avez modifié ecosystem.config.js, exécutez pm2 delete ecosystem.config.js et pm2 start ecosystem.config.js pour que les nouveaux réglages prennent effet, puis enregistrez de nouveau la liste avec pm2 save. Les sauvegardes automatiques ne sont pas incluses dans le service VDS ; faites une copie du dossier du projet et du fichier .env avant la mise à jour. Vous pouvez envoyer les copies via SFTP vers votre espace de sauvegarde cloud.
Lorsque vous mettez à jour Node.js avec nvm, les paquets globaux, PM2 compris, doivent être transférés vers la nouvelle version et le script de démarrage doit être régénéré :
nvm install --reinstall-packages-from=current 'lts/*'
nvm alias default 'lts/*'
pm2 update
pm2 unstartup
pm2 startup
Les deux dernières commandes affichent chacune une ligne sudo ; exécutez-les dans l'ordre depuis votre compte privilégié, puis enregistrez de nouveau la liste avec pm2 save.
Étape 7 : surveiller la consommation de mémoire et de CPU
Dans l'Espace client (hanhosting.com → Se connecter → Mes services → le VDS concerné), la section Utilisation en direct affiche sous forme de graphiques l'utilisation du CPU, de la RAM, du disque et du réseau. Si la courbe de la RAM grimpe pendant des heures sans que le bot redémarre, soupçonnez une fuite de mémoire ; si le CPU est constamment au maximum, le code contient peut-être une boucle ou des requêtes excessives. Pour vérifier depuis le serveur :
pm2 monit
pm2 show discord-bot
free -h
pm2 monit affiche en temps réel l'utilisation du CPU et de la mémoire par processus ; pm2 show indique le nombre de redémarrages et l'emplacement des fichiers de log. Sous Windows, regardez la ligne node.exe dans le « Task Manager » (Gestionnaire des tâches). Pour trouver la cause, consultez le guide Utilisation élevée du CPU et de la RAM sur les serveurs VDS HanHosting : causes et solutions.
Correspondance des réglages entre les méthodes
La même tâche dans chacune des quatre méthodes :
| Tâche | PM2 | systemd | NSSM | Task Scheduler |
|---|---|---|---|---|
| Redémarrage après un plantage | autorestart (activé par défaut) | Restart=on-failure | AppExit Default Restart (par défaut) | -RestartCount (tentatives limitées) |
| Délai entre les tentatives | restart_delay, exp_backoff_restart_delay | RestartSec (100 ms par défaut) | AppRestartDelay | -RestartInterval |
| Lancement au démarrage | pm2 startup + pm2 save | systemctl enable | Start SERVICE_AUTO_START | -AtStartup |
| Répertoire de travail | cwd | WorkingDirectory | AppDirectory | -WorkingDirectory |
| Limite de mémoire | max_memory_restart | MemoryMax | — | — |
| Logs | pm2 logs, ~/.pm2/logs | journalctl -u | AppStdout, AppStderr | Non enregistrés |
Erreurs fréquentes
pm2: command not founddans une nouvelle session SSH : Node.js et PM2 installés avec nvm ne sont visibles que pour l'utilisateur qui les a installés ; PM2 installé pour l'utilisateurbotest introuvable dans une session root. Basculez sur le bon utilisateur (sudo -i -u bot) et exécutezsource ~/.bashrcsi nécessaire.- Le bot ne revient pas après le redémarrage du serveur : soit la ligne affichée par
pm2 startupn'a pas été exécutée, soitpm2 savea été oublié. Pour restaurer à la main la liste enregistrée, utilisezpm2 resurrect. An invalid token was provided.: le token est incorrect ou a été réinitialisé, ou bien le fichier.envn'est pas lu. Vérifiez le répertoire de travail (cwd,WorkingDirectory,AppDirectory) ; le chemin de--env-fileest résolu par rapport à ce dossier.Used disallowed intents: les intents privilégiés demandés par votre code n'ont pas été activés dans le Developer Portal. Sur la page Bot de votre application, dans la section « Privileged Gateway Intents », activez les interrupteurs de ceux que vous utilisez parmi « Presence Intent », « Server Members Intent » et « Message Content Intent ».EACCES: permission denied: si vous avez copié les fichiers en tant que root, corrigez le propriétaire :sudo chown -R bot:bot /home/bot/discord-bot.status=203/EXECou200/CHDIRdans systemd : 203 signifie que le chemin de node dansExecStartest incorrect ou inaccessible ; 200 signifie que systemd n'a pas pu se placer dans le dossierWorkingDirectory.- PM2 affiche l'état
errored, ou le nombre de redémarrages ne cesse d'augmenter : le bot plante dès son démarrage. Trouvez la première erreur avecpm2 logs discord-bot --lines 100, corrigez-la et exécutezpm2 restart discord-bot. - Le service NSSM apparaît comme
Paused: pendant que NSSM attend avant un redémarrage, il affiche le service comme en pause. Si le service est souvent dans cet état, le bot plante sans cesse ; la raison se trouve dans le fichierbot.log.
Questions fréquentes
Faut-il utiliser PM2 ou systemd ?
Si vous souhaitez gérer plusieurs bots avec une seule commande et surveiller facilement les logs et la consommation de ressources, PM2 est le choix pratique. Si vous préférez utiliser la gestion des services du système d'exploitation sans installer d'outil supplémentaire, systemd suffit.
Puis-je exécuter plusieurs bots sur le même VDS ?
Oui. Utilisez un dossier séparé et un fichier .env distinct pour chaque bot ; dans PM2, ajoutez une nouvelle entrée au tableau apps, ou définissez un service distinct pour chaque bot. Surveillez la consommation totale de RAM dans le graphique d'utilisation en direct de l'Espace client.
Faut-il ouvrir un port dans le pare-feu pour le bot ?
Non. Le bot se connecte lui-même au serveur Gateway de Discord et n'attend pas de connexions entrantes. Si vous exécutez un panel web ou un écouteur de webhooks sur le même serveur, n'ouvrez que ce port dans le pare-feu du système d'exploitation ; les détails figurent dans le guide Comment configurer la sécurité initiale d'un nouveau VDS (Windows et Linux).
Je n'arrive pas à me connecter en SSH. Comment vérifier le bot ?
La console VNC de l'Espace client vous permet d'accéder à l'écran du serveur depuis votre navigateur, même lorsque SSH ou RDP ne fonctionne pas. Connectez-vous-y et vérifiez l'état avec pm2 list ou systemctl status discord-bot. Si le serveur ne répond pas, utilisez l'action « Redémarrer » de l'Espace client ; si les paramètres de démarrage sont corrects, le bot revient de lui-même.
Guides associés
- Comment créer un bot Discord à partir de zéro avec Discord.js v14
- Se connecter à un VDS Linux en SSH : PuTTY, OpenSSH et clés SSH
- Comment se connecter à un VDS Windows avec le Bureau à distance (RDP) ?
- Comment configurer la sécurité initiale d'un nouveau VDS (Windows et Linux)
- Utilisation élevée du CPU et de la RAM sur les serveurs VDS HanHosting : causes et solutions
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.