Xtream Sunucu Kurulum Rehberi: Ubuntu'da Xtream UI

Xtream sunucusu gerçekte nedir

Xtream sunucusu, Xtream Codes API'sini konuşan bir IPTV yönetim paneli çalıştıran Linux makinesidir. Panel üç iş yapar: canlı yayınları ve video kaynaklarını alır, hatları (kullanıcı adı, şifre, bitiş tarihi ve bağlantı limiti olan kullanıcı hesaplarını) yönetir ve her şeyi bilinen birkaç uç nokta üzerinden HTTP ile geri sunar: metadata için player_api.php, M3U oynatma listeleri için get.php, EPG verisi için xmltv.php. Neredeyse her IPTV istemci uygulaması bu API'yi desteklediği için, altında hangi yazılım çalışıyor olursa olsun, bu API'yi sunan her panele kısaca \"Xtream sunucusu\" denir hale geldi.

Teknik kısımdan önce kapsamla ilgili tek bir cümle: bu rehber yalnızca altyapı ve panel yönetimini kapsar; panel üzerinden dağıtılan her yayının yayın haklarına sahip olmak operatörün sorumluluğundadır. Temel kavramlar size yeniyse, IPTV'nin protokol düzeyinde nasıl çalıştığına dair giriş yazımızla başlayın. Panelin terminolojisi ardından çok daha anlamlı gelecek.

Xtream Codes'tan Xtream UI ve XUI.one'a

Kategoriyi tanımlayan ticari panel Xtream Codes'tu. Eylül 2019'da İtalyan yetkililer ve Europol tarafından koordine edilen bir kolluk operasyonu şirketin altyapısına el koydu ve yazılım bir daha satılmadı veya güncellenmedi. Ancak istemci tarafındaki API zaten sektör standardı olmuştu, bu yüzden ekosistem şirketten uzun süre sonra da yaşamaya devam etti.

Boşluğu iki proje doldurdu. Xtream UI, son herkese açık 2.9 kod tabanı üzerine kurulu ücretsiz bir topluluk sürümüdür; paneli yıllarca ayakta tuttu ama herkese açık geliştirmesi büyük ölçüde durdu. XUI.one ise eski bir Xtream UI geliştiricisi tarafından yazılmış, kapalı kaynaklı ticari bir paneldir ve bugün fiilen bakımı sürdürülen ardıldır. İkisi de aynı API'yi, aynı hat modelini ve aynı varsayılan portları koruduğu için birine yazılan kurulum rehberleri çoğunlukla diğeri için de geçerlidir. Bu yazının da belirli bir sürüme bağlı kalmamasının nedeni budur.

Sunucu gereksinimleri: CPU, RAM ve bant genişliği

Her sürüm temiz ve minimal bir Ubuntu LTS kurulumu ister ve çoğu belirli bir sürümü hedefler. Sunucuyu sipariş etmeden önce ilgili sürümün dokümanlarını kontrol edin, çünkü yanlış Ubuntu sürümüne kurulum, bozuk kurulumların en yaygın nedenidir. Kurulum betiği kendi paketlediği nginx, PHP ve MariaDB'yi /home/xtreamcodes/ altına yerleştirir; bu yüzden hâlihazırda bir web yığını veya hosting kontrol paneli çalıştıran bir makineye asla kurmayın: portlar ve paketler için birbirleriyle çakışırlar.

Boyutlandırma tek bir soruya iner: yeniden yayın mı yapıyorsunuz (yayınları dokunmadan geçirmek) yoksa transcode mu (ffmpeg ile yeniden kodlamak)? Yeniden yayın CPU'yu neredeyse hiç yormaz: sunucu çoğunlukla soketler arasında bayt kopyalar. Yazılımsal transcode ise 1080p kanal başına kabaca bir modern çekirdeğe mal olur ve bütçeler tam burada patlar. RAM tarafında 4 GB küçük bir test paneli çalıştırır; MariaDB önbelleği ve birkaç ffmpeg süreci üst üste bindiğinde üretimde 8 GB veya üzeri mantıklıdır. Veritabanını SSD depolamada tutun.

Bant genişliği saf aritmetiktir: tepe eşzamanlı izleyici sayısı çarpı yayın bit hızı, artı emniyet payı. Hiçbir panel ayarı bu hesabı değiştirmez.

Bu değerler yalnızca yeniden yayını ve tipik 8 Mbps 1080p bit hızını varsayar; transcode CPU kolonunu çarpar, bant genişliği kolonunu değil. Reklam edilen port hızından çok sürekli gerçek verim önemlidir, bu yüzden gerçek yük altında test edin. Boyutlandırma ödevini atlamak isterseniz, yayın iş yükleri için hazırlanmış sunucularımız tam olarak bu tür sürekli verim kullanımına göre boyutlandırılmıştır.

Ubuntu üzerinde Xtream UI tarzı bir panel kurmak

Her sürüm kendi kurulum betiğiyle gelir ama hepsi aynı üç adımlı yapıyı izler. Aşağıdaki komutlar bilinçli olarak geneldir: kurulum betiğini yalnızca kullandığınız sürümün resmi yayın sayfasından indirin, asla rastgele bir yeniden yüklemeden almayın ve root olarak çalıştırmadan önce betiği okuyun.

1. adım: Temiz bir sistem hazırlayın

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

Yeni bir çekirdek kurulduysa yeniden başlatın ve saat dilimini bilinçli olarak ayarlayın. EPG zamanlaması sistem saatine bağlıdır ve kayma, saatlerce şaşan yayın rehberleri üretir.

2. adım: Sürümün kurulum betiğini çalıştırın

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

Betik paketlenmiş yığını kurar, veritabanını oluşturur (örneğin Xtream UI, 127.0.0.1:7999 üzerinde kendi MariaDB'sini xtream_iptvpro adlı bir veritabanıyla çalıştırır) ve bitince yönetim URL'sini, portunu ve kimlik bilgilerini yazdırır. Bunları hemen kaydedin: bazı sürümler rastgele bir yönetim yolu veya portu üretir ve ikinci kez göstermez.

3. adım: İlk giriş ve kontroller

Tarayıcıda http://your-server-ip:25500 adresini açın, üretilen kimlik bilgileriyle giriş yapın ve her şeyden önce yönetici şifresini değiştirin. Ardından servislerin gerçekten dinlediğini doğrulayın:

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

Panelin paketlenmiş nginx'inin her iki porta da bağlandığını görmelisiniz. Bundan sonrası (ana sunucuyu tanımlamak, kategoriler ve bir test hattı oluşturmak) tamamen web arayüzünde yapılır.

Portlar, ters proxy ve TLS

Xtream Codes'tan devralınan varsayılanlar yönetim paneli için 25500 ve istemciye dönük HTTP çıkışı için 25461'dir, yani hatların oynatma listeleri ve yayınlar için bağlandığı port. Yalnızca ihtiyacınız olanı açın, gerisini güvenlik duvarıyla kapatın; yönetim IP'niz sabitse panel portunu ona kısıtlayın:

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

Sonra dış dünyanın gerçekte ne gördüğünü doğrulayın: Linux'ta açık portları kontrol etme rehberimiz ss, nmap ve dinleme ile erişilebilirlik arasındaki farkı ele alıyor.

Birçok operatör istemci portunun önüne 80, 443 veya 8080 üzerinde nginx ya da HAProxy koyar, çünkü bazı ağlar standart dışı portları tamamen engeller; proxy ayrıca yönetim paneli için TLS'i sonlandırabilir. Dürüst bir uyarı: pek çok eski set üstü kutu ve IPTV uygulaması hâlâ düz HTTP ile daha iyi çalışır, bu yüzden yayın portunda HTTPS'i zorunlu kılmadan önce gerçek istemci karmanızı test edin. Ve bunların hiçbirini güvenlik sanmayın: yönetim panelini alışılmadık bir porta taşımak yalnızca günlüklerinizdeki tarayıcı gürültüsünü azaltır. Gerçek sıkılaştırma; katı bir güvenlik duvarı, güçlü ve benzersiz şifreler, yönetim arayüzünde TLS ve güncel bir işletim sistemidir.

Yedekler, izleme ve güncellemeler

Veritabanı, panelin kendisidir: yayınlar, hatlar, buketler ve EPG yapılandırması hep MariaDB'de yaşar. Günlük dökümünü alın ve dökümü sunucu dışına kopyalayın:

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

İzleme için panel panosu yayın başına canlı bağlantıları zaten gösterir; bant genişliği eğilimi için vnstat, kontrolden çıkmış bir ffmpeg sürecini yakalamak için htop ekleyin. Yüksek bağlantı sayıları aynı zamanda binlerce açık soket anlamına gelir, bu yüzden kurulum betiğinin dosya tanımlayıcı limitlerini yükselttiğini doğrulayın. Çoğu bunu sysctl ve limits.conf ayarlarıyla yapar, ama kontrol edin. Son olarak çalıştırdığınız yazılım konusunda gerçekçi olun: artık yama almayan bir sürüm, internete açık eski bir PHP uygulaması gibi ele alınmalıdır. Başka hiçbir iş yapmayan ayrı bir sunucuda tutun, en az yüzeyi açın ve altındaki işletim sistemini düzenli olarak yamayın.

Bunların hiçbiri egzotik donanım gerektirmez. Gereken şey, root erişimi olan temiz bir Ubuntu LTS makinesi ve akşam boyunca her biri 8 Mbps çeken yüz soket altında sabit kalan bir ağdır. Linux VPS planlarımız tam bunun için kurulu: ayrılmış CPU ve RAM, sınırsız (fair-use) bant genişliği, KYC olmadan tam yönetici erişimi ve ödeme onaylandıktan yaklaşık 10 saniye sonra teslim. Sipariş verin, kurulum betiğini çalıştırın ve bir saat içinde panel giriş ekranında olabilirsiniz.

Sık sorulan sorular

Xtream UI hâlâ bakımı yapılıyor mu?

Xtream UI'nin herkese açık geliştirmesi büyük ölçüde durdu; aktif bakımı yapılan ardıl XUI.one'dır.

Ücretsiz Xtream UI sürümünün son önemli herkese açık yayınları yıllar öncesine ait ve orijinal topluluk kanalları sessizleşti. Bugün aktif geliştirme, eski bir Xtream UI geliştiricisinin kapalı kaynaklı ticari paneli XUI.one'da yapılıyor. Yine de Xtream UI çalıştırıyorsanız onu eski yazılım gibi ele alın: ayrı ve güvenlik duvarı arkasındaki bir sunucuda tutun, yönetim portunu bilinen IP'lere kısıtlayın ve hızlı geçiş yapabilmek için veritabanını her gün yedekleyin.

Xtream sunucusu ile Plex veya Jellyfin sunucusu arasındaki fark nedir?

Plex ve Jellyfin kişisel medya sunucularıdır; Xtream paneli ise çok kullanıcılı canlı yayın dağıtım ara katmanıdır.

Plex ve Jellyfin yerel bir medya kütüphanesini dizinler ve kendi cihazlarınıza yayınlar. Xtream paneli ise canlı kanallar ve abone yönetimi etrafında kuruludur: yayınları alır, bitiş tarihi ve bağlantı limiti olan hatlar (kullanıcı hesapları) oluşturur ve IPTV uygulamalarının beklediği Xtream Codes API'sini sunar. Yalnızca evde kendi dosyalarınızı izlemek istiyorsanız doğru araç Plex veya Jellyfin'dir. Xtream paneli gereksiz bir yük olur.

Bir IPTV yayını ne kadar bant genişliği kullanır?

SD için kabaca 2-4 Mbps, 1080p için 5-10 Mbps ve 4K HEVC için 15-25 Mbps.

Bu, panele değil kaynak bit hızına bağlıdır: SD kanallar tipik olarak 2-4 Mbps, 1080p yaklaşık 5-10 Mbps ve 4K HEVC 15-25 Mbps çeker. Uplink'i boyutlandırmak için bit hızını tepe eşzamanlı izleyici sayınızla çarpın: 8 Mbps kanallarda 100 izleyici, emniyet payı dışında yaklaşık 800 Mbps sürekli upload gerektirir. Reklam edilen port hızından çok sürekli verim önemlidir, bu yüzden yayına geçmeden önce sunucuyu gerçek yük altında test edin.

Xtream panelini paylaşımlı hostingde veya cPanel ile birlikte kurabilir miyim?

Hayır. Panel, root erişimi olan ayrı bir Linux sunucusu ve kendi paketlenmiş web yığınını gerektirir.

Panel kurulum betikleri kendi nginx, PHP ve MariaDB derlemelerini /home/xtreamcodes/ altına yerleştirir ve 25500 ile 25461 gibi sabit portlara bağlanır. Paylaşımlı hosting size ne root erişimi ne de boş port verir; cPanel veya Plesk gibi kontrol panelleri de paketlenmiş yığınla doğrudan çakışır. Uygulanabilir minimum platform, başka hiçbir iş yapmayan temiz bir Ubuntu LTS VPS veya dedicated sunucudur.