Connecter Pterodactyl

Créer les serveurs de jeu automatiquement au paiement.

Mis à jour le 1 octobre 2026

Sur cette page

Velnex crée, suspend, réactive, modifie et supprime les serveurs de jeu sur votre panel Pterodactyl, au rythme des paiements.

1. Côté Pterodactyl

  • au moins une Location avec un Node qui a des allocations (IP:port) libres ;
  • les Nests / Eggs des jeux que vous vendez ;
  • une clé API d’application : Admin → Application API → Create New, avec les droits lecture et écriture sur Users, Servers, Nests, Locations et Allocations. Elle commence par ptla_.
  • facultatif mais conseillé, une clé API client d’un compte administrateur : Account → API Credentials. Elle commence par ptlc_ et permet à vos clients de démarrer, arrêter et redémarrer leur serveur et de voir sa consommation depuis Velnex.

2. Ajouter le serveur dans Velnex

Catalogue → Serveurs → Nouveau serveur :

Champ Valeur
Fournisseur Pterodactyl
Nom pour vous repérer, ex. « Panel Gaming Paris »
URL du panel https://panel.mon-hebergeur.fr (la racine du panel, sans /api)
Capacité maximale nombre de services au plus sur ce serveur ; vide = illimitée
Serveur actif décoché : plus aucun nouveau service n’y est créé
Clé API d’application ptla_…
Clé API client (facultatif) ptlc_…

Enregistrez, puis cliquez sur Tester la connexion : « Connexion réussie » confirme que le panel répond et que la clé est valide. En cas d’échec, le détail est écrit dans storage/logs/laravel.log. Les clés sont chiffrées et ne sont jamais réaffichées ; si vous changez l’URL, ressaisissez-les.

3. Configurer un produit

Catalogue → Produits, section Provisioning : Fournisseur Pterodactyl, Serveur le vôtre ou « Automatique (premier serveur disponible) », puis les options (les listes se remplissent depuis le panel une fois le serveur choisi) :

Option Par défaut Détail
Emplacement un nœud disponible y est choisi automatiquement
Jeu / type de serveur (egg) format nest_id:egg_id si saisi à la main
Mémoire (Mo) 2048
Swap (Mo, -1 = illimité) 0
Disque (Mo) 10240
CPU (%) 100 100 = 1 cœur, 200 = 2 cœurs, 0 = illimité
Poids E/S (10-1000) 500
Bases de données / Sauvegardes 0 limites du serveur
Ports supplémentaires 1 allocations en plus du port principal
Variables d’environnement une ligne CLÉ=valeur par variable, pour remplacer les valeurs par défaut de l’egg

L’image Docker et la commande de démarrage viennent toujours de l’egg. Pour laisser le client choisir (RAM, slots…), ajoutez des Options de commande dont le Réglage remplacé est l’option du fournisseur (voir « Produits, cycles et options »).

Ce qui se passe ensuite

  • Au paiement : Velnex crée (ou retrouve, par son e-mail) le compte du client sur le panel, puis son serveur. Le compte est créé sans mot de passe : Pterodactyl envoie au client un e-mail pour le choisir. Par sécurité, Velnex refuse d’utiliser un compte administrateur du panel.
  • Impayé : le serveur est suspendu, puis supprimé à la résiliation.
  • Changement d’offre : les limites (RAM, disque, CPU…) sont mises à jour, sans réinstallation ; l’egg, l’emplacement et les variables sont conservés.
  • Espace client : adresse du serveur (ip:port), lien Gérer mon serveur vers le panel, identifiant du panel, raccourcis (console, fichiers, bases de données, sauvegardes, tâches, réseau, démarrage), bouton Générer un nouveau mot de passe pour le panel et, avec la clé client, boutons démarrer/arrêter/redémarrer et consommation en direct.

Dépannage

Symptôme Que vérifier
« Tester la connexion » échoue URL sans /api et en https://, droits de la clé ptla_, pare-feu du panel
Service « Échec de création » allocations libres dans l’emplacement, egg existant, e-mail du client déjà utilisé par un administrateur du panel
Service bloqué « Création en cours » le service velnex-queue doit tourner (voir « Tâches de fond »)
Pas de boutons ni de consommation côté client clé API client (ptlc_) absente ou d’un compte non administrateur

Cet article n’a pas résolu votre problème ?

Ouvrir un ticket