Easypanel + Nginx Otomasyonu Deploy Rehberi

Easypanel + Nginx Otomasyonu Deploy Rehberi

Bu rehber, Easypanel'de deploy edilen RepoDocs'a Nginx otomasyonunu eklemek için adımları açıklar.

Genel Bakış

Easypanel'de deploy ettiğinizde:

Easypanel zaten Nginx reverse proxy'si sağlıyor
SSL sertifikası Let's Encrypt tarafından otomatik yönetiliyor
Custom domain'ler Easypanel tarafından yönetiliyor

Nginx otomasyonu ek olarak:

Wildcard sertifika desteği ekler
Subdomain'ler için otomatik SSL sağlar
Certbot entegrasyonu ile sertifika yönetimini otomatikleştirir

Seçenek 1: Easypanel Entegrasyonu (Önerilen)

Easypanel zaten custom domain'leri yönetiyorsa, Nginx otomasyonuna gerek yok.

Kurulum

Easypanel API token'ını alın:
- Easypanel Dashboard → Settings → API Tokens
- Token'ı kopyalayın
.env dosyasını güncelleyin:
Deploy edin (Easypanel otomatik yeniden build edecek)

Nasıl Çalışır

Custom domain eklendiğinde:

API endpoint'i çağrılır
Easypanel client domain'i Easypanel'e ekler
Easypanel otomatik olarak:
- SSL sertifikası oluşturur
- Nginx konfigürasyonunu günceller
- Yönlendirmeyi yapılandırır

Seçenek 2: Sunucu Seviyesi Nginx (VPS'de Easypanel varsa)

Eğer Easypanel'i kendi VPS'inizde çalıştırıyorsanız, Nginx otomasyonunu ekleyebilirsiniz.

Gereksinimler

Easypanel kurulu VPS
Root erişimi
Certbot kurulu

Kurulum

SSH ile sunucuya bağlanın:
Certbot'u yükleyin (zaten kurulu değilse):

apt-get install -y certbot python3-certbot-nginx

Wildcard sertifika oluşturun:

-d "*.yourdomain.com" -d "yourdomain.com" </span> -m admin@yourdomain.com

Easypanel'de environment variables ekleyin:

App service → Environment sekmesine git:
Deploy edin:
- Easypanel'de "Deploy" butonuna tıklayın
- Uygulamayı yeniden başlatın

DNS Ayarları

Sunucu DNS sağlayıcısında:

Seçenek 3: Hibrit (Easypanel + Nginx)

Her iki sistemi de kullanabilirsiniz:

Sistem her ikisini de deneyecek ve başarılı olanları kullanacak.

Easypanel'de Deploy Adımları

1. Environment Variables Ekleyin

App service → Environment sekmesi:

2. Deploy Edin

"Deploy" butonuna tıklayın
Build loglarını takip edin
Deploy tamamlanana kadar bekleyin

3. Database Migration

Deploy tamamlandıktan sonra:

App service → Terminal sekmesi
Şu komutu çalıştırın:

4. Custom Domain Test Edin

Dashboard'dan custom domain ekleyin
DNS kaydını güncelleyin
Tarayıcıda test edin

Sorun Giderme

Custom Domain Çalışmıyor

SSL Sertifikası Hatası

Easypanel API Hatası

API token'ın doğru olduğundan emin olun
Easypanel URL'i kontrol edin
Logs sekmesinden hata mesajını kontrol edin

Faydalı Komutlar

Kontrol Listesi ✅

Sonraki Adımlar

Custom domain'ler otomatik olarak yönetilecek
SSL sertifikası Let's Encrypt tarafından otomatik yenilenir
Yeni custom domain eklendiğinde sistem otomatik olarak yapılandırır

Daha fazla bilgi için: docs/CUSTOM_DOMAIN_AUTOMATION.md