Pterodactyl Kontrol Paneli¶

Bu makalede

• Pterodactyl Ana Özellikleri
• Çalıştırma Özellikleri
• Pterodactyl Dağıtımından Sonra Başlangıç
• Kullanıcı Oluşturma
• Konum (Location) Oluşturma
• Düğüm (Node) Oluşturma
• Tahsisatları (Allocations) Yapılandırma
• Wings Kurulumu
• Sorun Giderme
• Nest Oluşturma ve Egg Ekleme
• Sunucu Oluşturma
• Sunucuyu Başlatma ve Yapılandırma
• Performans Kontrolü
• API ile Pterodactyl Sunucusu Sipariş Edin

Pterodactyl Ana Özellikleri¶

Pterodactyl, şunları birleştiren modern bir oyun sunucusu yönetim çözümüdür:

• 50'ten fazla oyuna destek: Popüler oyun sunucularının hızlı kurulumu için hazır şablonlar sağlar. Yazılımı, bağımlılıkları ve başlangıç parametrelerini otomatik olarak yapılandırır; oyun sürümü seçimi ve özel şablon eklemeyi destekler.
• Hassas kaynak yönetimi: RAM, CPU, disk alanı ve sunucular arası öncelik tahsisini kontrol eder. Aşırı yüklenmeleri önler, kaynakları kotalara göre ayırır ve kararlılık için SWAP belleği kullanır.
• Güvenilir otomatik yedeklemeler: Veri seçimi ile (tüm sunucu veya ana dosyalar) esnek, zamanlanmış yedekleme sağlar. Yedekleri yerel olarak veya bulutta (S3, FTP, GDrive), şifreleme ve anında kurtarma özelliğiyle depolar.
• Verimli çoklu sunucu kapasitesi: Her bir sunucuyu izole edilmiş bir Docker konteynerinde çalıştırır. Yükü düğümler (nodes) arasında otomatik olarak dağıtır, çakışma olmadan portlar atar ve ilgili sunucuların gruplandurulmasına olanak tanır.
• Esnek çok kullanıcılı erişim: 50'den fazla ayrıntılı izin ile rol tabanlı bir model (ön tanımlı + özel roller) üzerinden yetkileri yönetir. Geçici erişimi, işlem denetimini ve iki faktörlü doğrulamayı destekler.
• Real-time management console: Etkileşimli bir terminal (SSH'a benzer) ile web arayüzü üzerinden tam kontrol sağlar. Renkli biçimlendirme, komut geçmişi, hızlı işlem düğmeleri ve olay bildirimleri içerir.
• Gerçek zamanlı istatistik izleme: Kaynak kullanım grafiklerini (CPU, RAM, disk, ağ) ve oyun metriklerini (çevrimiçi oyuncular, TPS, ping) görüntüler. Özel paneller oluşturmaya, uyarılar yapılandırmaya ve verileri CSV olarak dışa aktarmaya olanak tanır.
• Basitleştirilmiş mod/eklenti yönetimi: Otomatik mod kurulumu için yerleşik bir mağaza, sürüm ve bağımlılık yönetimi sunar. Sözdizimi vurgulamalı görsel bir yapılandırma düzenleyicisi ve güncelleme bildirimleri içerir.
• Otomatik güncellemeler: Kesintisiz sistem çalışmasını sağlar. Oyun sunucularını test moduyla zamanlanmış olarak günceller ve hatalarda geri yükleme yapar. Kontrol panelini tek bir komutla (php artisan p:upgrade) uyumluluğu kontrol ederek ve veri kaybı olmadan veritabanını taşıyarak günceller. Farklı Linux dağıtımlarıyla uyumluluğu koruyarak Wings daemon'ı otomatik olarak günceller.

Çalıştırma Özellikleri¶

Temel Sistem Bileşenleri:¶

Yapılandırma Dosyaları¶

Otomatik Olarak Ne Yüklenir?¶

Playbook şunları otomatik olarak yükler ve yapılandırır:

• Pterodactyl Panel - web arayüzüne sahip merkezi yönetim paneli;
• MariaDB - tüm sistem verilerini depolamak için veritabanı;
• Redis - önbelleğe alma ve görev kuyrukları için;
• NGINX - otomatik SSL sertifika yönetimi (Certbot) için bir Docker konteyneri ile birlikte çalışan web sunucusu;
• PHP + PHP-FPM - Laravel uygulamasının çalışması için;
• Certbot - otomatik SSL sertifikası edinimi için;
• Systemd servisleri - pteroq (kuyruk işleme), cron görevleri (zamanlayıcı).

Ek Olarak Ne Yüklenmesi Gerekir?¶

Oyun sunucularını çalıştırmak için şunlara ihtiyacınız vardır:

• Wings - Docker konteynerlerinde oyun sunucularını fiziksel olarak başlatan ve yöneten daemon.

Wings, oyun sunucularının çalıştırılmasının planlandığı her makineye (node) kurulur. Bu, Panel'in kurulu olduğu aynı sunucu ("all-in-one" yapılandırması) veya ayrı özel sunucular (dağıtık mimari) olabilir.

Sistem Gereksinimleri¶

Panel İçin (Kontrol Paneli)¶

Minimum gereksinimler:

• İşlemci: 2+ çekirdek;
• Bellek: 2 GB RAM (Kararlı çalışma için 4 GB önerilir);
• Disk: 20 GB SSD (Günlükler ve yedekler için 40+ GB önerilir);
• OS: Ubuntu 22.04 LTS (Jammy) - otomatik kurulum için kesinlikle bu sürüm.

Yazılım (otomatik olarak yüklenir):

• PHP + PHP-FPM;
• MariaDB 10.6+;
• Redis 7.0+;
• NGINX;
• Composer 2;
• Certbot (SSL için);
• Docker (imaj içinde önceden yüklü gelir).

Ağ gereksinimleri:

• Açık portlar: 80 (HTTP), 443 (HTTPS);
• Statik IP adresi veya alan adı; Let's Encrypt üzerinden otomatik olarak bir SSL sertifikası almak için hostkey.com alan adında geçerli bir FQDN gereklidir;
• Stabil internet bağlantısı.

Node İçin (Oyun Sunucularının Olduğu Düğümler)¶

5-10 eşzamanlı oyun sunucusu için:

• İşlemci: 4+ çekirdek (Zorlayıcı oyunlar için 6-8 çekirdek önerilir);
• Bellek: 8 GB RAM (Oyunlara bağlı olarak 12-16 GB önerilir);
• Disk: 50 GB SSD (Modlu birden fazla sunucu için 100+ GB önerilir);
• OS: Ubuntu 20.04/22.04, Debian 10/11, CentOS ⅞ (Docker desteği olan herhangi bir Linux).
• Yazılım:
  • Docker (imaj içinde önceden yüklü gelir);
  • Wings (kurulum gerektirir).

Ağ gereksinimleri:

• Açık portlar:
  • 8080 - Wings API (Panel ile iletişim);
  • 12333 - SSL bağlantısı Wings/Daemon;
  • 2022 - SFTP (oyun sunucularına dosya yükleme);
  • 25565-25665 - oyun port aralığı (bireysel olarak yapılandırılır);
• İyi bant genişliğine sahip stabil internet bağlantısı;
• Konforlu bir oyun deneyimi için düşük gecikme süresi.

"All-in-One" Yapılandırması (Tek Sunucuda Panel + Wings)¶

Test veya küçük projeler için tek bir sunucu kullanabilirsiniz:

• İşlemci: 4+ çekirdek;
• Bellek: 8 GB RAM (minimum 6 GB);
• Disk: 60 GB SSD (100+ GB önerilir);
• OS: Ubuntu 22.04 LTS.

Bu yapılandırmada tek bir sunucu şunları çalıştırır:

• Pterodactyl Panel (web arayüzü);
• Wings (sunucu başlatma daemon'ı);
• Veritabanı ve önbellek;
• Docker konteynerlerinde oyun sunucuları.

Pterodactyl Dağıtımından Sonra Başlangıç¶

Siparişiniz için ödeme yaptıktan sonra, kayıtlı e-posta adresinize sunucunuzun çalışmaya hazır olduğuna dair bir bildirim alacaksınız. Bu bildirim VPS IP adresinin yanı sıra bağlantı için giriş ve şifre bilgilerini içerecektir. Şirketimizin müşterileri donanımı sunucularda ve API kontrol panelinde — Invapi üzerinden yönetirler.

Sunucu kontrol panelinin Configuration >> Tags sekmesinde veya e-postada bulunabilecek yetkilendirme verileri şunlardır:

• Link: webpanel etiketindedir. Admin paneline erişmek için ana linke /admin ekleyin;
• Login: admin;
• Password: Yazılım dağıtıldıktan sonra sunucu çalışmaya hazır olduğunda e-posta yoluyla adresinize gönderilir.

İlk Giriş¶

1. Bir web tarayıcısı açın ve Pterodactyl panel adresinize gidin;

2. Login düğmesine tıklayın:

   

3. Başarılı yetkilendirmeden sonra ana panel sayfasına yönlendirileceksiniz.

4. Admin paneline erişmek için düğmesine tıklayın:

   

Kullanıcı Oluşturma¶

1. Admin panelinin sol menüsünde, Users bölüm ismine tıklayın;

2. Sağ üst köşedeki Create New düğmesine tıklayın:

   

3. Gerekli alanları doldurun:

   • Username: kullanıcı adı;
   • Email: kullanıcı e-posta adresi;
   • First Name: isim;
   • Last Name: soyisim;
   • Password: şifre (en az 8 karakter, büyük/küçük harf ve rakam içermelidir);
4. Gerekiyorsa, yönetici hakları vermek için Administrator satırında Yes seçeneğini seçin;

5. Create User düğmesine tıklayın:

   

Konum (Location) Oluşturma¶

1. Sol menüden Locations öğesini seçin;

2. Sağ üst köşedeki Create New düğmesine tıklayın:

   

3. Alanları doldurun:

   • Short Code: kısa konum kodu (örn. "US1", "EU1");
   • Description: konum açıklaması (örn. "ABD'deki veri merkezi");

4. Create düğmesine tıklayın:

   

Düğüm (Node) Oluşturma¶

Düğüm Oluşturmadan Önce Hazırlık¶

Düğüm oluşturmadan önce şunlardan emin olun:

• Sunucuya Docker yüklüdür (HOSTKEY imajlarında önceden yüklü gelir);
• Düğüm için bir IP adresiniz veya alan adınız vardır;
• Güvenlik duvarında 8080 (Wings API) ve 12333 (Wings/Daemon SSL iletişimi) portları açılacaktır.

Panel Üzerinden Düğüm Oluşturma¶

1. Admin panelinin sol menüsünden Nodes öğesini seçin;

2. Sağ üst köşedeki Create New düğmesine tıklayın:

   

3. Temel ayarları (basic settings) doldurun:

   • Name: benzersiz düğüm adı (örn. hostkey-us-node1);
   • Location: daha önce oluşturulan konumu seçin;
   • Public: düğümün kullanıcılar tarafından görünür olması gerekiyorsa kutucuğu işaretleyin;
   • FQDN: panel alan adını (örn. pterodactyl50514.hostkey.in) veya IP adresini belirtin;
   • Communicate Over SSL: Panel HTTPS kullanıyorsa kutucuğu işaretleyin;
   • Behind Proxy: düğüm bir proxy arkasında değilse devre dışı bırakın.

4. Kaynak ayarlarını (resource settings) yapılandırın:

   • Daemon Server File Directory: /var/lib/pterodactyl/volumes (değiştirmeyin);
   • Total Memory: MB cinsinden kullanılabilir RAM miktarını belirtin (örn. 6GB'lık bir sunucu için rezerv hesabı ile 4608);
   • Memory Over-Allocation: 0 olarak belirtin (aşırı tahsis yok);
   • Total Disk Space: MB cinsinden kullanılabilir disk alanını belirtin (örn. 120GB'lık bir disk için rezerv hesabı ile 102400);
   • Disk Over-Allocation: 0 olarak belirtin (aşırı tahsis yok);
   • Daemon Port: 8080 (varsayılan olarak bırakın);
   • Daemon SFTP Port: 2022 (varsayılan olarak bırakın).

   

5. Create Node düğmesine tıklayın.

    Name: hostkey-us-node1
    Location: US1
    Public: ☑
    FQDN: pterodactyl50514.hostkey.in
    Communicate Over SSL: ☑
    Behind Proxy: ☐


    Total Memory: 4608 MB (sistem için 1.5GB bırakarak)
    Memory Over-Allocation: 0
    Total Disk Space: 102400 MB (sistem için 20GB bırakarak)
    Disk Over-Allocation: 0

Tahsisatları (Allocations) Yapılandırma¶

Bir düğüm oluşturduktan sonra tahsisatları yapılandırmanız gerekir; bunlar oyun sunucularına atanmak üzere kullanılacak IP adresi ve port kombinasyonlarıdır.

1. Düğümü oluşturduktan sonra sayfası otomatik olarak açılacaktır. Allocation sekmesine gidin;

2. Assign New Allocations bölümünde (sağ taraf), alanları doldurun:

   • IP Address: sunucu IP adresini girin;
   • IP Alias: bir açıklama belirtin (örn. Main IP) veya boş bırakın;
   • Ports: bir port aralığı belirtin (örn. Minecraft sunucuları için 25565-25570).

3. Yeşil Submit düğmesine tıklayın:

   

4. Oluşturulan tahsisatlar Existing Allocations tablosunda (sol taraf) görünecektir. Her satır, bir oyun sunucusuna atanabilecek ayrı bir IP:port kombinasyonunu temsil eder.

   

Wings Kurulumu¶

Sunucuya SSH üzerinden bağlanın ve komutları çalıştırın:

Yapılandırma için bir dizin oluşturun:

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

wings version

Wings sürümü görüntülenmelidir (örn. wings vv1.12.1).

Auto-Deploy ile Wings Yapılandırması (Önerilen)¶

1. Admin panelinde, oluşturulan düğümün Configuration sekmesine gidin;

2. Auto-Deploy bölümünde (sağ taraf), Generate Token düğmesine tıklayın:

   

3. Oluşturulan komutu kopyalayın. Şuna benzer görünecektir:

       cd /etc/pterodactyl && wings configure --panel-url https://your-domain.com --token TOKEN --node 1
   

   

4. Kopyalanan komutu sunucuda çalıştırın:

       cd /etc/pterodactyl && wings configure --panel-url https://pterodactyl50514.hostkey.in --token TOKEN --node 1
   

Successfully configured wings. mesajı görünmelidir.

1. Oluşturulan yapılandırmayı doğrulayın:

       cat /etc/pterodactyl/config.yml
   

Bir systemd Servisi Oluşturma¶

Otomatik Wings başlatılması için bir systemd servisi oluşturun:

cat > /etc/systemd/system/wings.service <<'EOF'
[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service

[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
EOF

Wings'i Başlatma¶

systemd yapılandırmasını yenileyin:

systemctl daemon-reload

systemctl enable --now wings

systemctl status wings

Durum Active: active (running) olarak görünmelidir.

Operasyon Kontrolü¶

Wings günlüklerini (logs) kontrol edin:

journalctl -u wings -n 50

Günlükler şu mesajları içermelidir:

• fetching list of servers from API - Wings Panel'e bağlandı;
• configuring internal webserver - Wings web sunucusu başlatıldı;
• sftp server listening for connections - SFTP sunucusu çalışıyor.

Sunucu dizini oluşturulmasını doğrulayın:

ls -la /var/lib/pterodactyl/volumes/

Admin Panelinde Durum Kontrolü¶

1. Admin panelini açın: https://your-domain.com/admin;
2. Şuraya gidin: Admin > Nodes > düğümünüz;
3. Sayfayı yenileyin (F5);
4. Sağ üst köşede yeşil Online durum göstergesi görünmelidir;
5. About sekmesinde kaynak bilgileri görüntülenmelidir (CPU, RAM, Disk).

Sorun Giderme¶

Düğüm Offline Görünüyor¶

Wings durumunu kontrol edin:

systemctl status wings

Eğer Wings çalışmıyorsa, başlatın:

systemctl start wings

Hatalar için günlükleri (logs) kontrol edin:

journalctl -u wings -n 100

Yaygın sorunlar:

1. Wings Panel'e bağlanamıyor:

   • Yapılandırmadaki panel URL'sini kontrol edin: cat /etc/pterodactyl/config.yml | grep remote;
   • Panel'in erişilebilir olduğundan emin olun: curl -I https://your-domain.com.

2. 8080 portu güvenlik duvarı tarafından engelleniyor:

   • Portu kontrol edin: netstat -tulpn | grep 8080;
   • Portu açın: ufw allow 8080/tcp.

3. SSL sorunları:

   • Panel HTTPS kullanıyorsa, Wings de SSL ile çalışmalıdır;
   • /etc/pterodactyl/config.yml içindeki SSL ayarlarını kontrol edin.

Manuel Yapılandırma (Alternatif Yöntem)¶

Auto-Deploy çalışmazsa, Wings'i manuel olarak yapılandırabilirsiniz:

1. Admin panelinde düğümün Configuration sekmesine gidin;
2. Sol taraftaki metin alanından yapılandırma dosyası içeriğini kopyalayın;

3. Sunucuda bir yapılandırma dosyası oluşturun:

   nano /etc/pterodactyl/config.yml
   

4. Kopyalanan yapılandırmayı yapıştırın ve kaydedin (Ctrl+X, sonra Y, sonra Enter);

5. Wings'i yeniden başlatın: systemctl restart wings;
6. Durumu kontrol edin: systemctl status wings.

Nest Oluşturma ve Egg Ekleme¶

Nest Oluşturma¶

1. Sol menüden Nests bölümünü seçin;

2. Sağ üst köşedeki Create New düğmesine tıklayın:

3. Alanları doldurun:

   • Name: nest adı (örn. "Minecraft");
   • Description: nest açıklaması;

4. Save düğmesine tıklayın:

   

Hazır Bir Egg İndirin¶

1. https://pelican-eggs.github.io/ web sitesini açın;

2. İstediğiniz oyunu bulun:

   • Game Eggs bölümünde bir kategori seçin (örn. Minecraft);
   • İstediğiniz sunucu türünü bulun (örn. Paper, Vanilla, Forge);

3. GitHub sayfasını açmak için sunucu adına tıklayın;

4. egg-name.json dosyasını bulun (örn. egg-paper.json);

5. Dosyaya tıklayın ve ardından sağ üst köşedeki Raw düğmesine tıklayın;

6. Dosyayı kaydedin (Ctrl+S veya sağ tık > Save as).

Egg'i Panele İçe Aktarın (Import)¶

1. Admin panelinde Nests bölümüne gidin;

2. Sağ üst köşedeki Import Egg düğmesine tıklayın:

   

3. Choose File düğmesine tıklayın ve indirilen .json dosyasını seçin;

4. Import düğmesine tıklayın:

   

Egg; tüm ayarları, Docker imajları ve değişkenleri ile birlikte içe aktarılacaktır.

İçe Aktarılan Egg'i Doğrulama¶

1. Egg listesinde içe aktarılanı bulun (örn. Paper);

2. Ayarları görüntülemek için üzerine tıklayın;

3. Aşağıdakilerin dolu olduğundan emin olun:

   • Docker Images: kullanılabilir imajların listesi;
   • Install Script: sunucu kurulum betiği;
   • Variables: ortam değişkenleri (sürüm, ayarlar).

   

   

Sunucu Oluşturma¶

1. Sol menüden Servers öğesini seçin;

2. Sağ üst köşedeki Create New düğmesine tıklayın:

   

3. Oluşturma formunu doldurun:

Temel Detaylar (Core Details):

• Server Name: sunucu adı (örn. Test Minecraft Server);
• Server Owner: listeden sahip kullanıcıyı seçin;
• Server Description: açıklama (isteğe bağlı);
• Start Server when Installed: kutucuğun işaretli olduğundan emin olun.

Tahsisat Yönetimi (Allocation Management):

• Node: oluşturulan düğümü seçin;
• Default Allocation: listeden IP adresi:port seçimini yapın;
• Additional Allocations: boş bırakın.

Uygulama Özellik Limitleri (Application Feature Limits):

• Database Limit: 0;
• Allocation Limit: 0;
• Backup Limit: 0.

Kaynak Yönetimi (Resource Management):

• CPU Limit: 0 (limit yok);
• Memory: 2048 MiB (başlangıç için 2GB);
• Swap: 0 MiB;
• Disk Space: 5120 MiB (5GB);
• Block IO Weight: 500;
• Enable OOM Killer: devre dışı bırakın.

Nest Yapılandırması (Nest Configuration):

• Nest: Minecraft;
• Egg: Paper (Sponge değil!);
• Docker Image: Java 21;

• Service Variables: varsayılan değerleri bırakın.

• Sayfanın altındaki Create Server düğmesine tıklayın;

• Kurulumun tamamlanmasını bekleyin (durum Installing'den Offline'a dönecektir):

Sunucuyu Başlatma ve Yapılandırma¶

1. Kurulumdan sonra, listeden sunucuyu açın (Admin > Servers):

   

2. Kullanıcı panelini açın ( /admin olmadan), sunucu sahibi olarak giriş yapın;

3. Start düğmesine tıklayın:

   

4. İlk çalıştırmada bir lisans kabul penceresi görünecektir:

   

5. Minecraft EULA'yı kabul etmek için I Accept düğmesine tıklayın;

6. Sunucunun başlamasını bekleyin (durum Running olarak değişecektir):

   

Performans Kontrolü¶

Tarayıcınızda açın (IP adresini sizinkiyle değiştirin):

https://api.mcsrvstat.us/3/<IP adresi>:25565

Bağlantı adresi:

<IP adresi>:25565

API ile Pterodactyl Sunucusu Sipariş Edin¶

Bu yazılımı API kullanarak kurmak için bu talimatları izleyin.