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 daire veya sakin 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 |
|---|---|---|
| Mülk yöneticisi hesabı | Bayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panel | Users → bayi ekle; yetkileri için Groups |
| Kanal listesi | Buket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesi | Bouquets, Streams ve Movies / Series'ten |
| Kanal veya bilgilendirme kanalı | Canlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayın | Streams → canlı yayın ekle (kaynak URL'si veya RTMP push) |
| Karşılama ve duyuru videoları | VOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veri | Movies ve Series ya da VOD ingest işi |
| Daire 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 |
| Kira veya ikamet süresi | Hattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenir | Hattın bitiş tarihi ve paketin süresi |
| Bina 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ı.
- Yönetim şirketi için bir sunucu (Ubuntu 22.04 veya 24.04), kurulum aracı ve sakinlerin ağına erişebilen her bina için bir sunucu.
- Topluluğun yeniden yayınlayabileceği kanal beslemeleri (pull URL'leri veya RTMP), yönetim şirketinin duyuruları ve karşılama videoları ve sakinlerin cihazları (set-top box'lar, oynatıcı uygulamalı akıllı TV'ler veya bir tarayıcı).
- Ev türleri (standart, yaşlı, öğrenci) ve yönetim şirketinde hatları kimin açıp yenileyeceği hakkında bir karar.
Altyapı dağıtımı
Merkezi sunucu, sonra bina başına bir node.
- Kurulum aracını merkezi sunucuda çalıştırın ve oynatma tabanı URL'sini binaların erişebildiği bir adrese ayarlayın.
- Kanal beslemelerini Streams altına, duyuruları Movies altına ekleyin ve web oynatıcıda kontrol edin.
- Servers'tan bina başına bir node kaydedin; panel onu SSH ile kurar veya node tek kullanımlık bir kodla kaydolur ve o binanın sakinlerini ona yönlendirir.
- Mülk yöneticisini Users → add a reseller altında, hatlara izin veren ve katalog değişikliğine izin vermeyen bir grupla ekleyin.
İçerik organizasyonu
Ev türü başına kanal listeleri.
- Her ev türünün kanallarından liste başına bir buket ve yönetim şirketinin bilgilendirmesi için bir buket oluşturun.
- Her sakin duyuruları alsın diye bilgilendirme buketini her pakete ekleyin.
- Ev türü başına, buketleri ve kira veya ikamet dönemine uyan bir süresi olan bir paket oluşturun.
- Televizyondaki menü iyi okunsun diye kanalları sıralayın ve logo verin.
Ortak (bayi) yapılandırması
Devredilmiş hesap olarak mülk yöneticisi.
- Yetkileri hatlarla sınırlı, kataloğa veya sunuculara erişimi olmayan bir grup oluşturun.
- Her mülk yöneticisini o grup, evlerinin paketleri ve bir kredi bakiyesiyle bayi olarak ekleyin.
- Birkaç binayı yöneten bir yönetici bina başına bir alt bayi ekleyebilir; her birinin kendi evleri ve kredileri olur.
Daire (hat) yapılandırması
Numarasıyla adlandırılmış daire başına bir hat.
- Lines → add altında daire başına bir hat oluşturun; adı daire numarası olsun ve o ev türünün paketini kullansın.
- En fazla bağlantıyı evdeki televizyon sayısına ayarlayın.
- Sakin cihaza kısa bir kod girsin istiyorsanız parola yerine bir etkinleştirme kodu kullanın.
- Cihazı bir kez yapılandırın (hattın kimlik bilgileriyle Xtream Codes API veya M3U, ya da MAG veya Enigma2 portalı); hatta yeni kimlik bilgileri verilene kadar kimlik bilgileri dairede kalır.
Karşılama ve duyuru videoları
Yönetim şirketinin isteğe bağlı videoları.
- Karşılama videosunu, bina kurallarını ve bakım kılavuzlarını konu başına bir kategoriyle film olarak yükleyin.
- Her paket içersin diye onları bilgilendirme buketine koyun.
- Bilgi değiştiğinde videoyu panelden değiştirin; sakinler yeni sürümü hemen görür.
Kanallar ve bilgilendirme kanalı
Canlı yayın olarak kanal listesi ve duyuru kanalı.
- Her lisanslı kanalı beslemesiyle Streams altına ekleyin ve televizyondaki rehber programları göstersin diye bir EPG kaynağı ekleyin.
- Bilgilendirme kanalını, RTMP ile bir kodlayıcının veya döngülü bir kaynağın beslediği canlı yayın olarak ekleyin ve bilgilendirme buketine koyun.
- Bölge sınırı olan kanalları yalnızca doğru paketlerin verdiği buketlerde tutun.
Taşınma, taşınma sonrası ve bitiş
Hattın geçerliliği olarak ikamet.
- Bir hat paketinin dönemi sonunda sona erer; her yeni kira dönemi için onu paketle veya bir kredi ile yenileyin.
- Bir sakin ayrıldığında hattı devre dışı bırakın; sonraki sakin onu yeni kimlik bilgileriyle yeniden etkinleştirir, böylece eski haneye hiçbir şey kalmaz.
- Süresi dolmak üzere olan veya dolmuş hatları görmek için konut sistemini veya yöneticiyi webhook'lara abone edin.
Konut veya faturalama sistemiyle entegrasyon
Sistemler erişimi açar; oynatıcı oynatır.
- Konut veya faturalama sistemi için bir Reseller API anahtarı oluşturun; create_line, renew_line, enable_line ve disable_line çağırır ve her yazma işleminde bir istek kimliği gönderir.
- Sakinler çevrimiçi ek paket satın alıyorsa bir ticaret konektörü kullanın; diğer tüm sistemler Reseller API ve webhook'ları kullanır.
- İzleyiciler için tek oturum açma yoktur: sakin oynatıcıda hattın kimlik bilgileriyle oturum açar.
Güvenlik değerlendirmeleri
Hizmeti topluluğun içinde tutun.
- Paneli TLS'li bir reverse proxy'nin arkasında sunun ve denetim günlüğü ile IP kuralları gerçek adresleri görsün diye TRUSTED_PROXIES'i ayarlayın.
- Her yönetim hesabı için iki adımlı oturum açma; mülk yöneticileri hatlarla sınırlı bir yetki grubu alır.
- Hat başına bağlantı sınırı, imzalı ve süresi dolan oynatma bağlantıları ve cihazların sabit adresi olduğu yerde adrese bağlama.
- Site dışı kopyalı şifreli veritabanı yedeğini etkinleştirin; hatların kimlik bilgileri onun içindedir.
Sorun giderme
Olağan ilk kontroller.
- Bir dairede televizyon yok: hattının etkin olduğunu ve süresinin dolmadığını, sonra cihazın kimlik bilgilerini ve oynatma adresini kontrol edin.
- Bir bina akşamları takılıyor: bina node'unun heartbeat'ini ve sakinlerinin ona yönlendirildiğini kontrol edin.
- Bir ev türü için bir kanal eksik: o paketin buketlerini kontrol edin.
- Bir yönetici hat oluşturamıyor: bayinin kredi bakiyesini, grubunun yetkilerini ve kendisine atanan paketleri kontrol edin.