Bu kılavuzlar bir sektörün kavramlarını platformun bugün sahip olduğu nesnelere (buketler, hatlar, paketler, bayi hesapları, node'lar, API) eşler. Bunlar kavramsal eşlemelerdir, sektöre özgü özellikler değildir ve bayi hesabı yalıtılmış bir kiracı değil, devredilmiş bir hesaptır.
Kavramsal eşleme
Panelde hiçbir şey abonelik veya sunuculuk noktası olarak adlandırılmaz. Tablo hangi nesnenin hangi rolü oynadığını gösterir; aşağıdaki bölümler onları bu sırayla kurar.
| Sektörünüzde | Platformda | Panelde nerede |
|---|---|---|
| Bayi veya bölgesel ortak hesabı | Bayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panel | Users → bayi ekle; yetkileri için Groups |
| Kanal kademesi veya ek paket | Buket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesi | Bouquets, Streams ve Movies / Series'ten |
| Televizyon kanalı | Canlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayın | Streams → canlı yayın ekle (kaynak URL'si veya RTMP push) |
| VOD arşivi | VOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veri | Movies ve Series ya da VOD ingest işi |
| Abonenin televizyon erişimi | Hat: paketi, buketleri, bitiş tarihi, bağlantı sınırı ve çıkışlarıyla tek bir erişim | Lines → ekle, veya etkinleştirme kodları, veya Reseller API |
| Faturalama döneminin sonu | Hattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenir | Hattın bitiş tarihi ve paketin süresi |
| Abonelik başına ekran | Hattın en fazla bağlantısı: aynı anda kaç cihaz izleyebilir | Hattın en fazla bağlantısı |
| Faturalama ve provizyon entegrasyonu | Reseller API ve webhook'lar: panelin işlemleri kendi sisteminizden | Bayinin panelindeki Reseller API anahtarları ve webhook'lar |
| Sunuculuk noktası node'u | Yayın node'ları: panelden kaydedilen edge sunucular, her site veya bina için bir tane | Servers → node ekle, SSH ile kurulur |
Ön koşullar
Kurmadan önce nelere sahip olmalı.
- Çekirdek sahada bir sunucu (Ubuntu 22.04 veya 24.04), kurulum aracı, abonelerin erişebildiği bir alan adı veya adres ve node'lar için her sunuculuk noktasında bir sunucu.
- Lisanslı kanal beslemeleri, VOD arşivi ve aboneliklerin bulunduğu faturalama sistemi.
- Kademeler, bir faturalama döneminin ne kadar sürdüğü ve hangi bayilerin ortak hesabı alacağı hakkında bir karar.
Altyapı dağıtımı
Çekirdek saha, sonra sunuculuk noktaları.
- Kurulum aracını çekirdek sunucuda çalıştırın; paneli reverse proxy'nizin arkasına koyun ve günlükler ile IP kuralları abonenin gerçek adresini görsün diye TRUSTED_PROXIES'i ayarlayın.
- Oynatma tabanını abonelerin eriştiği herkese açık adrese ve lisans anahtarını sunucuda ayarlayın.
- Servers'tan sunuculuk noktası başına bir node kaydedin; panel onu SSH ile kurar veya node tek kullanımlık bir kodla kaydolur ve yakınındaki aboneleri ona yönlendirir.
- Destek veya faturalama ekibi için yalnızca hat yetkileri olan bir ortak hesabı (bayi) oluşturun.
İçerik organizasyonu
Buket olarak kademeler ve paketler.
- Kanalları Streams altına, VOD arşivini Movies ve Series altına kategoriler ve bir EPG kaynağıyla ekleyin.
- Temel kanal listesi, premium kanallar ve VOD arşivi için buketler oluşturun.
- Abonelik kademesi başına, verdiği buketler, süre olarak faturalama dönemi ve kredi cinsinden bir fiyatla bir paket oluşturun.
- Bir promosyon veya yeni bir müşteri için kısa bir deneme paketi oluşturun.
Ortak (bayi) yapılandırması
Kredili bayiler.
- Bayiler için kendi hatlarına yetkisi olan, kataloğa veya ayarlara erişimi olmayan bir grup oluşturun.
- Her bölgesel bayiyi o grup, satabileceği paketler ve bir kredi bakiyesiyle ortak hesabı olarak ekleyin; bir bayinin beş seviyeye kadar alt bayisi olabilir.
- credits.low webhook'u ve düşük kredi bildirimi, satışlar durmadan önce bayiye bakiye yüklemesini söyler.
Abone hattı yapılandırması
Abonelik başına bir hat.
- Faturalama bir abonelik başladığında, bir konektör veya Reseller API'nin action=create_line çağrısıyla, kademenin paketi ve bir istek kimliğiyle hat oluşturur.
- Kademe başına en fazla bağlantıyı, bir hanenin aynı anda kullanabileceği ekran sayısını ayarlayın.
- Teklif yalnızca kendi ağınız içinse bir hattı abonenin adresine, ülkesine veya ISP'sine bağlayın.
- Bir pilot veya destek durumu için Lines → add'den hat ekleyin ve kimlik bilgilerini verin.
VOD arşivi
İsteğe bağlı katalog.
- Film ve dizileri sezon ve bölümlerle, VOD ingest işiyle içe alarak veya yükleyerek, afişler ve açıklamalar için TMDB metaverisiyle ekleyin.
- Başlıkları kademe veya ek pakete göre buketlerde gruplayın; böylece bir paket abonelikte tam olarak olanı verir.
- Node'lar VOD dosyalarını önbelleğe alır, bu yüzden popüler başlıklar aboneye yakın sunuculuk noktasından sunulur.
Canlı kanallar
Kanal listesi.
- Her lisanslı kanalı beslemesiyle Streams altına ekleyin ve catch-up veya timeshift'i yalnızca haklar izin verdiği yerde etkinleştirin.
- Uygulamalar ve kutular program rehberini göstersin diye bir EPG kaynağı ekleyin.
- Her node bir canlı kanalı origin'den bir kez alır ve abonelerine dağıtır.
Bitiş, yenileme ve iptal
Hattın geçerliliği olarak faturalama dönemi.
- Bir hat paketinin süresi boyunca sürer; faturalama onu her dönem action=renew_line ile veya konektör aracılığıyla yeniler.
- Bir abonelik sona erdiğinde veya iptal edildiğinde faturalama action=disable_line çağırır ve yeniden etkinleştirmede hattı tekrar etkinleştirir.
- Süresi dolmak üzere olan ve dolmuş hatları kayıtlarıyla uzlaştırmak için faturalamayı webhook'lara abone edin.
Faturalama ile entegrasyon
Faturalama erişimi yönetir; oynatıcı oynatır.
- Faturalama sisteminizin konektörünü onun tarafına kurun (WHMCS, Blesta, Odoo ve diğerleri) ya da kendi sisteminizden bir anahtar ve istek kimliğiyle Reseller API'yi çağırın.
- İzleyiciler için tek oturum açma yoktur: abone bir uygulamada veya kutuda, faturalamanın müşteri alanında gösterebileceği hattın kimlik bilgileriyle oturum açar.
- Raporlama araçları için salt okunur bayraklı, IP izin listeli ve bitiş tarihli Admin API anahtarları kullanın.
Güvenlik değerlendirmeleri
Hizmeti aboneler için tutun.
- Paneli TLS'li reverse proxy'nin arkasına koyun ve TRUSTED_PROXIES'i ayarlayın; node'ların yönetim trafiğini özel bir ağda tutun.
- Her panel hesabı için iki adımlı oturum açma, destek ve bayiler için yetki grupları; oturum açmada reCAPTCHA veya Turnstile.
- İmzalı ve süresi dolan oynatma bağlantıları, abonelik başına bağlantı sınırı ve uygun olduğu yerde adrese, ülkeye veya ISP'ye bağlama.
- Site dışı kopyalı şifreli veritabanı yedekleri ve hatların ve kredilerin her değişikliği için denetim günlüğü.
Sorun giderme
Olağan ilk kontroller.
- Bir abonenin televizyonu yok: hattın etkin olduğunu ve süresinin dolmadığını, sonra faturalamanın çağrısını Reseller API çağrı günlüğünde kontrol edin.
- Bir kademe için bir kanal eksik: o kademenin paketinin buketlerini kontrol edin.
- Bir sunuculuk noktası takılıyor: node'unun heartbeat'ini ve abonelerinin ona yönlendirildiğini kontrol edin.
- Bir bayi hat oluşturamıyor: kredilerini ve paketin satabileceği paketlerden biri olduğunu kontrol edin.