Pour héberger un bot disnake 24/7, faites-le tourner sur une machine qui reste allumée plutôt que sur votre PC : un VPS Linux avec un service systemd si vous l'hébergez vous-même, ou une offre bot sur PlayNHost Discord bot hosting (à partir de 1,99 $US par mois), où vous envoyez votre code, collez le token et appuyez sur Démarrer. Dans notre test, un bot disnake 2.12.2 a utilisé environ 47 Mo de mémoire et a joint Discord environ 0,9 seconde après son lancement. disnake demande de figer sa version, et sur un serveur qui met à jour les paquets tout seul, cela compte. Les étapes sur PlayNHost :
- Sur la page Discord bot hosting, cliquez sur Créer un serveur pour une offre. Dans la fenêtre de commande, répondez à Pour quelle plateforme est votre bot ? par Discord et choisissez Python.
- Ouvrez votre serveur dans le panel. La carte Configurer votre bot sur Aperçu s'ouvre sur Connexion à Discord. Sa première étape, Ce qui tourne, doit indiquer Ce bot fait tourner Python Bot. ; cliquez sur cette étape pour le vérifier, puis sur Continuer.
- Dans Connexion à Discord, collez votre token dans Collez le token de votre bot, cliquez sur Connexion, puis sur Oui, continuer.
- Dans Permissions, cochez Mon code l’utilise uniquement pour les intents privilégiés que demande votre code (le bot ci-dessous n'en a besoin d'aucun), cliquez sur Ajouter à un serveur Discord, puis sur Continuer.
- Dans Votre code, cliquez sur Téléverser des fichiers et envoyez
bot.pyet unrequirements.txtavec une lignedisnakefigée, ou cliquez sur Connecter Git. - Si votre fichier principal n'est pas
bot.py, définissez le Fichier d’entrée sur la page Bot, volet Code, puis cliquez sur Enregistrer. - Cliquez sur Démarrer le bot et surveillez la Console. Quand votre bot affiche
Logged in as ..., la carte indique Votre bot est en ligne sur Discord.
Les étapes générales pour Python (runtime, paquets, lignes de console) sont dans Comment héberger un bot Discord Python. Cette page couvre ce qui change avec disnake.
Ce que nous avons mesuré
Nous avons fait tourner chaque bibliothèque Discord pour Python sur nos propres serveurs, dans la même configuration Python 3.12 que celle d'une offre bot, avec une limite de mémoire de 1 Go :
| Bibliothèque | Version | Mémoire au repos | Du démarrage à la réponse de Discord |
|---|---|---|---|
| disnake | 2.12.2 | 47 Mo | 0,9 s |
| discord.py | 2.7.1 | 48 Mo | 1,0 s |
| Pycord | 2.8.1 | 51 Mo | 1,1 s |
| nextcord | 3.2.0 | 47 Mo | 1,0 s |
| hikari | 2.7.0 | 61 Mo | 1,3 s |
| Python seul | 3.12 | 9 Mo |
Méthode : le plus petit programme qui charge la bibliothèque et se connecte avec un faux token, installé comme nos serveurs l'installent. La mémoire est celle que le processus occupait 15 secondes après le refus du token par Discord, et le temps de démarrage va du lancement à cette réponse, il inclut donc un aller-retour vers Discord. Chaque valeur est la médiane de trois exécutions après une exécution de préchauffage. C'est le plancher : un bot qui s'est connecté, a rejoint des serveurs et mis des membres en cache en utilise plus, dans une mesure qui dépend du bot.
Ce que cela change pour l'offre : un bot disnake minimal n'utilise qu'une petite partie de l'offre STARTER de 0,5 Go. Dimensionnez l'offre selon ce que votre propre bot garde en mémoire, pas selon la bibliothèque.
Un bot disnake minimal
Il répond à /ping avec une commande slash et affiche une ligne de démarrage. Il lit le token dans DISCORD_TOKEN, le nom que le panel donne à votre code.
requirements.txt
disnake==2.12.*
bot.py
import os
import disnake
from disnake.ext import commands
bot = commands.InteractionBot()
@bot.event
async def on_ready():
print(f"Logged in as {bot.user}")
@bot.slash_command(description="Check that the bot answers")
async def ping(inter: disnake.ApplicationCommandInteraction):
await inter.response.send_message("Pong!")
bot.run(os.environ["DISCORD_TOKEN"])
commands.InteractionBot est le bot de disnake pour les commandes d'application uniquement, sans préfixe à définir. Il enregistre /ping auprès de Discord tout seul après la connexion. La ligne Logged in as fait passer l'indicateur sur Aperçu à En ligne sur Discord.
Si le token est incorrect
Quand Discord refuse le token, disnake lève cette erreur (le texte qu'a affiché notre bot de test) :
LoginFailure: Improper token has been passed.
Avec bot.run(), un traceback se termine par disnake.errors.LoginFailure: Improper token has been passed. et le bot s'arrête. Le panel lit cette ligne : l'indicateur affiche Problème de token et une bannière indique Discord n’a pas accepté le token de votre bot. Obtenez un nouveau token dans le Discord Developer Portal : votre application, Bot, Reset Token (il n'est affiché qu'une fois). Cliquez sur Remplacer le token dans la bannière, puis sur Remplacer le token dans le volet Discord, collez-le et redémarrez le bot. Voir Comment créer un bot Discord et obtenir son token.
Ce qu'un hébergeur doit savoir sur disnake
- Figez la version. Le README de disnake dit qu'il ne suit pas tout à fait le versionnage sémantique et recommande de figer une version mineure, comme
disnake==2.12.*oudisnake~=2.12.2. Sur nos serveurs, cela compte double : le script de démarrage exécutepip install -Usur votrerequirements.txtquand il change, et de nouveau au premier démarrage un jour après la dernière installation, si bien qu'une lignedisnakenon figée peut passer toute seule à une nouvelle version. Avec la version figée, vous recevez les correctifs dans 2.12 et choisissez quand monter. - L'import est disnake. Vous installez
disnakeet écrivezimport disnake; il n'installe pas de modulediscord, donc il n'écrase ni discord.py ni Pycord. Ne gardez malgré tout dansrequirements.txtque la bibliothèque que votre code utilise. - Version de Python. disnake 2.12 demande Python 3.10 ou plus récent. Le Runtime du volet Code propose de 3.10 à 3.14, avec 3.12 par défaut, donc tout choix convient.
- La synchronisation des commandes supprime ce que votre code ne définit pas. Par défaut, disnake synchronise les commandes globales et celles des serveurs et peut supprimer sur Discord des commandes que votre code n'a plus (
allow_command_deletion). Un second programme connecté avec le même bot, comme une copie de test sur votre PC, perd ses commandes quand la copie du serveur se synchronise. Utilisez une application distincte pour les tests. - Voir la synchronisation. Passez
command_sync_flags=commands.CommandSyncFlags(sync_commands_debug=True)àInteractionBot(). disnake affiche alors ce qu'il synchronise même si la journalisation n'est pas configurée, et les lignes apparaissent dans la Console. - Intents. Les intents par défaut n'en incluent aucun de privilégié, et les commandes slash n'en demandent pas. Les commandes à préfixe avec
commands.Botdemandentintents.message_content = Truedans votre code et Message Content Intent activé dans le Developer Portal. Si votre code le demande alors qu'il est désactivé dans le Portal, Discord refuse la connexion. Voir Corriger « Used disallowed intents » sur votre bot Discord.
L'héberger vous-même sur un VPS Linux
Sur Debian ou Ubuntu, installez Python, créez un utilisateur et un dossier pour le bot, puis installez disnake dans un environnement virtuel :
sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/disnake-bot bot
sudo cp bot.py requirements.txt /opt/disnake-bot/
sudo chown bot: /opt/disnake-bot/bot.py /opt/disnake-bot/requirements.txt
sudo -u bot python3 -m venv /opt/disnake-bot/venv
sudo -u bot /opt/disnake-bot/venv/bin/pip install -r /opt/disnake-bot/requirements.txt
Placez le token dans un fichier que seul root peut lire. Créez /etc/disnake-bot.env avec sudo nano /etc/disnake-bot.env, écrivez une ligne, DISCORD_TOKEN= suivi de votre token, enregistrez-la et exécutez sudo chmod 600 /etc/disnake-bot.env.
Créez ensuite /etc/systemd/system/disnake-bot.service :
[Unit]
Description=disnake Discord bot
Wants=network-online.target
After=network-online.target
[Service]
User=bot
WorkingDirectory=/opt/disnake-bot
EnvironmentFile=/etc/disnake-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/disnake-bot/venv/bin/python bot.py
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
Démarrez-le maintenant et à chaque démarrage, puis suivez sa sortie :
sudo systemctl daemon-reload
sudo systemctl enable --now disnake-bot
sudo journalctl -u disnake-bot -f
PYTHONUNBUFFERED=1 fait arriver print() dans le journal tout de suite au lieu d'attendre qu'un tampon se remplisse. Ici, rien ne se met à jour tout seul : pour passer à un disnake plus récent, changez la version figée, relancez la ligne pip install puis sudo systemctl restart disnake-bot.
Auto-hébergement ou offre bot
| Votre propre VPS | Une offre bot PlayNHost | |
|---|---|---|
| Python | La version fournie par votre distribution ; vous l'installez et la mettez à jour | Choisissez de 3.10 à 3.14 sous Runtime |
| Paquets | Vous lancez pip install après chaque changement | Installés avec pip install -U à un démarrage suivant un changement de requirements.txt ou de la version de Python, et au premier démarrage un jour après la dernière installation, dans le respect de vos versions figées |
| Redémarrages | Votre unité systemd | Redémarré après un plantage ; laissé à l'arrêt avec la raison s'il replante dans la minute |
| Le token | Un fichier que vous protégez vous-même | Stocké chiffré, vérifié auprès de Discord quand vous le collez, transmis à votre code sous le nom DISCORD_TOKEN |
| Erreurs | Vous lisez le journal | La bannière de la console nomme la cause, comme un token incorrect ou un intent manquant |
| Mises à jour système, pare-feu, SSH | À vous de les faire | Pas votre travail |
Questions fréquentes
Mon bot disnake est tombé en panne après un redémarrage sans aucun changement. Pourquoi ?
Si requirements.txt indique seulement disnake, l'installation des paquets au premier démarrage un jour après la précédente a pu le faire passer à une version plus récente, et disnake ne promet pas que les versions mineures soient exemptes de changements cassants. Figez la version que vous avez testée, par exemple disnake==2.12.*, puis redémarrez le bot : les paquets sont réinstallés parce que le fichier a changé.
Pourquoi /ping n'apparaît-il pas sur mon serveur ?
Vérifiez que le bot a été ajouté avec Ajouter à un serveur Discord et que la console affiche Logged in as. Pendant vos tests, passez test_guilds=[your_server_id] à InteractionBot(), comme le font les exemples de disnake : les commandes sont alors créées dans ce serveur, et la documentation de Discord indique que les commandes de serveur se mettent à jour instantanément.
Le code disnake est-il le même que celui de discord.py ?
Proche, mais pas identique. disnake garde la syntaxe et la structure de discord.py 2.0, sous le nom disnake, mais a ses propres commandes slash : @bot.slash_command avec inter.response.send_message(), et les options sont lues dans les paramètres de la fonction. Changez les imports et le code des commandes quand vous migrez.
Un bot disnake tient-il dans la plus petite offre ?
Oui. Avec environ 47 Mo dans notre test, un bot disnake minimal laisse l'essentiel de l'offre STARTER de 0,5 Go à votre propre code. Passez à l'offre supérieure quand votre bot l'exige : grands serveurs dont il met les membres en cache, fichiers ou images qu'il traite, ou données qu'il garde en mémoire.
Prêt à lancer le vôtre ? Choisissez une offre sur Discord bot hosting et envoyez votre bot disnake.



