Pterodactyl Kontrol Paneli¶

Bu makalede

• Pterodactyl. Temel Özellikler
• Çalıştırma Özellikleri
• Pterodactyl Dağıtımından Sonra Başlangıç
• Kullanıcı Oluşturma
• Konum Oluşturma
• Düğüm Oluşturma
• Tahsisleri Yapılandırma
• Wings Kurulumu
• Sorun Giderme
• Yuva Oluşturma ve Yumurta Ekleme
• Sunucu Oluşturma
• Sunucuyu Başlatma ve Yapılandırma
• Performans Kontrolü
• API ile Pterodactyl Sunucusu Siparişi

Pterodactyl. Temel Özellikler¶

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

• 50+ oyun desteği: 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 ekleme desteği sunar.
• Hassas kaynak yönetimi: RAM, CPU, disk alanını ve sunucular arası öncelik dağıtımını kontrol eder. Aşırı yüklenmeyi önler, kaynakları kota bazlı tahsis eder ve istikrar için SWAP bellek kullanır.
• Güvenilir otomatik yedeklemeler: Veri seçimi (tüm sunucu veya kritik dosyalar) ile esnek zamanlanmış yedekleme sağlar. Yedekleri yerel olarak veya bulutta (S3, FTP, GDrive) şifreleme ve anında geri yükleme ile saklar.
• Verimli çoklu sunucu yeteneği: Her sunucuyu izole edilmiş bir Docker kapsayıcısında çalıştırır. Yükü düğümler arasında otomatik olarak dağıtır, çakışma olmadan port atar ve ilgili sunucuların gruplandırılmasına izin verir.
• Esnek çoklu kullanıcı erişimi: 50'den fazla ayrıntı izinle rol tabanlı bir model (önceden tanımlanmış + özel roller) aracılığıyla izinleri yönetir. Geçici erişimi, işlem denetimini ve iki faktörlü kimlik doğrulamayı destekler.
• Gerçek zamanlı yönetim konsolu: Etkileşimli bir terminal (SSH'ye benzer) ile web arayüzü aracılığıyla tam kontrol sağlar. Renk biçimlendirmesi, 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 panolar oluşturmaya, uyarıları yapılandırmaya ve verileri CSV'ye dışa aktarmaya olanak tanır.
• Basitleştirilmiş mod/eklenti yönetimi: Otomatik mod kurulumu, sürüm ve bağımlılık yönetimi için yerleşik bir mağaza sunar. Söz dizimi vurgulama ve güncelleme bildirimleri içeren görsel bir yapılandırma düzenleyicisi içerir.
• Otomatik güncellemeler: Kesintisiz sistem çalışmasını sağlar. Oyun sunucularını test moduyla ve hatalarda geri almayla zamanlanmış olarak günceller. Kontrol panelini uyumluluğu kontrol ederek ve veri kaybı olmadan veritabanını göçleterek tek bir komutla (php artisan p:upgrade) günceller. Wings daemon'ını otomatik olarak günceller, farklı Linux dağıtımlarıyla uyumluluğu korur.

Çalıştırma Özellikleri¶

Temel Sistem Bileşenleri:¶

Yapılandırma Dosyaları¶

Otomatik Olarak Kurulanlar¶

Playbook otomatik olarak kurar ve yapılandırır:

• Pterodactyl Panel - web arayüzüne sahip merkezi yönetim paneli;
• MariaDB - tüm sistem verilerini saklamak için veritabanı;
• Redis - önbellekleme ve görev kuyrukları için;
• NGINX - Panel'i sunmak için web sunucusu;
• PHP 8.3 + PHP-FPM - Laravel uygulaması çalışması için;
• Certbot - otomatik SSL sertifikası edinme için;
• Systemd servisleri - pteroq (kuyruk işleme), cron görevleri (zamanlayıcı).

Ek Olarak Kurulması Gerekenler¶

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

• Wings - Docker kapsayıcılarında oyun sunucularını fiziksel olarak başlatan ve yöneten daemon

Wings, oyun sunucularının çalıştırılması planlanan her makineye (düğüm) kurulur. Bu, Panel'in kurulu olduğu aynı sunucu olabilir ("hepsi bir arada" yapılandırması) veya ayrı özel sunucular (dağıtık mimari).

Sistem Gereksinimleri¶

Panel İçin (Kontrol Paneli)¶

Minimum gereksinimler:

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

Yazılım (otomatik olarak kurulur):

• PHP 8.3 + PHP-FPM;
• MariaDB 10.6+;
• Redis 7.0+;
• NGINX;
• Composer 2;
• Certbot (SSL için);
• Docker (görüntüde önceden yüklü).

Ağ gereksinimleri:

• Açık portlar: 80 (HTTP), 443 (HTTPS);
• Statik IP adresi veya alan adı (SSL sertifikası için);
• İnternet bağlantısı.

Düğüm İçin (Oyun Sunuculu Düğümler)¶

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

• İşlemci: 4+ çekirdek (talepkar 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);
• İşletim Sistemi: Ubuntu 20.04/22.04, Debian 10/11, CentOS ⅞ (Docker desteği olan herhangi bir Linux).
• Yazılım:
  • Docker (görüntüde önceden yüklü);
  • Wings (kurulum gerektirir).

Ağ gereksinimleri:

• Açık portlar:
  • 8080 - Wings API (Panel ile iletişim);
  • 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 istikrarlı internet bağlantısı;
• Konforlu oyun için düşük gecikme süresi.

"Hepsi Bir Arada" Yapılandırması (Panel + Wings Tek Sunucuda)¶

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);
• İşletim Sistemi: Ubuntu 22.04 LTS.

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

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

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

Siparişinizi ödedikten sonra, kaydolduğunuz e-posta adresine sunucunuzun çalışmaya hazır olduğunu bildiren bir bildirim alacaksınız. Bu bildirimde VPS IP adresi ve bağlantı için bir kullanıcı adı ve şifre yer alacaktır. Şirketimizin müşterileri donanımı sunucu ve API kontrol panelinde — Invapi üzerinden yönetir.

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

• Bağlantı: webpanel etiketinde. Yönetici paneline erişmek için ana bağlantıya /admin ekleyin;
• Kullanıcı Adı: admin;
• Şifre: Yazılım dağıtımından sonra sunucu çalışmaya hazır olduğunda adresinize e-posta ile 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. Yönetici paneline erişmek için düğmesine tıklayın:

   

Kullanıcı Oluşturma¶

1. Yönetici panelinin sol menüsünde Users bölüm adına 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: ad;
   • Last Name: soyad;
   • Password: şifre (minimum 8 karakter, farklı büyük/küçük harf harfler ve rakamlar içermelidir);
4. Gerekirse, yönetici hakları vermek için Administrator satırında Yes seçin;

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

   

Konum Oluşturma¶

1. Sol menüden Locations'ı 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 Oluşturma¶

Düğüm Oluşturmaya Hazırlık¶

Bir düğüm oluşturmadan önce şunları sağlayın:

• Sunucuda Docker'ın kurulu olması (HOSTKEY görüntülerinde önceden yüklü);
• Düğüm için bir IP adresinize veya alan adına sahip olmanız;
• Güvenlik duvarında 8080 (Wings API) ve 2022 (SFTP) portlarının açık olması.

Panel'de Düğüm Oluşturma¶

1. Yönetici panelinin sol menüsünde Nodes'ı seçin;

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

   

3. temel ayarları doldurun:

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

4. kaynak ayarlarını yapılandırın:

   • Daemon Server File Directory: /var/lib/pterodactyl/volumes (değiştirmeyin);
   • Total Memory: MB cinsinden kullanılabilir RAM'i belirtin (örn. yedek hesaba katılarak 6GB'lık bir sunucu için 4608);
   • Memory Over-Allocation: 0 belirtin (aşırı tahsis yok);
   • Total Disk Space: MB cinsinden kullanılabilir disk alanını belirtin (örn. yedek hesaba katılarak 120GB'lık bir disk için 102400);
   • Disk Over-Allocation: 0 belirtin (aşırı tahsis yok);
   • Daemon Port: 8080 (varsayılanı bırakın);
   • Daemon SFTP Port: 2022 (varsayılanı 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ırakılıyor)
    Memory Over-Allocation: 0
    Total Disk Space: 102400 MB (sistem için 20GB bırakılıyor)
    Disk Over-Allocation: 0

Tahsisleri Yapılandırma¶

Bir düğüm oluşturduktan sonra, oyun sunucularına atanması için kullanılabilir olacak IP adresi ve port kombinasyonları olan tahsisleri yapılandırmanız gerekir.

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. Ana 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 tahsisler Existing Allocations tablosunda (sol taraf) görünecektir. Her satır, bir oyun sunucusuna atanabilen 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. Yönetici 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 bir görünümde olacaktır:

       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
   

   Şu mesaj görünmelidir: Successfully configured wings.

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

       cat /etc/pterodactyl/config.yml
   

Bir systemd Servisi Oluşturma¶

Otomatik Wings başlatması 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ı yeniden yükleyin

systemctl daemon-reload

systemctl enable --now wings

systemctl status wings

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

Çalışma Kontrolü¶

Wings günlüklerini 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şladı;
• sftp server listening for connections - SFTP sunucusu çalışıyor.

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

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

Yönetici Panelinde Durum Kontrolü¶

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

Sorun Giderme¶

Düğüm Çevrimdışı Durumunu Gösteriyor¶

Wings durumunu kontrol edin:

systemctl status wings

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

systemctl start wings

Hatalar için günlükleri kontrol edin:

journalctl -u wings -n 100

Yaygın sorunlar:

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

   • Yapılandırma 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 dosyasındaki SSL ayarlarını kontrol edin.

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

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

1. Yönetici panelinde, düğümün Configuration sekmesine gidin;
2. Sol 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, ardından Y, ardından Enter);

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

Yuva Oluşturma ve Yumurta Ekleme¶

Yuva 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: yuva adı (örn. "Minecraft");
   • Description: yuva açıklaması;

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

   

Hazır Bir Yumurta İndirme¶

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, ardından sağ üst köşedeki Raw düğmesine tıklayın;

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

Yumurtayı Panele İçe Aktarma¶

1. Yönetici 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:

   

Yumurta, tüm ayarlar, Docker görüntüleri ve değişkenlerle birlikte içe aktarılacaktır.

İçe Aktarılan Yumurtayı Doğrulama¶

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

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

3. Şunların doldurulduğundan emin olun:

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

   

   

Sunucu Oluşturma¶

1. Sol menüden Servers'ı seçin;

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

   

3. Oluşturma formunu doldurun:

Temel Ayrıntılar:

• Server Name: sunucu adı (örn. Test Minecraft Server);
• Server Owner: listeden sahibi kullanıcıyı seçin;
• Server Description: açıklama (isteğe bağlı);
• Start Server when Installed: kutunun işaretli bırakın.

Tahsis Yönetimi:

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

Uygulama Özellik Sınırları:

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

Kaynak Yönetimi:

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

Yuva Yapılandırması:

• 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 değişecektir):

Sunucuyu Başlatma ve Yapılandırma¶

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

   

2. Kullanıcı paneline gidin (/admin olmadan), sunucu sahibi olarak giriş yapın;

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

   

4. İlk başlatmada 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'yi kendinizinkilerle değiştirin):

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

Bağlantı adresi:

<IP adresi>:25565

API ile Pterodactyl Sunucusu Siparişi¶