Tu choisis les services que nous pouvons activer pour l’analyse, la personnalisation et les contenus externes.
Nous utilisons des cookies et des technologies similaires sur notre site pour personnaliser les contenus, intégrer des médias externes et mieux comprendre l’utilisation de certaines sections.
Cookies nécessaires
Ces entrées assurent des fonctions essentielles comme la sécurité, la stabilité et le traitement des formulaires.
Tes données peuvent être traitées avec ton consentement ou sur la base d’intérêts légitimes. Dans les paramètres des cookies, tu peux refuser chaque catégorie facultative ou l’autoriser individuellement.
Certains services traitent des données personnelles dans des pays tiers. En donnant ton consentement, tu acceptes également ce transfert. Pour en savoir plus, consulte notre politique de confidentialité.
Tu pourras rouvrir et modifier ta sélection à tout moment. · 1.0.2
Installer Pterodactyl sur un serveur Linux – Héberge ton propre panneau de serveurs de jeux
Découvre comment installer Pterodactyl Panel et Wings sur ton serveur Linux et gérer facilement tes propres serveurs de jeux depuis une interface Web → En savoir plus
10 novembre 202614 min de lecture1 Vues0 utile
Introduction
Pterodactyl est un panneau gratuit et open source qui te permet de gérer des serveurs de jeux comme Minecraft, Rust, ARK ou CS2 depuis une interface Web. Chaque serveur de jeu fonctionne dans son propre conteneur Docker, bien isolé des autres.
Pterodactyl se compose de deux éléments :
Panel – l’interface Web dans laquelle tu gères les serveurs, les utilisateurs et les ressources (application PHP avec base de données et serveur Web)
Wings – le service installé sur le serveur qui démarre, arrête et surveille les conteneurs des serveurs de jeux
Dans ce guide, nous allons te montrer étape par étape comment installer Panel et Wings sur ton serveur ZapX ou ton serveur dédié, configurer un domaine avec SSL et créer ton premier serveur de jeu.
Préparation
Pour utiliser Pterodactyl, tu as besoin d’un VPS ou d’un serveur dédié sous Linux, avec un accès root via SSH. Pour savoir comment te connecter à ton serveur, consulte notre guide sur le premier accès SSH. Tu découvres ZapX ? Consulte d’abord les guides d’introduction aux VPS et aux serveurs dédiés.
Conseil
Authentification par clé SSH
Nous te recommandons d’utiliser une clé SSH plutôt qu’un mot de passe. Pour savoir comment faire, consulte notre guide Créer et utiliser des clés SSH.
Configuration matérielle requise
Le Panel en lui-même est léger. Les ressources dont tu as besoin dépendent surtout du nombre de serveurs de jeux que tu veux faire fonctionner avec Wings. Si tu installes Panel et Wings sur le même serveur, nous te recommandons la configuration suivante :
Matériel
Minimum
Recommandé
CPU
2 cœurs vCPU
4 cœurs vCPU ou plus
RAM
4 Go
8 Go ou plus
Espace disque
30 Go
100 Go ou plus
Systèmes d’exploitation pris en charge
D’après la documentation officielle de Pterodactyl, les systèmes suivants sont actuellement pris en charge :
Système d’exploitation
Versions
Remarque
Ubuntu
22.04, 24.04
Pour la version 22.04, tu as besoin d’un dépôt PHP supplémentaire
Debian
11, 12, 13
PHP 8.3 provient du dépôt Sury
Rocky Linux / AlmaLinux / RHEL
8, 9
Les noms des paquets et les chemins sont différents ; ils ne sont pas traités dans ce guide
Ce guide fournit les commandes pour Ubuntu et Debian. Ubuntu 20.04 et les versions antérieures ne sont plus prises en charge par le Panel. Si tu réinstalles ton système, privilégie Ubuntu 24.04 ou Debian 12.
Vérifier la virtualisation
Wings a besoin de Docker. Docker fonctionne sans problème sur les serveurs basés sur KVM et les serveurs dédiés, mais généralement pas dans les conteneurs OpenVZ ou LXC. Vérifie ton environnement avec la commande suivante :
bash
systemd-detect-virt
La réponse kvm ou none (serveur dédié sans virtualisation) convient. Si la commande renvoie openvz ou lxc, tu ne pourras généralement pas faire fonctionner Wings sur ce serveur.
Mettre le système à jour
Avant l’installation, mets ton système à jour :
bash
apt update && apt upgrade -y
Pare-feu et ports
Si un pare-feu est activé sur ton serveur, tu dois ouvrir les ports suivants :
Port
Protocole
Utilisation
80 et 443
TCP
Panel (HTTP/HTTPS) et vérification du certificat par Certbot
8080
TCP
API Wings, utilisée par le Panel pour communiquer avec le Node
2022
TCP
Accès SFTP aux fichiers des serveurs de jeux
Ports de jeu
TCP/UDP
Les ports de tes allocations, par exemple 25565 pour Minecraft
Avec UFW, tu peux ouvrir les ports comme ceci. Autorise impérativement SSH en premier, sinon tu risques de perdre l’accès au serveur lorsque tu activeras le pare-feu :
Docker crée ses propres règles pour les ports des conteneurs de serveurs de jeux. Ces ports sont donc souvent accessibles même si tu ne les as pas autorisés dans UFW. Pour les ports de jeu, ne compte donc pas uniquement sur UFW.
FAQ
Questions fréquentes
Pterodactyl est un panneau gratuit et open source pour gérer des serveurs de jeux. Il comprend le Panel (l’interface Web) et Wings, le service qui lance chaque serveur de jeu dans son propre conteneur Docker.
La documentation officielle indique Ubuntu 22.04 et 24.04, Debian 11, 12 et 13, ainsi que Rocky Linux, AlmaLinux et RHEL 8 et 9. Le Panel ne prend plus en charge Ubuntu 20.04 et les versions antérieures.
Le Panel nécessite PHP 8.2 ou 8.3 ; PHP 8.3 est recommandé. Sous Ubuntu 22.04 et Debian, PHP 8.3 provient d’un dépôt supplémentaire. Ubuntu 24.04 l’inclut déjà.
Pour le Panel, ouvre les ports 80 et 443. Pour Wings, ouvre le port 8080 (API) et le port 2022 (SFTP). Ajoute également les ports de jeu de tes allocations, par exemple le port 25565 pour Minecraft.
Avis
Cet article t’a-t-il été utile ?
Ton avis nous aide à mieux définir les priorités et à améliorer les contenus.
0 de 0 Les personnes ayant donné leur avis ont trouvé cet article utile.
Aide personnalisée
Le guide ne suffit pas ?
Notre équipe d’assistance ZAP connaît ton produit : décris brièvement ta demande et nous t’aiderons personnellement.
Zappy connaît ce guide et te répond directement dans le chat.
Navigation
Logiciel
Télécharger le Panel
Crée le dossier du Panel et ouvre-le :
bash
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
Télécharge la dernière version, décompresse-la et définis les droits des dossiers storage/ et bootstrap/cache/ :
Tout est maintenant prêt pour ton premier serveur de jeu :
Dans la zone d’administration, ouvre Servers et clique sur Create New.
Attribue un nom et sélectionne le propriétaire (par exemple, ton compte administrateur).
Sélectionne le Node et une allocation disponible.
Définis la quantité de CPU, de RAM et d’espace disque attribuée au serveur.
Dans Nest et Egg, sélectionne le jeu, par exemple Minecraft avec Paper.
Clique sur Create Server.
Wings télécharge alors l’image Docker correspondante et installe le serveur. Tu le retrouveras ensuite dans la vue habituelle du Panel, où tu pourras le démarrer, ouvrir sa console et gérer ses fichiers.
Pour terminer et ressources supplémentaires
Félicitations ! Tu as installé Pterodactyl Panel et Wings sur ton serveur et tu peux maintenant gérer tes propres serveurs de jeux depuis l’interface Web. Ces ressources pourront t’aider :
Remarque : depuis la version 1.11, Pterodactyl envoie des données d’utilisation anonymes (télémétrie). La documentation officielle, dans la section « Additional Configuration », explique comment désactiver cette option.
Tu as encore des questions auxquelles ce guide ne répond pas ? Notre équipe d’assistance est là pour t’aider tous les jours : contacte-nous sans hésiter ! 🙂
Hébergement de serveurs dès 2,49 € / mois, mise en ligne immédiate, protection DDoS incluse.
Le Panel a besoin de PHP 8.2 ou 8.3 (la version 8.3 est recommandée) avec plusieurs extensions, d’une base de données (MariaDB ou MySQL), de Redis, d’un serveur Web (nous utilisons Nginx), ainsi que de curl, tar, unzip, git et Composer. Exécute les commandes correspondant à ta distribution.
Ubuntu 24.04
Sous Ubuntu 24.04, PHP 8.3, MariaDB et Redis sont déjà disponibles dans les dépôts de paquets par défaut. Tu n’as donc pas besoin d’ajouter de dépôts :
Ubuntu 22.04 ne fournit que PHP 8.1. Tu dois donc d’abord ajouter le dépôt PHP d’Ondřej Surý et le dépôt officiel de Redis, puis installer tous les paquets :
Copie l’exemple de configuration, installe les dépendances PHP et génère la clé de l’application :
bash
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
# Nur bei einer Neuinstallation ausführen, nicht bei einem bestehenden Panel
php artisan key:generate --force
Attention
Sauvegarder APP_KEY
Configurer le cron et le worker de file d’attente
Le Panel effectue de nombreuses tâches en arrière-plan, comme les tâches planifiées, l’envoi d’e-mails et le nettoyage. Tu as besoin d’un cron et d’un worker de file d’attente pour cela.
Cron
Ouvre la crontab avec sudo crontab -e et ajoute cette ligne. Elle lance le planificateur du Panel chaque minute :
Pour accéder au Panel via ton propre domaine en HTTPS, tu vas maintenant configurer le DNS, un certificat SSL et Nginx.
Créer un enregistrement DNS
Crée chez ton fournisseur de domaine un enregistrement A qui pointe vers l’adresse IP de ton serveur, par exemple panel.example.com. Si ton domaine est hébergé chez ZAP-Hosting, consulte notre guide sur les enregistrements de domaine. La propagation de l’enregistrement à l’échelle mondiale peut prendre un certain temps.
Créer un certificat SSL avec Certbot
Installe Certbot avec le plug-in Nginx et crée le certificat. Remplace panel.example.com par ton domaine :
Certbot vérifie le domaine via le port 80. Ce port doit donc être accessible depuis Internet. Pour en savoir plus sur Certbot, consulte notre guide Configurer Certbot sur un serveur Linux.
Le paquet Certbot renouvelle automatiquement les certificats. Pour que Nginx et Wings chargent également le certificat renouvelé, tu peux ajouter cette ligne à la crontab (sudo crontab -e) :
Crée un nouveau fichier de configuration pour le Panel :
bash
nano /etc/nginx/sites-available/pterodactyl.conf
Installer Wings
Wings est le service qui exécute réellement tes serveurs de jeux. Tu peux l’installer sur le même serveur que le Panel ou sur d’autres serveurs, que tu ajouteras ensuite au Panel en tant que nœuds supplémentaires.
Installer Docker
Wings lance chaque serveur de jeu dans un conteneur Docker. Installe Docker CE à l’aide du script d’installation officiel et active le service :
Debian 13 fournit PHP 8.4 par défaut, une version que Pterodactyl ne prend pas officiellement en charge. Tu dois donc récupérer PHP 8.3 depuis le dépôt Sury. Installe MariaDB et Redis directement depuis les dépôts de paquets Debian, sans ajouter de dépôts supplémentaires :
Vérifie ensuite rapidement que PHP 8.3 est actif :
bash
php -v
La valeur APP_KEY du fichier .env chiffre toutes les données sensibles du Panel, comme les clés API. Si tu la perds, ces données deviennent illisibles, même avec une sauvegarde de la base de données. Affiche-la avec grep APP_KEY /var/www/pterodactyl/.env et conserve-la en lieu sûr en dehors du serveur, par exemple dans ton gestionnaire de mots de passe.
Configurer l’environnement
Les commandes suivantes permettent de configurer les sessions, le cache, la connexion à la base de données et l’envoi d’e-mails. Elles te demanderont les valeurs de manière interactive :
bash
php artisan p:environment:setup
php artisan p:environment:database
# Optional: Mailversand einrichten ("smtp" für einen eigenen Mailserver)
php artisan p:environment:mail
À la question Application URL, indique l’adresse que tu utiliseras pour ton Panel, par exemple https://panel.example.com. Pour la base de données, utilise 127.0.0.1, le nom de base panel, l’utilisateur pterodactyl et le mot de passe que tu as défini précédemment. Tu peux choisir Redis pour le cache, les sessions et la file d’attente.
Remplir la base de données
Le Panel crée maintenant ses tables et importe les Nests et Eggs fournis (les modèles pour les différents jeux) :
bash
php artisan migrate --seed --force
Infos
Patiente un peu
L’opération peut prendre quelques minutes. Ne l’interromps pas, sinon la base de données sera incomplète.
Créer le premier compte administrateur
Crée ton compte administrateur. Le mot de passe doit comporter au moins 8 caractères, des lettres majuscules et minuscules, et au moins un chiffre :
bash
php artisan p:user:make
Réponds yes à la question qui te demande si l’utilisateur doit être administrateur.
Définir les autorisations
Pour permettre à Nginx et PHP d’accéder aux fichiers, attribue-les à l’utilisateur du serveur Web :
bash
chown -R www-data:www-data /var/www/pterodactyl/*
WantedBy
Enregistre avec STRG + X, puis Y et Enter. Active ensuite Redis et le worker de file d’attente pour qu’ils démarrent automatiquement après un redémarrage :
Avec cette configuration, Nginx ne démarre que si le certificat SSL existe déjà. Tu dois donc absolument le créer avec Certbot au préalable.
Configurer Nginx sans SSL
Tu veux seulement tester le Panel sans encore utiliser de domaine avec certificat ? Tu peux utiliser à la place cette configuration plus simple dans /etc/nginx/sites-available/pterodactyl.conf. Remplace panel.example.com par ton domaine ou l’adresse IP de ton serveur et supprime également au préalable le fichier /etc/nginx/sites-enabled/default :
Sans SSL, les identifiants et les mots de passe circulent en clair sur le réseau. Pour une utilisation à long terme, utilise donc toujours la configuration avec SSL.
Activer la configuration
Active la configuration, vérifie qu’elle ne contient pas d’erreur et redémarre Nginx :
Ouvre maintenant https://panel.example.com dans ton navigateur et connecte-toi avec le compte administrateur que tu as créé précédemment. Pour en savoir plus sur Nginx, consulte notre guide Configurer Nginx et Apache sur un serveur Linux.
Dans le Panel, ouvre la zone d’administration en haut à droite (icône d’engrenage).
Dans Locations, crée un emplacement avec Create New, par exemple avec le code de1.
Va dans Nodes et clique sur Create New.
Saisis un nom, sélectionne la Location et indique le domaine du serveur dans FQDN. Si Wings fonctionne sur le même serveur que le Panel, tu peux utiliser le même domaine, par exemple panel.example.com.
Dans Communicate Over SSL, sélectionne Use SSL Connection si ton Panel fonctionne en HTTPS. Le Node a alors aussi besoin d’un certificat valide pour son FQDN.
Dans Total Memory et Total Disk Space, indique la quantité de RAM et d’espace disque que Wings peut attribuer aux serveurs de jeux. Pense à laisser une marge pour le système lui-même.
Laisse Daemon Port sur 8080 et Daemon SFTP Port sur 2022, puis enregistre le Node.
Ouvre ensuite le Node et accède à l’onglet Configuration. Clique sur Generate Token et exécute la commande affichée sur ton serveur. Elle crée automatiquement le fichier /etc/pterodactyl/config.yml. Tu peux aussi copier manuellement le contenu du bloc de code dans ce fichier.
Tester Wings
Démarre Wings une fois en mode débogage afin de repérer immédiatement les erreurs :
bash
sudo wings --debug
Si Wings fonctionne sans erreur et que le Node affiche un cœur vert dans le Panel, sous Nodes, arrête le test avec STRG + C.
Configurer Wings en tant que service
Pour que Wings fonctionne en permanence en arrière-plan, crée un service systemd :
Une allocation est une combinaison d’adresse IP et de port que tu attribues à un serveur de jeu. Chaque serveur a besoin d’au moins une allocation. Tu peux trouver l’adresse IP de ton serveur avec la commande suivante :
bash
hostname -I | awk '{print $1}'
Dans la zone d’administration, ouvre ton Node et accède à l’onglet Allocation. Dans Assign New Allocations, indique l’adresse IP et les ports souhaités, par exemple 25565-25570 pour Minecraft. N’utilise jamais 127.0.0.1 comme allocation.
Source préférée sur Google
