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
- Panele admin ile girin → Admin → Nodes → Create New.
- İsim, FQDN (node IP veya domain), toplam bellek / disk limitlerini girin.
- Location seçin (yoksa önce Locations’tan ekleyin).
- Kaydedin → node detayında Configuration sekmesine gidin.
- 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.).
- Admin → Nests → bir nest oluşturun (örnek: Oyunlar).
- Eggs → Import Egg / New Egg.
- Hazır egg JSON’unu içe aktarın (Pterodactyl Egg Collection / oyun dokümanı).
- Egg içinde Docker image, startup komutu, portlar ve değişkenler tanımlıdır — gerekirse düzenleyin.
- Admin → Servers → Create New → Nest + Egg seçin → node, RAM, disk, port ayarlayın → Create.
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
- Nodes → node’unuz → Allocation.
- IP + port aralığı ekleyin (örnek: 25565 Minecraft, 28015 Rust, 27015 CS2).
- Sunucu oluştururken bu allocation’ı seçin.
Kontrol listesi
- Panel HTTPS ile açılıyor mu?
pteroqve cron çalışıyor mu?- Wings
systemctl status wingsactive 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.