balikci/docs/NGINX_PROXY_MANAGER.md

🌐 Nginx Proxy Manager Kurulum Rehberi

Oltalama Panel için Nginx Proxy Manager (NPM) ile reverse proxy kurulumu.

📋 Neden Tek Domain?

Önerilen Yapı: Tek domain, path-based routing

Avantajları:

• ✅ CORS Sorunu Yok: Frontend ve backend aynı origin'de
• ✅ Tek SSL Sertifikası: Sadece bir domain için sertifika
• ✅ Basit Yönetim: Tek entry point
• ✅ Kolay Kurulum: Daha az konfigürasyon

Alternatif: İki Subdomain

Eğer iki ayrı subdomain kullanmak isterseniz:

• panel.yourdomain.com → Frontend
• api.yourdomain.com → Backend

Not: Bu durumda CORS ayarları gerekir ve iki SSL sertifikası gerekir.

🚀 Nginx Proxy Manager Kurulumu

1. Docker ile NPM Kurulumu

# Docker ve Docker Compose kurulumu (eğer yoksa)
sudo apt update
sudo apt install docker.io docker-compose -y

# NPM dizini oluştur
mkdir -p ~/nginx-proxy-manager
cd ~/nginx-proxy-manager

docker-compose.yml:

version: '3'
services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    ports:
      - '80:80'     # HTTP
      - '443:443'   # HTTPS
      - '81:81'     # Admin Panel
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt

# NPM başlat
docker-compose up -d

# Logları izle
docker-compose logs -f

2. NPM Admin Paneline Giriş

1. Tarayıcıdan http://sunucu-ip:81 adresine gidin
2. İlk giriş bilgileri:
   • Email: admin@example.com
   • Şifre: changeme
3. Giriş yaptıktan sonra mutlaka email ve şifreyi değiştirin

🔧 Tek Domain Konfigürasyonu (Önerilen)

Adım 1: Proxy Host Ekle

NPM Admin Panel → Hosts → Proxy Hosts → Add Proxy Host

Details Sekmesi:

Domain Names:     yourdomain.com
                  www.yourdomain.com

Scheme:           http
Forward Hostname: localhost (veya Oltalama sunucusunun IP'si)
Forward Port:     4173

☑ Cache Assets
☑ Block Common Exploits
☑ Websockets Support

SSL Sekmesi:

SSL Certificate:  Request a new SSL Certificate

☑ Force SSL
☑ HTTP/2 Support
☑ HSTS Enabled
☑ HSTS Subdomains

Email Address:    youremail@example.com
☑ I Agree to the Let's Encrypt Terms of Service

Advanced Sekmesi:

Custom Nginx Configuration:

# Backend API routing
location /api {
    proxy_pass http://localhost:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_cache_bypass $http_upgrade;
    
    # Timeouts
    proxy_connect_timeout 60s;
    proxy_send_timeout 60s;
    proxy_read_timeout 60s;
}

# Tracking endpoint
location /t/ {
    proxy_pass http://localhost:3000;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    
    # No cache for tracking
    add_header Cache-Control "no-cache, no-store, must-revalidate";
    add_header Pragma "no-cache";
    add_header Expires "0";
}

# Health check endpoint
location /health {
    proxy_pass http://localhost:3000;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
}

# Frontend static files
location / {
    proxy_pass http://localhost:4173;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

Adım 2: Oltalama Panel Ayarları

Panele giriş yapın → Ayarlar → Genel Ayarlar

Domain (Base URL): https://yourdomain.com

Önemli:

• Protokolü ekleyin: https://
• Sondaki / karakterini eklemeyin
• Subdomain kullanıyorsanız: https://panel.yourdomain.com

🔀 İki Domain Konfigürasyonu (Alternatif)

Oltalama Panel Ayarları

Panele giriş yapın → Ayarlar → Genel Ayarlar

☑ İki Ayrı Domain Kullan (CORS Aktif Et)
Backend Domain:  https://api.yourdomain.com
Frontend Domain: https://panel.yourdomain.com

Önemli:

• CORS checkbox'ını işaretleyin
• Her iki domain'i de https:// ile girin
• Sondaki / karakterini eklemeyin

🔀 Nginx Proxy Manager - İki Domain Kurulumu

Eğer backend ve frontend'i ayırmak isterseniz:

Backend Proxy Host

Domain Names:     api.yourdomain.com
Scheme:           http
Forward Hostname: localhost
Forward Port:     3000

SSL:              ✓ Force SSL, HTTP/2, HSTS

Frontend Proxy Host

Domain Names:     panel.yourdomain.com
Scheme:           http
Forward Hostname: localhost
Forward Port:     4173

SSL:              ✓ Force SSL, HTTP/2, HSTS

Advanced (Frontend):

# Proxy backend API calls
location /api {
    proxy_pass https://api.yourdomain.com;
    proxy_ssl_server_name on;
    proxy_set_header Host api.yourdomain.com;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

CORS Ayarları

İki domain kullanıyorsanız CORS otomatik olarak ayarlanır. Sadece panelden ayarları yapın:

Panelden Ayarlama (Önerilen):

1. Giriş yapın → Ayarlar → Genel Ayarlar
2. ☑ İki Ayrı Domain Kullan checkbox'ını işaretleyin
3. Backend Domain: https://api.yourdomain.com
4. Frontend Domain: https://panel.yourdomain.com
5. Kaydet butonuna tıklayın

CORS ayarları otomatik olarak uygulanacaktır.

Manuel .env Ayarları (Opsiyonel):

Backend .env (varsayılan):

FRONTEND_URL=http://localhost:5173

Production'da panel ayarları bu değeri override edecektir.

✅ Test ve Doğrulama

1. DNS Kontrolü

# Domain çözümleniyor mu?
nslookup yourdomain.com

# Ping testi
ping yourdomain.com

2. SSL Sertifikası Kontrolü

# SSL sertifikası geçerli mi?
curl -I https://yourdomain.com

# Detaylı SSL testi
openssl s_client -connect yourdomain.com:443 -servername yourdomain.com

3. Endpoint Testleri

# Frontend erişilebilir mi?
curl https://yourdomain.com

# Backend API erişilebilir mi?
curl https://yourdomain.com/api/health

# Tracking endpoint çalışıyor mu?
curl -I https://yourdomain.com/t/test-token

4. Tarayıcı Testleri

1. https://yourdomain.com adresine gidin
2. Login sayfası açılmalı
3. Developer Console'da hata olmamalı
4. Network sekmesinde:
   • Frontend dosyaları (JS, CSS) yüklenmeli
   • API istekleri /api/* başarılı olmalı
   • CORS hatası olmamalı

🐛 Sorun Giderme

Problem: 502 Bad Gateway

Çözüm:

# Backend çalışıyor mu?
pm2 status

# Port dinleniyor mu?
sudo netstat -tulpn | grep -E ':(3000|4173)'

# Firewall açık mı?
sudo ufw status

Problem: SSL Sertifikası Alınamıyor

Çözüm:

1. DNS kayıtlarının doğru olduğundan emin olun
2. 80 ve 443 portlarının açık olduğunu kontrol edin
3. Domain'in sunucuyu gösterdiğinden emin olun

# Port 80 ve 443 dinleniyor mu?
sudo netstat -tulpn | grep -E ':(80|443)'

# Firewall kuralları
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Problem: CORS Hatası

İki subdomain kullanıyorsanız:

1. Backend .env dosyasında CORS_ORIGIN ayarlayın
2. Frontend'den API URL'i doğru mu kontrol edin
3. Backend'i yeniden başlatın

cd /opt/oltalama/backend
pm2 restart oltalama-backend

Problem: Tracking Linkleri Çalışmıyor

Çözüm:

1. Panelde doğru domain ayarlandığından emin olun
2. /t/ route'unun proxy'de tanımlı olduğunu kontrol edin
3. Backend loglarını kontrol edin:

pm2 logs oltalama-backend --lines 50

📊 Performans Optimizasyonu

NPM Cache Ayarları

Advanced Nginx Config:

# Static dosyalar için cache
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
    proxy_pass http://localhost:4173;
    expires 1y;
    add_header Cache-Control "public, immutable";
}

# API istekleri için cache yok
location /api {
    proxy_pass http://localhost:3000;
    add_header Cache-Control "no-cache, no-store, must-revalidate";
}

Rate Limiting

# Rate limit tanımı
limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;

location /api {
    limit_req zone=api_limit burst=20 nodelay;
    limit_req_status 429;
    
    proxy_pass http://localhost:3000;
    # ... diğer ayarlar
}

🔒 Güvenlik İpuçları

1. NPM Admin Paneli Güvenliği:
   • Port 81'i firewall'dan kapatın (sadece lokal erişim)
   • Güçlü şifre kullanın
   • 2FA aktif edin (eğer varsa)

# NPM admin paneline sadece lokal erişim
sudo ufw deny 81/tcp

2. SSL/TLS:

   • Her zaman Let's Encrypt kullanın
   • Force SSL aktif edin
   • HSTS etkinleştirin

3. Headers:

   • NPM otomatik güvenlik başlıkları ekler
   • Ek başlıklar için Advanced Nginx Config kullanın

📝 Özet Karşılaştırma

Özellik	Tek Domain	İki Subdomain
CORS	✅ Yok	⚠️ Gerekli
SSL	✅ 1 Sertifika	⚠️ 2 Sertifika
Kurulum	✅ Kolay	⚠️ Orta
Yönetim	✅ Basit	⚠️ Karmaşık
DNS	✅ 1 Kayıt	⚠️ 2 Kayıt
Önerilen	✅ Evet	⚠️ İhtiyaç varsa

🎯 Sonuç

Önerimiz: Tek domain kullanın (yourdomain.com)

• Frontend: yourdomain.com/
• Backend: yourdomain.com/api/
• Tracking: yourdomain.com/t/

Bu yapı en kolay ve en sorunsuz çözümdür.

---

Son Güncelleme: 2025-11-10
Versiyon: 1.0.0