🎮 Installer Pterodactyl Panel via script

Ce guide vous apprendra à installer Pterodactyl Panel et Wings sur votre VPS en utilisant le script d'installation automatique simplifié. Pterodactyl est un panel de gestion gratuit et open-source pour gérer vos serveurs de jeux (Minecraft, FiveM, etc.).

📋 Prérequis

• Un serveur VPS avec accès root
• Un minimum de 1 Go de RAM (2 Go recommandé)
• Ubuntu 22.04/24.04, Debian 11/12/13, Rocky Linux 8/9, ou AlmaLinux 8/9
• Un domaine pointant vers l'IP de votre VPS (optionnel mais recommandé)
• Ports 80, 443, 2022, et 8080 ouverts (si vous utilisez un pare-feu)

💡 Recommandation d'infrastructure

Pterodactyl Panel est idéal pour gérer des serveurs de jeux gourmands en ressources. Pour une performance optimale, nous recommandons nos VPS Performance qui offrent des processeurs haute performance et une RAM DDR5, parfaits pour héberger plusieurs serveurs de jeux simultanément (Minecraft, FiveM, etc.).

🚀 Installation du Panel Pterodactyl

Préparation du serveur

Avant d'installer Pterodactyl, préparez votre serveur :

# Mettre à jour le système
sudo apt update && sudo apt upgrade -y

# Installer curl si nécessaire
sudo apt install curl -y

# Vérifier que vous êtes en root ou utilisez sudo
whoami

Installation via le script simplifié

Le script d'installation automatique simplifie grandement l'installation de Pterodactyl :

# Lancer le script d'installation Pterodactyl
bash <(curl -s https://pterodactyl-installer.se)

Le script va vous guider à travers l'installation étape par étape :

1. Choix du type d'installation :

   • Installation du Panel (Pterodactyl Panel)
   • Installation de Wings (daemon pour gérer les serveurs)
   • Installation complète (Panel + Wings)

2. Configuration du système :

   • Installation automatique des dépendances (PHP, MySQL, Nginx, etc.)
   • Configuration de la base de données
   • Configuration du serveur web (Nginx)
   • Configuration SSL (Let's Encrypt)

Installation du Panel uniquement

Si vous voulez installer uniquement le Panel (pour gérer les serveurs) :

# Lancer le script
bash <(curl -s https://pterodactyl-installer.se)

# Choisir l'option "1" pour installer le Panel
# Suivre les instructions du script

Installation complète (Panel + Wings)

Pour installer le Panel et Wings sur le même serveur :

# Lancer le script
bash <(curl -s https://pterodactyl-installer.se)

# Choisir l'option "3" pour installation complète
# Suivre les instructions du script

⚙️ Configuration du Panel

Configuration initiale

Après l'installation du Panel, vous devrez configurer :

1. Créer un compte administrateur :

   • Le script vous demandera de créer le premier utilisateur admin
   • Choisissez un email et un mot de passe sécurisé

2. Configuration de la base de données :

   • Le script créera automatiquement une base de données MySQL
   • Notez les identifiants de la base de données

3. Configuration du domaine :

   • Si vous avez un domaine, le script configurera automatiquement Nginx
   • Sinon, vous pourrez accéder via l'IP du serveur

Accès au Panel

Une fois l'installation terminée, accédez au Panel :

# Si vous avez configuré un domaine
https://votre-domaine.com

# Si vous n'avez pas de domaine
http://VOTRE_IP_SERVEUR

🛠️ Installation de Wings (Daemon)

Wings est le daemon qui gère réellement les serveurs de jeux. Vous pouvez l'installer sur le même serveur que le Panel ou sur un serveur séparé.

Installation de Wings sur le même serveur

# Lancer le script
bash <(curl -s https://pterodactyl-installer.se)

# Choisir l'option "3" pour installation complète
# Ou l'option "2" si vous avez déjà installé le Panel

Installation de Wings sur un serveur séparé

Si vous installez Wings sur un serveur différent du Panel :

# Sur le serveur où installer Wings
bash <(curl -s https://pterodactyl-installer.se)

# Choisir l'option "2" pour installer Wings uniquement
# Suivre les instructions du script

Configuration de Wings

Après l'installation, vous devrez configurer Wings :

1. Obtenir la clé d'API :

   • Connectez-vous au Panel
   • Allez dans Administration → Configuration → Nodes
   • Créez un nouveau node ou utilisez celui existant
   • Copiez la clé d'API et le FQDN

2. Configurer Wings :

   # Éditer le fichier de configuration Wings
   sudo nano /etc/pterodactyl/config.yml
   
   # Coller la clé d'API et le FQDN du Panel
   # Sauvegarder et quitter (Ctrl+X, puis Y, puis Enter)

3. Démarrer Wings :

   # Démarrer le service Wings
   sudo systemctl start wings
   
   # Activer Wings au démarrage
   sudo systemctl enable wings
   
   # Vérifier le statut
   sudo systemctl status wings

🔧 Configuration du pare-feu (UFW)

Si vous utilisez UFW, configurez les ports nécessaires :

# Autoriser les ports pour Pterodactyl Panel
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# Autoriser le port Wings (par défaut 8080)
sudo ufw allow 8080/tcp

# Autoriser le port SFTP Wings (par défaut 2022)
sudo ufw allow 2022/tcp

# Vérifier les règles
sudo ufw status

📝 Configuration post-installation

Vérifier l'installation

# Vérifier que le Panel fonctionne
curl -I http://localhost

# Vérifier que Wings fonctionne
sudo systemctl status wings

# Vérifier les logs Wings
sudo journalctl -u wings -f

Mettre à jour Pterodactyl

Pour mettre à jour le Panel ou Wings :

# Relancer le script d'installation
bash <(curl -s https://pterodactyl-installer.se)

# Choisir l'option de mise à jour
# Le script détectera l'installation existante et proposera la mise à jour

Commandes utiles Wings

# Redémarrer Wings
sudo systemctl restart wings

# Arrêter Wings
sudo systemctl stop wings

# Voir les logs en temps réel
sudo journalctl -u wings -f

# Recharger la configuration Wings sans redémarrer
sudo wings --debug

🎮 Créer votre premier serveur

Dans le Panel Pterodactyl

1. Créer un utilisateur :

   • Allez dans Utilisateurs → Nouvel utilisateur
   • Créez un compte pour vous-même (si ce n'est pas déjà fait)

2. Créer un serveur :

   • Cliquez sur "Créer un nouveau serveur"
   • Sélectionnez un node (votre Wings)
   • Choisissez un egg (Minecraft, FiveM, etc.)
   • Configurez les ressources (RAM, CPU, disque)
   • Définissez le nom et la description

3. Démarrer le serveur :

   • Une fois créé, cliquez sur votre serveur
   • Cliquez sur "Power" → "Start" pour démarrer

✅ Vérification et test

Vérifier que tout fonctionne

# Vérifier le Panel (doit retourner HTTP 200)
curl -I http://localhost

# Vérifier Wings
sudo systemctl status wings

# Vérifier les services requis
sudo systemctl status nginx
sudo systemctl status mysql
sudo systemctl status redis

Tester la connexion Panel → Wings

Dans le Panel :

1. Allez dans Administration → Nodes
2. Vérifiez que votre node est en ligne (statut vert)
3. Si le node est hors ligne, vérifiez la configuration Wings

🆘 Dépannage

Le Panel ne s'affiche pas

# Vérifier que Nginx fonctionne
sudo systemctl status nginx

# Vérifier les logs Nginx
sudo tail -f /var/log/nginx/error.log

# Redémarrer Nginx
sudo systemctl restart nginx

# Vérifier la configuration Nginx
sudo nginx -t

Wings ne démarre pas

# Vérifier les logs Wings
sudo journalctl -u wings -n 50

# Vérifier le fichier de configuration
sudo nano /etc/pterodactyl/config.yml

# Vérifier la syntaxe de la configuration
sudo wings --debug

# Vérifier que le port 8080 est libre
sudo netstat -tlnp | grep 8080

Erreur de connexion Panel → Wings

# Vérifier la clé d'API dans config.yml
sudo cat /etc/pterodactyl/config.yml | grep -i "api\|token"

# Vérifier que le FQDN est correct
sudo cat /etc/pterodactyl/config.yml | grep -i "remote"

# Vérifier la connectivité réseau
curl -I https://VOTRE_DOMAINE_PANEL

# Redémarrer Wings
sudo systemctl restart wings

Problème avec la base de données

# Vérifier que MySQL fonctionne
sudo systemctl status mysql

# Se connecter à MySQL
sudo mysql -u root -p

# Dans MySQL, lister les bases de données
SHOW DATABASES;

# Vérifier que la base pterodactyl existe
USE pterodactyl;
SHOW TABLES;

Erreur SSL/HTTPS

Si vous avez des problèmes avec SSL :

# Vérifier Certbot
sudo certbot --version

# Renouveler le certificat SSL
sudo certbot renew

# Vérifier la configuration Nginx SSL
sudo nginx -t
sudo systemctl reload nginx

📚 Ressources supplémentaires

• Documentation officielle Pterodactyl
• Documentation Wings
• GitHub Pterodactyl
• Script d'installation
• Support Infrawire

❓ Questions fréquentes

Q : Puis-je installer le Panel et Wings sur des serveurs séparés ?
R : Oui, c'est même recommandé pour les gros déploiements. Installez le Panel sur un serveur et Wings sur un ou plusieurs autres serveurs. Configurez ensuite Wings pour se connecter au Panel via la clé d'API.

Q : Quelle est la différence entre le Panel et Wings ?
R : Le Panel est l'interface web pour gérer vos serveurs. Wings est le daemon qui s'exécute sur les serveurs de jeux et gère réellement les conteneurs Docker et les serveurs de jeux.

Q : Puis-je installer Pterodactyl sans domaine ?
R : Oui, vous pouvez utiliser l'IP de votre serveur, mais vous devrez configurer SSL manuellement ou accepter un certificat auto-signé. Il est fortement recommandé d'utiliser un domaine avec Let's Encrypt.

Q : Le script installe-t-il automatiquement Docker ?
R : Oui, le script installe automatiquement Docker et Docker Compose qui sont nécessaires pour Wings.

Q : Comment mettre à jour Pterodactyl après l'installation ?
R : Relancez le script d'installation. Il détectera l'installation existante et proposera une mise à jour :

bash <(curl -s https://pterodactyl-installer.se)

Q : Puis-je utiliser un autre serveur web que Nginx ?
R : Le script installe automatiquement Nginx. Vous pouvez utiliser Apache à la place, mais vous devrez configurer manuellement après l'installation.

Q : Combien de RAM faut-il pour installer Pterodactyl ?
R : Minimum 1 Go de RAM, mais 2 Go sont recommandés. Pour gérer des serveurs de jeux, vous aurez besoin de RAM supplémentaire selon le nombre et la taille de vos serveurs.

Q : Comment créer plusieurs serveurs de jeux ?
R : Une fois le Panel et Wings configurés, vous pouvez créer autant de serveurs que vous voulez dans le Panel. Chaque serveur utilisera une partie de vos ressources (RAM, CPU, disque).

Q : Puis-je utiliser Pterodactyl pour des serveurs autres que des jeux ?
R : Oui, Pterodactyl peut gérer n'importe quel conteneur Docker. Vous pouvez l'utiliser pour des applications web, des bots Discord, etc.