Installazione di Pterodactyl: guida completa per il pannello e Wings

Pterodactyl è una soluzione open source che semplifica l'hosting e la gestione dei server di gioco. La sua interfaccia web intuitiva comunica con un demone chiamato Wings per controllare le tue istanze. Questa guida ti accompagnerà nell'installazione completa: pannello, Wings e configurazione del Node.

Cosa ti serve prima di iniziare

Prepara il tuo ambiente con i seguenti elementi:

Server compatibile

Ubuntu 20.04, 22.04 o 24.04
Debian 10, 11 o 12

Accesso richiesto

Accesso root o utente con privilegi sudo
Pacchetti di base installati nel sistema

Inizia aggiornando il tuo sistema:

apt update && apt upgrade -y

Successivamente, installa le dipendenze essenziali:

apt install sudo curl

Deploy del pannello Pterodactyl

⚠️ Avviso: Lo script di installazione è adatto per un uso privato. Per un ambiente di produzione pubblico, preferisci un'installazione manuale.

Esegui lo script di installazione:

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

Seleziona l'opzione 0 per installare il pannello:

* Input 0-8: 0

Configurazione del database

Accetta l'installazione di MariaDB:

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

Lascia vuoti i campi del database: lo script genererà automaticamente una password sicura.

Configurazione generale

Imposta il fuso orario:

Select timezone [Europe/Stockholm]: Europe/Paris

Inserisci un indirizzo email valido per le notifiche:

Provide the email address: [email protected]

Creazione dell'account amministratore

Completa le informazioni del primo account:

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

Dominio e sicurezza

Specifica il nome di dominio che punta al tuo VPS:

Set the FQDN: panel.ouiheberg.com

Rifiuta la configurazione automatica del firewall per mantenere il controllo:

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

Attiva il certificato SSL tramite Let's Encrypt:

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

Conferma l'installazione:

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

✅ Il pannello è operativo.

Installazione del demone Wings

Rilancia lo script di installazione:

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

Scegli l'opzione 1 per Wings:

* Input 0-8: 1

Configurazione di Wings

Non reinstallare MariaDB se è già presente:

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

Mantieni la configurazione manuale del firewall:

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

Configura HTTPS per garantire la sicurezza delle comunicazioni:

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 è pronto.

Collegare il Node al pannello

Accedi al tuo pannello (es: panel.ouiheberg.com).

Creare una località

Vai su Locations e aggiungi una nuova località. Il nome è libero: serve per organizzare i tuoi nodi per zona geografica o utilizzo.

Aggiungere il Node

In Nodes, clicca su Create New e completa i campi:

Parametro	Descrizione
Name	Nome identificativo del node
FQDN	Dominio o IP del server Wings
Connessione	HTTPS se SSL attivo, HTTP altrimenti
Total Memory	Memoria allocata (es: 1024 per 1 GB)
Total Disk Space	Spazio disco disponibile
Over-Allocation	Percentuale di sovrallocazione consentita (0 se non desiderata)

Finalizzare il collegamento

Dopo la creazione, apri la scheda Configuration del Node. Genera un token e copia il comando visualizzato.

Esegui questo comando sul tuo VPS tramite SSH, quindi attiva Wings:

systemctl enable --now wings
systemctl start wings

Risolvere i problemi comuni

Sintomo	Causa probabile	Soluzione
Pannello non accessibile	DNS non propagato correttamente o FQDN errato	Verificare la configurazione DNS
Node disconnesso	Porte bloccate dal firewall	Aprire le porte 8080 e 2022
Wings rifiuta di avviarsi	Certificato SSL non valido	Consultare i log: `journalctl -u wings`
Errore del database	MariaDB inattivo o configurato male	Verificare: `systemctl status mariadb`
Errore SSL	Il dominio non punta al VPS	Correggere il record DNS A

Consigli sulla sicurezza

Segui queste best practices per un'installazione duratura:

Utilizza nomi di dominio dedicati per il pannello e ogni node
Attiva sempre HTTPS con un certificato valido
Mantieni il sistema aggiornato: apt update && apt upgrade -y
Crea account utente separati anziché utilizzare l'admin quotidianamente
Pianifica backup regolari del database e dei file di configurazione

Per concludere

Lo script di installazione semplifica notevolmente il deploy di Pterodactyl, ma una rigorosa configurazione di rete e SSL rimane essenziale. Applicando questa guida e i consigli sulla sicurezza, avrai a disposizione una piattaforma solida per ospitare i tuoi server di gioco.