ZentexNodeZentexNode
Tutoriel

Héberger votre bot Node.js ou Python sur ZentexGame

Envoyez votre bot Discord (ou toute app Node.js ou Python) en SFTP ou depuis GitHub : variables de Démarrage, token et que faire s'il ne démarre pas.

Par Tech Team··5 min de lecture
Héberger votre bot Node.js ou Python sur ZentexGame

🤖 Ce qu'il vous faut

Pour garder votre bot en ligne 24/7, il vous faut un serveur de l'offre Node.js / Python : à la commande, vous choisissez Node.js ou Python, et il se gère depuis ZentexGame, le même panneau que nos serveurs de jeux. Il convient aux bots Discord, aux API, aux scrapers ou à toute application qui doit tourner en continu. Il vous faut aussi :
  • Le code du bot, avec son fichier principal : index.js en Node.js ou app.py en Python (ou le nom que vous utilisez).
  • La liste des dépendances : package.json en Node.js ou requirements.txt en Python. Le serveur les installe à chaque démarrage.
  • Le token du bot, fourni par le portail développeurs de Discord. C'est comme un mot de passe : ne le laissez ni dans le code ni dans un dépôt public (étape 4).
Un serveur tout juste créé n'a pas encore votre code. Si vous le démarrez avant d'envoyer vos fichiers, il s'arrête aussitôt avec une erreur du type Cannot find module '/home/container/index.js' en Node.js ou can't open file '/home/container/app.py' en Python. C'est normal : dès que vos fichiers sont en place, il démarre.

⚙️ 1. Les variables de Démarrage

Ouvrez votre serveur dans ZentexGame et allez dans Démarrage. Voici celles qui comptent :
VariableÀ quoi elle sert
Fichier principal (Node.js)Le fichier qui lance le bot ; index.js par défaut. S'il se termine par .ts, il est exécuté en TypeScript.
Fichier .py principal (Python)app.py par défaut.
Fichier de dépendances (Python)requirements.txt par défaut. Il est installé à chaque démarrage.
Paquets Node supplémentaires / Paquets Python supplémentairesPaquets isolés installés au démarrage, séparés par des espaces. Inutile s'ils figurent déjà dans package.json ou requirements.txt.
Adresse du dépôt Git et Branche GitPour installer le bot depuis GitHub (étape 3).
Utilisateur Git et Jeton d'accès GitUniquement pour les dépôts privés.
Mettre à jour au démarrageSi le bot vient de GitHub, il récupère les dernières modifications du dépôt à chaque démarrage.
Dans le même onglet, Image Docker indique la version et permet de la changer : Node.js 22, 24 ou 26, ou Python 3.7 à 3.12.

📤 2. Option A : envoyer votre code

C'est la méthode la plus directe :
  • En SFTP, avec FileZilla ou WinSCP : le plus pratique s'il y a beaucoup de fichiers. Voici comment se connecter en SFTP.
  • Ou depuis Fichiers dans le panneau, en les envoyant depuis le navigateur.
Envoyez le contenu du dossier de votre projet dans le dossier principal du serveur, celui qui s'ouvre quand vous allez dans Fichiers. Le fichier principal doit s'y trouver directement, pas dans un autre dossier. N'envoyez pas node_modules ni l'environnement virtuel Python : les dépendances s'installent toutes seules au démarrage. Puis cliquez sur Démarrer.

🔗 3. Option B : l'installer depuis GitHub

Si votre bot est dans un dépôt :
  • Dans Démarrage, saisissez l'URL dans Adresse du dépôt Git (par exemple https://github.com/utilisateur/mon-bot) et, si vous n'utilisez pas la branche par défaut, son nom dans Branche Git.
  • Allez dans Paramètres et cliquez sur Réinstaller le serveur. Le dépôt n'est téléchargé qu'à la réinstallation : enregistrer la variable ne suffit pas.
  • Le téléchargement a besoin d'un dossier vide. Si vous aviez déjà envoyé des fichiers à la main, supprimez-les avant de réinstaller ; sinon l'installation les laisse tels quels et ne télécharge rien.
  • Avec Mettre à jour au démarrage activé, chaque démarrage récupère les dernières modifications du dépôt. Cela ne marche que si le bot vient de GitHub (s'il existe un dossier .git).
Dépôt privé : mettez votre nom d'utilisateur GitHub dans Utilisateur Git et, dans Jeton d'accès Git, un jeton personnel avec un accès en lecture seule au contenu de ce dépôt (sur GitHub : Settings → Developer settings → Personal access tokens). N'utilisez pas votre mot de passe. Attention : toute personne ayant accès à Démarrage voit ce jeton, comme nous l'expliquons dans notre guide des sous-utilisateurs.

🔑 4. Le token hors du code

Gardez le token dans un fichier .env (ou un config.json) que vous n'envoyez pas dans le dépôt (ajoutez-le à .gitignore), et envoyez-le à part en SFTP ou depuis Fichiers. Votre bot le lit au démarrage, par exemple avec le paquet dotenv en Node.js ou python-dotenv en Python. Si vous installez depuis GitHub, envoyez le .env après la réinstallation, car le téléchargement a besoin d'un dossier vide.

▶️ 5. Démarrer et vérifier

  • Cliquez sur Démarrer et regardez la Console : vous y verrez l'installation des dépendances et les messages de votre bot.
  • Le panneau affiche le serveur En marche quand la console montre une ligne contenant Estoy listo! (en Node.js, ready fonctionne aussi). Si votre bot ne l'écrit pas, il fonctionne quand même, mais le panneau continue de l'afficher en Démarrage.
  • S'il s'arrête, la dernière erreur de la console en donne la raison : un fichier principal avec un autre nom, une dépendance manquante ou un token invalide.
  • Après avoir modifié le code ou les variables, cliquez sur Redémarrer.
Si vous bloquez, ouvrez un ticket sur notre Discord et nous regarderons cela avec vous.
Node.js / Python

Besoin d’héberger votre bot ?

Hébergement Node.js et Python pour bots Discord, API et scrapers, en ligne 24/7, avec activation automatique, panneau maison et sans engagement.

Voir les offres dès 1,00 €/mois →