Installer Pterodactyl : guide complet panel et Wings

Pterodactyl est une solution open source qui simplifie l'hébergement et la gestion de serveurs de jeux. Son interface web intuitive communique avec un démon nommé Wings pour contrôler vos instances. Ce guide vous accompagne dans l'installation complète : panel, Wings et configuration du Node.

Ce qu'il vous faut avant de commencer

Préparez votre environnement avec les éléments suivants :

Serveur compatible

• Ubuntu 20.04, 22.04 ou 24.04
• Debian 10, 11 ou 12

Accès requis

• Connexion root ou utilisateur disposant des droits sudo
• Paquets de base installés sur le système

Commencez par mettre votre système à jour :

apt update && apt upgrade -y

Installez ensuite les dépendances essentielles :

apt install sudo curl

Déployer le panel Pterodactyl

⚠️ Avertissement : Le script d'installation convient à un usage privé. Pour un environnement de production public, privilégiez une installation manuelle.

Lancez le script d'installation :

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

Sélectionnez l'option 0 pour installer le panel :

* Input 0-8: 0

Paramétrage de la base de données

Acceptez l'installation de MariaDB :

Would you like to install MariaDB (MySQL) server on the daemon as well? (y/N): y

Laissez les champs de la base de données vides : le script génère automatiquement un mot de passe sécurisé.

Configuration générale

Définissez votre fuseau horaire :

Select timezone [Europe/Stockholm]: Europe/Paris

Renseignez une adresse mail valide pour les notifications :

Provide the email address: [email protected]

Création du compte administrateur

Complétez les informations du premier compte :

Email: [email protected]
Username: admin
First name: Admin
Last name: OuiHeberg
Password: *****

Domaine et sécurité

Indiquez le nom de domaine pointant vers votre VPS :

Set the FQDN: panel.ouiheberg.com

Refusez la configuration automatique du pare-feu pour garder le contrôle :

Do you want to automatically configure UFW (firewall)? (y/N): n

Activez le certificat SSL via Let's Encrypt :

Do you want to automatically configure HTTPS using Let's Encrypt? (y/N): y
I agree... (y/N): y

Validez l'installation :

Initial configuration completed. Continue with installation? (y/N): y
(A)gree/(C)ancel: a

✅ Le panel est opérationnel.

Installer le démon Wings

Relancez le script d'installation :

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

Choisissez l'option 1 pour Wings :

* Input 0-8: 1

Configuration de Wings

Ne réinstallez pas MariaDB si déjà présent :

Would you like to install MariaDB... (y/N): n

Conservez la gestion manuelle du pare-feu :

Do you want to automatically configure UFW (firewall)? (y/N): n

Configurez HTTPS pour sécuriser les échanges :

Do you want to automatically configure HTTPS... (y/N): y
Set the FQDN: node.ouiheberg.com
I agree... (y/N): y
Enter email address: [email protected]
Proceed with installation? (y/N): y

✅ Wings est prêt.

Relier le Node au panel

Connectez-vous à votre panel (ex : panel.ouiheberg.com).

Créer une localisation

Rendez-vous dans Locations et ajoutez une nouvelle localisation. Le nom est libre : il sert à organiser vos nodes par zone géographique ou usage.

Ajouter le Node

Dans Nodes, cliquez sur Create New et complétez les champs :

Paramètre	Description
Name	Nom identifiant le node
FQDN	Domaine ou IP du serveur Wings
Connexion	HTTPS si SSL actif, HTTP sinon
Total Memory	Mémoire allouée (ex : 1024 pour 1 Go)
Total Disk Space	Espace disque disponible
Over-Allocation	Pourcentage de dépassement autorisé (0 si non souhaité)

Finaliser la liaison

Après création, ouvrez l'onglet Configuration du Node. Générez un token et copiez la commande affichée.

Exécutez cette commande sur votre VPS via SSH, puis activez Wings :

systemctl enable --now wings
systemctl start wings

Résoudre les problèmes fréquents

Symptôme	Cause probable	Solution
Panel inaccessible	DNS mal propagé ou FQDN erroné	Vérifier la configuration DNS
Node déconnecté	Ports bloqués par le pare-feu	Ouvrir les ports 8080 et 2022
Wings refuse de démarrer	Certificat SSL invalide	Consulter les logs : journalctl -u wings
Erreur base de données	MariaDB inactif ou mal configuré	Vérifier : systemctl status mariadb
Échec SSL	Domaine ne pointe pas vers le VPS	Corriger l'enregistrement DNS A

Recommandations de sécurité

Adoptez ces bonnes pratiques pour une installation pérenne :

• Utilisez des noms de domaine dédiés pour le panel et chaque node
• Activez systématiquement HTTPS avec un certificat valide
• Maintenez votre système à jour : apt update && apt upgrade -y
• Créez des comptes utilisateurs distincts plutôt que d'utiliser l'admin au quotidien
• Planifiez des sauvegardes régulières de la base de données et des fichiers de configuration

Pour conclure

Le script d'installation simplifie considérablement le déploiement de Pterodactyl, mais une configuration réseau et SSL rigoureuse reste indispensable. En appliquant ce guide et les recommandations de sécurité, vous disposez d'une plateforme solide pour héberger vos serveurs de jeux.