Pterodactyl est le panel de gestion de serveurs de jeux open-source de référence. Il utilise Docker pour faire tourner vos instances (Minecraft, FiveM, GMod...) dans des environnements isolés et sécurisés. Ce guide vous accompagne dans l'installation complète du Panel (l'interface d'administration) et des Wings (l'agent de virtualisation sur le serveur de jeu) sur Debian 11/12 ou Ubuntu 20.04/22.04.
Préparer le système et installer les dépendances
Commencez par mettre à jour vos paquets Debian ou Ubuntu et installez les outils de base indispensables tels que curl, tar, unzip, git, ainsi que MariaDB (la base de données) et Nginx (le serveur web).
apt update && apt full-upgrade -yapt install -y curl tar unzip git software-properties-common dirmngr ca-certificates apt-transport-https # Installation de MariaDB et Nginxapt install -y nginx mariadb-serverInstaller PHP 8.2 (Debian / Ubuntu)
Pterodactyl nécessite PHP 8.1 ou 8.2 avec plusieurs extensions spécifiques pour fonctionner. Sur Debian, ajoutez le dépôt SURY pour installer PHP 8.2.
# Pour Debian :curl -sS https://packages.sury.org/php/README.txt | bash -xapt update # Pour Ubuntu, le dépôt standard ou le PPA d'Ondrej est utilisé. Installez ensuite PHP 8.2 :apt install -y php8.2 php8.2-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} # Démarrer PHP-FPMsystemctl enable --now php8.2-fpmConfigurer la base de données MariaDB
Sécurisez MariaDB et créez une base de données dédiée pour Pterodactyl, ainsi qu'un utilisateur associé avec des privilèges complets.
mysql_secure_installation # Connectez-vous à MySQLmysql -u root -p # Dans la console MySQL, exécutez :CREATE DATABASE pterodactyl;CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'VOTRE_MOT_DE_PASSE_SECURISE';GRANT ALL PRIVILEGES ON pterodactyl.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;FLUSH PRIVILEGES;EXIT;Télécharger et configurer le Panel Pterodactyl
Créez le dossier web pour le panel, téléchargez la dernière archive officielle de Pterodactyl, extrayez-la, installez Composer (le gestionnaire de dépendances PHP), puis initialisez l'application.
mkdir -p /var/www/pterodactylcd /var/www/pterodactylcurl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gztar -xzvf panel.tar.gzchmod -R 755 storage/* bootstrap/cache/ # Installer Composercurl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer # Installer les dépendances du Panelcomposer install --no-dev --optimize-autoloader # Configurer l'environnement (avec les commandes officielles de Pterodactyl)cp .env.example .envphp artisan key:generate --force # Configuration de l'environnement (Session, Cache, Database, Mail)php artisan p:environment:setupphp artisan p:environment:databasephp artisan p:environment:mail # Migrer la base de données et importer les structures initiales (Nests & Eggs)php artisan migrate --seed --force # Créer le premier utilisateur administrateur (8 caract., mélange maj/min, 1 chiffre)php artisan p:user:make # Donner les permissions à Nginx (www-data)chown -R www-data:www-data /var/www/pterodactyl/*Configurer le serveur web Nginx avec SSL
Créez un bloc serveur Nginx pour héberger le panel et sécurisez l'accès en générant un certificat SSL gratuit Let's Encrypt avec Certbot.
apt install -y certbot python3-certbot-nginxcertbot certonly --nginx -d panel.votre-domaine.com # Créez la configuration Nginxnano /etc/nginx/sites-available/pterodactyl.confInstaller l'agent de virtualisation : Wings
Wings est l'agent qui s'exécute sur le serveur hébergeant les jeux. Il nécessite Docker. Installez Docker, puis téléchargez et installez Wings.
# Installer Dockercurl -sSL https://get.docker.com/ | CHANNEL=stable shsystemctl enable --now docker # Télécharger Wingsmkdir -p /etc/pterodactylcurl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64chmod +x /usr/local/bin/wings # Configurez Wings dans le panel web (Créez un Node, copiez la configuration générée et collez-la dans /etc/pterodactyl/config.yml) # Lancer Wings en arrière-plan en tant que service systemdcurl -o /etc/systemd/system/wings.service https://raw.githubusercontent.com/pterodactyl/wings/develop/debian/wings.servicesystemctl enable --now wingsPour terminer
Félicitations, vous disposez maintenant d'un panel Pterodactyl parfaitement opérationnel ! Vous pouvez dès à présent ajouter des serveurs de jeux (Minecraft, Ark, CS:GO...) depuis le panel d'administration en utilisant les serveurs virtuels isolés configurés avec Wings.
Problèmes fréquents
Pourquoi mes conteneurs Docker ne se lancent pas après le redémarrage du VPS ?
Vérifiez que le service Docker est activé au démarrage en exécutant 'systemctl enable docker' et 'systemctl enable wings'.
Erreur 500 sur le Panel après installation : comment résoudre ?
L'erreur 500 est généralement liée à des permissions de fichiers incorrectes ou à un fichier .env mal configuré. Exécutez 'chown -R www-data:www-data /var/www/pterodactyl' et inspectez les logs dans '/var/www/pterodactyl/storage/logs/'.
Est-il possible d'héberger le Panel et les Wings sur le même VPS ?
Oui, c'est tout à fait possible et très courant pour les petites infrastructures. Il vous suffit d'indiquer l'IP locale '127.0.0.1' ou l'IP publique lors de la configuration du Node sur votre Panel.