Serwer Xtream: instalacja Xtream UI na Ubuntu

Czym właściwie jest serwer Xtream

Serwer Xtream to maszyna z Linuksem, na której działa panel zarządzania IPTV posługujący się API Xtream Codes. Panel wykonuje trzy zadania: przyjmuje strumienie na żywo i źródła wideo, zarządza liniami (kontami użytkowników z nazwą, hasłem, datą wygaśnięcia i limitem połączeń) oraz udostępnia wszystko z powrotem po HTTP przez kilka dobrze znanych punktów końcowych (player_api.php dla metadanych, get.php dla playlist M3U, xmltv.php dla danych EPG). Ponieważ niemal każda aplikacja kliencka IPTV obsługuje to API, „serwer Xtream” stał się skrótowym określeniem każdego panelu, który je udostępnia, niezależnie od tego, jakie oprogramowanie działa pod spodem.

Jedno zdanie o zakresie przed częścią techniczną: ten przewodnik dotyczy wyłącznie infrastruktury i administracji panelem, a operator odpowiada za posiadanie praw do transmisji każdego strumienia rozprowadzanego przez panel. Jeśli te pojęcia są dla Ciebie nowe, zacznij od naszego wprowadzenia do tego, jak IPTV działa na poziomie protokołu. Terminologia panelu stanie się wtedy znacznie bardziej zrozumiała.

Od Xtream Codes do Xtream UI i XUI.one

Xtream Codes był komercyjnym panelem, który zdefiniował całą kategorię. W sierpniu i wrześniu 2019 roku operacja organów śledczych koordynowana przez włoskie służby i Europol zajęła infrastrukturę firmy, a oprogramowanie nigdy więcej nie było sprzedawane ani aktualizowane. API po stronie klienta było już jednak standardem branżowym, więc ekosystem przetrwał samą firmę.

Lukę wypełniły dwa projekty. Xtream UI to darmowy fork społecznościowy zbudowany na ostatniej publicznej wersji kodu 2.9; utrzymywał panel przy życiu przez lata, ale jego publiczny rozwój praktycznie stanął. XUI.one to komercyjny panel o zamkniętym kodzie, napisany przez byłego dewelopera Xtream UI, i faktycznie utrzymywany następca. Oba zachowują to samo API, ten sam model linii i te same domyślne porty, dlatego instrukcje instalacji jednego w większości pasują do drugiego. I dlatego ten artykuł nie zakłada konkretnego forka.

Wymagania serwera: CPU, RAM i pasmo

Każdy fork wymaga świeżej, minimalnej instalacji Ubuntu LTS, a większość celuje w jedno konkretne wydanie, więc sprawdź dokumentację forka przed zamówieniem serwera, bo instalacja na niewłaściwej wersji Ubuntu to najczęstsza przyczyna nieudanego wdrożenia. Instalator rozpakowuje własne, dołączone nginx, PHP i MariaDB w katalogu /home/xtreamcodes/, więc nigdy nie umieszczaj go na maszynie, na której już działa stos webowy albo panel hostingowy: będą walczyć o porty i pakiety.

Dobór zasobów sprowadza się do jednego pytania: robisz restreaming (przekazujesz strumienie bez zmian) czy transkodowanie (przekodowujesz je z użyciem ffmpeg)? Restreaming niemal nie obciąża procesora: serwer głównie kopiuje bajty między socketami. Transkodowanie programowe kosztuje około jednego nowoczesnego rdzenia na kanał 1080p, i właśnie tam budżety wybuchają. Jeśli chodzi o RAM, 4 GB wystarczą na mały panel testowy; 8 GB lub więcej ma sens na produkcji, gdy nakładają się cache MariaDB i kilka procesów ffmpeg. Bazę danych trzymaj na dyskach SSD.

Pasmo to czysta arytmetyka: szczytowa liczba jednoczesnych widzów pomnożona przez bitrate strumienia, plus zapas. Żadne ustawienie panelu tego rachunku nie zmieni.

Te liczby zakładają wyłącznie restreaming i typowy bitrate 8 Mbps dla 1080p; transkodowanie mnoży kolumnę CPU, a nie kolumnę pasma. Stała przepustowość liczy się znacznie bardziej niż reklamowana prędkość portu, więc testuj pod realnym obciążeniem. Jeśli wolisz pominąć te obliczenia, nasze serwery przygotowane pod obciążenia streamingowe są wymiarowane dokładnie pod taki tryb stałej przepustowości.

Instalacja panelu w stylu Xtream UI na Ubuntu

Każdy fork dostarcza własny instalator, ale wszystkie mają ten sam trzyetapowy schemat. Poniższe komendy są celowo ogólne: pobieraj instalator wyłącznie z oficjalnej strony wydań swojego forka, nigdy z losowego re-uploadu, i przeczytaj skrypt przed uruchomieniem go jako root.

Krok 1: Przygotuj czysty system

apt update && apt upgrade -y
apt install -y wget unzip python3 net-tools
timedatectl set-timezone UTC

Zrestartuj serwer, jeśli zainstalowano nowy kernel, i świadomie ustaw strefę czasową. Harmonogram EPG zależy od zegara systemowego, a jego rozjechanie daje przewodniki programowe przesunięte o godziny.

Krok 2: Uruchom instalator forka

cd /root
wget "$INSTALLER_URL" -O install.py   # from your fork's official release page
python3 install.py

Skrypt instaluje dołączony stos, tworzy bazę danych (Xtream UI uruchamia na przykład własną instancję MariaDB na 127.0.0.1:7999 z bazą o nazwie xtream_iptvpro) i po zakończeniu wypisuje adres panelu, port oraz dane logowania. Zapisz je natychmiast: niektóre forki generują losową ścieżkę lub port panelu i nie pokażą ich po raz drugi.

Krok 3: Pierwsze logowanie i podstawowa weryfikacja

Otwórz w przeglądarce http://your-server-ip:25500, zaloguj się wygenerowanymi danymi i przede wszystkim zmień hasło administratora. Następnie potwierdź, że usługi faktycznie nasłuchują:

ss -tlnp | grep -E '25500|25461'

Powinieneś zobaczyć dołączony do panelu nginx przypisany do obu portów. Dalsza praca po stronie panelu (zdefiniowanie serwera głównego, utworzenie kategorii i linii testowej) odbywa się w całości w interfejsie webowym.

Porty, reverse proxy i TLS

Domyślne wartości odziedziczone po Xtream Codes to 25500 dla panelu administracyjnego i 25461 dla wyjścia HTTP kierowanego do klientów, czyli portu, z którym linie łączą się po playlisty i strumienie. Otwórz tylko to, co potrzebne, a resztę zablokuj na firewallu; jeśli Twoje administracyjne IP jest stałe, ogranicz do niego port panelu:

ufw allow 22/tcp
ufw allow 25461/tcp
ufw allow from YOUR_ADMIN_IP to any port 25500 proto tcp
ufw enable

Następnie sprawdź, co widzi świat zewnętrzny: nasz przewodnik po sprawdzaniu otwartych portów w Linuksie omawia ss, nmap oraz różnicę między nasłuchiwaniem a osiągalnością.

Wielu operatorów stawia nginx lub HAProxy przed portem klienckim na 80, 443 albo 8080, bo część sieci wprost blokuje niestandardowe porty; proxy może też terminować TLS dla panelu administracyjnego. Jedno uczciwe zastrzeżenie: wiele starszych dekoderów i aplikacji IPTV nadal działa lepiej po zwykłym HTTP, więc przetestuj swój realny zestaw klientów przed wymuszeniem HTTPS na porcie streamingowym. I nie myl tego z bezpieczeństwem: przeniesienie panelu na nietypowy port jedynie zmniejsza szum skanerów w logach. Prawdziwe hartowanie to ścisły firewall, silne unikalne hasła, TLS na interfejsie administracyjnym i aktualny system operacyjny.

Kopie zapasowe, monitoring i aktualizacje

Baza danych jest panelem: strumienie, linie, bukiety i konfiguracja EPG żyją w MariaDB. Zrzucaj ją codziennie i kopiuj zrzut poza serwer:

mysqldump -h 127.0.0.1 -P 7999 -u user_iptvpro -p xtream_iptvpro | gzip > /root/xtream-db-$(date +%F).sql.gz
tar czf /root/xtream-config-$(date +%F).tar.gz /home/xtreamcodes/iptv_xtream_codes/config

Do monitoringu pulpit panelu pokazuje już aktywne połączenia dla każdego strumienia; dodaj vnstat dla trendu pasma i htop, aby wychwycić rozbiegany proces ffmpeg. Duża liczba połączeń oznacza też tysiące otwartych socketów, więc sprawdź, czy instalator podniósł limity deskryptorów plików. Większość to robi przez zmiany w sysctl i limits.conf, ale zweryfikuj to. Na koniec podejdź realistycznie do oprogramowania, które uruchamiasz: forka, który nie dostaje już poprawek, należy traktować jak starą aplikację PHP wystawioną do internetu. Trzymaj go na dedykowanym serwerze, który nie robi nic innego, wystawiaj minimum i regularnie łataj system pod nim.

Nic z tego nie wymaga egzotycznego sprzętu. Wymaga czystej maszyny z Ubuntu LTS, dostępu root i sieci, która trzyma stabilny poziom, gdy sto socketów ciągnie po 8 Mbps przez cały wieczór. Właśnie do tego zbudowane są nasze plany Linux VPS: dedykowane CPU i RAM, nielimitowane pasmo (fair-use), pełny dostęp administracyjny bez KYC i dostawa około 10 sekund po potwierdzeniu płatności. Zamów, uruchom instalator i możesz być na ekranie logowania panelu w ciągu godziny.

Najczęściej zadawane pytania

Czy Xtream UI jest nadal rozwijane?

Publiczny rozwój Xtream UI praktycznie stanął; aktywnie utrzymywanym następcą jest XUI.one.

Darmowy fork Xtream UI miał ostatnie istotne publiczne wydania wiele lat temu, a jego pierwotne kanały społecznościowe zamilkły. Aktywny rozwój toczy się dziś w XUI.one, komercyjnym panelu o zamkniętym kodzie od byłego dewelopera Xtream UI. Jeśli i tak używasz Xtream UI, traktuj go jak stare oprogramowanie: trzymaj na dedykowanym serwerze za firewallem, ogranicz port administracyjny do znanych adresów IP i codziennie twórz kopię bazy danych, aby móc szybko migrować.

Czym różni się serwer Xtream od serwera Plex lub Jellyfin?

Plex i Jellyfin to prywatne serwery multimediów; panel Xtream to wielouzytkownikowe oprogramowanie do dystrybucji strumieni na żywo.

Plex i Jellyfin indeksują lokalną bibliotekę multimediów i przesyłają ją na Twoje własne urządzenia. Panel Xtream jest zbudowany wokół kanałów na żywo i zarządzania abonentami: przyjmuje strumienie, tworzy linie (konta użytkowników) z datami wygaśnięcia i limitami połączeń oraz udostępnia API Xtream Codes, którego oczekują aplikacje IPTV. Jeśli chcesz tylko odtwarzać własne pliki w domu, właściwym narzędziem jest Plex albo Jellyfin, a panel Xtream byłby zbędnym narzutem.

Ile pasma zużywa jeden strumień IPTV?

Około 2-4 Mbps dla SD, 5-10 Mbps dla 1080p i 15-25 Mbps dla 4K HEVC.

Zależy to od bitrate źródła, a nie od panelu: kanały SD zwykle mają 2-4 Mbps, 1080p około 5-10 Mbps, a 4K HEVC 15-25 Mbps. Pomnóż bitrate przez szczytową liczbę jednoczesnych widzów, aby wymiarować uplink: 100 widzów na kanałach 8 Mbps potrzebuje około 800 Mbps stałego uploadu, plus zapas. Stała przepustowość liczy się bardziej niż reklamowana prędkość portu, więc przetestuj serwer pod realnym obciążeniem przed startem.

Czy mogę zainstalować panel Xtream na hostingu współdzielonym lub obok cPanel?

Nie, panel wymaga dedykowanego serwera z Linuksem, dostępu root i własnego dołączonego stosu webowego.

Instalatory paneli rozpakowują własne buildy nginx, PHP i MariaDB w katalogu /home/xtreamcodes/ i przypisują się do stałych portów, takich jak 25500 i 25461. Hosting współdzielony nie daje ani dostępu root, ani wolnych portów, a panele typu cPanel czy Plesk kolidują bezpośrednio z dołączonym stosem. Minimalną sensowną platformą jest czysty VPS lub serwer dedykowany z Ubuntu LTS, na którym nie działa nic innego.