Qu'est-ce que Pterodactyl ? Panel, Wings et installation sur VPS

Pterodactyl est un panel open source et gratuit qui permet de gérer des serveurs de jeu (Minecraft, Rust, FiveM…) depuis une interface web. Il repose sur deux briques : le Panel (PHP/Laravel) et Wings, un démon qui lance chaque serveur dans un conteneur Docker isolé. Il s'agit bien du logiciel, pas du ptérosaure.

Si vous administrez déjà un serveur chez un hébergeur, vous avez sans doute croisé un panel de ce genre sans le savoir. Voici comment celui-ci fonctionne, ce qu'il faut pour l'installer, et comment choisir entre le monter vous-même et le déléguer.

En bref

• Pterodactyl se compose d'un Panel (interface web, API, base de données) et de Wings (démon qui pilote Docker sur chaque machine).
• Les « eggs » sont les recettes qui décrivent comment installer et lancer chaque jeu.
• Le logiciel est gratuit sous licence MIT, mais le VPS, la maintenance et la sécurité restent à votre charge.
• Wings exige un Linux capable de faire tourner Docker : KVM sans souci, OpenVZ et LXC à éviter.
• Pour plusieurs serveurs ou de la revente, un VPS pré-installé fait gagner du temps ; pour un ou deux serveurs, un serveur géré suffit.

À quoi sert Pterodactyl et pour qui ?

Pterodactyl rassemble tous vos serveurs de jeu dans une seule interface, avec des accès séparés pour chaque personne. Fini les sessions SSH et les dossiers éparpillés : vous créez un serveur en quelques clics et chaque admin ne voit que ce qui le concerne.

Trois profils s'y retrouvent :

• une communauté qui fait tourner un Minecraft survie, un créatif, un Rust et un bot Discord, avec des modérateurs différents sur chacun ;
• un revendeur ou micro-hébergeur qui loue des serveurs à des clients ;
• une association ou une team e-sport qui veut garder la main sur son infrastructure.

Le panel embarque des comptes et sous-utilisateurs avec permissions, une console en temps réel, un gestionnaire de fichiers, un accès SFTP, un planificateur de tâches (redémarrage, sauvegarde), des sauvegardes et une base de données par serveur.

Reste qu'il n'est pas fait pour tout le monde. Pour un seul serveur entre amis, administrer Linux, Docker et SSL revient à perdre du temps : un serveur Minecraft clé en main vous met en ligne en moins d'une minute, sans la moindre ligne de commande.

Panel et Wings : la différence en clair

Le Panel est le cerveau, Wings est le bras. Le premier affiche l'interface et stocke la configuration ; le second exécute réellement les serveurs.

Le schéma tient en une ligne : Panel ↔ Wings ↔ conteneurs Docker (un par serveur de jeu).

Brique	Rôle	Technologies
Panel	Interface web, API, comptes, configuration des serveurs	PHP/Laravel, front React, base MariaDB ou MySQL, Redis (cache et files d'attente)
Wings	Démon installé sur chaque machine (node) : lance les conteneurs, expose le SFTP	Go, Docker

Un seul panel peut piloter plusieurs nodes. Vous répartissez donc vos serveurs sur plusieurs VPS ou dédiés sans quitter l'interface unique. Pour démarrer, Panel et Wings peuvent cohabiter sur le même VPS, comme le font la plupart des petites communautés.

Wings a remplacé l'ancien démon Node.js et il est écrit en Go. La documentation officielle détaille son installation.

Les eggs et les nests : les recettes de chaque jeu

Un egg est un fichier JSON qui décrit comment faire tourner un jeu : image Docker, script d'installation, commande de démarrage, variables modifiables (version, RAM, seed de map…) et détection du démarrage. Les nests classent les eggs par famille : Minecraft, Source Engine, Rust, etc.

Exemples concrets : un egg Paper pour Minecraft, un egg Rust avec Oxide/uMod, un egg FiveM avec txAdmin. Pterodactyl en fournit quelques-uns, et la communauté en publie un grand nombre d'autres sur des dépôts publics.

Le piège classique, c'est l'egg communautaire mal maintenu. Une mise à jour du jeu, et l'installation ou le démarrage casse. Avant d'importer un egg, regardez la date de sa dernière mise à jour et lisez les derniers retours des utilisateurs.

Pterodactyl est-il gratuit ?

Oui. Le dépôt officiel du Panel indique un projet libre et open source sous licence MIT, sans formule payante. Le coût réel se niche ailleurs :

• le VPS ou le dédié qui héberge le tout ;
• un nom de domaine, utile pour le SSL (facultatif mais recommandé) ;
• votre temps : mises à jour, correctifs de sécurité, sauvegardes ;
• éventuellement des thèmes ou addons payants de développeurs tiers.

Avant de vous lancer, sachez que l'écosystème bouge. À la date de rédaction, la branche stable reste la 1.x (v1.15.2), tandis que Pterodactyl 2.0 est en bêta et déconseillée en production. Pour un nouveau projet, partez sur la 1.x stable. Si votre panel tourne déjà, elle reste un choix raisonnable.

Quel VPS pour installer Pterodactyl ?

Dimensionnez le VPS pour vos jeux, pas pour le panel. Ce dernier est léger ; ce sont les serveurs de jeu qui avalent la RAM, le CPU et le disque.

Système d'exploitation et virtualisation

D'après la documentation de Wings 1.x, les systèmes pris en charge sont Ubuntu 22.04 et 24.04, Rocky Linux et AlmaLinux 8 et 9, et Debian 12 et 13. Windows n'est pas pris en charge. Pour le Panel, la doc de la version 2 recommande Ubuntu 24.04, qui embarque déjà PHP 8.3.

Côté virtualisation, la règle est simple : KVM fonctionne à coup sûr. Avec OpenVZ, LXC ou Virtuozzo, Wings risque de ne pas démarrer, sauf si l'hébergeur a activé le support de Docker. Pour vérifier votre machine :

systemd-detect-virt

Si la sortie ne contient ni openvz ni lxc, vous êtes en bonne posture. Il vous faut aussi un accès root.

Un VPS Windows est donc exclu pour Pterodactyl. Il reste utile pour les besoins propres à Windows, comme certains serveurs de jeu ou outils : c'est le rôle d'un VPS Windows.

CPU, RAM et stockage selon vos serveurs

Comptez environ 1 à 2 Go de RAM pour le panel, puis ajoutez la RAM de chaque serveur de jeu. Ces ordres de grandeur sont indicatifs : plugins, mods et nombre de joueurs les font bouger.

Usage	RAM à prévoir (indicatif)
Panel seul	1 à 2 Go
Minecraft Paper, 10 joueurs	3 à 4 Go
FiveM selon les ressources	4 à 8 Go
Rust, 100 joueurs	8 à 12 Go

Deux critères pèsent plus lourd que le nombre de cœurs. D'abord la fréquence monocœur : Minecraft et Rust s'appuient en grande partie sur un thread principal, et un processeur rapide se ressent plus qu'une armée de cœurs lents. Ensuite le NVMe, qui accélère les sauvegardes et le chargement des maps.

À titre d'exemple, la gamme Premium de Fly-Serv associe Ryzen 9 7950X3D, DDR5 et NVMe. C'est le profil qu'il faut pour un serveur Rust avec Oxide en 1 clic ou pour plusieurs serveurs Minecraft sur une même machine.

Ports à ouvrir pour Pterodactyl et Wings

Les ports par défaut sont connus, mais chaque port de jeu dépend de ce que vous définissez dans les allocations du node.

Port	Protocole	Usage
80 / 443	TCP	Panel web, HTTPS via Let's Encrypt
8080	TCP	API de Wings (configurable)
2022	TCP	SFTP de Wings (configurable)
22	TCP	SSH d'administration, à restreindre à vos IP
25565	TCP (Java)	Minecraft par défaut
28015 / 28016	UDP / TCP	Rust par défaut (jeu / RCON)
30120	TCP et UDP	FiveM par défaut

Les ports 8080 et 2022 figurent aussi dans l'exemple Docker Compose du dépôt Wings. Pour les ports de jeu, fiez-vous à l'egg que vous utilisez : ils changent d'un jeu à l'autre.

Une autre erreur revient souvent : si votre panel est en HTTPS, Wings doit lui aussi être joignable en HTTPS, avec un certificat valide sur son nom de domaine. Sans cela, le panel affiche le node en rouge et la console reste muette. Méfiez-vous aussi de Docker : les ports qu'il publie peuvent contourner UFW. Filtrez via le pare-feu de votre hébergeur ou la chaîne DOCKER-USER.

Reste la question des attaques. Les ports de jeu en UDP sont la cible favorite des DDoS les soirs de wipe ou d'événement. Un filtrage en amont change tout : chez Fly-Serv, il repose sur XDP/eBPF avec une capacité de 2 Tbit/s incluse sur les VPS.

Installer Pterodactyl sur un VPS : les étapes et les pièges

Voici la vue d'ensemble, sans tutoriel exhaustif. Prévoyez 1 à 2 heures pour un premier essai si SSH n'a pas de secret pour vous.

1. Mettez à jour l'OS.
2. Installez PHP, Composer, MariaDB (ou MySQL), Redis et un serveur web (Nginx, Apache ou Caddy).
3. Téléchargez le panel, configurez le fichier .env, lancez les migrations de base de données et créez le compte administrateur.
4. Mettez en place le SSL avec Let's Encrypt.
5. Installez Docker, puis Wings. Dans le panel, créez le node et ses allocations de ports, puis collez la configuration générée sur la machine.
6. Importez les eggs et créez un premier serveur.

Pour la version 2.0 en bêta, la doc demande PHP 8.3 ou 8.4, MariaDB 10.11 ou 11 (ou MySQL 8 ou 9), Redis et Composer 2. En 1.x, les versions exactes diffèrent : ouvrez la page d'installation de votre branche avant de taper la première commande.

Les pièges les plus fréquents :

• une mauvaise version de PHP ;
• des permissions incorrectes sur les dossiers du panel ;
• un SSL mal configuré entre panel et Wings ;
• le port 8080 bloqué par un pare-feu ;
• l'absence de swap sur un petit VPS ;
• des mises à jour oubliées, alors que le panel est exposé sur Internet.

Des scripts d'installation communautaires automatisent tout cela. Ils marchent souvent, mais vous les lancez en root : lisez le code avant de l'exécuter et testez d'abord sur un VPS jetable.

Installer soi-même, VPS pré-installé ou serveur géré ?

Tout dépend du nombre de serveurs et du temps que vous voulez consacrer à l'administration.

Option	Pour qui	Ce que vous gérez
Installation manuelle	Admin qui veut le contrôle total et apprendre	Tout : installation, mises à jour, sécurité, eggs
VPS Pterodactyl pré-installé	Plusieurs serveurs, revente, communauté structurée	Les serveurs et les eggs, pas l'installation du panel ni de Wings
Serveur de jeu géré via FlyPanel	1 ou 2 serveurs, joueur ou petite équipe	Uniquement le jeu : mods en 1 clic, console, sauvegardes

Le VPS Pterodactyl de Fly-Serv est proposé à ceux qui préfèrent ne pas monter la pile eux-mêmes. Le détail de la configuration proposée (OS, version du panel, eggs fournis) se trouve sur la page de l'offre.

Côté budget, les tarifs des VPS et serveurs de jeu Fly-Serv sont sans engagement, avec des remises de 5 % à 20 % selon la durée choisie (3, 6 ou 12 mois). Si votre hésitation porte surtout sur FiveM, ce guide aide à choisir entre panel et VPS pour un serveur FiveM.

Questions fréquentes

Qu'est-ce que Pterodactyl et à quoi sert-il ?

Pterodactyl est un panel open source de gestion de serveurs de jeu. Son interface web permet de créer, démarrer, surveiller et sauvegarder des serveurs Minecraft, Rust, FiveM et bien d'autres, chacun isolé dans un conteneur Docker. Il convient aux communautés, aux revendeurs et aux équipes qui gèrent plusieurs serveurs.

Quelle différence entre le panel Pterodactyl et Wings ?

Le panel est l'interface web : comptes, API, base de données, configuration des serveurs. Wings est le démon écrit en Go, installé sur chaque machine (node), qui pilote Docker et expose le SFTP. Un panel peut piloter plusieurs nodes, et les deux peuvent tourner sur le même VPS pour démarrer.

Qu'est-ce qu'un egg Pterodactyl ?

Un egg est un fichier JSON qui décrit comment installer et lancer un type de serveur : image Docker, script d'installation, commande de démarrage et variables modifiables. Les eggs sont rangés dans des nests, par famille de jeux. Avant d'importer un egg communautaire, vérifiez sa date de dernière mise à jour.

Quelle configuration de VPS faut-il pour installer Pterodactyl ?

Il vous faut un Linux supporté (Ubuntu, Debian, Rocky ou Alma), une virtualisation KVM compatible Docker et un accès root. Prévoyez 1 à 2 Go de RAM pour le panel, plus la RAM de chaque serveur de jeu. Un processeur à fréquence élevée et du NVMe comptent plus que le nombre de cœurs.

Quels ports ouvrir pour Pterodactyl et Wings ?

Ouvrez 80 et 443 en TCP pour le panel, 8080 pour l'API de Wings et 2022 pour le SFTP (valeurs par défaut, modifiables). Ajoutez les ports de jeu définis dans vos allocations, par exemple 25565 pour Minecraft ou 30120 pour FiveM. Restreignez le port 22 à vos adresses IP.

Pterodactyl est-il gratuit ?

Oui, le logiciel est open source sous licence MIT et sans version payante. Vous payez le VPS ou le dédié, éventuellement un nom de domaine et des addons tiers, et vous investissez du temps en maintenance.

Quelle option choisir pour votre prochain serveur ?

Comptez d'abord les serveurs que vous gérez réellement, puis le temps que vous voulez passer sur Linux, SSL et Docker. Si vous en avez plusieurs ou si vous revendez de l'hébergement, le VPS Pterodactyl vous épargne la partie fastidieuse : dépendances, Docker, ports, configuration de Wings. Vous gardez du matériel taillé pour les jeux (Ryzen 9 7950X3D, DDR5, NVMe), l'Anti-DDoS inclus sur les ports de jeu, l'absence d'engagement et un support francophone sur Discord.

Et si un seul serveur vous suffit, un serveur de jeu géré via FlyPanel fait le travail sans aucune administration système.