Pterodactyl Panel Kullanım Rehberi

Pterodactyl panel kullanımı öğrenildiğinde Minecraft sunucunuzu SSH ya da RDP’ye hiç dokunmadan tarayıcıdan yönetebilirsiniz: konsola komut yazmak, dosya düzenlemek, yedek almak, otomatik yeniden başlatma kurmak ve arkadaşlarınıza sınırlı yetki vermek tek bir arayüzden yapılır. Panelin istemci tarafı tamamen tarayıcı üzerinden çalışır, bu yüzden Windows, macOS veya Linux kullanmanız fark etmez.

Bu rehber panelin kurulumunu değil kullanımını anlatır. Paneli kendi sunucunuza kuracaksanız önce Pterodactyl Panel kurulumu rehberini okuyun. Aşağıdaki adımlar, hosting sağlayıcınızın verdiği hazır panel hesabı için de birebir geçerlidir.

Pterodactyl ne yapar, ne yapmaz#

Pterodactyl, her oyun sunucusunu ayrı bir Docker konteynerinde çalıştıran açık kaynak bir oyun sunucusu yönetim panelidir. İki parçadan oluşur: web arayüzünü sunan Panel ve konteynerleri gerçekten çalıştıran Wings daemon’u. Siz konsola bir komut yazdığınızda panel bunu WebSocket üzerinden Wings’e iletir, Wings de konteynerin standart girişine yazar.

Panelin yaptıkları:

• Sunucuyu başlatma, durdurma, yeniden başlatma ve canlı konsol
• Dosya yöneticisi, arşiv açma/oluşturma, SFTP erişimi
• Otomatik ve manuel yedekleme, yedekten geri dönme
• Cron tabanlı zamanlanmış görevler
• MySQL veritabanı oluşturma, alt kullanıcı ve izin yönetimi
• CPU, RAM, disk ve ağ kullanımının anlık grafiği

Panelin yapamadıkları: RAM/CPU limitinizi kendi kendine artırmak, sunucuya root erişimi vermek, konteyner dışına dosya yazmak. Bu limitler yönetici tarafında tanımlıdır. Kök erişimi ve sınırsız yapılandırma istiyorsanız panelli paket yerine yüksek frekanslı Ryzen VDS tarafına geçmeniz, paneli kendi sunucunuza kurmanız gerekir.

Panele giriş, hesap güvenliği ve API anahtarları#

Panel adresi genellikle panel.firmaadi.com biçimindedir. Giriş yaptıktan sonra ana sayfada yetkiniz olan sunucular listelenir; her satırda sunucu adı, IP:port ve anlık CPU/RAM kullanımı görünür.

Sağ üstteki avatardan Account sayfasına girin ve iki adımlı doğrulamayı (2FA) mutlaka açın. Panel şifreniz aynı zamanda SFTP şifrenizdir; ele geçirilirse saldırgan tüm dünya ve eklenti dosyalarınıza erişir. Bu yüzden panel şifresini başka hiçbir serviste kullanmayın ve en az 16 karakter tutun.

Aynı sayfadaki API Credentials bölümünden istemci API anahtarı üretebilirsiniz. Discord botundan sunucuyu başlatmak, harici bir izleme sistemine durum bilgisi taşımak gibi işler için kullanılır:

curl -s "https://panel.firmaadi.com/api/client/servers/a1b2c3d4/resources" \
  -H "Authorization: Bearer ptlc_ANAHTARINIZ" \
  -H "Accept: application/json"

Sunucu arayüzünün haritası#

Bir sunucuya tıkladığınızda üstte sekmeler belirir. Hangi sekmenin ne işe yaradığını bir tabloda toplayalım:

Console sekmesi: başlatma, durdurma ve komut gönderme#

Console sekmesinde dört güç düğmesi vardır: Start, Restart, Stop ve sunucu çalışırken beliren Kill. Stop düğmesi egg’de tanımlı durdurma komutunu (Minecraft için stop) konsola yazar; sunucu dünyayı kaydeder ve düzgün kapanır. Kill ise SIGKILL gönderir ve hiçbir kaydetme yapılmaz.

Konsolun alt satırına doğrudan sunucu komutu yazabilirsiniz — başına eğik çizgi koymayın. Konsolda op OyuncuAdi yazılır, /op OyuncuAdi değil. Kullanabileceğiniz komutların tam listesi için Minecraft sunucu konsol komutları sayfasına bakın.

Konsolun sağındaki grafikler CPU, bellek, disk ve ağ kullanımını gösterir. Buradaki bellek değeri konteynerin toplam kullanımıdır; Java heap’ten fazladır çünkü metaspace, GC yapıları ve doğrudan tampon bellek de sayılır. Grafikteki bellek sürekli limitin dibindeyse heap değeriniz konteyner limitine fazla yakın demektir.

Files sekmesi ve SFTP ile dosya aktarımı#

Dosya yöneticisi tarayıcıdan klasör gezmenize, dosya oluşturmanıza, yeniden adlandırmanıza, taşımanıza ve içerik düzenlemenize izin verir. Metin dosyalarına tıkladığınızda sözdizimi renklendirmeli bir düzenleyici açılır; server.properties, bukkit.yml, config.yml gibi dosyaları buradan düzenleyebilirsiniz. server.properties ayarlarının tam listesi ayrı bir sayfada anlatılıyor.

Birkaç kritik nokta:

1. Yükleme sınırına takılmayın#

   Tarayıcıdan yükleme büyük modpack arşivlerinde zaman aşımına uğrayabilir. 100 MB üzeri dosyaları SFTP ile aktarın.

2. Arşivi sunucuda açın#

   Bir .zip ya da .tar.gz dosyasını yükledikten sonra sağ tıklayıp Unarchive deyin. Modpack’i bilgisayarınızda açıp binlerce küçük dosyayı tek tek yüklemekten çok daha hızlıdır.

3. SFTP bilgilerini Settings sekmesinden alın#

   Adres, kullanıcı adı ve port orada yazar. Şifre panel şifrenizdir.

   Sunucu   : sftp://dugum.firmaadi.com
   Port     : 2022
   Kullanıcı: kullaniciadi.a1b2c3d4
   Şifre    : panel şifreniz

SFTP için Windows’ta WinSCP, çapraz platformda FileZilla iş görür. Eklenti kurulumunun mantığı panelde de aynıdır: jar dosyası plugins/ klasörüne atılır ve sunucu yeniden başlatılır — ayrıntı için Minecraft plugin kurulumu sayfasına bakın.

Startup sekmesi: sürüm, jar dosyası ve JVM bayrakları#

Startup sekmesi panelin en kritik kısmıdır. Üstte sunucunun tam başlangıç komutu, altta egg’in tanımladığı değişkenler, en altta da Docker imaj seçimi bulunur.

Docker imajı = Java sürümü#

Pterodactyl’de Java’yı siz kurmazsınız; seçtiğiniz Docker imajı Java sürümünü belirler. Minecraft 26.1 ve 26.2 Java 25 zorunlu kılar. Listeden Java 21 seçili kalırsa sunucu UnsupportedClassVersionError ile kapanır.

Sürüm–Java eşleşmesinin ayrıntısı için Minecraft için hangi Java sürümü gerekir sayfasına bakabilirsiniz.

Başlangıç komutunu düzenleme#

Varsayılan Paper egg’i genellikle şu komutu kullanır:

java -Xms128M -XX:MaxRAMPercentage=95.0 -jar {{SERVER_JARFILE}}

MaxRAMPercentage yaklaşımı çalışır ama tahmin edilebilir performans için sabit heap vermek daha iyidir. 16 GB’lık bir konteynerde başlangıç komutunu şöyle değiştirebilirsiniz:

java -Xms14G -Xmx14G -XX:+UseG1GC -XX:+ParallelRefProcEnabled \
-XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC \
-XX:+AlwaysPreTouch -XX:G1NewSizePercent=40 -XX:G1MaxNewSizePercent=50 \
-XX:G1HeapRegionSize=16M -XX:G1ReservePercent=15 -XX:G1HeapWastePercent=5 \
-XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=20 \
-XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 \
-XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 \
-Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true \
-jar {{SERVER_JARFILE}} nogui

Aikar’s Flags 26.x sunucularında hâlâ geçerlidir ve 8–12 GB heap için en iyi sonucu verir. 16 GB üzeri heap’li veya ağır modlu sunucularda G1GC yerine -XX:+UseZGC denenebilir; bu durumda G1’e özel bayrakların hepsini kaldırın. Bayrak seçiminin gerekçeleri RAM ayarları ve JVM flag’leri sayfasında ayrıntılı anlatılıyor.

Backups: yedek alma, geri yükleme ve .pteroignore#

Backups sekmesinden tek tıkla yedek alırsınız. Wings, sunucu dizinini .tar.gz olarak arşivler ve düğümün diskine (varsayılan /var/lib/pterodactyl/backups) yazar. Sağlayıcı S3 tanımladıysa uzak depoya gider.

Yedek alırken sunucu çalışmaya devam eder, ancak arşivleme sırasında disk I/O arttığı için TPS düşebilir. Bu yüzden yedekleri gece 04:00–06:00 arasına zamanlamak mantıklıdır.

Yedek boyutunu küçültmek için sunucu kök dizininde .pteroignore dosyası oluşturun. Söz dizimi .gitignore ile aynıdır:

# Yedeğe girmeyecekler
cache/
logs/
crash-reports/
libraries/
versions/
plugins/dynmap/web/
*.jar.tmp

Panel yedeği tek başına yeterli bir strateji değildir çünkü yedek çoğu kurulumda sunucuyla aynı diskte durur. En az bir kopyayı kendi bilgisayarınıza indirin. 3-2-1 kuralı ve otomasyon için sunucu yedekleme stratejileri sayfasını okuyun.

Schedules: otomatik yeniden başlatma ve zamanlanmış görevler#

Schedules sekmesi cron söz dizimiyle çalışır. Bir zamanlama oluşturur, içine sırayla çalışacak görevler (task) eklersiniz. Kullanılabilir görev türleri: Send command, Send power action ve Create backup. Her görevin başına saniye cinsinden bir gecikme (offset) verilebilir.

Her gece 05:00’te oyuncuları uyarıp yedek alan ve yeniden başlatan tipik bir zamanlama şöyle kurulur:

Görev sırası:

1. Oyuncuları uyar#

   Send command, gecikme 0 saniye:

   say Sunucu 2 dakika icinde yeniden baslatilacak.

2. Dünyayı diske yaz#

   Send command, gecikme 90 saniye:

   save-all flush

3. Yedek al ve yeniden başlat#

   Önce Create backup (gecikme 15 saniye), ardından Send power action → Restart (gecikme 120 saniye).

Günlük yeniden başlatma, bellek sızıntısı yapan eklentilerin etkisini sıfırladığı ve chunk önbelleğini temizlediği için TPS’i belirgin şekilde toparlar. Konuyu Minecraft sunucu optimizasyonu sayfasında ayrıntılı ele alıyoruz.

Databases, Users ve Network sekmeleri#

Veritabanı oluşturma#

Databases sekmesinde New Database derseniz panel bir MySQL veritabanı, kullanıcı ve rastgele şifre üretir. Bağlantı bilgilerini eklentinin yapılandırmasına şu biçimde girersiniz:

storage-method: MySQL
data:
  address: 10.0.0.5:3306
  database: s12_luckperms
  username: u12_kX9pQ2vLmA
  password: 'panelden-kopyalanan-sifre'

Panelin gösterdiği “Connections From” alanı varsayılan olarak %’tir; yani veritabanına her IP’den bağlanılabilir. Sağlayıcınız izin veriyorsa bunu sunucunun kendi IP’siyle sınırlayın. Veritabanı en çok LuckPerms, CoreProtect ve ekonomi eklentilerinde işe yarar; LuckPerms yetki sistemi sayfasında MySQL kurulumunu adım adım bulabilirsiniz.

Alt kullanıcı ekleme#

Users sekmesinden e-posta adresiyle alt kullanıcı davet edersiniz. Davet edilen kişi kendi panel hesabıyla giriş yapar; sizin şifrenizi bilmesi gerekmez. İzinler onay kutularıyla verilir: yalnızca konsolu okuyabilsin, komut gönderebilsin, dosya indirebilsin ama silemesin gibi.

Port tahsisleri#

Network sekmesinde sunucuya atanmış IP:port çiftleri listelenir. Biri birincil (primary) tahsistir ve Minecraft bu porttan dinler. Ek tahsis alabiliyorsanız Bedrock istemcileri için Geyser (19132/UDP) ya da dinamik harita eklentisinin web portu için ikinci bir port ekleyebilirsiniz.

Settings sekmesi ve Reinstall tuzağı#

Settings sekmesinde sunucu adını değiştirebilir, SFTP bilgilerini görebilir ve Reinstall Server düğmesine ulaşabilirsiniz. Reinstall, egg’in kurulum betiğini baştan çalıştırır: sunucu jar’ını yeniden indirir, gerekli dizinleri oluşturur.

Reinstall genelde şu durumlarda gerekir: sürüm yükseltmesinden sonra jar indirilmediyse, kurulum yarıda kaldıysa veya sunucu türünü (Vanilla → Paper gibi) değiştirdiyseniz. Sunucuyu başka bir sağlayıcıya taşıyacaksanız Reinstall değil, sunucu taşıma rehberindeki yöntemi izleyin.

Sık karşılaşılan panel sorunları#

Sunucu başlıyor, hemen kapanıyor

Konsolun ilk 20 satırını okuyun. En sık iki neden: EULA kabul edilmemiş (eula.txt içinde eula=true olmalı) veya Docker imajı yanlış Java sürümünde.

“Server marked as starting but never started”

Wings, egg’de tanımlı başlangıç göstergesini konsolda göremedi. Genellikle başlangıç komutu bozuk yazılmıştır; Startup sekmesindeki komutu varsayılana döndürüp deneyin.

Konsol boş kalıyor, güç düğmeleri gri

Panel ile Wings arasındaki WebSocket bağlantısı kurulamıyor demektir. Tarayıcı sekmesini yenileyin; düzelmezse düğüm çevrimdışıdır, sağlayıcınıza destek talebi açın.

Disk dolu uyarısı

logs/, crash-reports/ ve dinamik harita önbellekleri şişer. Files sekmesinden temizleyin, ardından .pteroignore ile yedeklerden de dışlayın.

Sunucu limitten önce kapanıyor (exit code 137)

Konteyner belleği aşıldı ve çekirdek işlemi öldürdü. -Xmx değerini konteyner limitinin 2 GB altına çekin; sorun sürerse pakedinizi büyütün.

Bunların dışındaki hatalar genelde paneli değil Minecraft’ı ilgilendirir; hata metnini Minecraft sunucu hataları ve çözümleri sayfasında arayın.

Özetle#

Pterodactyl panel kullanımının özü şu: günlük iş Console ve Files sekmelerinde döner, sunucunun kimliğini Startup sekmesi belirler, hayat kurtaran şey ise Backups ve Schedules’tır. Minecraft 26.2 için Docker imajını Java 25’e almayı, heap değerini konteyner limitinin altında tutmayı ve gecelik otomatik yedek + restart zamanlaması kurmayı ilk gün halledin.

Paneli kendiniz kurmak istiyorsanız Pterodactyl kurulum rehberi baştan sona anlatıyor. Uğraşmadan hazır panelli bir sunucu istiyorsanız Batihost’un web panelli sunucu ve Minecraft sunucu paketleri NVMe SSD ve yüksek frekanslı Ryzen işlemcilerle 156 TL’den başlıyor.