Aller au contenu

VPS & Linux

Installer Pterodactyl sur un VPS : Panel, Wings et premiers serveurs

Pterodactyl vous donne votre propre panel de serveurs de jeux. Ce guide installe le Panel et Wings sur un même VPS Ubuntu LTS, puis crée le nœud et un premier serveur.

Mis à jour le 5 min de lectureAvancé60 min de mise en œuvre

Ce que vous allez installer

Pterodactyl se compose de deux briques :

BriqueRôleTechnologies
PanelInterface web : comptes, serveurs, ressources, consolePHP, MariaDB, Redis, Nginx
WingsService qui lance chaque serveur de jeu dans un conteneurGo, Docker

Ce guide installe les deux sur le même VPS pour Pterodactyl, sous Ubuntu LTS. Il suit la documentation officielle de Pterodactyl : en cas de doute sur une version (PHP notamment), c’est elle qui fait foi.

Prérequis :

  • un VPS KVM avec accès root (Docker a besoin d’un vrai noyau) ;
  • deux sous-domaines pointés vers l’IPv4 du VPS, par exemple panel.example.com et node.example.com ;
  • une connexion SSH avec un utilisateur sudo (voir première connexion à un VPS).

1. Installer les dépendances du Panel

Sur Ubuntu 24.04 LTS, PHP 8.3, MariaDB, Redis et Nginx sont disponibles dans les dépôts officiels :

sudo apt update
sudo apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} \
  mariadb-server nginx redis-server tar unzip git curl
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Vérifiez que la version de PHP installée fait partie de celles prises en charge par la version du Panel que vous allez télécharger.

2. Télécharger le Panel

sudo mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
sudo curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
sudo tar -xzvf panel.tar.gz
sudo chmod -R 755 storage/* bootstrap/cache/

3. Créer la base de données

Ouvrez la console MariaDB avec sudo mariadb, puis créez l’utilisateur et la base. Remplacez le mot de passe par une valeur longue et aléatoire :

CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'MotDePasseLongEtAleatoire';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
EXIT;

4. Configurer le Panel

cd /var/www/pterodactyl
sudo cp .env.example .env
sudo COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
sudo php artisan key:generate --force
sudo php artisan p:environment:setup
sudo php artisan p:environment:database
sudo php artisan p:environment:mail
sudo php artisan migrate --seed --force
sudo php artisan p:user:make
sudo chown -R www-data:www-data /var/www/pterodactyl/*

Les commandes p:environment posent des questions : URL du Panel (https://panel.example.com), pilote de cache et de sessions (Redis), identifiants de la base créée plus haut. p:user:make crée votre compte administrateur.

Sauvegardez la clé APP_KEY du fichier .env en lieu sûr : sans elle, les données chiffrées du Panel sont irrécupérables.

5. Tâche planifiée et file d’attente

Ajoutez la tâche planifiée du Panel avec sudo crontab -e :

* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

Puis créez le service de file d’attente /etc/systemd/system/pteroq.service :

[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service

[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
sudo systemctl enable --now redis-server
sudo systemctl enable --now pteroq.service

Pour le détail des services, voir créer un service systemd.

6. Nginx et HTTPS

Obtenez un certificat pour le Panel et pour le nœud avec Certbot :

sudo apt -y install certbot python3-certbot-nginx
sudo certbot certonly --nginx -d panel.example.com -d node.example.com

Créez ensuite /etc/nginx/sites-available/pterodactyl.conf à partir du modèle « Nginx avec SSL » de la documentation officielle, en remplaçant le nom de domaine et la version de PHP-FPM (php8.3-fpm.sock). Activez-le et rechargez Nginx :

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl restart nginx

Le Panel répond maintenant sur https://panel.example.com. Connectez-vous avec le compte créé à l’étape 4.

7. Installer Docker et Wings

curl -sSL https://get.docker.com/ | sudo CHANNEL=stable bash
sudo systemctl enable --now docker
sudo mkdir -p /etc/pterodactyl
sudo curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64
sudo chmod u+x /usr/local/bin/wings

Si vous préférez installer Docker depuis son dépôt officiel, suivez notre guide installer Docker sur un VPS.

8. Créer le nœud dans le Panel

  1. Dans l’administration du Panel, créez une Location (par exemple « fr »).
  2. Créez un Node : FQDN node.example.com, SSL activé, mémoire et disque totaux légèrement inférieurs à ceux du VPS.
  3. Dans l’onglet Configuration du nœud, copiez le bloc affiché dans /etc/pterodactyl/config.yml sur le VPS.
  4. Dans l’onglet Allocation, ajoutez l’IPv4 du VPS et une plage de ports pour vos jeux, par exemple 25565-25575.

Testez Wings au premier plan, qui affiche les erreurs éventuelles :

sudo wings --debug

Quand le nœud apparaît en vert (cœur battant) dans le Panel, arrêtez-le avec Ctrl+C et créez le service /etc/systemd/system/wings.service :

[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service

[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
sudo systemctl enable --now wings

9. Ouvrir les ports

PortUsage
22/tcpSSH
80, 443/tcpPanel (HTTP vers HTTPS)
8080/tcpAPI de Wings
2022/tcpSFTP des serveurs
Plage choisiePorts de jeu (TCP et/ou UDP selon le jeu)
sudo ufw allow 22/tcp
sudo ufw allow 80,443,8080,2022/tcp
sudo ufw allow 25565:25575/tcp
sudo ufw enable

Attention : Docker publie les ports des conteneurs en contournant en partie UFW. Ne comptez pas sur UFW seul pour masquer un port publié par un conteneur. Plus de détails dans configurer un pare-feu UFW.

10. Créer un premier serveur

Dans l’administration, menu Servers : choisissez le propriétaire, le nœud, une allocation, la RAM et le disque, puis le nest et l’egg du jeu (Minecraft Paper, par exemple). Pterodactyl télécharge l’image Docker, installe le jeu, et le serveur apparaît dans votre espace avec sa console.

D’autres eggs (Rust, Valheim, FiveM…) sont publiés par la communauté : importez-les depuis l’administration, et lisez-les avant de les utiliser, car un egg exécute un script d’installation sur votre nœud.

Maintenance

  • Mettez à jour le Panel et Wings en suivant la procédure officielle de chaque version : elle peut inclure des migrations de base de données.
  • Sauvegardez la base panel, le fichier .env et le dossier /var/lib/pterodactyl/volumes, qui contient les données des serveurs. Voir stratégie de sauvegarde.
  • Surveillez la RAM et le disque : un serveur de jeu qui manque de mémoire est arrêté par le système.

Vous préférez un serveur de jeu prêt à l’emploi, sans administration ? Nos offres Minecraft, Rust ou FiveM sont livrées avec leur panel.

Questions fréquentes

Pterodactyl est-il gratuit ?

Oui, Pterodactyl est un logiciel open source distribué sous licence MIT. Vous payez seulement le serveur qui l’héberge.

Peut-on installer le Panel et Wings sur le même VPS ?

Oui. C’est la configuration la plus simple pour débuter ; d’autres nœuds Wings pourront être ajoutés plus tard sur d’autres serveurs.

Pourquoi Wings ne démarre-t-il pas ?

Lancez wings --debug pour lire l’erreur. Les causes les plus fréquentes sont un fichier config.yml absent ou mal copié, un certificat SSL manquant pour le nœud alors que le Panel est en HTTPS, ou Docker arrêté.

Quelle RAM prévoir ?

Le Panel se contente de peu de mémoire. Additionnez la RAM de chaque serveur de jeu prévu, ajoutez 1 à 2 Go pour le système et gardez de la marge.

Articles liés