ACLClouds
ACLClouds

Pterodactyl: cos’è e come installarlo su un VPS

Il pannello Pterodactyl e il suo demone Wings spiegati, poi l’installazione completa su un VPS Debian o Ubuntu: PHP, MariaDB, Redis, nginx, certbot, Docker

Qui Pterodactyl non è il rettile volante: è un pannello open source per creare e gestire server di gioco dal browser. Questa guida spiega come funziona e che macchina richiede, poi lo installa passo passo su un VPS Ubuntu 24.04: il pannello con PHP 8.3, MariaDB, Redis e nginx, l’HTTPS con certbot, infine Wings e Docker per far girare i server. I comandi seguono la documentazione ufficiale di Pterodactyl e vanno eseguiti come root.

  • Pterodactyl sono due software: il pannello web (PHP, MariaDB, Redis) e Wings, che esegue ogni server di gioco in un container Docker.
  • Ti serve un VPS KVM con Ubuntu, Debian, Rocky o AlmaLinux, un dominio per l’HTTPS e 2 GB di RAM per il solo pannello.
  • Con Wings sulla stessa macchina, la RAM necessaria è quella del pannello più quella di ogni server di gioco.
  • Fai il backup del file .env (APP_KEY), del database del pannello e dei volumi dei server, fuori dal VPS.

Cos’è Pterodactyl?

Pterodactyl è un pannello di gestione per server di gioco rilasciato con licenza MIT. È composto da due software: il pannello, un’applicazione web in PHP che conserva account, server e impostazioni, e Wings, un demone scritto in Go che avvia ogni server di gioco nel proprio container Docker. Un solo pannello può gestire più macchine Wings, chiamate nodi.

  • Il pannello: interfaccia web, API, database MariaDB o MySQL, cache e coda dei job in Redis.
  • Wings: API del nodo sulla porta 8080 e SFTP sulla porta 2022 di default, container Docker per i server.
  • Gli egg: modelli di server (Minecraft Paper, Rust, ARK, bot e altri) che definiscono l’immagine Docker, l’installazione e il comando di avvio.
  • Ogni giocatore o cliente riceve l’accesso ai propri server: console, file, backup, attività pianificate e sotto-utenti.

Requisiti: sistema, RAM e virtualizzazione

La documentazione ufficiale supporta Ubuntu 22.04 e 24.04, Debian 11, 12 e 13, oltre a Rocky Linux e AlmaLinux 8 e 9. Il pannello richiede PHP 8.2 o 8.3, MariaDB 10.2 o successivo (oppure MySQL 5.7.22 o successivo), Redis, un web server e Composer 2. Wings ha bisogno di Docker e di una virtualizzazione completa: KVM funziona, OpenVZ e LXC danno quasi sempre problemi.

  • Verifica la virtualizzazione con systemd-detect-virt: l’output non deve contenere né openvz né lxc. I VPS ACLClouds sono macchine KVM.
  • RAM: il pannello da solo sta in 2 GB. Con Wings sulla stessa macchina, aggiungi la memoria di ogni server di gioco, per esempio 4 GB per un server Minecraft Paper con una decina di giocatori.
  • Per l’HTTPS serve un dominio che punti all’IP del VPS; va bene un sottodominio gratuito su aclclouds.online.
  • Per il pannello e uno o due server piccoli basta il piano Mini (8 GB di RAM, 2 vCPU); oltre, il piano Essentiel (16 GB, 4 vCPU) lascia margine. Vedi i VPS Linux.

Installare PHP, MariaDB, Redis e nginx

Su Ubuntu 24.04, PHP 8.3 arriva dal repository ondrej/php. Aggiorna prima il sistema con apt update && apt -y upgrade, poi installa le dipendenze e Composer. Su Debian la documentazione ufficiale ha una pagina dedicata con un altro repository PHP: segui quella invece di questi comandi.

  • apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
  • LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php && apt update
  • apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server
  • curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Scaricare il pannello e creare il database

Il pannello si installa in /var/www/pterodactyl partendo dall’archivio dell’ultima versione pubblicata su GitHub. Crea poi un database MariaDB e un utente usato solo dal pannello, con una password lunga e unica.

  • mkdir -p /var/www/pterodactyl && cd /var/www/pterodactyl
  • curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz && tar -xzvf panel.tar.gz && chmod -R 755 storage/* bootstrap/cache/
  • In mariadb -u root -p: CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'passwordUnica'; CREATE DATABASE panel; GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
  • cp .env.example .env && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
  • php artisan key:generate --force: la chiave APP_KEY cifra dati del pannello. Copiala fuori dal server, perché senza di essa il ripristino è impossibile.

Configurare l’ambiente e creare l’amministratore

Tre procedure guidate compilano il file .env: l’indirizzo del pannello e i driver di cache, sessione e coda (scegli Redis), poi la connessione al database, infine l’invio delle e-mail. La migrazione crea quindi le tabelle e gli egg inclusi, e l’ultimo comando crea il primo account amministratore.

  • php artisan p:environment:setup, poi php artisan p:environment:database e php artisan p:environment:mail
  • php artisan migrate --seed --force: non interromperlo, l’importazione degli egg richiede un po’ di tempo.
  • php artisan p:user:make: rispondi yes alla domanda sull’amministratore.
  • chown -R www-data:www-data /var/www/pterodactyl/*: i file appartengono all’utente del web server.

Attivare il cron e il worker della coda

Il pannello ha bisogno di un cron che giri ogni minuto (pulizia, attività pianificate dei server) e di un worker che elabori la coda Redis. Senza worker, la creazione dei server e le e-mail restano bloccate.

  • crontab -e, poi la riga: * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
  • Crea /etc/systemd/system/pteroq.service con User=www-data, Group=www-data, Restart=always ed ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
  • systemctl enable --now redis-server, poi systemctl enable --now pteroq.service

Configurare nginx e l’HTTPS con certbot

Punta prima un record A del dominio, per esempio panel.example.com, verso l’IPv4 del VPS. Ottieni poi il certificato con il plugin nginx di certbot e crea il blocco server del pannello partendo dal modello nginx con SSL della documentazione ufficiale: root /var/www/pterodactyl/public, PHP inoltrato al socket di PHP-FPM 8.3 e i percorsi del certificato ottenuto.

  • apt -y install certbot python3-certbot-nginx, poi certbot certonly --nginx -d panel.example.com
  • In /etc/nginx/sites-available/pterodactyl.conf: server_name panel.example.com, ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem e fastcgi_pass unix:/run/php/php8.3-fpm.sock.
  • rm /etc/nginx/sites-enabled/default, ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/, poi nginx -t && systemctl restart nginx
  • Il rinnovo è automatico con il timer di certbot; provalo con certbot renew --dry-run. I dettagli sono nella guida al certificato HTTPS gratuito.

Installare Docker e Wings, poi collegare il nodo

Wings può girare sullo stesso VPS del pannello o su un’altra macchina. Installa Docker con lo script ufficiale, poi il binario di Wings. Nel pannello crea una Location, poi un nodo con il suo dominio, l’opzione SSL e la memoria e il disco da condividere. La scheda Configuration del nodo mostra il contenuto di config.yml da copiare in /etc/pterodactyl.

  • curl -sSL https://get.docker.com/ | CHANNEL=stable bash && systemctl enable --now docker
  • mkdir -p /etc/pterodactyl && curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64 && chmod u+x /usr/local/bin/wings
  • Avvia wings --debug una prima volta per vedere gli errori, poi crea il servizio wings.service (ExecStart=/usr/local/bin/wings, dopo docker.service) e attivalo con systemctl enable --now wings.
  • Aggiungi le allocation al nodo: l’IP pubblico indicato da hostname -I, mai 127.0.0.1, e un intervallo di porte, per esempio 25565-25600.
  • Il pannello mostra un cuore verde accanto al nodo quando Wings risponde; altrimenti controlla il certificato e la porta 8080.

Proteggere il pannello e i nodi

Un pannello di gioco espone un’interfaccia di amministrazione, un’API e porte di gioco: è un bersaglio. Apri solo le porte necessarie, proteggi gli account e fai il backup di ciò che non si reinstalla. Le basi per irrobustire un VPS sono nella nostra guida alla sicurezza Linux.

  • Firewall: 22 (SSH), 80 e 443 per il pannello, 8080 e 2022 per Wings, poi le porte delle allocation, in TCP e UDP a seconda del gioco.
  • Attiva l’autenticazione a due fattori sugli account amministratore e disattiva l’accesso SSH con password.
  • Fai il backup del file .env, del database panel (mysqldump panel) e dei dati dei server in /var/lib/pterodactyl/volumes, poi copiali fuori dal VPS.
  • Aggiorna il pannello con php artisan p:upgrade e Wings sostituendo il binario, dopo un backup e seguendo le note di rilascio.

Senza installare nulla: le opzioni di ACLClouds

Se vuoi un tuo pannello senza passare da questi passaggi, il VPS Pterodactyl preconfigurato installa pannello, MariaDB, Redis, coda dei job e HTTPS a partire dal tuo dominio e dalle tue credenziali. Il VPS Pterodactyl + Wings aggiunge Docker e Wings, con il nodo, il suo config.yml e 100 allocation già creati. In entrambi i casi mantieni l’accesso root.

  • Queste immagini costano quanto gli altri VPS: l’installazione preconfigurata è inclusa.
  • Se vuoi solo giocare, senza amministrare un server, i nostri server di gioco girano sul pannello ACLClouds, costruito su Pterodactyl e Wings: il server viene consegnato pronto, senza nulla da installare da parte tua.

Domande frequenti

Pterodactyl è gratuito?

Sì. Il pannello e Wings sono rilasciati con licenza MIT, senza limiti di server o di utenti. Paghi solo la macchina su cui girano.

Quanta RAM serve per Pterodactyl?

Il pannello da solo funziona con 2 GB. Se Wings gira sullo stesso VPS, somma la memoria di ogni server di gioco: 8 GB bastano per uno o due server piccoli, 16 GB per diversi server medi.

Si può installare Pterodactyl su Windows?

No. Il pannello e Wings sono pensati per Linux e Wings non funziona su Windows. Usa un VPS Linux oppure, per i test, una macchina virtuale Linux sul tuo PC.

Pterodactyl ha bisogno di un nome di dominio?

Per un uso reale sì: l’HTTPS del pannello e la connessione sicura tra pannello e Wings si basano su un certificato legato a un nome. Basta un sottodominio gratuito su aclclouds.online.