Cum instalezi și configurezi Pterodactyl Panel pe un VPS SSD: ghid complet

Dacă administrezi servere de jocuri — Minecraft, CS2, Rust, Valheim sau altele — știi cât de important este un panou de control stabil și profesionist. Pterodactyl Panel este soluția open-source de referință în acest domeniu: interfață web modernă, izolare prin Docker, API robust și suport pentru zeci de tipuri de servere de jocuri.

În acest ghid vei afla cum instalezi Pterodactyl Panel complet (Panel + Wings) pe un VPS SSD cu Ubuntu 22.04, de la zero până la primul server de joc funcțional.

Ce este Pterodactyl Panel și de ce ai nevoie de un VPS solid

Pterodactyl este o platformă de management a serverelor de jocuri, construită cu Laravel (PHP), MySQL și Redis. Fiecare instanță de joc rulează izolat într-un container Docker, ceea ce îmbunătățește semnificativ securitatea și stabilitatea.

Pentru a rula Pterodactyl fără probleme, ai nevoie de:

Minim 2 vCPU (recomandat 4 pentru mai multe instanțe)
Minim 2 GB RAM pentru Panel (Wings necesită memorie suplimentară per instanță)
SSD NVMe pentru I/O rapid — esențial la serverele de jocuri
Ubuntu 22.04 LTS sau Debian 12
Acces root via SSH

Un VPS NVMe de la CLIQHOST este ideal pentru această configurație, datorită vitezei de disk și latenței reduse.

Pasul 1: Pregătirea serverului

Conectează-te la VPS prin SSH și actualizează sistemul:

apt update && apt upgrade -y
apt install -y curl wget tar unzip git

Setează hostname-ul serverului:

hostnamectl set-hostname panel.domeniultau.com

Asigură-te că ai un domeniu sau subdomeniu (ex. panel.domeniultau.com) cu un record A care pointează spre IP-ul VPS-ului. Vei avea nevoie de un certificat SSL pentru Pterodactyl — vom folosi Let's Encrypt gratuit.

Pasul 2: Instalarea dependințelor

PHP 8.3

apt install -y software-properties-common
add-apt-repository ppa:ondrej/php -y
apt update
apt install -y php8.3 php8.3-cli php8.3-fpm php8.3-mysql \
  php8.3-mbstring php8.3-xml php8.3-bcmath php8.3-curl \
  php8.3-zip php8.3-gd php8.3-tokenizer

MySQL 8

apt install -y mysql-server
mysql_secure_installation

Creează baza de date pentru Pterodactyl:

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

Redis, Composer și Nginx

apt install -y redis-server nginx
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Pasul 3: Instalarea Pterodactyl Panel

Creează directorul aplicației și descarcă ultima versiune:

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/

Copiază fișierul de configurare și instalează dependințele:

cp .env.example .env
composer install --no-dev --optimize-autoloader
php artisan key:generate --force

Configurează mediul:

php artisan p:environment:setup
php artisan p:environment:database
php artisan p:environment:mail

Migrează baza de date și creează utilizatorul admin:

php artisan migrate --seed --force
php artisan p:user:make

Setează permisiunile corecte:

chown -R www-data:www-data /var/www/pterodactyl/

Pasul 4: Configurarea Nginx cu SSL

Instalează Certbot și obține certificatul Let's Encrypt:

apt install -y certbot python3-certbot-nginx
certbot certonly --nginx -d panel.domeniultau.com

Creează configurația Nginx /etc/nginx/sites-available/pterodactyl.conf:

server {
    listen 80;
    server_name panel.domeniultau.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name panel.domeniultau.com;

    root /var/www/pterodactyl/public;
    index index.php;

    ssl_certificate /etc/letsencrypt/live/panel.domeniultau.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/panel.domeniultau.com/privkey.pem;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Activează configurația:

ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

Pasul 5: Configurarea Queue Worker (cron + serviciu)

Adaugă cron job-ul pentru task-uri automate:

crontab -e
# Adaugă:
* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

Creează serviciul systemd /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

systemctl enable --now pteroq.service

Pasul 6: Instalarea Wings (agentul pe nodul de jocuri)

Wings este componenta care gestionează efectiv containerele Docker. Poate rula pe același VPS (pentru instalări mici) sau pe noduri separate.

Instalarea Docker

curl -sSL https://get.docker.com/ | CHANNEL=stable bash
systemctl enable --now docker

Instalarea Wings

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

Din panoul web Pterodactyl, mergi la Admin → Nodes → Create Node, completează datele și copiază config-ul generat în /etc/pterodactyl/config.yml.

Creează serviciul systemd:

curl -o /etc/systemd/system/wings.service \
  https://raw.githubusercontent.com/pterodactyl/wings/develop/installer/wings.service
systemctl enable --now wings

Pasul 7: Crearea primului server de joc

Intră în panoul Pterodactyl la https://panel.domeniultau.com
Mergi la Admin → Nests și importă un egg (ex. Minecraft Java)
Mergi la Servers → Create Server
Selectează utilizatorul, nodul, egg-ul și resursele alocate (RAM, disk, CPU)
Serverul va fi creat și pornit automat

Interfața web îți permite să pornești/oprești serverul, să accesezi consola live, să gestionezi fișierele și să configurezi backup-uri — totul fără SSH.

Sfaturi pentru o instalare stabilă

Actualizează periodic Panel-ul și Wings — comunitatea lansează patch-uri frecvent
Configurează un firewall cu UFW: permite doar porturile 80, 443, 8080 (Wings API) și porturile de joc necesare
Monitorizează resursele cu htop, df -h și docker stats pentru a evita supraîncărcarea
Backup automat — dacă folosești mai mulți utilizatori, backup-urile regulate sunt esențiale. Poți configura backup-uri automate direct din panou sau la nivel de sistem pe VPS
Separă Panel de Wings pe noduri diferite pentru instalări de producție cu mulți utilizatori

Dacă ai nevoie de ajutor cu configurarea serverului sau cu alegerea planului potrivit, echipa CLIQHOST îți stă la dispoziție.

Concluzie

Pterodactyl Panel transformă un VPS SSD obișnuit într-o platformă profesionistă de hosting pentru jocuri, cu izolare completă, interfață web modernă și posibilitate de scalare. Instalarea necesită atenție la detalii, dar ghidul de mai sus acoperă toți pașii esențiali pentru o configurare funcțională.

Dacă vrei performanță și mai bună pentru serverele de jocuri, explorează opțiunile de VPS NVMe sau servere dedicate de la CLIQHOST — resurse garantate, uptime ridicat și suport tehnic disponibil.

Cum instalezi și configurezi Pterodactyl Panel pe un VPS SSD: ghid complet