Le panel Pterodactyl et son démon Wings expliqués, puis l’installation complète sur un VPS Debian ou Ubuntu : PHP, MariaDB, Redis, nginx, certbot, Docker
Pterodactyl, ici, n’est pas le reptile volant : c’est un panel open source qui sert à créer et gérer des serveurs de jeux depuis un navigateur. Ce guide explique comment il fonctionne, ce qu’il demande comme machine, puis l’installe pas à pas sur un VPS Ubuntu 24.04 : le panel avec PHP 8.3, MariaDB, Redis et nginx, le HTTPS avec certbot, puis Wings et Docker pour faire tourner les serveurs. Les commandes suivent la documentation officielle de Pterodactyl et se lancent en root.
- Pterodactyl, c’est deux logiciels : le panel web (PHP, MariaDB, Redis) et Wings, qui lance chaque serveur de jeu dans un conteneur Docker.
- Il faut un VPS KVM sous Ubuntu, Debian, Rocky ou AlmaLinux, un domaine pour le HTTPS et 2 Go de RAM pour le panel seul.
- Avec Wings sur la même machine, la RAM nécessaire est celle du panel plus celle de chaque serveur de jeu.
- Sauvegardez le fichier .env (clé APP_KEY), la base panel et les volumes des serveurs, hors du VPS.
Pterodactyl, c’est quoi ?
Pterodactyl est un panel de gestion de serveurs de jeux publié sous licence MIT. Il se compose de deux logiciels : le panel, une application web en PHP qui stocke les comptes, les serveurs et les réglages, et Wings, un démon écrit en Go qui démarre chaque serveur de jeu dans son propre conteneur Docker. Le panel peut piloter plusieurs machines Wings, appelées nœuds.
- Le panel : interface web, API, base MariaDB ou MySQL, cache et file de tâches dans Redis.
- Wings : API du nœud sur le port 8080 et SFTP sur le port 2022 par défaut, conteneurs Docker pour les serveurs.
- Les eggs : des modèles de serveur (Minecraft Paper, Rust, ARK, bots, etc.) qui décrivent l’image Docker, l’installation et la commande de démarrage.
- Chaque joueur ou client reçoit un accès à ses serveurs : console, fichiers, sauvegardes, tâches planifiées et sous-utilisateurs.
Prérequis : système, RAM et virtualisation
La documentation officielle prend en charge Ubuntu 22.04 et 24.04, Debian 11, 12 et 13, ainsi que Rocky Linux et AlmaLinux 8 et 9. Le panel demande PHP 8.2 ou 8.3, MariaDB 10.2 ou plus récent (ou MySQL 5.7.22 et plus), Redis, un serveur web et Composer 2. Wings, lui, a besoin de Docker et d’une virtualisation complète : KVM fonctionne, OpenVZ et LXC posent presque toujours problème.
- Vérifiez la virtualisation avec systemd-detect-virt : le résultat ne doit contenir ni openvz ni lxc. Les VPS ACLClouds sont des machines KVM.
- RAM : le panel seul tient dans 2 Go. Avec Wings sur la même machine, ajoutez la mémoire de chaque serveur de jeu, par exemple 4 Go pour un serveur Minecraft Paper d’une dizaine de joueurs.
- Un nom de domaine pointé vers l’IP du VPS est nécessaire pour le HTTPS ; un sous-domaine gratuit en aclclouds.online convient.
- Pour le panel et un ou deux petits serveurs, le plan Mini (8 Go de RAM, 2 vCPU) suffit ; au-delà, le plan Essentiel (16 Go, 4 vCPU) laisse de la marge. Voir les VPS Linux.
Installer PHP, MariaDB, Redis et nginx
Sur Ubuntu 24.04, PHP 8.3 vient du dépôt ondrej/php. Mettez d’abord le système à jour avec apt update && apt -y upgrade, puis installez les dépendances et Composer. Sur Debian, la documentation officielle donne une page dédiée avec un autre dépôt PHP : suivez-la plutôt que ces commandes.
- apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
- LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php && apt update
- apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server
- curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
Télécharger le panel et créer la base de données
Le panel s’installe dans /var/www/pterodactyl à partir de l’archive de la dernière version publiée sur GitHub. Créez ensuite une base et un utilisateur MariaDB qui ne sert qu’au panel, avec un mot de passe long et unique.
- mkdir -p /var/www/pterodactyl && cd /var/www/pterodactyl
- curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz && tar -xzvf panel.tar.gz && chmod -R 755 storage/* bootstrap/cache/
- Dans mariadb -u root -p : CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'motDePasseUnique'; CREATE DATABASE panel; GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
- cp .env.example .env && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
- php artisan key:generate --force : la clé APP_KEY chiffre des données du panel. Copiez-la hors du serveur, car sans elle une restauration est impossible.
Configurer l’environnement et créer l’administrateur
Trois assistants interactifs remplissent le fichier .env : l’adresse du panel et les pilotes de cache, de session et de file (choisissez Redis), puis la connexion à la base, puis l’envoi des e-mails. La migration crée ensuite les tables et les eggs fournis, et la dernière commande crée le premier compte administrateur.
- php artisan p:environment:setup, puis php artisan p:environment:database et php artisan p:environment:mail
- php artisan migrate --seed --force : ne l’interrompez pas, l’import des eggs prend un moment.
- php artisan p:user:make : répondez yes à la question administrateur.
- chown -R www-data:www-data /var/www/pterodactyl/* : les fichiers appartiennent à l’utilisateur du serveur web.
Activer la tâche planifiée et la file de tâches
Le panel a besoin d’une tâche cron qui tourne chaque minute (nettoyage, tâches planifiées des serveurs) et d’un worker qui traite la file Redis. Sans le worker, les créations de serveurs et les e-mails restent bloqués.
- crontab -e, puis la ligne : * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
- Créez /etc/systemd/system/pteroq.service avec User=www-data, Group=www-data, Restart=always et ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
- systemctl enable --now redis-server, puis systemctl enable --now pteroq.service
Configurer nginx et le HTTPS avec certbot
Pointez d’abord un enregistrement A du domaine, par exemple panel.exemple.com, vers l’IPv4 du VPS. Obtenez ensuite le certificat avec le plugin nginx de certbot, puis créez le bloc serveur du panel à partir du modèle nginx avec SSL de la documentation officielle : root /var/www/pterodactyl/public, PHP transmis au socket de PHP-FPM 8.3 et les chemins du certificat obtenu.
- apt -y install certbot python3-certbot-nginx, puis certbot certonly --nginx -d panel.exemple.com
- Dans /etc/nginx/sites-available/pterodactyl.conf : server_name panel.exemple.com, ssl_certificate /etc/letsencrypt/live/panel.exemple.com/fullchain.pem et fastcgi_pass unix:/run/php/php8.3-fpm.sock.
- rm /etc/nginx/sites-enabled/default, ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/, puis nginx -t && systemctl restart nginx
- Le renouvellement est automatique avec le timer de certbot ; testez-le avec certbot renew --dry-run. Le détail est dans le guide du certificat HTTPS gratuit.
Installer Docker et Wings, puis relier le nœud
Wings peut tourner sur le même VPS que le panel ou sur une autre machine. Installez Docker avec le script officiel, puis le binaire Wings. Dans le panel, créez une Location, puis un nœud avec son nom de domaine, l’option SSL, la mémoire et le disque à partager. L’onglet Configuration du nœud affiche le contenu de config.yml à copier dans /etc/pterodactyl.
- curl -sSL https://get.docker.com/ | CHANNEL=stable bash && systemctl enable --now docker
- mkdir -p /etc/pterodactyl && curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64 && chmod u+x /usr/local/bin/wings
- Lancez wings --debug une première fois pour voir les erreurs, puis créez le service wings.service (ExecStart=/usr/local/bin/wings, après docker.service) et activez-le avec systemctl enable --now wings.
- Ajoutez des allocations au nœud : l’IP publique donnée par hostname -I, jamais 127.0.0.1, et une plage de ports, par exemple 25565-25600.
- Le panel affiche un cœur vert à côté du nœud quand Wings répond ; sinon, vérifiez le certificat et le port 8080.
Sécuriser le panel et les nœuds
Un panel de jeux expose une interface d’administration, une API et des ports de jeu : c’est une cible. N’ouvrez que les ports utiles, protégez les comptes et sauvegardez ce qui ne se réinstalle pas. Les bases du durcissement d’un VPS sont dans notre guide de sécurité Linux.
- Pare-feu : 22 (SSH), 80 et 443 pour le panel, 8080 et 2022 pour Wings, puis les ports des allocations, en TCP et en UDP selon le jeu.
- Activez la double authentification sur les comptes administrateurs et désactivez la connexion SSH par mot de passe.
- Sauvegardez le fichier .env, la base panel (mysqldump panel) et les données des serveurs dans /var/lib/pterodactyl/volumes, puis copiez-les hors du VPS.
- Mettez à jour le panel avec php artisan p:upgrade et Wings en remplaçant le binaire, après une sauvegarde, en suivant les notes de version.
Sans rien installer : les options ACLClouds
Si vous voulez votre propre panel sans passer par ces étapes, le VPS Pterodactyl préconfiguré installe le panel, MariaDB, Redis, la file de tâches et le HTTPS à partir de votre domaine et de vos identifiants. Le VPS Pterodactyl + Wings ajoute Docker et Wings, avec le nœud, son config.yml et 100 allocations déjà créés. Vous gardez l’accès root dans les deux cas.
- Ces images sont au même tarif que les autres VPS : l’installation préconfigurée est incluse.
- Si vous voulez seulement jouer, sans administrer de serveur, nos serveurs de jeux tournent sur le panel ACLClouds, construit sur Pterodactyl et Wings : le serveur est livré prêt, sans installation de votre côté.