📖 Rehber Pterodactyl Panel Kurulumu: Adım Adım Rehber

Pterodactyl Panel Kurulumu — Sıfırdan Çalışan Bir Panel

Bu rehberde Pterodactyl Panel'i temiz bir Ubuntu 22.04 sunucuya kuracağız. Kuruluma başlamadan önce bir VPS'e, alan adına ve temel Linux komut bilgisine ihtiyacınız var. Acele etmeyin; her adımı sırasıyla uygulayın.

Ön Gereksinimler

• Ubuntu 20.04/22.04 veya Debian 11+ kurulu bir VPS
  
• En az 2 GB RAM (panel için), sunucular için ek kaynak
  
• Bir alan adı (örn. panel.sunucum.net)
  
• Root veya sudo yetkili kullanıcı
  

1. Sistemi Güncelleyin

İlk iş her zaman sistemi güncel tutmaktır:

sudo apt update && sudo apt upgrade -y

2. Gerekli Bağımlılıkları Kurun

Panel; PHP, MySQL/MariaDB, Redis ve Nginx üzerine çalışır. Bu bileşenleri kurmanız gerekir. PHP 8.1 veya üzeri önerilir:

sudo apt -y install php8.1 php8.1-cli php8.1-gd php8.1-mysql php8.1-pdo php8.1-mbstring php8.1-tokenizer php8.1-bcmath php8.1-xml php8.1-curl php8.1-zip php8.1-fpm mariadb-server nginx redis-server tar unzip git

3. Composer Kurulumu

Pterodactyl, PHP bağımlılıklarını Composer ile yönetir:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

4. Veritabanı Oluşturun

MariaDB'ye girin ve panel için bir veritabanı ile kullanıcı oluşturun:

mysql -u root -p
CREATE DATABASE panel;
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'GucluBirParola';
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
FLUSH PRIVILEGES;
exit

Parolanızı güçlü seçin; bu veritabanı tüm kullanıcı ve sunucu bilgilerini tutar.

5. Panel Dosyalarını İndirin

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

6. Yapılandırma ve Kurulum Komutları

cp .env.example .env
composer install --no-dev --optimize-autoloader
php artisan key:generate --force
php artisan p:environment:setup
php artisan p:environment:database
php artisan migrate --seed --force
php artisan p:user:make

Son komut size ilk yönetici hesabını oluşturmanızı sağlar. E-posta ve parolanızı dikkatle belirleyin.

7. Nginx ve SSL

Nginx için bir site yapılandırması oluşturup Let's Encrypt ile ücretsiz SSL alın. SSL olmadan panel'i internete açmak ciddi bir güvenlik riskidir. Certbot ile sertifika almak yalnızca birkaç dakika sürer.

Sık Yapılan Hatalar

• 500 hatası: Genellikle dosya izinleri veya eksik .env anahtarından kaynaklanır.
  
• Beyaz ekran: PHP-FPM servisi çalışmıyor olabilir; durumunu kontrol edin.
  
• Veritabanı bağlantı hatası: .env içindeki bilgileri yeniden gözden geçirin.
  

Kurulum bittiğinde panele tarayıcıdan erişip giriş yapabilmelisiniz. Ancak henüz sunucu oluşturamazsınız — bunun için Wings kurmanız gerekir.

Sonraki Adım

Panel ayakta ama tek başına yeterli değil. Bir sonraki rehberde Wings daemon kurulumunu ve node tanımlamayı ele alacağız. Onu da tamamladığınızda ilk sunucunuzu oluşturabileceksiniz.