Ana sayfa
XtreamUIPro

Kurulum kılavuzu

Konut Toplulukları kurulum kılavuzu

Platformu bir konut topluluğunun televizyon hizmeti olarak yapılandırın: ev türü başına bir kanal listesi, bina başına bir node, daire başına bir hat ve yönetim şirketinin bir bilgilendirme kanalı.

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üzdePlatformdaPanelde nerede
Mülk yöneticisi hesabıBayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panelUsers → bayi ekle; yetkileri için Groups
Kanal listesiBuket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesiBouquets, Streams ve Movies / Series'ten
Kanal veya bilgilendirme kanalıCanlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayınStreams → 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 veriMovies ve Series ya da VOD ingest işi
Daire erişimiHat: paketi, buketleri, bitiş tarihi, bağlantı sınırı ve çıkışlarıyla tek bir erişimLines → ekle, veya etkinleştirme kodları, veya Reseller API
Kira veya ikamet süresiHattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenirHattın bitiş tarihi ve paketin süresi
Bina node'uYayın node'ları: panelden kaydedilen edge sunucular, her site veya bina için bir taneServers → node ekle, SSH ile kurulur

Ön koşullar

Kurmadan önce nelere sahip olmalı.

  1. 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.
  2. 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ı).
  3. 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.

  1. Kurulum aracını merkezi sunucuda çalıştırın ve oynatma tabanı URL'sini binaların erişebildiği bir adrese ayarlayın.
  2. Kanal beslemelerini Streams altına, duyuruları Movies altına ekleyin ve web oynatıcıda kontrol edin.
  3. 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.
  4. 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.

  1. Her ev türünün kanallarından liste başına bir buket ve yönetim şirketinin bilgilendirmesi için bir buket oluşturun.
  2. Her sakin duyuruları alsın diye bilgilendirme buketini her pakete ekleyin.
  3. Ev türü başına, buketleri ve kira veya ikamet dönemine uyan bir süresi olan bir paket oluşturun.
  4. Televizyondaki menü iyi okunsun diye kanalları sıralayın ve logo verin.

Ortak (bayi) yapılandırması

Devredilmiş hesap olarak mülk yöneticisi.

  1. Yetkileri hatlarla sınırlı, kataloğa veya sunuculara erişimi olmayan bir grup oluşturun.
  2. Her mülk yöneticisini o grup, evlerinin paketleri ve bir kredi bakiyesiyle bayi olarak ekleyin.
  3. 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.

  1. 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.
  2. En fazla bağlantıyı evdeki televizyon sayısına ayarlayın.
  3. Sakin cihaza kısa bir kod girsin istiyorsanız parola yerine bir etkinleştirme kodu kullanın.
  4. 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ı.

  1. Karşılama videosunu, bina kurallarını ve bakım kılavuzlarını konu başına bir kategoriyle film olarak yükleyin.
  2. Her paket içersin diye onları bilgilendirme buketine koyun.
  3. 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ı.

  1. Her lisanslı kanalı beslemesiyle Streams altına ekleyin ve televizyondaki rehber programları göstersin diye bir EPG kaynağı ekleyin.
  2. 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.
  3. 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.

  1. Bir hat paketinin dönemi sonunda sona erer; her yeni kira dönemi için onu paketle veya bir kredi ile yenileyin.
  2. 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.
  3. 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.

  1. 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.
  2. 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.
  3. İ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.

  1. 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.
  2. 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.
  3. 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.
  4. Site dışı kopyalı şifreli veritabanı yedeğini etkinleştirin; hatların kimlik bilgileri onun içindedir.

Sorun giderme

Olağan ilk kontroller.

  1. 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.
  2. Bir bina akşamları takılıyor: bina node'unun heartbeat'ini ve sakinlerinin ona yönlendirildiğini kontrol edin.
  3. Bir ev türü için bir kanal eksik: o paketin buketlerini kontrol edin.
  4. Bir yönetici hat oluşturamıyor: bayinin kredi bakiyesini, grubunun yetkilerini ve kendisine atanan paketleri kontrol edin.