Vai al contenuto

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:

HardwareMinimoConsigliato
CPU2 core vCPU4 core vCPU o più
RAM4 GB8 GB o più
Spazio su disco30 GB100 GB o più

Sistemi operativi supportati

Secondo la documentazione ufficiale di Pterodactyl, al momento sono supportati questi sistemi:

Sistema operativoVersioniNota
Ubuntu22.04, 24.04Con la versione 22.04 ti serve un repository PHP aggiuntivo
Debian11, 12, 13PHP 8.3 è disponibile tramite il repository Sury
Rocky Linux / AlmaLinux / RHEL8, 9Nomi 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:

PortaProtocolloScopo
80 e 443TCPPanel (HTTP/HTTPS) e verifica del certificato da parte di Certbot
8080TCPAPI di Wings, usata dal Panel per comunicare con il Node
2022TCPAccesso SFTP ai file dei game server
Porte dei giochiTCP/UDPLe 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:

bash
ufw allow OpenSSH
ufw allow 80,443/tcp
ufw allow 8080/tcp
ufw allow 2022/tcp
ufw allow 25565:25570/tcp
ufw allow 25565:25570/udp
ufw enable

Scopri di più nella nostra guida alla gestione del firewall su Linux.

Info

Docker e UFW

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à.

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.