Pterodactyl Kontrol Paneli¶

Bu makalede

• Pterodactyl. Ana Özellikler
• Çalıştırma Özellikleri
• Pterodactyl Dağıtımından Sonra Başlangıç
• Kullanıcı Oluşturma
• Konum Oluşturma
• Node Oluşturma
• Tahsis Yapılandırması (Allocations)
• Nest Oluşturma ve Egg Ekleme
• Sunucu Oluşturma
• Sunucuyu Başlatma ve Yapılandırma
• Performans Kontrolü
• API kullanarak Pterodactyl Sunucusu Siparişi

Pterodactyl. Ana Özellikler¶

Pterodactyl, aşağıdakileri birleştiren modern bir oyun sunucusu 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şlatma parametrelerini otomatik olarak yapılandırır, oyun sürümü seçimini ve özel şablon eklemeyi destekler.
• Hassas kaynak yönetimi: Sunucular arasında RAM, CPU, disk alanı ve öncelik dağıtımını kontrol eder. Aşırı yüklenmeleri önler, kaynaklarını kotalara göre ayırır ve kararlılık için SWAP belleği kullanır.
• Güvenilir otomatik yedeklemeler: Veri seçimi (tüm sunucu veya anahtar dosyalar) ile zamanlanmış esnek yedekleme sağlar. Yedeklemeleri yerel olarak veya bulutta (S3, FTP, GDrive) şifreleme ve anında kurtarma ile saklar.
• Etkili çoklu sunucu yeteneği: Her sunucuyu izole edilmiş bir Docker konteynerinde çalıştırır. Yükü node'lar arasında otomatik olarak dağıtır, çakışma olmadan portları atar ve ilgili sunucuların gruplandırılmasına izin verir.
• Esnek çok kullanıcılı erişim: 50'den fazla ayrıntılı izinle rol tabanlı model (önceden ayarlanmış + özel roller) aracılığıyla izinleri yönetir. Geçici erişimi, eylem denetimini ve iki faktörlü kimlik doğrulamayı destekler.
• Gerçek zamanlı yönetim konsolu: Etkileşimli terminal (SSH'ye benzer) ile web arayüzü aracılığıyla tam kontrol sağlar. Renk biçimlendirme, komut geçmişi, hızlı eylem 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österir. Özel kontrol panelleri oluşturmaya, uyarıları yapılandırmaya ve verileri CSV'ye 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 mağaza sunar. Sözdizimi vurgulama ve güncelleme bildirimleri ile görsel yapılandırma düzenleyicisi içerir.
• Otomatik güncellemeler: Kesintisiz sistem çalışmasını sağlar. Oyun sunucularını günceller, test modu ve hatalar durumunda geri alma ile zamanlamaya göre. Kontrol panelini günceller tek bir komutla (php artisan p:upgrade), uyumluluğu kontrol eder ve veritabanını veri kaybı olmadan taşır. Wings daemon'unu otomatik günceller, farklı Linux dağıtımlarıyla uyumluluğu korur.

Çalıştırma Özellikleri¶

Ana Sistem Bileşenleri:¶

Yapılandırma Dosyaları¶

Otomatik Olarak Kurulmuş Olanlar¶

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

• Pterodactyl Panel - web arayüzü ile merkezi yönetim paneli;
• MariaDB - tüm sistem verilerini saklamak için veritabanı;
• Redis - önbelleğe alma 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ı edinimi 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 konteynerlerinde oyun sunucularını fiziksel olarak başlatan ve yöneten daemon

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

Sistem Gereksinimleri¶

Panel (Kontrol Paneli) İçin¶

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 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 (imajda önceden yüklenmiş).

Ağ gereksinimleri:

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

Node (Oyun Sunucularına Sahip Node'lar) İçin¶

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

• İşlemci: 4+ çekirdek (zorlu 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 (imajda önceden yüklenmiş);
  • 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ı;
• Rahat oyun için düşük gecikme (low latency).

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

Test veya küçük projeler için 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, bir sunucu şunları çalıştırır:

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

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

Siparişinizi ödedikten sonra, kayıtlı e-posta adresinize sunucunuzun çalışmaya hazır olduğunu bildiren bir bildirim alacaksınız. Bu, VPS IP adresini ve bağlanmak için gerekli kullanıcı adı ve şifreyi içerecektir. Şirketimizin müşterileri sunucular ve API kontrol panelinde donanım yönetir — Invapi.

Kontrol panelinin sunucu Info >> Tags sekmesinde ya da e-postada bulunan yetkilendirme verileri:

• Link: 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 e-posta 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. 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ı durumda 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:

   

Node Oluşturma¶

Node Oluşturmadan Önce Hazırlık¶

Bir node oluşturmadan önce şunlardan emin olun:

• Docker sunucuya kurulmuş (HOSTKEY imajlarında önceden yüklenmiş);
• Node için bir IP adresi veya alan adınız var;
• 8080 (Wings API) ve 2022 (SFTP) portları güvenlik duvarında açık olacak.

Panel'de Node 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 node adı (örn. hostkey-us-node1);
   • Location: daha önce oluşturulan konumu seçin;
   • Public: node kullanıcılara görünür olmalıysa 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: node 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 mevcut RAM'i belirtin (örn. yedek dahil 6GB sunucu için 4608);
   • Memory Over-Allocation: 0 belirtin (aşırı tahsis yok);
   • Total Disk Space: MB cinsinden mevcut disk alanını belirtin (örn. yedek dahil 120GB disk için 102400);
   • Disk Over-Allocation: 0 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ırakılıyor)
    Memory Over-Allocation: 0
    Total Disk Space: 102400 MB (sistem için 20GB bırakılıyor)
    Disk Over-Allocation: 0

Tahsis Yapılandırması (Allocations)¶

Bir node oluşturduktan sonra, tahsisleri yapılandırmanız gerekir - bunlar oyun sunucularına atanmak üzere kullanılabilecek IP adresi ve port kombinasyonlarıdır.

1. Node'u oluşturduktan sonra sayfası otomatik olarak açılı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 tahsisler Existing Allocations tablosunda (sol taraf) görünecektir. Her satır, bir oyun sunucusuna atanabilecek ayrı bir IP:port kombinasyonunu temsil eder.

   

Wings Kurulumu¶

SSH ile sunucuya bağlanın ve komutları yürütü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 node'un 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. Şöyle görünecektir:

       cd /etc/pterodactyl && wings configure --panel-url https://alanınız.com --token TOKEN --node 1
   

   

4. Kopyalanan komutu sunucuda yürütün:

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

   Mesaj görünmelidir: Successfully configured wings.

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

       cat /etc/pterodactyl/config.yml
   

systemd Servisi Oluşturma¶

Otomatik Wings başlatma 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) göstermelidir.

Çalışma Kontrolü¶

Wings günlüklerini kontrol edin:

journalctl -u wings -n 50

Günlüklerde şu mesajlar olmalıdır:

• 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/

Yönetici Panelinde Durum Kontrolü¶

1. Yönetici panelini açın: https://alanınız.com/admin;
2. Gidin: Admin → Nodes → node'nuz;
3. Sayfayı yenileyin (F5);
4. Sağ üstte yeşil Online durum göstergesi görünmelidir;
5. About sekmesinde kaynak bilgileri görüntülenmelidir (CPU, RAM, Disk).

Sorun Giderme¶

Node Offline Durumunu Gösteriyor¶

Wings durumunu kontrol edin:

systemctl status wings

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

systemctl start wings

Hata günlüklerini kontrol edin:

journalctl -u wings -n 100

Yaygın sorunlar:

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

   • Yapılandırmada panel URL'sini kontrol edin: cat /etc/pterodactyl/config.yml | grep remote;
   • Panel'in erişilebilir olduğundan emin olun: curl -I https://alanınız.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ışmıyorsa, Wings'i manuel olarak yapılandırabilirsiniz:

1. Yönetici panelinde, node'un 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, 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. İstenen oyunu bulun:

   • Game Eggs bölümünde bir kategori seçin (örn. Minecraft);
   • İstenen 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-ad.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ıklama → Farklı Kaydet).

Egg'i Panel'e İçe Aktarın¶

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:

   

Egg, tüm ayarlar, Docker imajları ve değişkenlerle 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. Şunların doldurulduğundan emin olun:

   • Docker Images: mevcut 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 seçin;

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

   

3. Oluşturma formunu doldurun:

Core Details:

• 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: onay kutusunu işaretli bırakın.

Allocation Management:

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

Application Feature Limits:

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

Resource Management:

• CPU Limit: 0 (sınır 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 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 değişecek):

Sunucuyu Başlatma ve Yapılandırma¶

1. Kurulumdan sonra sunucuyu listeden 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 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'e değişecek):

   

Performans Kontrolü¶

Tarayıcınızda açın (IP'nizi kendinizinkiyle değiştirin):

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

Bağlantı adresi:

<IP adresi>:25565

API kullanarak Pterodactyl Sunucusu Siparişi¶

Bu yazılımı API kullanarak kurmak için bu talimatları takip edin

Bu sayfanın bazı içerikleri ya da yazıları AI tarafından oluşturulmuş veya çevrilmiş olabilir.