Minecraft sunucularını yönetmek için her işlemde SSH bağlantısı kurmak veya Linux terminalinde komut çalıştırmak zorunda değilsiniz. Pterodactyl Panel, web tarayıcısı üzerinden oyun sunucularını yönetmenizi sağlayan ücretsiz ve açık kaynaklı bir kontrol panelidir.
Pterodactyl ile Minecraft sunucusu başlatabilir, durdurabilir, yeniden başlatabilir, konsol komutları çalıştırabilir, dosyaları düzenleyebilir ve sunucu kaynaklarını sınırlandırabilirsiniz.
Bu rehberde Ubuntu VPS üzerinde Pterodactyl Panel ve Wings kurulumunu, Docker yapılandırmasını, SSL sertifikasını ve Minecraft sunucusu oluşturma işlemlerini anlatacağız.
Pterodactyl Panel Nedir?
Pterodactyl, farklı oyun ve uygulama sunucularını tek bir web arayüzünden yönetmenizi sağlayan açık kaynaklı bir sunucu yönetim sistemidir.
Özellikle Minecraft hosting hizmeti verenler, birden fazla oyun sunucusu yönetenler ve kendi VPS altyapısını kurmak isteyenler tarafından kullanılır.
Pterodactyl'in temel özellikleri:
Pterodactyl yalnızca Minecraft için tasarlanmamıştır. Desteklenen Egg yapılandırmaları sayesinde farklı oyun sunucularını ve uygulamaları da yönetebilir.
Pterodactyl Panel Nasıl Çalışır? Panel ve Wings Nedir?
Pterodactyl iki temel bileşenden oluşur: Panel ve Wings.
Panel: Web üzerinden eriştiğiniz yönetim arayüzüdür. Kullanıcıları, sunucuları, düğümleri ve yönetim ayarlarını kontrol eder.
Wings: Linux sunucusunda çalışan ve Docker konteynerleri üzerinden oyun sunucularını yöneten servistir.
Sistem mimarisi şu şekildedir:
Panel yönetim işlemlerini gerçekleştirirken Wings, oyun sunucularını çalıştırır. Oyuncular ise doğrudan Minecraft sunucusunun IP adresine ve oyun portuna bağlanır.
Önemli: Panel kapansa bile Wings çalışmaya devam ettiği sürece mevcut oyun sunucuları çalışmayı sürdürebilir.
Pterodactyl Panel Sistem Gereksinimleri
Pterodactyl kurulumundan önce VPS veya dedicated sunucunuzun gerekli altyapıyı desteklediğinden emin olun.
Önerilen kurulum ortamı:
Panelin kendisi için çok yüksek donanım gereksinimi bulunmaz. Ancak aynı makinede Minecraft sunucuları da çalıştırılacaksa işlemci, RAM ve SSD kapasitesi oyun sunucularının ihtiyacına göre belirlenmelidir.
Sürüm uyarısı: Kasım 2026 itibarıyla resmî dokümantasyonda Pterodactyl 1.x kararlı sürüm, 2.0 ise açık beta olarak listelenmektedir. Bu rehberde üretim ortamı için 1.x kurulum yaklaşımı esas alınmıştır. 2.0'ın PHP 8.3/8.4 ve diğer gereksinimleri farklıdır. İki sürümün kurulum komutlarını birbirine karıştırmayın.
1. Ubuntu VPS Hazırlığı
Öncelikle SSH üzerinden Ubuntu sunucunuza bağlanın.
Sistem paketlerini güncelleyin:
Gerekli temel araçları yükleyin:
Sunucunun sanallaştırma türünü kontrol edin:
Wings, Docker çalıştırabilen bir Linux ortamına ihtiyaç duyar. KVM tabanlı VPS tercih etmek kurulum açısından avantajlıdır. LXC ve OpenVZ ortamlarında Docker desteğini sağlayıcınızla doğrulamanız gerekir.
2. Pterodactyl Panel Bağımlılıklarını Kurma
Pterodactyl Panel'in çalışması için PHP, MariaDB, Redis, NGINX ve Composer gibi bileşenler gerekir.
Ubuntu 24.04 üzerinde Pterodactyl 1.x için örnek PHP 8.3 ve bağımlılık kurulumu:
PHP sürümünü kontrol edin:
Redis servisini başlatın:
MariaDB servisini başlatın:
Composer 2 kurulumunu gerçekleştirin:
Kurulumu doğrulayın:
Not: PHP paketleri ve depo gereksinimleri işletim sistemi sürümüne göre değişebilir. Farklı Ubuntu veya Debian sürümlerinde resmî Pterodactyl bağımlılık listesini kontrol edin.
3. MariaDB Veritabanı Oluşturma
Pterodactyl, kullanıcı bilgileri ve sunucu yapılandırmaları gibi verileri saklamak için veritabanına ihtiyaç duyar.
MariaDB konsolunu açın:
Panel için veritabanı ve kullanıcı oluşturun:
`GUCLU_VE_BENZERSIZ_SIFRE` bölümünü kendinize ait güçlü bir şifreyle değiştirin.
4. Pterodactyl Panel Dosyalarını İndirme
Panel dosyalarını `/var/www/pterodactyl` dizinine indireceğiz.
Dosyalar açıldıktan sonra Composer bağımlılıklarını yükleyin:
Yeni kurulum için uygulama anahtarını oluşturun:
Önemli güvenlik uyarısı: `APP_KEY` değerini güvenli bir yerde saklayın. Bu anahtar, şifrelenmiş verilerin okunabilmesi için gereklidir. Mevcut bir kurulumda rastgele yeniden oluşturulması şifrelenmiş verilerin erişilemez olmasına neden olabilir.
5. Panel Ortam ve Veritabanı Ayarları
Panelin temel yapılandırmasını başlatın:
Veritabanı bağlantısını yapılandırın:
E-posta gönderimi için SMTP ayarlarını yapılandırın:
Ardından veritabanı tablolarını oluşturun:
Yönetici hesabını oluşturun:
Bu işlem sırasında yönetici e-posta adresi, kullanıcı adı ve şifre bilgileri istenir.
Panel dosyalarının web sunucusu tarafından kullanılabilmesi için izinleri düzenleyin:
6. Queue Worker ve Zamanlanmış Görevleri Ayarlama
Pterodactyl'in arka planda çalıştırdığı e-posta, zamanlanmış görev ve diğer işlemler için Queue Worker ve Cron yapılandırması gerekir.
Cron görevini açın:
Aşağıdaki satırı ekleyin:
Queue Worker için servis dosyası oluşturun:
Aşağıdaki yapılandırmayı ekleyin:
Servisleri etkinleştirin:
Durum kontrolü:
7. NGINX Web Sunucusu ve Alan Adı Ayarları
Pterodactyl Panel'e tarayıcı üzerinden erişmek için bir alan adı ve NGINX yapılandırması gerekir.
Örnek alan adımız:
DNS yönetim panelinizden aşağıdaki kaydı oluşturun:
Ardından NGINX yapılandırma dosyasını oluşturun:
NGINX yapılandırması için resmî Pterodactyl örneğini kullanın:
Yapılandırmayı etkinleştirin:
NGINX yapılandırmasında Panel'in `public` dizini web kök dizini olmalıdır. Uygulamanın ana dizinini doğrudan internete açmayın.
8. SSL Sertifikası ve HTTPS Kurulumu
Panel yönetiminde HTTPS kullanılması önemlidir. Let's Encrypt ile ücretsiz SSL sertifikası alabilirsiniz.
Certbot kurulumu:
Sertifika oluşturma:
Sertifika yenileme kontrolü:
Kurulum tamamlandığında Panel'e şu adres üzerinden erişebilirsiniz:
9. Docker Kurulumu
Wings, Minecraft sunucularını Docker konteynerleri içerisinde çalıştırır. Bu nedenle oyun sunucularını yönetecek makinede Docker kurulmalıdır.
Docker'ın resmî kurulum dokümantasyonunu takip ederek Docker Engine'i yükleyin:
Kurulum tamamlandıktan sonra servisi etkinleştirin:
Docker durumunu kontrol edin:
Docker sürümünü görüntüleyin:
10. Wings Kurulumu
Wings, Panel ile Docker arasında bağlantı kuran ve oyun sunucularının çalışmasını yöneten servistir.
Öncelikle gerekli dizini oluşturun:
Resmî Wings indirme adresinden uygun Linux mimarisini kullanarak dosyayı indirin:
Bu örnek AMD64 işlemciler içindir. ARM64 sistemlerde uygun ARM64 dosyasını indirmelisiniz.
Wings'in çalışmasını doğrulamak için:
11. Panel Üzerinden Node Oluşturma
Wings kurulduktan sonra Panel içerisinde bir Node tanımlamalısınız.
Yönetici hesabınızla Panel'e giriş yapın.
Örnek yapılandırma:
Node için de DNS A kaydı oluşturun:
Panel ve Wings farklı sunucularda çalışıyorsa iki sunucunun da gerekli ağ erişimine sahip olması gerekir.
12. Wings Yapılandırması ve Servis Başlatma
Node oluşturduktan sonra Panel'deki Configuration sekmesine girin.
Buradaki yapılandırmayı Wings sunucusunda şu dosyaya kaydedin:
Panelin ürettiği yapılandırmayı dosyaya ekleyin. Token bilgilerini kimseyle paylaşmayın.
Wings'i test modunda başlatın:
Hata yoksa `CTRL + C` ile durdurun.
Ardından systemd servis dosyasını oluşturun:
İçeriği:
Servisi etkinleştirin:
Durum kontrolü:
Panel üzerinden Node durumunu kontrol edin. Wings bağlantısı başarılıysa Node kullanılabilir duruma gelir.
13. Pterodactyl Firewall ve Port Ayarları
Pterodactyl kurulumunda en sık yapılan hatalardan biri gerekli portların açılmamasıdır.
Örnek port listesi:
Minecraft sunucularında farklı portlar kullanılıyorsa bunların da ayrıca tanımlanması gerekir. Bedrock sunucuları için UDP portları kullanılabilir.
UFW ile örnek güvenlik duvarı kuralları:
Önemli güvenlik notları:
14. Pterodactyl Üzerinden Minecraft Sunucusu Oluşturma
Kurulum tamamlandıktan sonra Minecraft sunucusu oluşturabilirsiniz.
Minecraft için kullanılabilecek örnek Egg türleri:
Sunucu oluşturulurken RAM, CPU ve disk sınırlarını gerçek donanım kapasitenize göre belirleyin.
15. Pterodactyl Web Panel Özellikleri
Pterodactyl'in en büyük avantajı, oyun sunucusu yönetim işlemlerini tek bir arayüzde toplamasıdır.
Canlı konsol yönetimi
Sunucunun konsolunu tarayıcı üzerinden açabilir, Minecraft komutları çalıştırabilir ve hata kayıtlarını takip edebilirsiniz.
Örnek komutlar:
Dosya yöneticisi
Sunucunun dosyalarını web üzerinden düzenleyebilirsiniz.
Kaynak kullanımı
Pterodactyl, sunucular için belirlediğiniz CPU ve RAM limitlerini Docker üzerinden uygular. Böylece aynı makinede birden fazla oyun sunucusu çalıştırırken kaynakları daha kontrollü dağıtabilirsiniz.
Yedekleme
Panel üzerinden sunucu yedekleri oluşturabilir, mevcut yedekleri yönetebilir ve uygun yapılandırmayla uzak depolama kullanabilirsiniz.
Zamanlanmış görevler
Desteklenen görevlerle sunucuyu belirli zamanlarda yeniden başlatabilir, komut çalıştırabilir ve otomatik yedekleme süreçleri oluşturabilirsiniz.
16. Pterodactyl Güvenliği Nasıl Sağlanır?
Pterodactyl paneli internete açık bir yönetim arayüzü olduğu için güvenlik ayarları önemlidir.
Pterodactyl'in güvenliği yalnızca panel parolasına bağlı değildir. Docker, Linux, SSH, Wings ve ağ yapılandırmasının tamamı güvenli olmalıdır.
Pterodactyl Kurulumunda Sık Karşılaşılan Hatalar
Wings bağlantı kuramıyor
Docker çalışmıyor
Panel 500 Internal Server Error hatası veriyor
Minecraft sunucusu başlatılamıyor
Panel açılıyor ancak konsol çalışmıyor
Pterodactyl 1.x ve 2.0 Arasındaki Farklar
Pterodactyl'in yeni 2.0 sürümü yeni yönetim alanı, uzantı sistemi ve altyapı değişiklikleri getiriyor. Ancak resmî dokümantasyonda 2.0 açık beta olarak listelendiği için kararlı üretim ortamında sürüm seçimine dikkat edilmelidir.
Yeni kurulumlarda mutlaka resmî dokümantasyondaki güncel sürüm gereksinimlerini kontrol edin. 1.x için hazırlanan kurulum adımlarını 2.0'a doğrudan uygulamayın.
Sık Sorulan Sorular
Pterodactyl Panel ücretsiz mi?
Evet. Pterodactyl açık kaynaklı bir projedir. Kendi sunucunuza kurarak ücretsiz kullanabilirsiniz. VPS, donanım, alan adı ve yedekleme gibi altyapı maliyetleri size aittir.
Pterodactyl Windows'a kurulur mu?
Wings, Windows üzerinde çalışmaz. Resmî kurulum Linux tabanlı işletim sistemleri içindir. Panel ve Wings için desteklenen Linux dağıtımlarını kullanmalısınız.
Pterodactyl için Docker gerekli mi?
Evet. Wings, oyun sunucularını Docker konteynerlerinde çalıştırır. Bu nedenle oyun sunucularını yöneten Node üzerinde Docker gereklidir.
Tek VPS üzerinde Panel ve Minecraft sunucusu çalıştırabilir miyim?
Evet. Panel ve Wings aynı makinede bulunabilir. Ancak çok sayıda oyun sunucusu çalıştırılacaksa kaynakların ayrılması ve ayrı Node kullanılması daha sağlıklı olabilir.
Pterodactyl ile kaç Minecraft sunucusu açabilirim?
Sabit bir sayı yoktur. İşlemci, RAM, disk, oyuncu sayısı ve sunucu türü belirleyicidir. Her sunucu için kaynak limitlerini ayrı ayrı belirleyebilirsiniz.
Pterodactyl ile Paper ve Spigot kurulabilir mi?
Evet. Uygun Minecraft Egg yapılandırmasıyla Paper, Spigot, Vanilla, Fabric ve Forge gibi sunucu yazılımlarını çalıştırabilirsiniz.
Pterodactyl Panel kapandığında Minecraft sunucusu kapanır mı?
Hayır. Wings çalışmaya devam ettiği sürece oyun sunucuları çalışabilir. Panel, yönetim arayüzüdür; oyun süreçlerini doğrudan çalıştıran bileşen Wings'tir.
Pterodactyl ile birden fazla VPS yönetilebilir mi?
Evet. Her VPS üzerinde Wings çalıştırarak Panel'e birden fazla Node ekleyebilirsiniz. Böylece farklı makinelerdeki oyun sunucularını tek arayüzden yönetebilirsiniz.
Sonuç: Minecraft Sunucunuzu Pterodactyl ile Yönetin
Pterodactyl Panel, Minecraft sunucularını web üzerinden yönetmek isteyenler için güçlü ve esnek bir çözümdür. Konsol erişimi, dosya yönetimi, kaynak sınırlandırması, yedekleme ve kullanıcı yetkilendirme özellikleri sayesinde birden fazla sunucuyu tek merkezden kontrol edebilirsiniz.
Özellikle Minecraft hosting hizmeti sunanlar, Survival ve SMP sunucularını yönetenler ve kendi oyun sunucusu altyapısını kurmak isteyenler için değerlendirilebilecek bir sistemdir.
Kurulum sırasında Panel, Wings ve Docker bileşenlerinin doğru yapılandırılması; SSL, firewall ve yedekleme ayarlarının ihmal edilmemesi gerekir.
Pterodactyl ile Minecraft sunucusu başlatabilir, durdurabilir, yeniden başlatabilir, konsol komutları çalıştırabilir, dosyaları düzenleyebilir ve sunucu kaynaklarını sınırlandırabilirsiniz.
Bu rehberde Ubuntu VPS üzerinde Pterodactyl Panel ve Wings kurulumunu, Docker yapılandırmasını, SSL sertifikasını ve Minecraft sunucusu oluşturma işlemlerini anlatacağız.
Pterodactyl Panel Nedir?
Pterodactyl, farklı oyun ve uygulama sunucularını tek bir web arayüzünden yönetmenizi sağlayan açık kaynaklı bir sunucu yönetim sistemidir.
Özellikle Minecraft hosting hizmeti verenler, birden fazla oyun sunucusu yönetenler ve kendi VPS altyapısını kurmak isteyenler tarafından kullanılır.
Pterodactyl'in temel özellikleri:
- Web üzerinden Minecraft sunucusu yönetimi
- Başlatma, durdurma ve yeniden başlatma işlemleri
- Canlı sunucu konsolu ve komut yönetimi
- Dosya yöneticisi ve SFTP erişimi
- RAM, CPU ve disk kullanım sınırları
- Birden fazla Minecraft sunucusu oluşturma
- Kullanıcı ve yetki yönetimi
- Otomatik yedekleme ve zamanlanmış görevler
- Paper, Vanilla, Fabric ve diğer sunucu türleri için Egg desteği
Pterodactyl yalnızca Minecraft için tasarlanmamıştır. Desteklenen Egg yapılandırmaları sayesinde farklı oyun sunucularını ve uygulamaları da yönetebilir.
Pterodactyl Panel Nasıl Çalışır? Panel ve Wings Nedir?
Pterodactyl iki temel bileşenden oluşur: Panel ve Wings.
Panel: Web üzerinden eriştiğiniz yönetim arayüzüdür. Kullanıcıları, sunucuları, düğümleri ve yönetim ayarlarını kontrol eder.
Wings: Linux sunucusunda çalışan ve Docker konteynerleri üzerinden oyun sunucularını yöneten servistir.
Sistem mimarisi şu şekildedir:
Kod:
Yönetici / Kullanıcı
|
v
Pterodactyl Panel
(Web Arayüzü)
|
v
Wings
(Sunucu Yönetimi)
|
v
Docker
/ |
/ |
Paper Vanilla Fabric
Server Server Server
Panel yönetim işlemlerini gerçekleştirirken Wings, oyun sunucularını çalıştırır. Oyuncular ise doğrudan Minecraft sunucusunun IP adresine ve oyun portuna bağlanır.
Önemli: Panel kapansa bile Wings çalışmaya devam ettiği sürece mevcut oyun sunucuları çalışmayı sürdürebilir.
Pterodactyl Panel Sistem Gereksinimleri
Pterodactyl kurulumundan önce VPS veya dedicated sunucunuzun gerekli altyapıyı desteklediğinden emin olun.
Önerilen kurulum ortamı:
| Bileşen | Öneri |
| İşletim sistemi | Ubuntu 24.04 LTS |
| Panel PHP | Pterodactyl 1.x için PHP 8.2 veya 8.3 |
| Veritabanı | MariaDB veya MySQL |
| Önbellek | Redis |
| Web sunucusu | NGINX |
| Konteyner sistemi | Docker |
| Sunucu yönetimi | Wings |
| Sanalizasyon | Tercihen KVM |
Panelin kendisi için çok yüksek donanım gereksinimi bulunmaz. Ancak aynı makinede Minecraft sunucuları da çalıştırılacaksa işlemci, RAM ve SSD kapasitesi oyun sunucularının ihtiyacına göre belirlenmelidir.
Sürüm uyarısı: Kasım 2026 itibarıyla resmî dokümantasyonda Pterodactyl 1.x kararlı sürüm, 2.0 ise açık beta olarak listelenmektedir. Bu rehberde üretim ortamı için 1.x kurulum yaklaşımı esas alınmıştır. 2.0'ın PHP 8.3/8.4 ve diğer gereksinimleri farklıdır. İki sürümün kurulum komutlarını birbirine karıştırmayın.
1. Ubuntu VPS Hazırlığı
Öncelikle SSH üzerinden Ubuntu sunucunuza bağlanın.
Kod:
ssh root@SUNUCU_IP
Sistem paketlerini güncelleyin:
Kod:
apt update && apt upgrade -y
Gerekli temel araçları yükleyin:
Kod:
apt install -y curl wget sudo tar unzip git ca-certificates gnupg
Sunucunun sanallaştırma türünü kontrol edin:
Kod:
systemd-detect-virt
Wings, Docker çalıştırabilen bir Linux ortamına ihtiyaç duyar. KVM tabanlı VPS tercih etmek kurulum açısından avantajlıdır. LXC ve OpenVZ ortamlarında Docker desteğini sağlayıcınızla doğrulamanız gerekir.
2. Pterodactyl Panel Bağımlılıklarını Kurma
Pterodactyl Panel'in çalışması için PHP, MariaDB, Redis, NGINX ve Composer gibi bileşenler gerekir.
Ubuntu 24.04 üzerinde Pterodactyl 1.x için örnek PHP 8.3 ve bağımlılık kurulumu:
Kod:
apt install -y
php8.3 php8.3-cli php8.3-gd php8.3-mysql
php8.3-mbstring php8.3-bcmath php8.3-xml
php8.3-fpm php8.3-curl php8.3-zip
mariadb-server nginx redis-server
tar unzip git curl
PHP sürümünü kontrol edin:
Kod:
php -v
Redis servisini başlatın:
Kod:
systemctl enable --now redis-server
MariaDB servisini başlatın:
Kod:
systemctl enable --now mariadb
Composer 2 kurulumunu gerçekleştirin:
Kod:
curl -sS https://getcomposer.org/installer |
php -- --install-dir=/usr/local/bin --filename=composer
Kurulumu doğrulayın:
Kod:
composer --version
Not: PHP paketleri ve depo gereksinimleri işletim sistemi sürümüne göre değişebilir. Farklı Ubuntu veya Debian sürümlerinde resmî Pterodactyl bağımlılık listesini kontrol edin.
3. MariaDB Veritabanı Oluşturma
Pterodactyl, kullanıcı bilgileri ve sunucu yapılandırmaları gibi verileri saklamak için veritabanına ihtiyaç duyar.
MariaDB konsolunu açın:
Kod:
mariadb -u root
Panel için veritabanı ve kullanıcı oluşturun:
Kod:
CREATE DATABASE panel;
CREATE USER 'pterodactyl'@'127.0.0.1'
IDENTIFIED BY 'GUCLU_VE_BENZERSIZ_SIFRE';
GRANT ALL PRIVILEGES ON panel.*
TO 'pterodactyl'@'127.0.0.1'
WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;
`GUCLU_VE_BENZERSIZ_SIFRE` bölümünü kendinize ait güçlü bir şifreyle değiştirin.
4. Pterodactyl Panel Dosyalarını İndirme
Panel dosyalarını `/var/www/pterodactyl` dizinine indireceğiz.
Kod:
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
curl -Lo panel.tar.gz
https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
tar -xzvf panel.tar.gz
chmod -R 755 storage/* bootstrap/cache/
Dosyalar açıldıktan sonra Composer bağımlılıklarını yükleyin:
Kod:
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1
composer install --no-dev --optimize-autoloader
Yeni kurulum için uygulama anahtarını oluşturun:
Kod:
php artisan key:generate --force
Önemli güvenlik uyarısı: `APP_KEY` değerini güvenli bir yerde saklayın. Bu anahtar, şifrelenmiş verilerin okunabilmesi için gereklidir. Mevcut bir kurulumda rastgele yeniden oluşturulması şifrelenmiş verilerin erişilemez olmasına neden olabilir.
5. Panel Ortam ve Veritabanı Ayarları
Panelin temel yapılandırmasını başlatın:
Kod:
php artisan p:environment:setup
Veritabanı bağlantısını yapılandırın:
Kod:
php artisan p:environment:database
E-posta gönderimi için SMTP ayarlarını yapılandırın:
Kod:
php artisan p:environment:mail
Ardından veritabanı tablolarını oluşturun:
Kod:
php artisan migrate --seed --force
Yönetici hesabını oluşturun:
Kod:
php artisan p:user:make
Bu işlem sırasında yönetici e-posta adresi, kullanıcı adı ve şifre bilgileri istenir.
Panel dosyalarının web sunucusu tarafından kullanılabilmesi için izinleri düzenleyin:
Kod:
chown -R www-data:www-data /var/www/pterodactyl/*
6. Queue Worker ve Zamanlanmış Görevleri Ayarlama
Pterodactyl'in arka planda çalıştırdığı e-posta, zamanlanmış görev ve diğer işlemler için Queue Worker ve Cron yapılandırması gerekir.
Cron görevini açın:
Kod:
crontab -e
Aşağıdaki satırı ekleyin:
Kod:
* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
Queue Worker için servis dosyası oluşturun:
Kod:
nano /etc/systemd/system/pteroq.service
Aşağıdaki yapılandırmayı ekleyin:
Kod:
[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service
[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s
[Install]
WantedBy=multi-user.target
Servisleri etkinleştirin:
Kod:
systemctl daemon-reload
systemctl enable --now redis-server
systemctl enable --now pteroq.service
Durum kontrolü:
Kod:
systemctl status pteroq
7. NGINX Web Sunucusu ve Alan Adı Ayarları
Pterodactyl Panel'e tarayıcı üzerinden erişmek için bir alan adı ve NGINX yapılandırması gerekir.
Örnek alan adımız:
Kod:
panel.ornekdomain.com
DNS yönetim panelinizden aşağıdaki kaydı oluşturun:
| Tür | Ad | Değer |
| A | panel | VPS IPv4 adresi |
Ardından NGINX yapılandırma dosyasını oluşturun:
Kod:
nano /etc/nginx/sites-available/pterodactyl.conf
NGINX yapılandırması için resmî Pterodactyl örneğini kullanın:
Linkleri görebilmek için Turkmmo Forumuna ÜYE olmanız gerekmektedir.
Yapılandırmayı etkinleştirin:
Kod:
ln -s /etc/nginx/sites-available/pterodactyl.conf
/etc/nginx/sites-enabled/pterodactyl.conf
nginx -t
systemctl reload nginx
NGINX yapılandırmasında Panel'in `public` dizini web kök dizini olmalıdır. Uygulamanın ana dizinini doğrudan internete açmayın.
8. SSL Sertifikası ve HTTPS Kurulumu
Panel yönetiminde HTTPS kullanılması önemlidir. Let's Encrypt ile ücretsiz SSL sertifikası alabilirsiniz.
Certbot kurulumu:
Kod:
apt install -y certbot python3-certbot-nginx
Sertifika oluşturma:
Kod:
certbot --nginx -d panel.ornekdomain.com
Sertifika yenileme kontrolü:
Kod:
certbot renew --dry-run
Kurulum tamamlandığında Panel'e şu adres üzerinden erişebilirsiniz:
Kod:
https://panel.ornekdomain.com
9. Docker Kurulumu
Wings, Minecraft sunucularını Docker konteynerleri içerisinde çalıştırır. Bu nedenle oyun sunucularını yönetecek makinede Docker kurulmalıdır.
Docker'ın resmî kurulum dokümantasyonunu takip ederek Docker Engine'i yükleyin:
Linkleri görebilmek için Turkmmo Forumuna ÜYE olmanız gerekmektedir.
Kurulum tamamlandıktan sonra servisi etkinleştirin:
Kod:
systemctl enable --now docker
Docker durumunu kontrol edin:
Kod:
systemctl status docker
Docker sürümünü görüntüleyin:
Kod:
docker version
10. Wings Kurulumu
Wings, Panel ile Docker arasında bağlantı kuran ve oyun sunucularının çalışmasını yöneten servistir.
Öncelikle gerekli dizini oluşturun:
Kod:
mkdir -p /etc/pterodactyl
Resmî Wings indirme adresinden uygun Linux mimarisini kullanarak dosyayı indirin:
Kod:
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
Bu örnek AMD64 işlemciler içindir. ARM64 sistemlerde uygun ARM64 dosyasını indirmelisiniz.
Wings'in çalışmasını doğrulamak için:
Kod:
wings --version
11. Panel Üzerinden Node Oluşturma
Wings kurulduktan sonra Panel içerisinde bir Node tanımlamalısınız.
Yönetici hesabınızla Panel'e giriş yapın.
- Admin Panel bölümüne girin.
- Nodes menüsünü açın.
- Create New butonuna tıklayın.
- Node adı belirleyin.
- FQDN alanına Node alan adını yazın.
- Daemon Port değerini belirleyin.
- SFTP Port değerini belirleyin.
- Sunucunun kaynak ve depolama bilgilerini tanımlayın.
- Node oluşturma işlemini tamamlayın.
Örnek yapılandırma:
| Ayar | Örnek değer |
| Node Name | Minecraft-Node-01 |
| FQDN | node.ornekdomain.com |
| Daemon Port | 8080 |
| SFTP Port | 2022 |
| SSL | Enabled |
Node için de DNS A kaydı oluşturun:
Kod:
node.ornekdomain.com -> VPS IPv4
Panel ve Wings farklı sunucularda çalışıyorsa iki sunucunun da gerekli ağ erişimine sahip olması gerekir.
12. Wings Yapılandırması ve Servis Başlatma
Node oluşturduktan sonra Panel'deki Configuration sekmesine girin.
Buradaki yapılandırmayı Wings sunucusunda şu dosyaya kaydedin:
Kod:
nano /etc/pterodactyl/config.yml
Panelin ürettiği yapılandırmayı dosyaya ekleyin. Token bilgilerini kimseyle paylaşmayın.
Wings'i test modunda başlatın:
Kod:
wings --debug
Hata yoksa `CTRL + C` ile durdurun.
Ardından systemd servis dosyasını oluşturun:
Kod:
nano /etc/systemd/system/wings.service
İçeriği:
Kod:
[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
ExecStart=/usr/local/bin/wings
Restart=on-failure
RestartSec=5s
[Install]
WantedBy=multi-user.target
Servisi etkinleştirin:
Kod:
systemctl daemon-reload
systemctl enable --now wings
Durum kontrolü:
Kod:
systemctl status wings
Panel üzerinden Node durumunu kontrol edin. Wings bağlantısı başarılıysa Node kullanılabilir duruma gelir.
13. Pterodactyl Firewall ve Port Ayarları
Pterodactyl kurulumunda en sık yapılan hatalardan biri gerekli portların açılmamasıdır.
Örnek port listesi:
| Port | Protokol | Kullanım |
| 80 | TCP | HTTP |
| 443 | TCP | HTTPS Panel |
| 8080 | TCP | Wings API ve web bağlantıları |
| 2022 | TCP | SFTP |
| 25565 | TCP | Örnek Minecraft Java portu |
Minecraft sunucularında farklı portlar kullanılıyorsa bunların da ayrıca tanımlanması gerekir. Bedrock sunucuları için UDP portları kullanılabilir.
UFW ile örnek güvenlik duvarı kuralları:
Kod:
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8080/tcp
ufw allow 2022/tcp
ufw allow 25565/tcp
ufw enable
ufw status
Önemli güvenlik notları:
- SSH erişimini kaybetmemek için firewall etkinleştirmeden önce SSH portunu açın.
- Minecraft için kullandığınız diğer portları da açın.
- Wings portlarını yalnızca gerekli erişime izin verecek şekilde sınırlandırın.
- Panel ve Wings farklı makinelerdeyse iki makine arasındaki bağlantıyı doğrulayın.
- Hosting sağlayıcısının harici firewall kurallarını da kontrol edin.
- Veritabanı portlarını gereksiz yere internete açmayın.
14. Pterodactyl Üzerinden Minecraft Sunucusu Oluşturma
Kurulum tamamlandıktan sonra Minecraft sunucusu oluşturabilirsiniz.
- Panel'e yönetici hesabınızla giriş yapın.
- Admin Panel bölümüne girin.
- Servers menüsünü açın.
- Create New butonuna tıklayın.
- Sunucu sahibini seçin.
- Sunucu adını belirleyin.
- Kurulu Node'u seçin.
- Minecraft Egg yapılandırmasını belirleyin.
- RAM, CPU ve disk limitlerini ayarlayın.
- Kullanılacak oyun portunu seçin.
- Create Server butonuna tıklayın.
Minecraft için kullanılabilecek örnek Egg türleri:
| Egg | Açıklama |
| Vanilla | Resmî Minecraft Java sunucusu |
| Paper | Eklenti destekli optimize sunucu yazılımı |
| Purpur | Paper tabanlı özelleştirilebilir sunucu yazılımı |
| Fabric | Mod destekli Minecraft sunucusu |
| Forge | Modlu Minecraft sunucusu |
Sunucu oluşturulurken RAM, CPU ve disk sınırlarını gerçek donanım kapasitenize göre belirleyin.
15. Pterodactyl Web Panel Özellikleri
Pterodactyl'in en büyük avantajı, oyun sunucusu yönetim işlemlerini tek bir arayüzde toplamasıdır.
Canlı konsol yönetimi
Sunucunun konsolunu tarayıcı üzerinden açabilir, Minecraft komutları çalıştırabilir ve hata kayıtlarını takip edebilirsiniz.
Örnek komutlar:
Kod:
list
say Sunucu yeniden baslatilacak!
save-all
stop
Dosya yöneticisi
Sunucunun dosyalarını web üzerinden düzenleyebilirsiniz.
- server.properties
- bukkit.yml
- spigot.yml
- paper-global.yml
- plugins klasörü
- world klasörü
- ops.json
- whitelist.json
Kaynak kullanımı
Pterodactyl, sunucular için belirlediğiniz CPU ve RAM limitlerini Docker üzerinden uygular. Böylece aynı makinede birden fazla oyun sunucusu çalıştırırken kaynakları daha kontrollü dağıtabilirsiniz.
Yedekleme
Panel üzerinden sunucu yedekleri oluşturabilir, mevcut yedekleri yönetebilir ve uygun yapılandırmayla uzak depolama kullanabilirsiniz.
Zamanlanmış görevler
Desteklenen görevlerle sunucuyu belirli zamanlarda yeniden başlatabilir, komut çalıştırabilir ve otomatik yedekleme süreçleri oluşturabilirsiniz.
16. Pterodactyl Güvenliği Nasıl Sağlanır?
Pterodactyl paneli internete açık bir yönetim arayüzü olduğu için güvenlik ayarları önemlidir.
- Panelde HTTPS kullanın.
- Yönetici hesabında güçlü ve benzersiz parola kullanın.
- Mümkünse iki aşamalı doğrulamayı etkinleştirin.
- SSH erişimini anahtar tabanlı yapılandırın.
- İşletim sistemi ve Panel güncellemelerini takip edin.
- Wings yapılandırma dosyasını ve token bilgilerini paylaşmayın.
- Veritabanı erişimini yerel bağlantıyla sınırlandırın.
- Sunucu yedeklerini ayrı bir depolama alanında saklayın.
- Kullanıcıların gereksiz yönetici yetkileri almasını engelleyin.
- Node ve Minecraft portlarını firewall üzerinden kontrol edin.
Pterodactyl'in güvenliği yalnızca panel parolasına bağlı değildir. Docker, Linux, SSH, Wings ve ağ yapılandırmasının tamamı güvenli olmalıdır.
Pterodactyl Kurulumunda Sık Karşılaşılan Hatalar
Wings bağlantı kuramıyor
- Wings servisinin çalıştığını kontrol edin.
- Node FQDN ve DNS kayıtlarını inceleyin.
- 8080 portunun erişilebilir olduğunu doğrulayın.
- Panel ve Wings SSL ayarlarını karşılaştırın.
- `/etc/pterodactyl/config.yml` dosyasını kontrol edin.
Docker çalışmıyor
- Docker servis durumunu kontrol edin.
- Sanallaştırma altyapısının Docker desteklediğinden emin olun.
- Linux kernel ve Docker hata kayıtlarını inceleyin.
- Gerekirse hosting sağlayıcınızdan nested virtualization desteği isteyin.
Panel 500 Internal Server Error hatası veriyor
- PHP sürümünü ve gerekli uzantıları kontrol edin.
- Composer bağımlılıklarının eksiksiz yüklendiğinden emin olun.
- NGINX ve PHP-FPM servislerini inceleyin.
- Dosya izinlerini kontrol edin.
- Panel loglarını `storage/logs` dizininden inceleyin.
Minecraft sunucusu başlatılamıyor
- Seçilen Egg ve Docker imajını kontrol edin.
- Java sürümünün Minecraft sürümüyle uyumlu olduğundan emin olun.
- RAM ve disk limitlerini inceleyin.
- Sunucu portunun doğru atanıp atanmadığını kontrol edin.
- Konsol hata kayıtlarını inceleyin.
Panel açılıyor ancak konsol çalışmıyor
- Wings API bağlantısını kontrol edin.
- SSL sertifikalarını doğrulayın.
- WebSocket bağlantısının reverse proxy tarafından engellenmediğini kontrol edin.
- Tarayıcı konsolundaki bağlantı hatalarını inceleyin.
Pterodactyl 1.x ve 2.0 Arasındaki Farklar
Pterodactyl'in yeni 2.0 sürümü yeni yönetim alanı, uzantı sistemi ve altyapı değişiklikleri getiriyor. Ancak resmî dokümantasyonda 2.0 açık beta olarak listelendiği için kararlı üretim ortamında sürüm seçimine dikkat edilmelidir.
| Özellik | Pterodactyl 1.x | Pterodactyl 2.0 |
| Sürüm durumu | Kararlı sürüm hattı | Açık beta |
| PHP | 8.2 / 8.3 | 8.3 / 8.4 |
| Yönetim arayüzü | Mevcut klasik arayüz | Yeni yönetim alanı |
| Uzantılar | Mevcut eklenti ve tema ekosistemi | Yeni Extension sistemi |
| Wings | Wings 1.x | Uyumlu Wings 1.13.x sürümleri |
Yeni kurulumlarda mutlaka resmî dokümantasyondaki güncel sürüm gereksinimlerini kontrol edin. 1.x için hazırlanan kurulum adımlarını 2.0'a doğrudan uygulamayın.
Sık Sorulan Sorular
Pterodactyl Panel ücretsiz mi?
Evet. Pterodactyl açık kaynaklı bir projedir. Kendi sunucunuza kurarak ücretsiz kullanabilirsiniz. VPS, donanım, alan adı ve yedekleme gibi altyapı maliyetleri size aittir.
Pterodactyl Windows'a kurulur mu?
Wings, Windows üzerinde çalışmaz. Resmî kurulum Linux tabanlı işletim sistemleri içindir. Panel ve Wings için desteklenen Linux dağıtımlarını kullanmalısınız.
Pterodactyl için Docker gerekli mi?
Evet. Wings, oyun sunucularını Docker konteynerlerinde çalıştırır. Bu nedenle oyun sunucularını yöneten Node üzerinde Docker gereklidir.
Tek VPS üzerinde Panel ve Minecraft sunucusu çalıştırabilir miyim?
Evet. Panel ve Wings aynı makinede bulunabilir. Ancak çok sayıda oyun sunucusu çalıştırılacaksa kaynakların ayrılması ve ayrı Node kullanılması daha sağlıklı olabilir.
Pterodactyl ile kaç Minecraft sunucusu açabilirim?
Sabit bir sayı yoktur. İşlemci, RAM, disk, oyuncu sayısı ve sunucu türü belirleyicidir. Her sunucu için kaynak limitlerini ayrı ayrı belirleyebilirsiniz.
Pterodactyl ile Paper ve Spigot kurulabilir mi?
Evet. Uygun Minecraft Egg yapılandırmasıyla Paper, Spigot, Vanilla, Fabric ve Forge gibi sunucu yazılımlarını çalıştırabilirsiniz.
Pterodactyl Panel kapandığında Minecraft sunucusu kapanır mı?
Hayır. Wings çalışmaya devam ettiği sürece oyun sunucuları çalışabilir. Panel, yönetim arayüzüdür; oyun süreçlerini doğrudan çalıştıran bileşen Wings'tir.
Pterodactyl ile birden fazla VPS yönetilebilir mi?
Evet. Her VPS üzerinde Wings çalıştırarak Panel'e birden fazla Node ekleyebilirsiniz. Böylece farklı makinelerdeki oyun sunucularını tek arayüzden yönetebilirsiniz.
Sonuç: Minecraft Sunucunuzu Pterodactyl ile Yönetin
Pterodactyl Panel, Minecraft sunucularını web üzerinden yönetmek isteyenler için güçlü ve esnek bir çözümdür. Konsol erişimi, dosya yönetimi, kaynak sınırlandırması, yedekleme ve kullanıcı yetkilendirme özellikleri sayesinde birden fazla sunucuyu tek merkezden kontrol edebilirsiniz.
Özellikle Minecraft hosting hizmeti sunanlar, Survival ve SMP sunucularını yönetenler ve kendi oyun sunucusu altyapısını kurmak isteyenler için değerlendirilebilecek bir sistemdir.
Kurulum sırasında Panel, Wings ve Docker bileşenlerinin doğru yapılandırılması; SSL, firewall ve yedekleme ayarlarının ihmal edilmemesi gerekir.
Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)
Benzer konular
- Cevaplar
- 1
- Görüntüleme
- 2
- Cevaplar
- 1
- Görüntüleme
- 2
- Cevaplar
- 1
- Görüntüleme
- 2
- Cevaplar
- 1
- Görüntüleme
- 3
- Cevaplar
- 1
- Görüntüleme
- 2