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 Ryzen 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 :

Bash
1# Mettre à jour le système
2sudo apt update && sudo apt upgrade -y
3
4# Installer curl si nécessaire
5sudo apt install curl -y
6
7# Vérifier que vous êtes en root ou utilisez sudo
8whoami

Installation via le script simplifié

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

Bash
# 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) :

Bash
1# Lancer le script
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choisir l'option "1" pour installer le Panel
5# Suivre les instructions du script

Installation complète (Panel + Wings)

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

Bash
1# Lancer le script
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choisir l'option "3" pour installation complète
5# 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 :

Bash
1# Si vous avez configuré un domaine
2https://votre-domaine.com
3
4# Si vous n'avez pas de domaine
5http://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

Bash
1# Lancer le script
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choisir l'option "3" pour installation complète
5# 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 :

Bash
1# Sur le serveur où installer Wings
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choisir l'option "2" pour installer Wings uniquement
5# 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 :

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

3. Démarrer Wings :

   Bash
   1# Démarrer le service Wings
   2sudo systemctl start wings
   3
   4# Activer Wings au démarrage
   5sudo systemctl enable wings
   6
   7# Vérifier le statut
   8sudo systemctl status wings

🔧 Configuration du pare-feu (UFW)

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

Bash
1# Autoriser les ports pour Pterodactyl Panel
2sudo ufw allow 80/tcp
3sudo ufw allow 443/tcp
4
5# Autoriser le port Wings (par défaut 8080)
6sudo ufw allow 8080/tcp
7
8# Autoriser le port SFTP Wings (par défaut 2022)
9sudo ufw allow 2022/tcp
10
11# Vérifier les règles
12sudo ufw status

📝 Configuration post-installation

Vérifier l'installation

Bash
1# Vérifier que le Panel fonctionne
2curl -I http://localhost
3
4# Vérifier que Wings fonctionne
5sudo systemctl status wings
6
7# Vérifier les logs Wings
8sudo journalctl -u wings -f

Mettre à jour Pterodactyl

Pour mettre à jour le Panel ou Wings :

Bash
1# Relancer le script d'installation
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choisir l'option de mise à jour
5# Le script détectera l'installation existante et proposera la mise à jour

Commandes utiles Wings

Bash
1# Redémarrer Wings
2sudo systemctl restart wings
3
4# Arrêter Wings
5sudo systemctl stop wings
6
7# Voir les logs en temps réel
8sudo journalctl -u wings -f
9
10# Recharger la configuration Wings sans redémarrer
11sudo 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

Bash
1# Vérifier le Panel (doit retourner HTTP 200)
2curl -I http://localhost
3
4# Vérifier Wings
5sudo systemctl status wings
6
7# Vérifier les services requis
8sudo systemctl status nginx
9sudo systemctl status mysql
10sudo 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

Bash
1# Vérifier que Nginx fonctionne
2sudo systemctl status nginx
3
4# Vérifier les logs Nginx
5sudo tail -f /var/log/nginx/error.log
6
7# Redémarrer Nginx
8sudo systemctl restart nginx
9
10# Vérifier la configuration Nginx
11sudo nginx -t

Wings ne démarre pas

Bash
1# Vérifier les logs Wings
2sudo journalctl -u wings -n 50
3
4# Vérifier le fichier de configuration
5sudo nano /etc/pterodactyl/config.yml
6
7# Vérifier la syntaxe de la configuration
8sudo wings --debug
9
10# Vérifier que le port 8080 est libre
11sudo netstat -tlnp | grep 8080

Erreur de connexion Panel → Wings

Bash
1# Vérifier la clé d'API dans config.yml
2sudo cat /etc/pterodactyl/config.yml | grep -i "api\|token"
3
4# Vérifier que le FQDN est correct
5sudo cat /etc/pterodactyl/config.yml | grep -i "remote"
6
7# Vérifier la connectivité réseau
8curl -I https://VOTRE_DOMAINE_PANEL
9
10# Redémarrer Wings
11sudo systemctl restart wings

Problème avec la base de données

Bash
1# Vérifier que MySQL fonctionne
2sudo systemctl status mysql
3
4# Se connecter à MySQL
5sudo mysql -u root -p
6
7# Dans MySQL, lister les bases de données
8SHOW DATABASES;
9
10# Vérifier que la base pterodactyl existe
11USE pterodactyl;
12SHOW TABLES;

Erreur SSL/HTTPS

Si vous avez des problèmes avec SSL :

Bash
1# Vérifier Certbot
2sudo certbot --version
3
4# Renouveler le certificat SSL
5sudo certbot renew
6
7# Vérifier la configuration Nginx SSL
8sudo nginx -t
9sudo 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
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.