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