Pterodactyl Panel Nasıl Kurulur? Debian + Wings

Bu rehber Debian 12 (önerilen) üzerinde Pterodactyl Panel kurulumu, Wings (node) ekleme ve egg yüklemeyi anlatır. Ubuntu 22.04 adımları çok benzerdir. Öncelikli işletim sistemi: Debian.

Ne lazım?

  • Temiz Debian 12 VDS (en az 2 vCPU / 4 GB RAM panel için; oyun node’u ayrı veya aynı makine)
  • Domain veya alt alan adı (örnek: panel.alanadiniz.com) — SSL için
  • Root veya sudo yetkisi

1) Sistem hazırlığı (Debian)

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git unzip tar software-properties-common apt-transport-https ca-certificates gnupg

2) Bağımlılıklar: PHP, MariaDB, Redis, Nginx

Resmi Pterodactyl dokümantasyonundaki Debian paketlerini kurun (PHP 8.2/8.3, composer, nginx, mariadb, redis). Özet:

# Redis
sudo apt install -y redis-server
sudo systemctl enable --now redis-server

# MariaDB
sudo apt install -y mariadb-server
sudo mysql_secure_installation

# PHP + eklentiler (sürüme göre php8.2-* veya php8.3-*)
sudo apt install -y php-cli php-fpm php-mysql php-gd php-mbstring php-bcmath php-xml php-curl php-zip php-tokenizer php-common redis

# Nginx + Composer
sudo apt install -y nginx
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

MariaDB’de panel veritabanı oluşturun:

sudo mysql -e "CREATE DATABASE panel;
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'GUCLU_SIFRE';
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
FLUSH PRIVILEGES;"

3) Panel dosyalarını indirin

sudo mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
sudo curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
sudo tar -xzvf panel.tar.gz
sudo chmod -R 755 storage/* bootstrap/cache/
sudo composer install --no-dev --optimize-autoloader
sudo cp .env.example .env
sudo php artisan key:generate --force

.env içinde veritabanı bilgilerini, APP_URL adresinizi ve mail ayarlarını doldurun. Sonra:

sudo php artisan migrate --seed --force
sudo php artisan p:user:make
sudo chown -R www-data:www-data /var/www/pterodactyl/*

4) Nginx + SSL

Nginx’te panel için bir site yapılandırması oluşturun (/etc/nginx/sites-available/pterodactyl.conf), domain’i panel.alanadiniz.com yapın, PHP-FPM sock’una bağlayın. Etkinleştirin:

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d panel.alanadiniz.com

Queue worker için systemd servisi ekleyin (p:schedule:run + queue:work). Resmi dokümandaki pteroq.service örneğini kullanın, sonra:

sudo systemctl enable --now pteroq.service
sudo systemctl enable --now cron
(crontab -l 2>/dev/null; echo "* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1") | crontab -

5) Wings (node) kurulumu — Debian

Wings, sunucuların çalıştığı node ajanıdır. Docker gerekir:

curl -sSL https://get.docker.com/ | CHANNEL=stable sudo sh
sudo systemctl enable --now docker
sudo mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64"
sudo chmod u+x /usr/local/bin/wings

Panel’den node ekleme

  1. Panele admin ile girin → Admin → Nodes → Create New.
  2. İsim, FQDN (node IP veya domain), toplam bellek / disk limitlerini girin.
  3. Location seçin (yoksa önce Locations’tan ekleyin).
  4. Kaydedin → node detayında Configuration sekmesine gidin.
  5. Gösterilen YAML’ı kopyalayın → node sunucusunda:
sudo nano /etc/pterodactyl/config.yml
# yapıştırın, kaydedin
sudo wings --debug
# test OK ise systemd ile kalıcı başlatın (resmi wings.service)
sudo systemctl enable --now wings

Firewall’da Wings / SFTP portlarını açın (varsayılan genelde 8080 HTTPS API, 2022 SFTP — panelde ne yazdıysa onu açın).

6) Egg yükleme

Egg = oyun/servis şablonu (Minecraft, Rust, CS2 vb.).

  1. Admin → Nests → bir nest oluşturun (örnek: Oyunlar).
  2. Eggs → Import Egg / New Egg.
  3. Hazır egg JSON’unu içe aktarın (Pterodactyl Egg Collection / oyun dokümanı).
  4. Egg içinde Docker image, startup komutu, portlar ve değişkenler tanımlıdır — gerekirse düzenleyin.
  5. Admin → Servers → Create New → Nest + Egg seçin → node, RAM, disk, port ayarlayın → Create.
Steam oyunu egg’lerinde çoğu zaman SteamCMD kullanılır. Egg’in SRCDS_APPID / App ID değerinin doğru olduğundan emin olun. Phoenix blogdaki oyun rehberleri App ID ve port için referanstır.

7) Allocation (port) ekleme

  1. Nodes → node’unuz → Allocation.
  2. IP + port aralığı ekleyin (örnek: 25565 Minecraft, 28015 Rust, 27015 CS2).
  3. Sunucu oluştururken bu allocation’ı seçin.

Kontrol listesi

  • Panel HTTPS ile açılıyor mu?
  • pteroq ve cron çalışıyor mu?
  • Wings systemctl status wings active mi?
  • Node panelde yeşil / reachable mi?
  • Egg import edildi mi, sunucu oluştu mu?

Resmi kaynak: pterodactyl.io dokümantasyonu. VDS: Ryzen VDS · Oyun paketleri: Oyun sunucu.

DDoS koruması: Oyun sunucusu ve VDS için Phoenix Guard DDoS koruması — XDP/eBPF + DPDK/VPP. Korumalı VDS paketleri.

Sık sorulan sorular

Pterodactyl Panel ile Wings farkı nedir?

Panel web arayüzü ve API’dir; Wings node ajanıdır ve oyun süreçlerini çalıştırır. İkisi de gerekir (aynı veya ayrı makinede).

Minimum sistem gereksinimi nedir?

Panel için genelde en az 2 vCPU / 4 GB RAM önerilir. Oyun node’u oyuna göre ayrıca RAM ve CPU ister.

Egg nedir?

Sunucu tipi şablonudur (Minecraft, FiveM vb.). Egg yükledikten sonra allocation (port) ekleyip sunucu oluşturursunuz.

SSL / domain şart mı?

Üretimde evet: panel için domain + Let’s Encrypt (veya benzeri) SSL önerilir. IP üzerinden ham HTTP kullanımı güvenli değildir.


İlgili rehberler