Pytania i odpowiedzi

Kompletny system OTT / IPTV: panel administracyjny (dashboard), serwer API dla aplikacji widzów, dostarczanie kanałów na żywo, filmów, seriali i radia oraz odtwarzacz webowy. My dostarczamy i utrzymujemy system; resellerzy używają go, aby dać swoim klientom prawo do oglądania (linie).

• Nie pobiera pieniędzy za Ciebie i nie ma bramki płatności. Cena dla Twoich klientów, sposób rozliczeń i fakturowanie to sprawa resellera (zobacz CON-01).
• Nie kontaktuje się z widzami resellera. Panel wysyła e-maile wyłącznie na konta panelu, nigdy do linii.
• Nie przechowuje danych osobowych usuniętego klienta i nie ma funkcji przywracania (zobacz DATA-01).

1. Admin buduje katalog (kanały, filmy, seriale, radio) i grupuje go w bukiety.
2. Admin tworzy pakiet: bukiety + czas trwania + liczba połączeń + cena w kredytach.
3. Reseller wydaje kredyty, aby sprzedać pakiet → system tworzy linię.
4. Klient wpisuje dane linii w aplikacji; system sprawdza linię (nie wygasła, jest włączona, mieści się w limitach) i odtwarza z odpowiedniego serwera.

Reseller może przeglądać listy kanałów, filmów, seriali, radia, bukietów i pakietów (gdy jego grupa ma takie uprawnienie), ale nie może dodawać, edytować ani usuwać treści. Treścią i pakietami zarządza admin. Reseller decyduje, co każdy klient może oglądać, wybierając pakiet (oraz bukiety, gdy grupa na to pozwala — PKG-05).

Pozycja Support na pasku bocznym otwiera osobną witrynę pomocy. Panel nie ma własnego systemu zgłoszeń. Wysyłając zgłoszenie, podaj: nazwę użytkownika linii (nigdy hasło), kiedy to się stało, aplikację / urządzenie oraz kod pytania z tej strony, jeśli już go wypróbowałeś.

Panel, odtwarzacz webowy i ta strona pomocy mają przełącznik języka z 27 językami. Angielski i wietnamski są tłumaczeniami wzorcowymi; w pozostałych językach nowo dodany ekran może przez jakiś czas pozostać po angielsku. E-maile wysyłane przez panel są obecnie wyłącznie po angielsku.

Pakiety instalacyjne, ich sumy kontrolne SHA-256 i pełna instrukcja instalacji (po angielsku) są pod adresem https://download.xtream-ui.pro.

• Potrzebujesz: Ubuntu 22.04 lub 24.04 (maszyna wirtualna lub bare metal), root lub sudo, najlepiej świeży serwer.
• Instalacja: pobierz pakiet dla swojego procesora bezpośrednio na serwer, sprawdź go poleceniem sha256sum, rozpakuj i uruchom sudo ./install.sh.
• Aktualizacja działającego serwera: sudo ./upgrade.sh --tag <version>.

Domeny z TLS, węzły brzegowe i wszystkie opcje opisano w instrukcji.

Tak zaprojektowano: linia nie jest kontem panelu. Klient używa danych linii tylko w aplikacji IPTV, na dekoderze lub w odtwarzaczu webowym. W drugą stronę, konta resellera nie można używać do oglądania kanałów.

Menu i akcje zależą od grupy, którą admin nadał Twojemu kontu. Strona, do której Twoja grupa nie ma uprawnień, nie jest pokazywana na pasku bocznym i nie można jej otworzyć. Poproś admina o więcej uprawnień.

W obszarze konta (profil → zmiana hasła). Hasła do panelu są przechowywane w postaci skrótu; nikt nie może ich odczytać — nawet admin. Jeśli je zapomnisz, poproś konto nad sobą (nadrzędnego resellera lub admina) o ustawienie nowego.

Panel można skonfigurować tak, aby kończył sesję po zmianie adresu IP, dzięki czemu skradziona sesja nie może być użyta ponownie. Zaloguj się ponownie. To ustawienie admina.

Panel ogranicza liczbę nieudanych logowań (konfiguruje to admin). Po przekroczeniu limitu trzeba odczekać przed kolejną próbą.

Konto demo tylko pokazuje interfejs: nie może zmieniać hasła, edytować profilu, tworzyć kodów aktywacyjnych ani robić niczego, czego nie da się cofnąć.

Konto nad Tobą je wyłączyło: nie możesz zalogować się do panelu, a Twoje klucze API są odrzucane. Sprzedane już linie nie są usuwane. Skontaktuj się z kontem nad sobą.

Logs → Reseller Logs (gdy grupa może przeglądać logi): każda utworzona, edytowana, odnowiona, włączona / wyłączona lub usunięta linia lub urządzenie, każdy utworzony sub-reseller i każdy transfer kredytów — wraz z pobranymi kredytami. Widzisz tylko własne wpisy i wpisy kont poniżej; logu nie można usunąć (tylko admin). Księga kredytów (CRD) pozostaje miejscem do uzgodnienia salda.

Przedpłacona jednostka panelu. Każda sprzedaż (utworzenie linii, odnowienie, tworzenie kodów aktywacyjnych, tworzenie sub-resellera) pobiera kredyty zgodnie z ceną pakietu lub opłatą grupy. Kredyt nie jest pieniądzem, a panel go nie przelicza: ile wart jest jeden kredyt, ustalasz z kontem nad sobą.

Kredyty płyną z góry na dół: admin przekazuje kredyty resellerowi, reseller przelewa je sub-resellerowi. Płatność na rzecz konta nad Tobą odbywa się poza panelem.

Zawsze kredyty konta, które wykonuje akcję, nawet jeśli linia jest przypisana do sub-resellera poniżej.

Strona Credits: jeden wiersz na każdy ruch, z datą, kwotą, saldem po operacji, powodem i osobą, która go wykonała. To jest księga — wiarygodne źródło Twojego salda.

Cała akcja jest odrzucana: żadna linia nie jest tworzona i nic nie jest pobierane. Saldo nigdy nie spada poniżej zera.

Nie. Każde żądanie sprzedaży niesie identyfikator żądania (request_id); ponowne wysłanie tego samego identyfikatora zwraca wcześniejszy wynik. Utworzenie linii i pobranie kredytów zawsze udają się razem albo są razem anulowane.

Nie. Usunięcie linii niczego nie zwraca, nawet jeśli zostało jej dużo czasu. Jedyny wyjątek: usunięcie niewykorzystanego kodu aktywacyjnego utworzonego przez resellera jest zwracane (CODE-08).

Tak: w formularzu edycji sub-resellera wpisz liczbę ujemną w polu transferu kredytów. Żadne saldo nie może spaść poniżej 0.

Selektor pakietu w formularzu linii pokazuje Twoją własną cenę. Przez API akcja pricing zwraca Twoje saldo, cenę każdego pakietu i to, na ile Cię stać.

Bukiet to lista treści (kanały, filmy, seriale). Pakiet to produkt, który sprzedajesz: jeden lub więcej bukietów, czas trwania, liczba połączeń, formaty wyjściowe, blokady i cena w kredytach (cena oficjalna i cena próbna).

Pakiet mogą sprzedawać tylko grupy wybrane przez admina. Pakiet nieprzeznaczony dla Twojej grupy nie pojawia się w selektorze i jest odrzucany, gdy zostanie wysłany przez API.

Admin może ustawić własną cenę dla każdego resellera i każdego pakietu (0 = za darmo). Własna cena dotyczy tworzenia oficjalnej linii, odnawiania i oficjalnych kodów aktywacyjnych; nie dotyczy okresów próbnych.

Nie. Bukiety są kopiowane do linii w chwili sprzedaży; późniejsza edycja pakietu nie wpływa na linie już sprzedane. Linia otrzymuje nowe bukiety pakietu przy następnym odnowieniu / zmianie pakietu. (Gdy zmienia się treść wewnątrz bukietu, każda linia z tym bukietem widzi to od razu. Usunięcie bukietu usuwa jego identyfikator z każdej linii i pakietu. Zmiana globalnej kolejności bukietów zmienia kolejność zapisaną na sprzedanych liniach tylko wtedy, gdy zaznaczysz pole „apply to sold lines and packages”; zestaw bukietów linii się nie zmienia.)

Tylko gdy Twoja grupa ma włączone Allow Bouquet Selection: zaznaczasz część bukietów pakietu; nic nie zaznaczone = cały pakiet; bukiety spoza pakietu są odrzucane. Cena się nie zmienia.

Data wygaśnięcia (dziś + czas trwania pakietu), liczba połączeń, formaty wyjściowe, restreamer, blokada urządzenia, wymuszony kraj, wymuszony serwer, blokada ISP, bukiety. Wartości wpisane przez resellera w tych polach są ignorowane, z wyjątkiem bukietów (PKG-05) i blokady ISP, gdy grupa ma włączone Allow Line Restrictions.

Pakiet, który można sprzedać tylko dla danego rodzaju dekodera; nie można go sprzedać dla zwykłej linii ani dla drugiego typu urządzenia. I odwrotnie: pakiet musi dopuszczać dany typ urządzenia, zanim będzie można go użyć w formularzu Add MAG / Add Enigma.

Musisz wybrać pakiet, który Twoja grupa może sprzedawać, i mieć dość kredytów. Nazwa użytkownika / hasło: wpisz własne (gdy grupa na to pozwala) lub zostaw puste, aby zostały wygenerowane. Admin może też zostawić jedno z nich (lub oba) puste przy tworzeniu linii: system wygeneruje 10 znaków i pokaże je zaraz po zapisaniu; formularz edycji nadal wymaga nazwy użytkownika.

Twoja grupa ma wyłączone Allow Username Change / Allow Password Change: nowa linia dostaje wartości wygenerowane. Gdy możesz wpisać własne, minimalną długość określa grupa (domyślnie 8 znaków).

W formularzu edycji linii oraz w oknie Generate play link na liście Lines. Hasła linii są przechowywane w postaci czytelnej, ponieważ potrzebują ich aplikacje IPTV i linki do playlist. Wygenerowane hasło jest pokazywane zaraz po zapisaniu.

Niektóre linie utworzone przez wcześniejszą wersję panelu mają tylko hasło w postaci skrótu. Taka linia nie może się zalogować, a panel nie pokazuje jej hasła. Ustaw nowe hasło w formularzu edycji linii i prześlij je klientowi.

Włączanie / wyłączanie, notatki resellera, kontakt, szablon kategorii, właściciela (w obrębie własnego drzewa); nazwę użytkownika i hasło, gdy grupa na to pozwala; ograniczenia (IP, user agenty, blokada ISP), gdy grupa ma włączone Allow Line Restrictions; nowy wybór bukietów w obrębie pakietu, gdy grupa na to pozwala. Pakietu, daty wygaśnięcia, liczby połączeń, flagi okresu próbnego, formatów wyjściowych, blokady urządzenia i kraju nie można edytować bezpośrednio — zmieniają się tylko przez odnowienie / zmianę pakietu.

Dwa sposoby, jedna zasada:

• przycisk Renew (charged) na liście: używa bieżącego pakietu linii;
• pole Extend with package w formularzu edycji: wybierz dowolny pakiet, który możesz sprzedawać (tak też zmieniasz pakiet).

Gdy edytujesz linię i w tym samym zapisie wybierzesz odnowienie, oba są jedną transakcją: jeśli odnowienie zostanie odrzucone (za mało kredytów, pakiet nie do sprzedaży), edycja również nie zostanie zapisana i żadne kredyty nie zostaną pobrane. Popraw i zapisz ponownie.

• Linia nie wygasła i nowy pakiet jest zgodny ze starym → czas jest dodawany do bieżącej daty wygaśnięcia.
• Linia wygasła lub oba pakiety nie są zgodne → liczone od dziś; pozostały czas nie jest zachowywany.

„Zgodność” jest sprawdzana tylko wtedy, gdy nowy pakiet ma włączoną opcję sprawdzania zgodności: oba pakiety muszą mieć te same bukiety, formaty wyjściowe, liczbę połączeń, flagę restreamera i blokadę urządzenia. Przy wyłączonej opcji zawsze są uznawane za zgodne. Nowe pakiety mają tę opcję domyślnie włączoną (admin może ją wyłączyć); istniejące pakiety zachowują swoje ustawienie. Linię MAG / Enigma można odnowić tylko pakietem dopuszczającym ten rodzaj dekodera lub zmienić na taki pakiet.

Zmiana pakietu = zakup jednego oficjalnego okresu nowego pakietu: pobierana jest pełna cena nowego pakietu (Twoja własna cena, jeśli ją masz), bez rozliczenia niewykorzystanej części. Linia przyjmuje wszystkie właściwości nowego pakietu.

Wyłączenie (Disable): klient nie może się zalogować ani oglądać, trwające sesje są zamykane w ciągu około minuty; okres subskrypcji nadal biegnie; możesz ją włączyć ponownie w dowolnym momencie. Usunięcie (Delete): trwałe, bez przywracania, bez zwrotu (DATA-01). Dla klienta, który robi przerwę, wyłącz — nie usuwaj.

Klient jest odrzucany do czasu odnowienia linii (linia jednocześnie wygasła i zbanowana widzi klip „wygasła”, bo wygaśnięcie jest sprawdzane najpierw); trwające sesje są zamykane w ciągu około minuty. Linia nie jest usuwana automatycznie: odnów ją, a będzie działać ponownie z tą samą nazwą użytkownika / hasłem.

Tak: wybierz jako właściciela konto poniżej siebie. Właściciel widzi linię na swojej liście. Kredyty nadal są pobierane od tego, kto naciśnie zapisz.

Własne i każdego konta poniżej Ciebie. Linia spoza Twojego drzewa dla Ciebie nie istnieje (odpowiedź to „nie znaleziono”).

Abyś pamiętał, kim jest klient (e-mail, numer telefonu, numer zamówienia). Subskrybent nigdy ich nie widzi. Są trwale usuwane razem z linią.

Gdy grupa ma uprawnienie: Logs → Line Activity pokazuje historię oglądania każdej linii, a Logs → Live Connections pokazuje każde otwarte połączenie linii w Twoim drzewie (która linia, który kanał, z jakiego adresu) z przyciskiem zamknięcia. Live Connections otwiera się tylko wtedy, gdy admin włączył dla Twojej grupy opcję przeglądania historii połączeń klientów (pole client connection logs w formularzu grupy); nigdy nie widzisz połączeń linii spoza Twojego drzewa.

Linia należąca do kodu aktywacyjnego jest domyślnie ukryta na liście, dopóki nie przefiltrujesz po niej (CODE-02).

Tak. Pole Expires on w formularzu linii to data i godzina w strefie czasowej panelu, więc linia może wygasnąć o określonej godzinie. Otwarcie formularza i zapis bez dotykania tego pola zachowuje wygaśnięcie co do sekundy — edycja notatki lub bukietów nie daje godzinowej linii próbnej dodatkowego czasu. Wartość, której nie da się odczytać, jest zgłaszana przy samym polu i nigdy nie zamienia się w „nigdy nie wygasa”. Strona edycji zbiorczej nadal przyjmuje datę, odczytywaną jako koniec tego dnia.

Gdy spełnione jest wszystko poniższe: admin nie wyłączył okresów próbnych dla resellerów; pakiet ma okres próbny; Twoja grupa ma Allowed Trials > 0; Twoje kredyty są ≥ Minimum Trial Credits grupy; a liczba linii próbnych utworzonych w oknie liczenia nie osiągnęła limitu.

Zgodnie z ustawieniem grupy: dzień = ostatnie 24 godziny, miesiąc = ostatnie 30 dni. Przykład, limit 5 / dzień: najwyżej 5 linii próbnych w dowolnych 24 godzinach. Starszy okres próbny zwalnia miejsce, gdy opuszcza okno.

Dokładnie cenę próbną pakietu (zwykle 0). Własna cena resellera nie dotyczy okresów próbnych.

Jeden z warunków z TRI-01 nie jest spełniony; formularz podaje powód obok pola.

Odnów linię pakietem: linia dostaje oficjalny okres i przestaje być próbna. Nazwa użytkownika i hasło pozostają bez zmian, klient nie musi niczego konfigurować od nowa.

Nie. Okres próbny jest przyznawany raz, przy tworzeniu linii; istniejącą linię można tylko odnowić oficjalnym okresem (TRI-05). Aby klient mógł spróbować ponownie, utwórz nową linię próbną (wlicza się do limitu okresów próbnych).

Lines → Generate play link: wybierz format; link jest budowany z nazwy użytkownika i hasła linii. Przez API get_line zwraca gotowe linki: m3u, m3u_hls, xmltv, player_api, web_player.

Z każdej aplikacji obsługującej Xtream Codes API (IPTV Smarters, TiviMate, XCIPTV, GSE…): wpisz adres serwera + nazwę użytkownika + hasło. Dla aplikacji przyjmującej tylko playlistę użyj linku M3U. Dekodery MAG używają portalu, dekodery Enigma2 — playlisty / wtyczki. Bez żadnego urządzenia użyj odtwarzacza webowego w przeglądarce.

MPEG-TS: szybkie przełączanie kanałów, pasuje do aplikacji IPTV i dekoderów. HLS: dobrze działa w przeglądarkach, na urządzeniach Apple i w niestabilnych sieciach. Linia może używać tylko formatów dozwolonych przez jej pakiet; link w niedozwolonym formacie jest odrzucany.

m3u_plus (z logo, grupami, identyfikatorami EPG — zalecany domyślny), zwykły m3u, typy dla Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive oraz proste typy list. Wybierz jeden w oknie Generate play link.

Aplikacje Xtream pobierają go same. Dla aplikacji M3U użyj linku XMLTV linii (playlista m3u_plus zawiera już adres EPG).

Tak, na kanałach, dla których admin włączył archiwizację; aplikacje pokazują na nich ikonę catch-up.

Pod adresem /player/ na serwerze API (link web_player). Zaloguj się nazwą użytkownika / hasłem linii lub kodem aktywacyjnym.

Nie. Hasło jest częścią linku i jest zapisane w aplikacji; po zmianie hasła klient musi wpisać je ponownie / dostać nowy link. W ten sposób można też odciąć kogoś, kto używa linii bez pozwolenia.

Tak: ustaw Your own play address na stronie klucza API (lub akcją API set_play_base). Kierujesz DNS domeny na serwer API panelu, a operator musi skonfigurować swoją stronę; powiadom admina, zanim z tego skorzystasz. Adres dotyczy linków, które API zwraca Twojemu systemowi.

Technicznie dzielą jedną linię, więc dzielą jej liczbę połączeń (SEC-01) i mogą natrafić na regułę drugiego IP (SEC-03). Każdy klient powinien mieć własną linię.

Devices → Add MAG / Add Enigma: wpisz MAC, wybierz pakiet. System sprzedaje nową linię i podłącza urządzenie w jednym kroku; urządzenie loguje się po MAC, nikt nie musi wpisywać nazwy użytkownika / hasła. Kredyty są pobierane dokładnie tak jak dla zwykłej linii.

W formularzu urządzenia wybierz istniejącą linię klienta zamiast pakietu: urządzenie jest sparowane z tą linią, bezpłatnie. Klient nadal używa linii w aplikacji; dekoder podąża za pakietem, wygaśnięciem, bukietami i statusem linii.

Dzielą limit połączeń: aplikacja i dekoder to jeden subskrybent.

Odnów jego linię (link jest w formularzu urządzenia). Dla sparowanego urządzenia odnów linię klienta — dekoder podąży sam.

Edytuj MAC w urządzeniu. Jeśli linia ma włączoną blokadę urządzenia, wyczyść zapisany numer seryjny / identyfikator urządzenia, aby nowy dekoder mógł się zarejestrować.

Tak. Usunięcie urządzenia usuwa też jego linię (wraz z historią połączeń i oczekującymi zdarzeniami). Aby zachować opłaconą linię, użyj przycisku Convert to line: urządzenie zostaje usunięte, a linia staje się zwykłą linią. Gdy usuniesz linię klienta, sparowane urządzenie żyje dalej niezależnie, z własną linią.

Własnymi dekoderami MAG tak: wysłać wiadomość na telewizor, odtworzyć kanał, przeładować portal, zrestartować, zamknąć połączenia linii (grupa potrzebuje uprawnienia do przeglądania logów połączeń klientów), zresetować zapisany ISP i zresetować blokadę STB. Polecenia X-Plugin i zrzuty ekranu dekoderów Enigma, banowanie urządzenia i przenoszenie urządzenia na inną linię są tylko dla admina. Włączenie / wyłączenie urządzenia resellera włącza / wyłącza jego linię; reseller nie może zdjąć statusu Banned z urządzenia.

Sprzedaż dostępu w postaci kodu (zdrapka, kod wysłany wiadomością): klient wpisuje kod w aplikacji lub w odtwarzaczu webowym i może oglądać, bez nazwy użytkownika / hasła. Okres zaczyna biec dopiero, gdy klient po raz pierwszy aktywuje kod.

Active Codes → New: wybierz pakiet, ilość (1–500 na partię), długość kodu (6–24), opcję tylko cyfr (łatwo wpisać pilotem TV) i opcję okresu próbnego. Kredyty są pobierane przy tworzeniu = cena pakietu × liczba kodów. Każdy kod ma własną linię, zablokowaną do czasu aktywacji.

Wielkie litery i cyfry bez łatwych do pomylenia (0, O, 1, I) albo same cyfry. Klient wpisujący małe litery jest nadal akceptowany.

Na jednym. Kod jest powiązany z pierwszym urządzeniem, które go aktywuje; inne urządzenie wpisujące ten sam kod jest odrzucane. To urządzenie może wpisywać kod tyle razy, ile chce, dane logowania linii się nie zmieniają.

Reset device na tym kodzie; nowe urządzenie może go wtedy aktywować. Do okresu nie jest dodawany żaden czas.

Wpisanie kilku różnych błędnych kodów z rzędu powoduje zablokowanie adresu IP na pewien czas (SEC-08).

Na stronie Active Codes zaznacz kod, wybierz akcję Extend (days) i wpisz liczbę dni. Dni są dodawane tylko do kodu aktywowanego (niewykorzystany kod nie rozpoczął jeszcze okresu); kod nadal ważny jest przedłużany od bieżącej daty wygaśnięcia, wygasły — od teraz. Ta akcja nie pobiera kredytów, więc może z niej korzystać tylko administrator: sprzedawca odnawia linię kodu jak każdą linię, z pakietem i jego ceną (Lines → Renew albo renew_line w Reseller API). Błędne obciążenie naprawia wsparcie korektą kredytów, nigdy darmowym przedłużeniem. Admin API: extend_active_code.

Niewykorzystany kod utworzony przez resellera: zwracany w całości, z wierszem w księdze kredytów. Kod aktywowany: bez zwrotu.

Strona Batches pokazuje dla każdej partii liczby: łącznie / gotowe / aktywowane / wyłączone, i eksportuje plik TXT (jeden kod w wierszu). Akcje zbiorcze: włącz, wyłącz, resetuj urządzenie, usuń.

Tak, jak każda linia sprzedana z tym pakietem: liczba połączeń, formaty wyjściowe, bukiety, blokada urządzenia, restreamer, a także wymuszony kraj pakietu (SEC-07). Klient, który aktywuje kod z kraju spoza dozwolonej listy, może go aktywować, ale zostanie odrzucony przy odtwarzaniu.

To liczba urządzeń oglądających jednocześnie na jednej linii. 0 = bez limitu. Ponowne otwarcie kanału, który już oglądasz, z tego samego urządzenia nie liczy się jako kolejne połączenie.

Domyślnie: nowe połączenie wchodzi, a najstarsze jest zamykane (z preferencją połączenia z tego samego urządzenia, potem z tego samego IP). Zamknięty odtwarzacz zatrzymuje się w ciągu około 30 sekund. Admin może przełączyć na odrzucanie nowego połączenia zamiast zamykania starego.

Gdy admin ją włączy: dopóki linia jest oglądana z jednego IP, połączenie na żywo z innego IP jest odrzucane. Regułę można ograniczyć do linii z małą liczbą połączeń (na przykład linie z 1 połączeniem; linia z nielimitowanymi połączeniami jest wiązana tylko wtedy, gdy próg wynosi 0). Przy włączonym Match The Address By Network adresy tej samej sieci /24 (IPv6: /64) liczą się jako jeden widz. To narzędzie przeciw współdzieleniu konta.

Gdy grupa ma włączone Allow Line Restrictions: pole Allowed IPs (IP, zakres CIDR lub nazwa domeny, po jednym w wierszu; domena jest sprawdzana w chwili połączenia, więc dynamiczne IP nadal działa) oraz Allowed User-Agents. Puste = wszystko dozwolone. Uwaga: te ograniczenia blokują przy odtwarzaniu; aplikacja nadal się loguje i pokazuje listę kanałów.

Linia zapamiętuje dostawcę internetu z pierwszego połączenia i odrzuca użycie od innego dostawcy. Gdy klient zmieni dostawcę, wyłącz i włącz ponownie blokadę ISP, aby zapisać nowego. Nie dotyczy dekoderów MAG.

Wiąże linię z pierwszym dekoderem, który się zaloguje (numer seryjny, identyfikator urządzenia); inny dekoder jest odrzucany. Decyduje o niej pakiet.

Linia może łączyć się tylko ze swojego wymuszonego kraju (ALL = z dowolnego miejsca). Gdy jest puste, obowiązuje ogólna lista dozwolonych krajów panelu. Klient podróżujący za granicą lub używający VPN może zostać z tego powodu odrzucony.

• Automatycznie: nieudane logowania z jednego IP z wieloma różnymi nazwami użytkowników / kodami aktywacyjnymi w krótkim czasie lub zalew żądań. Blokada automatyczna sama się zdejmuje po czasie skonfigurowanym przez admina (domyślnie 60 minut).
• Ręcznie: admin zablokował IP / zakres IP; to nie wygasa.

Gdy IP jest zablokowany, żadna linia nie może się z niego połączyć. Wielokrotna pomyłka w tej samej nazwie użytkownika nie powoduje blokady.

Admin może blokować po User-Agent (aplikacji), po dostawcy internetu (ISP) i po ASN (na przykład zakresy hostingowe / VPN). Linia, dla której admin włączył „bypass UA”, pomija listę blokad aplikacji.

Linia dla partnera, który pobiera strumienie, aby je redystrybuować. Jest zwolniona z limitu połączeń, reguły drugiego IP, automatycznego kończenia długich sesji i blokady ASN. Decyduje o niej pakiet / admin; nie jest przeznaczona dla zwykłych widzów.

Admin może ustawić maksymalny czas ciągłej sesji; po jego przekroczeniu sesja jest zamykana, a klient naciska play, aby kontynuować. Sesja, która traci sygnał na około 90 sekund, również liczy się jako zamknięta.

• Strona Theft Detection (gdy grupa ma uprawnienie): szereguje linie według liczby różnych filmów / odcinków obejrzanych w 1 godzinę / 24 godziny / 7 dni, z liczbą różnych IP — nietypowo wysoka linia jest podejrzana.
• Strona aktywności linii: pokazuje używane IP i urządzenia.
• Co zrobić: zmień hasło linii (PLAY-08), włącz ograniczenie IP / blokadę ISP lub wyłącz linię.

Gdy Twoja grupa ma włączone Can Create Sub-Resellers i co najmniej jedną grupę w Groups for sub-resellers. Każde utworzenie pobiera opłatę za utworzenie (kredyty) ustawioną w grupie. Drzewo resellerów ma najwyżej 5 poziomów.

Wybierasz grupę z listy dozwolonej przez admina; ta grupa decyduje o uprawnieniach sub-resellera, pakietach do sprzedaży i limicie okresów próbnych.

E-mail, imię i nazwisko, hasło, status, grupa (z listy), notatki, przekazywanie / odbieranie kredytów oraz wszystkie linie poniżej. Nie możesz zmienić jego roli ani właściciela.

Nic: każde konto widzi tylko to, co jest poniżej, nigdy poziomów wyżej ani innych gałęzi.

Grupa musi mieć włączone Can Delete Users. Pozostałe kredyty, linie i konta podrzędne przechodzą na konto, które usuwa. Linie klientów nadal działają. Dane osobowe usuniętego konta (nazwa użytkownika, e-mail, imię i nazwisko, hasło, klucze API, notatki) są kasowane; tej nazwy użytkownika i e-maila można użyć ponownie.

Gdy admin włączył e-mail powitalny: nowe konto otrzymuje swoją nazwę logowania i link do logowania. E-mail nigdy nie zawiera hasła — hasło przesyłasz mu sam.

Do zmiany kolejności, nazw lub ukrywania kategorii (na żywo, filmy, seriale, radio), które klient widzi w aplikacji — per linia, bez dotykania własnych kategorii panelu.

Cała treść tej kategorii jest również ukrywana w aplikacji i playliście linii używających szablonu.

Tak, od razu dla każdej linii, do której szablon jest przypisany. Po usunięciu szablonu jego linie wracają do układu domyślnego.

Widzieć: własne i kont poniżej, szablony systemowe oraz szablony udostępnione przez wyższe poziomy. Edytować: tylko własne i poniżej. Aby dostosować szablon systemowy, zduplikuj go i edytuj kopię.

Własna kolejność kategorii nie dotyczy części filmowej / serialowej playlisty M3U (nazwy i ukrywanie nadal obowiązują). Aplikacje używające Xtream API dostają wszystko.

Dla Twojego własnego systemu (sklep internetowy, rozliczenia, bot), aby sprzedawać i zarządzać liniami / sub-resellerami bez otwierania dashboardu. Adres: {API}/reseller/v1, uwierzytelnianie nagłówkiem X-API-Key. Pełna dokumentacja jest pod /docs/ na serwerze API.

Strona API Key. Klucz jest pokazywany raz, przy tworzeniu — skopiuj go od razu. Jeśli go zgubisz, utwórz nowy klucz (stary przestaje działać).

Lepiej nie. Utwórz dodatkowy klucz dla każdego systemu: nadaj mu nazwę, ogranicz IP / CIDR, które mogą go używać, opcjonalnie ustaw go jako tylko do odczytu (tylko listy i podgląd) i unieważniaj go osobno, bez wpływu na pozostałe klucze.

Każda reguła dashboardu (grupa, własna cena, limit okresów próbnych, zakres drzewa) obowiązuje przez API dokładnie tak samo.

Nie, o ile wyślesz ten sam request_id dla tej samej transakcji: system zwróci wcześniejszy wynik. request_id odnowienia jest związany z tą linią: użycie go dla innej linii zwraca błąd konfliktu (HTTP 409), a druga linia się nie zmienia — generuj nowy request_id dla każdej transakcji.

Strona API Key ma tabelę ostatnich wywołań API (30 dni): akcja, wynik, kod błędu, adres wywołujący, nazwa konektora. Parametry nigdy nie są zapisywane.

Panel powiadamia Twój system, gdy coś się dzieje, więc nie musisz ciągle pytać. Zdarzenia: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring (3 dni wcześniej), line.expired, credits.low (poniżej ustawionego progu). Adres odbiorcy musi być https i osiągalny z internetu.

Każde powiadomienie niesie podpis X-Xtream-Signature: sha256=HMAC(secret, timestamp.body); sekret jest pokazywany raz, przy tworzeniu endpointu. Webhook nigdy nie zawiera hasła.

Każde powiadomienie jest próbowane 3 razy; endpoint, który zawiedzie w 20 dostarczeniach z rzędu, jest wyłączany. Napraw swoją stronę, użyj Send test, a następnie utwórz endpoint ponownie, jeśli został wyłączony.

Tak, ale tylko właścicielowi linii (Tobie i poziomom nad Tobą w drzewie). Nie przechowuj haseł linii w logach ani nie wysyłaj ich niezabezpieczonym kanałem.

Tak, gdy wyślesz razem z nią package_id (stara nazwa package też jest akceptowana): oprócz edycji akcja sprzedaje jeden oficjalny okres tego pakietu dokładnie jak change_package — ta sama cena, ten sam request_id, a odpowiedź zawiera credits_charged. Edycja i odnowienie to jedna transakcja: gdy zostanie odrzucona (za mało kredytów, nieprawidłowy pakiet, wysłany trial), nic się nie zmienia. edit_line bez pakietu edytuje tylko nazwę użytkownika, hasło, kontakt i notatki i nie dotyka pakietu ani daty wygaśnięcia.

Nie bez zmian. API zachowuje znajome nazwy akcji, ale jest nowym interfejsem: adres /reseller/v1, klucz API utworzony w tym panelu, akcje zapisu wysyłane przez POST, błędy zwracane jako status HTTP z polem error oraz wynik utworzenia linii w data.line. Użyj dokumentacji pod /docs/ lub gotowego konektora (CON-02).

Za pomocą własnego systemu i bramki płatności. Panel nie obsługuje płatności. Konektor łączy Twój system sklepowy z panelem: klient płaci po Twojej stronie → konektor wywołuje Reseller API, aby utworzyć / odnowić linię.

WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress (WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext oraz „webhook bridge” dla Shopify, Upmind i Invoice Ninja.

W panelu: pasek boczny Zasoby → Wszystkie konektory — każdy konektor z danymi połączenia, krokami instalacji, przyciskiem Pobierz i sumą SHA-256 pliku do weryfikacji.

Te same konektory, z krokami instalacji i sumami kontrolnymi, są opublikowane pod adresem https://plugins.xtream-ui.pro; kod źródłowy jest pod https://github.com/xtreamui-pro/plugins.

Różnie dla każdego konektora, co jest napisane na jego stronie: niektóre działały w prawdziwej platformie (na przykład WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), inne miały przetestowane tylko rdzeń. Przeczytaj wiersz „how it was tested” i wypróbuj w środowisku testowym, zanim zaczniesz sprzedawać naprawdę.

Konektor tylko wywołuje Reseller API z Twoim kluczem API — może robić dokładnie to, co Ty, nic więcej. Kod źródłowy jest otwarty, możesz go przeczytać i sprawdzić. Daj każdemu konektorowi własny klucz z ograniczeniem IP (API-03).

Linie (tworzenie, odnawianie, zmiana pakietu, zawieszanie, usuwanie) oraz konta sub-resellerów z kredytami.

Zintegruj ją samodzielnie przez Reseller API (API-01) i webhooki albo wyślij prośbę kanałem pomocy.

Nie. Usunięte znaczy zniknęło: dane linii (nazwa użytkownika, hasło, kontakt, notatki), historia połączeń (IP, urządzenia, co oglądano), dekodery przypisane do linii i jej kod aktywacyjny. Nie ma kosza ani funkcji przywracania, ani API do tego. Gdy klient wróci, utwórz nową linię.

Tylko anonimowy rekord statystyczny dla operatora (nowy czy powracający klient, jakie pakiety są popularne). Nie zawiera nic czytelnego o kliencie i żaden reseller, konektor ani API nie może do niego sięgnąć.

Nie. Kopie zapasowe bazy danych służą tylko do odbudowy systemu po awarii i są w rękach operatora; nie służą do cofania usunięcia. Stare kopie są rotowane, więc usunięte dane znikają również z nich.

Hasło linii trzeba wpisać w aplikacjach i jest częścią linku do playlisty, więc panel przechowuje je w postaci czytelnej dla właściciela linii. Hasła kont panelu są przechowywane wyłącznie w postaci skrótu.

Ty, konta nad Tobą w Twoim drzewie i admin. Inni resellerzy i poziomy poniżej Ciebie nie.

Nigdy. Klienci linii należą do resellera; kontaktujesz się z nimi przez własny system.

Na dwa sposoby: codzienny e-mail z podsumowaniem linii bliskich wygaśnięcia (gdy admin go włączył; domyślnie 3 dni wcześniej) oraz webhooki line.expiring / line.expired dla Twojego systemu.

Zwykle to jedna z blokad odtwarzania (wiersze 5–9 w FIX-01): logowanie i lista kanałów nie sprawdzają IP / aplikacji, tylko odtwarzanie. Jeśli zawodzi tylko jeden kanał na każdej linii → problem jest w kanale źródłowym; podaj adminowi nazwę kanału i godzinę.

Sprawdź bukiety linii (PKG-04, PKG-05) i przypisany jej szablon kategorii (CAT-02). Po zmianie poproś klienta o przeładowanie listy w aplikacji. Kanał dopiero co dodany przez admina pojawia się po około pół minuty; jeśli kanał jest w bukiecie, a żadna linia go nie widzi, admin mógł zdjąć ten kanał z emisji.

Spróbuj po kolei: inny kanał (jeden kanał czy wszystkie?) → inna sieć → inny format (HLS zamiast MPEG-TS) → inna aplikacja. Każdy kanał zawodzi w każdej sieci → podaj pomocy nazwę użytkownika, godzinę i kanał.

Aplikacja M3U wymaga dodania linku XMLTV (PLAY-05). Kanał bez EPG u źródła nie pokazuje ramówki.

Po kolei: nie wybrano pakietu · pakiet nie jest dla Twojej grupy (PKG-02) · za mało kredytów (CRD-05) · nazwa użytkownika jest zajęta lub krótsza niż minimum (LINE-02) · limit okresów próbnych został wykorzystany (TRI-01).

429: linia pobiera naraz zbyt wiele playlist / plików EPG — poczekaj i spróbuj ponownie. Strona 404: system odpowiada 404 na każde odrzucenie (złe dane, wygaśnięcie, blokada, przekroczenie limitu), aby nie zdradzać powodu obcym; sprawdź według FIX-01.

Twoja grupa nie ma uprawnień do tej strony (ACC-02). Live Connections wymaga dodatkowo, by admin włączył dla grupy opcję przeglądania połączeń klientów (LINE-15).

E-mail jest wysyłany tylko wtedy, gdy admin skonfigurował serwer pocztowy i włączył dany rodzaj wiadomości; konto musi mieć prawdziwy adres e-mail. Sprawdź folder ze spamem.