Ana içeriğe atla
LeaderOS Web Hosting (paylaşımlı hosting) üzerinde çalışmaz. Next.js temalarının sürekli çalışan bir Node.js süreci gerekir ve paylaşımlı hostingte Node.js sunucusu çalıştırılamaz. Temanızı kendi VDS/VPS veya Node.js destekleyen bir platformda yayınlamalısınız. LeaderOS sitenizin kendisi (API, yönetim paneli) mevcut hostingte çalışmaya devam eder.

Mimari

  • LeaderOS sitesi (play.example.com): API, yönetim paneli, ödeme geri aramaları. Çalışmaya devam etmelidir.
  • Tema (shop.example.com): oyuncuların girdiği adres. Veriyi LeaderOS’tan çeker.

Gereksinimler

1. Sunucuyu hazırlayın

2. Projeyi sunucuya alın

3. Ortam değişkenleri

Sunucuda /var/www/my-theme/.env.production oluşturun:
.env* dosyalarını Git’e eklemeyin. Anahtarı yenilerseniz bu dosyayı güncelleyip uygulamayı yeniden başlatın.

4. Derleyin ve başlatın

Uygulama varsayılan olarak 3000 portunda çalışır. Farklı port için: PORT=3100 pm2 start npm --name leaderos-theme -- start.

5. Nginx ters vekil (reverse proxy)

/etc/nginx/sites-available/leaderos-theme:
X-Forwarded-For başlığı önemlidir: tema, ziyaretçinin gerçek IP adresini LeaderOS’a bu başlıkla iletir (kayıt limiti, loglar vb.). Cloudflare kullanıyorsanız gerçek IP’yi doğru ilettiğinizden emin olun.

6. SSL (HTTPS)

Sertifika otomatik yenilenir. Canlı sitede HTTPS zorunludur; aksi halde çerezler ve ödeme sağlayıcıları sorun çıkarır.

7. LeaderOS panelini yapılandırın

Ayarlar → Headless API sayfasında:
1

Frontend URL

https://shop.example.com yazın. E-posta bağlantıları ve ödeme dönüşleri artık temanıza gelir.
2

Sayfa yolları

Şablondaki varsayılanları kullanıyorsanız dokunmayın; değiştirdiyseniz aynı yolları girin.
3

Origin'ler

Proxy kullanan şablonda gerekmez. Tarayıcıdan doğrudan API’ye istek atıyorsanız https://shop.example.com ekleyin. “Tüm origin’lere izin ver” kapalı olmalıdır.

8. Ödeme sağlayıcıları

  • Tarayıcı dönüşü: oyuncu ödeme sonrası temanızdaki /payment/success ve /payment/error sayfalarına döner.
  • Sunucu bildirimleri (callback/webhook) LeaderOS’a gelmeye devam eder: PayTR bildirim URL’si, Stripe/Shopier webhook’u vb. mevcut ayarlarınızı değiştirmeyin; hâlâ LeaderOS sitenizi göstermelidir.
  • Ödeme akışını yayına almadan önce küçük bir tutarla uçtan uca deneyin.

Güncelleme

Sorun giderme

Footer’daki “Powered by LeaderOS” bağlantısını yayına almadan önce kontrol edin. Gizlenirse sayfa bir uyarı ile değiştirilir.