Decidi tu quali servizi possiamo attivare per analisi, personalizzazione e contenuti esterni.
Utilizziamo cookie e tecnologie simili sul nostro sito web per personalizzare i contenuti, integrare media esterni e comprendere meglio l'utilizzo delle singole sezioni.
Cookie necessari
Queste voci garantiscono funzioni di base come sicurezza, stabilità e gestione dei moduli.
Il trattamento dei dati può avvenire con il tuo consenso o sulla base di interessi legittimi. Nelle impostazioni dei cookie puoi negare il consenso a ciascuna categoria facoltativa o autorizzarla singolarmente.
Alcuni servizi trattano dati personali in Paesi terzi. Con il tuo consenso, accetti anche questo trasferimento. Trovi maggiori informazioni nella nostra informativa sulla privacy.
Potrai riaprire e modificare la tua selezione in qualsiasi momento. · 1.0.2
Configurare Pterodactyl su un Server VPS Linux: ospita il tuo pannello per game server
Scopri come installare Pterodactyl Panel e Wings sul tuo server Linux e gestire comodamente i tuoi game server tramite un’interfaccia web → Scopri di più
10 novembre 202613 min di lettura0 Visualizzazioni0 utile
Introduzione
Pterodactyl è un pannello gratuito e open source che ti permette di gestire game server come Minecraft, Rust, ARK o CS2 tramite un’interfaccia web. Ogni game server viene eseguito in un proprio container Docker, ben separato dagli altri.
Pterodactyl è composto da due parti:
Panel – l’interfaccia web in cui gestisci server, utenti e risorse (applicazione PHP con database e web server)
Wings – il servizio sul server che avvia, arresta e monitora i container dei game server
In questa guida ti mostriamo passo dopo passo come installare Panel e Wings sul tuo VPS ZapX o Server dedicato, configurare un dominio con SSL e creare il tuo primo game server.
Preparazione
Per usare Pterodactyl ti serve un VPS o un Server dedicato con Linux e accesso root tramite SSH. Scopri come collegarti al tuo server nella nostra guida al primo accesso SSH. Non conosci ancora ZapX? Dai prima un’occhiata all’introduzione ai VPS o ai Server dedicati.
Suggerimento
Autenticazione con chiave SSH
Ti consigliamo di usare una chiave SSH invece di una password. Scopri come fare nella nostra guida Creare e usare le chiavi SSH.
Requisiti hardware
Il Panel è leggero. Le risorse necessarie dipendono soprattutto dal numero di game server che vuoi gestire con Wings. Se installi Panel e Wings sullo stesso server, ti consigliamo:
Hardware
Minimo
Consigliato
CPU
2 core vCPU
4 core vCPU o più
RAM
4 GB
8 GB o più
Spazio su disco
30 GB
100 GB o più
Sistemi operativi supportati
Secondo la documentazione ufficiale di Pterodactyl, al momento sono supportati questi sistemi:
Sistema operativo
Versioni
Nota
Ubuntu
22.04, 24.04
Con la versione 22.04 ti serve un repository PHP aggiuntivo
Debian
11, 12, 13
PHP 8.3 è disponibile tramite il repository Sury
Rocky Linux / AlmaLinux / RHEL
8, 9
Nomi dei pacchetti e percorsi diversi; non trattati in questa guida
In questa guida trovi i comandi per Ubuntu e Debian. Il Panel non supporta più Ubuntu 20.04 e versioni precedenti. Se devi reinstallare il sistema, ti consigliamo Ubuntu 24.04 o Debian 12.
Verificare la virtualizzazione
Wings ha bisogno di Docker. Docker funziona senza problemi sui server basati su KVM e sui Server dedicati, ma di solito non sui container OpenVZ o LXC. Verifica la virtualizzazione con questo comando:
bash
systemd-detect-virt
L’output kvm o none (Server dedicato senza virtualizzazione) è corretto. Se compare openvz o lxc, in genere non puoi eseguire Wings su questo server.
Aggiornare il sistema
Prima dell’installazione, aggiorna il sistema all’ultima versione:
bash
apt update && apt upgrade -y
Firewall e porte
Se usi un firewall sul server, devi aprire queste porte:
Porta
Protocollo
Scopo
80 e 443
TCP
Panel (HTTP/HTTPS) e verifica del certificato da parte di Certbot
8080
TCP
API di Wings, usata dal Panel per comunicare con il Node
2022
TCP
Accesso SFTP ai file dei game server
Porte dei giochi
TCP/UDP
Le porte delle tue Allocation, ad esempio 25565 per Minecraft
Con UFW puoi aprire le porte, ad esempio, così. Consenti prima l’accesso SSH, altrimenti potresti bloccarti fuori dal server quando attivi il firewall:
Docker crea regole proprie per le porte dei container dei game server. Per questo, spesso queste porte sono raggiungibili anche se non le hai aperte in UFW. Non fare quindi affidamento solo su UFW per proteggere le porte dei giochi.
FAQ
Domande frequenti
Pterodactyl è un pannello gratuito e open source per gestire game server. È composto dal Panel (l’interfaccia web) e da Wings (il servizio sul server), che avvia ogni game server in un proprio container Docker.
Secondo la documentazione ufficiale, sono supportati Ubuntu 22.04 e 24.04, Debian 11, 12 e 13, Rocky Linux, AlmaLinux e RHEL 8 e 9. Il Panel non supporta più Ubuntu 20.04 e versioni precedenti.
Il Panel richiede PHP 8.2 o 8.3; è consigliata la versione 8.3. Su Ubuntu 22.04 e Debian, PHP 8.3 è disponibile tramite un repository aggiuntivo, mentre Ubuntu 24.04 lo include già.
Per il Panel, apri le porte 80 e 443; per Wings, la porta 8080 (API) e la porta 2022 (SFTP). Servono anche le porte di gioco delle tue Allocation, ad esempio la 25565 per Minecraft.
Feedback
Questo articolo ti è stato utile?
Il tuo feedback ci aiuta a definire le priorità e a migliorare i contenuti.
0 di 0 I feedback hanno giudicato utile questo articolo.
Assistenza personale
Le istruzioni non sono sufficienti?
Il supporto ZAP conosce il tuo prodotto: descrivi brevemente la tua richiesta e ti aiuteremo personalmente.
Navigazione
Software
Installare le dipendenze
Il Panel richiede PHP 8.2 o 8.3 (è consigliata la versione 8.3) con alcune estensioni, un database (MariaDB o MySQL), Redis, un web server (useremo Nginx) e anche curl, tar, unzip, git e Composer. Esegui i comandi per la tua distribuzione.
Ubuntu 24.04
Con Ubuntu 24.04, PHP 8.3, MariaDB e Redis sono già inclusi nei repository dei pacchetti standard. Non ti servono repository aggiuntivi:
Ubuntu 22.04 include solo PHP 8.1. Per questo, aggiungi prima il repository PHP di Ondřej Surý e il repository ufficiale di Redis, poi installa tutti i pacchetti:
Con Debian 11 e 12, PHP 8.3 è disponibile tramite il repository Sury, Redis tramite il repository ufficiale di Redis e MariaDB tramite lo script di configurazione di MariaDB:
Debian 13 include PHP 8.4 per impostazione predefinita, una versione non supportata ufficialmente da Pterodactyl. Per questo, installa PHP 8.3 dal repository Sury. Puoi installare MariaDB e Redis direttamente dai repository dei pacchetti Debian, senza aggiungerne altri:
Copia la configurazione di esempio, installa le dipendenze PHP e genera la chiave dell’applicazione:
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
Attenzione
Salva una copia di APP_KEY
Il valore APP_KEY nel file .env crittografa tutti i dati sensibili del Panel, ad esempio le chiavi API. Se lo perdi, questi dati non saranno più leggibili nemmeno con un backup del database. Visualizzalo con grep APP_KEY /var/www/pterodactyl/.env e salvalo in un luogo sicuro al di fuori del server, ad esempio nel tuo gestore di password.
Configurare l’ambiente
Con i comandi seguenti configuri le sessioni, la cache, la connessione al database e l’invio delle e-mail. I comandi ti chiederanno i valori in modo interattivo:
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
Quando ti viene chiesto l’Application URL, inserisci l’indirizzo che userai per il Panel, ad esempio https://panel.example.com. Per il database, usa 127.0.0.1, il database panel, l’utente pterodactyl e la password che hai impostato prima. Per cache, sessioni e code puoi scegliere Redis.
Popolare il database
Ora il Panel crea le proprie tabelle e importa i Nests e gli Eggs inclusi (i modelli per i singoli giochi):
bash
php artisan migrate --seed --force
Info
Attendi
L’operazione può richiedere alcuni minuti. Non interromperla, altrimenti il database non sarà completo.
Creare il primo account amministratore
Crea il tuo account amministratore. La password deve essere lunga almeno 8 caratteri, contenere lettere maiuscole e minuscole e almeno un numero:
bash
php artisan p:user:make
Quando ti viene chiesto se l’utente deve essere un amministratore, rispondi yes.
Impostare i permessi
Per consentire a Nginx e PHP di accedere ai file, assegnali all’utente del web server:
bash
chown -R www-data:www-data /var/www/pterodactyl/*
Configurare il cron job e il worker della coda
Il Panel svolge molte attività in background, ad esempio attività pianificate, e-mail e operazioni di pulizia. Per questo ti servono un cron job e un worker della coda.
Cron job
Apri il crontab con sudo crontab -e e aggiungi questa riga. Avvia lo scheduler del Panel ogni minuto:
Salva con STRG + X, poi premi Y e Enter. A questo punto abilita Redis e il worker della coda, in modo che entrambi si avviino automaticamente anche dopo un riavvio:
Puoi controllare se il servizio è attivo con systemctl status pteroq.
Configurare il web server e SSL
Per raggiungere il Panel tramite un tuo dominio con HTTPS, configura DNS, un certificato SSL e Nginx.
Aggiungere un record DNS
Crea un record A presso il tuo provider di domini e fallo puntare all’indirizzo IP del tuo server, ad esempio panel.example.com. Se il tuo dominio è registrato presso ZAP-Hosting, consulta la nostra guida ai record di dominio. Potrebbe volerci un po’ di tempo prima che il record sia attivo in tutto il mondo.
Creare un certificato SSL con Certbot
Installa Certbot con il plugin Nginx e crea il certificato. Sostituisci panel.example.com con il tuo dominio:
Certbot verifica il dominio tramite la porta 80, che deve quindi essere raggiungibile da Internet. Scopri di più su Certbot nella nostra guida Configurare Certbot su un server Linux.
Il pacchetto Certbot rinnova automaticamente i certificati. Per fare in modo che Nginx e Wings carichino anche i certificati rinnovati, puoi aggiungere questa riga al crontab (sudo crontab -e):
Nginx si avvia con questa configurazione solo se il certificato SSL esiste già. Assicurati quindi di crearlo prima con Certbot.
Configurare Nginx senza SSL
Se vuoi solo provare il Panel e non hai ancora un dominio con certificato, puoi usare questa configurazione più semplice in /etc/nginx/sites-available/pterodactyl.conf. Sostituisci panel.example.com con il tuo dominio o con l’indirizzo IP del server e, anche in questo caso, elimina prima il file /etc/nginx/sites-enabled/default:
Senza SSL, i login e le password viaggiano in rete non crittografati. Per l’uso continuativo, ti consigliamo quindi di usare sempre la configurazione con SSL.
Attivare la configurazione
Attiva la configurazione, verifica che non ci siano errori e riavvia Nginx:
Ora apri https://panel.example.com nel browser e accedi con l’account amministratore che hai creato prima. Per informazioni generali su Nginx, consulta la nostra guida Configurare Nginx e Apache su un server Linux.
Installare Wings
Wings è il servizio che esegue i tuoi game server. Puoi installare Wings sullo stesso server del Panel oppure su altri server, che potrai poi aggiungere al Panel come nodi aggiuntivi.
Installare Docker
Wings avvia ogni game server in un container Docker. Installa Docker CE con lo script di installazione ufficiale e attiva il servizio:
Prima di avviare Wings, crea un Node nel Panel, ovvero il server su cui viene eseguito Wings:
Apri la sezione amministrativa dal menu in alto a destra del Panel (icona a forma di ingranaggio).
In Locations, crea una sede con Create New, ad esempio usando il codice de1.
Vai a Nodes e fai clic su Create New.
Inserisci un nome, seleziona la Location e specifica il dominio del server come FQDN. Se Wings è installato sullo stesso server del Panel, puoi usare lo stesso dominio, ad esempio panel.example.com.
In Communicate Over SSL, seleziona Use SSL Connection se il Panel usa HTTPS. Anche il Node avrà bisogno di un certificato valido per il proprio FQDN.
In Total Memory e Total Disk Space, inserisci la quantità di RAM e di spazio che Wings può assegnare ai game server. Lascia un po’ di margine per il sistema.
Lascia Daemon Port su 8080 e Daemon SFTP Port su 2022, poi salva il Node.
Dopodiché apri il Node e passa alla scheda Configuration. Fai clic su Generate Token ed esegui sul server il comando visualizzato. Il comando crea automaticamente il file /etc/pterodactyl/config.yml. In alternativa, copia manualmente in questo file il contenuto del blocco di codice.
Testare Wings
Avvia Wings una volta in modalità debug per vedere subito eventuali errori:
bash
sudo wings --debug
Se Wings funziona senza errori e in Nodes il Node mostra un cuore verde nel Panel, interrompi il test con STRG + C.
Configurare Wings come servizio
Per mantenere Wings in esecuzione in background, crea un servizio systemd:
Un’Allocation è una combinazione di indirizzo IP e porta che assegni a un game server. Ogni server ne ha bisogno di almeno una. Trovi l’indirizzo IP del tuo server con:
bash
hostname -I | awk '{print $1}'
Nella sezione amministrativa, apri il tuo Node e passa alla scheda Allocation. In Assign New Allocations, inserisci l’indirizzo IP e le porte desiderate, ad esempio 25565-25570 per Minecraft. Non usare mai 127.0.0.1 come Allocation.
Creare il primo game server
Ora è tutto pronto per creare il tuo primo game server:
Nella sezione amministrativa, apri Servers e fai clic su Create New.
Assegna un nome e scegli il proprietario (ad esempio il tuo account amministratore).
Seleziona il Node e un’Allocation libera.
Imposta la quantità di CPU, RAM e spazio di archiviazione da assegnare al server.
In Nest e Egg, seleziona il gioco, ad esempio Minecraft con Paper.
Fai clic su Create Server.
Wings scaricherà l’immagine Docker appropriata e installerà il server. Dopo, lo troverai nella normale schermata del Panel, da cui potrai avviarlo, aprire la console e gestire i file.
Conclusione e altre risorse
Congratulazioni! Hai installato correttamente Pterodactyl Panel e Wings sul tuo server e ora puoi gestire i tuoi game server tramite l’interfaccia web. Queste risorse possono esserti utili:
Nota: a partire dalla versione 1.11, Pterodactyl invia dati anonimi sull’utilizzo (telemetria). Per disattivare questa funzione, consulta la sezione «Additional Configuration» nella documentazione ufficiale.
Hai altre domande a cui non hai trovato risposta qui? Il nostro team di assistenza è a tua disposizione ogni giorno: contattaci! 🙂
Hosting server da 2,49 € / mese, subito online, protezione DDoS inclusa.