Xtream-Server einrichten: Xtream UI auf Ubuntu installieren

Was ein Xtream-Server tatsächlich ist

Ein Xtream-Server ist eine Linux-Maschine, auf der ein IPTV-Verwaltungspanel läuft, das die Xtream-Codes-API spricht. Das Panel erfüllt drei Aufgaben: Es nimmt Livestreams und Videoquellen auf, es verwaltet Lines (Benutzerkonten mit Benutzername, Passwort, Ablaufdatum und Verbindungslimit), und es liefert alles per HTTP über eine Handvoll bekannter Endpunkte wieder aus: player_api.php für Metadaten, get.php für M3U-Playlists, xmltv.php für EPG-Daten. Da praktisch jede IPTV-Client-App diese API implementiert, ist „Xtream-Server“ zum Kurzbegriff für jedes Panel geworden, das sie bereitstellt, unabhängig davon, welche Software darunter tatsächlich läuft.

Ein Satz zur Abgrenzung vor dem technischen Teil: Diese Anleitung behandelt ausschließlich Infrastruktur und Panel-Administration, und der Betreiber ist dafür verantwortlich, die Senderechte für jeden über das Panel verbreiteten Stream zu besitzen. Wenn dir die Grundlagen neu sind, beginne mit unserer Einführung dazu, wie IPTV auf Protokollebene funktioniert. Die Terminologie des Panels ergibt danach deutlich mehr Sinn.

Von Xtream Codes zu Xtream UI und XUI.one

Xtream Codes war das kommerzielle Panel, das die Kategorie geprägt hat. Im September 2019 beschlagnahmte eine von italienischen Behörden und Europol koordinierte Strafverfolgungsaktion die Infrastruktur des Unternehmens, und die Software wurde nie wieder verkauft oder aktualisiert. Die clientseitige API war jedoch bereits Branchenstandard, sodass das Ökosystem das Unternehmen überlebte.

Zwei Projekte füllten die Lücke. Xtream UI ist ein kostenloser Community-Fork auf Basis der letzten öffentlichen 2.9-Codebasis; er hat das Panel jahrelang am Leben gehalten, doch seine öffentliche Entwicklung ist weitgehend zum Stillstand gekommen. XUI.one ist ein kommerzielles Closed-Source-Panel, geschrieben von einem früheren Xtream-UI-Entwickler, und heute der de facto gepflegte Nachfolger. Beide behalten die gleiche API, das gleiche Line-Modell und die gleichen Standard-Ports bei. Deshalb gelten Installationsanleitungen für das eine meist auch für das andere, und deshalb bleibt dieser Artikel fork-neutral.

Serveranforderungen: CPU, RAM und Bandbreite

Jeder Fork verlangt eine frische, minimale Ubuntu-LTS-Installation, und die meisten setzen auf ein bestimmtes Release. Prüfe die Dokumentation des Forks, bevor du den Server bestellst, denn eine Installation auf der falschen Ubuntu-Version ist die häufigste Ursache für ein kaputtes Setup. Der Installer richtet unter /home/xtreamcodes/ seinen eigenen mitgelieferten Stack aus nginx, PHP und MariaDB ein: Setze ihn also nie auf eine Maschine, auf der schon ein Webstack oder ein Hosting-Control-Panel läuft, denn sie streiten sich um Ports und Pakete.

Die Dimensionierung läuft auf eine Frage hinaus: Machst du Restreaming (Streams unverändert durchleiten) oder Transcoding (Neucodierung mit ffmpeg)? Restreaming belastet die CPU kaum: Der Server kopiert im Wesentlichen Bytes zwischen Sockets. Software-Transcoding kostet etwa einen modernen Kern pro 1080p-Kanal, und genau dort explodieren die Budgets. Beim RAM reichen 4 GB für ein kleines Test-Panel; 8 GB oder mehr sind im Produktivbetrieb sinnvoll, sobald MariaDB-Caching und ein paar ffmpeg-Prozesse zusammenkommen. Halte die Datenbank auf SSD-Speicher.

Die Bandbreite ist reine Rechenaufgabe: gleichzeitige Zuschauer in der Spitze mal Stream-Bitrate, plus Reserve. Keine Panel-Einstellung ändert diese Rechnung.

Diese Werte gehen von reinem Restreaming und einer typischen 1080p-Bitrate von 8 Mbps aus; Transcoding vervielfacht die CPU-Spalte, nicht die Bandbreiten-Spalte. Dauerhafter Durchsatz zählt weit mehr als die beworbene Portgeschwindigkeit, teste also unter realer Last. Wenn du dir die Dimensionierungs-Hausaufgaben sparen möchtest: Unsere Server für Streaming-Workloads sind genau für diese Art von Dauerdurchsatz ausgelegt.

Ein Panel im Stil von Xtream UI unter Ubuntu installieren

Jeder Fork liefert seinen eigenen Installer, aber alle folgen dem gleichen dreistufigen Muster. Die folgenden Befehle sind bewusst allgemein gehalten: Lade den Installer ausschließlich von der offiziellen Release-Seite deines Forks herunter, nie von einem beliebigen Re-Upload, und lies das Skript, bevor du es als root ausführst.

Schritt 1: Ein sauberes System vorbereiten

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

Starte neu, wenn ein neuer Kernel installiert wurde, und setze die Zeitzone bewusst: Die EPG-Planung hängt von der Systemuhr ab, und eine Abweichung erzeugt Programmführer, die um Stunden verschoben sind.

Schritt 2: Den Installer des Forks ausführen

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

Das Skript installiert den mitgelieferten Stack, erstellt die Datenbank (Xtream UI betreibt zum Beispiel eine eigene MariaDB auf 127.0.0.1:7999 mit einer Datenbank namens xtream_iptvpro) und gibt am Ende Admin-URL, Port und Zugangsdaten aus. Notiere sie sofort: Manche Forks erzeugen einen zufälligen Admin-Pfad oder -Port und zeigen ihn nicht erneut an.

Schritt 3: Erste Anmeldung und Plausibilitätsprüfungen

Öffne http://your-server-ip:25500 im Browser, melde dich mit den generierten Zugangsdaten an und ändere zuerst das Admin-Passwort. Prüfe anschließend, ob die Dienste wirklich lauschen:

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

Du solltest sehen, dass das mitgelieferte nginx des Panels an beide Ports gebunden ist. Die Arbeit auf Panel-Seite (Hauptserver definieren, Kategorien und eine Test-Line anlegen) findet danach vollständig in der Weboberfläche statt.

Ports, Reverse Proxy und TLS

Die von Xtream Codes übernommenen Standardwerte sind 25500 für das Admin-Panel und 25461 für die HTTP-Ausgabe an Clients (der Port, mit dem sich Lines für Playlists und Streams verbinden). Öffne nur das Nötige und sperre den Rest per Firewall; wenn deine Admin-IP statisch ist, beschränke den Panel-Port darauf:

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

Prüfe danach, was die Außenwelt tatsächlich sieht: Unsere Anleitung zum Prüfen offener Ports unter Linux behandelt ss, nmap und den Unterschied zwischen lauschend und erreichbar.

Viele Betreiber setzen nginx oder HAProxy vor den Client-Port auf 80, 443 oder 8080, weil manche Netzwerke Nicht-Standard-Ports komplett blockieren; der Proxy kann außerdem TLS für das Admin-Panel terminieren. Eine ehrliche Einschränkung: Viele ältere Set-Top-Boxen und IPTV-Apps verhalten sich über einfaches HTTP weiterhin besser. Teste also deinen tatsächlichen Client-Mix, bevor du HTTPS auf dem Streaming-Port erzwingst. Und verwechsle nichts davon mit Sicherheit: Das Admin-Panel auf einen ungewöhnlichen Port zu verlegen, reduziert nur das Scanner-Rauschen in den Logs. Echte Härtung besteht aus einer strikten Firewall, starken einmaligen Passwörtern, TLS auf der Admin-Oberfläche und einem aktuellen Betriebssystem.

Backups, Monitoring und Updates

Die Datenbank ist das Panel: Streams, Lines, Bouquets und EPG-Konfiguration liegen alle in MariaDB. Erstelle täglich einen Dump und kopiere ihn vom Server weg:

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

Für das Monitoring zeigt das Panel-Dashboard bereits die laufenden Verbindungen pro Stream; ergänze vnstat für den Bandbreitenverlauf und htop, um einen entlaufenen ffmpeg-Prozess zu erkennen. Hohe Verbindungszahlen bedeuten außerdem tausende offene Sockets. Prüfe daher, ob der Installer die Limits für Dateideskriptoren erhöht hat; die meisten tun das über Anpassungen an sysctl und limits.conf, aber kontrolliere es. Und sei realistisch bezüglich der Software, die du betreibst: Ein Fork, der keine Patches mehr erhält, sollte wie eine veraltete, aus dem Internet erreichbare PHP-Anwendung behandelt werden. Betreibe ihn auf einem dedizierten Server, der nichts anderes tut, exponiere das Minimum und patche das darunterliegende Betriebssystem regelmäßig.

Dafür braucht es keine exotische Hardware. Es braucht eine saubere Ubuntu-LTS-Maschine mit Root-Zugang und ein Netzwerk, das stabil bleibt, wenn hundert Sockets den ganzen Abend je 8 Mbps ziehen. Genau dafür sind unsere Linux-VPS-Pakete gebaut: dedizierte CPU und RAM, unbegrenzte Bandbreite (Fair Use), voller Admin-Zugang ohne KYC und Bereitstellung etwa 10 Sekunden nach Zahlungsbestätigung. Bestellen, den Installer ausführen, und du kannst innerhalb einer Stunde am Login-Bildschirm des Panels sein.

Häufig gestellte Fragen

Wird Xtream UI noch gepflegt?

Die öffentliche Entwicklung von Xtream UI ist weitgehend zum Stillstand gekommen; XUI.one ist der aktiv gepflegte Nachfolger.

Der kostenlose Fork Xtream UI hatte seine letzten bedeutenden öffentlichen Releases vor Jahren, und die ursprünglichen Community-Kanäle sind still geworden. XUI.one, ein kommerzielles Closed-Source-Panel eines früheren Xtream-UI-Entwicklers, ist heute der Ort der aktiven Entwicklung. Wenn du Xtream UI trotzdem betreibst, behandle es als Legacy-Software: auf einem dedizierten, per Firewall geschützten Server halten, den Admin-Port auf bekannte IPs beschränken und die Datenbank täglich sichern, damit du schnell migrieren kannst.

Was ist der Unterschied zwischen einem Xtream-Server und einem Plex- oder Jellyfin-Server?

Plex und Jellyfin sind persönliche Medienserver; ein Xtream-Panel ist Middleware zur Livestream-Verteilung für viele Nutzer.

Plex und Jellyfin indexieren eine lokale Medienbibliothek und streamen sie auf deine eigenen Geräte. Ein Xtream-Panel ist um Live-Kanäle und Abonnentenverwaltung herum gebaut: Es nimmt Streams auf, erstellt Lines (Benutzerkonten) mit Ablaufdatum und Verbindungslimits und stellt die Xtream-Codes-API bereit, die IPTV-Apps erwarten. Wenn du nur deine eigenen Dateien zu Hause ansehen willst, ist Plex oder Jellyfin das richtige Werkzeug. Ein Xtream-Panel wäre sinnloser Overhead.

Wie viel Bandbreite verbraucht ein IPTV-Stream?

Etwa 2-4 Mbps für SD, 5-10 Mbps für 1080p und 15-25 Mbps für 4K HEVC.

Das hängt von der Bitrate der Quelle ab, nicht vom Panel: SD-Kanäle laufen typischerweise mit 2-4 Mbps, 1080p mit etwa 5-10 Mbps und 4K HEVC mit 15-25 Mbps. Multipliziere die Bitrate mit deinen gleichzeitigen Zuschauern in der Spitze, um den Uplink zu dimensionieren: 100 Zuschauer auf 8-Mbps-Kanälen benötigen rund 800 Mbps dauerhaften Upload, plus Reserve. Dauerhafter Durchsatz zählt mehr als die beworbene Portgeschwindigkeit, teste den Server also unter realer Last, bevor du live gehst.

Kann ich ein Xtream-Panel auf Shared Hosting oder neben cPanel installieren?

Nein, das Panel braucht einen dedizierten Linux-Server mit Root-Zugang und seinen eigenen mitgelieferten Webstack.

Panel-Installer richten ihre eigenen Builds von nginx, PHP und MariaDB unter /home/xtreamcodes/ ein und binden sich an feste Ports wie 25500 und 25461. Shared Hosting bietet dir weder Root-Zugang noch freie Ports, und Control Panels wie cPanel oder Plesk kollidieren direkt mit dem mitgelieferten Stack. Die minimal brauchbare Plattform ist ein sauberer Ubuntu-LTS-VPS oder dedizierter Server, auf dem nichts anderes läuft.