Diese Anleitungen bilden die Begriffe einer Branche auf die Objekte ab, die die Plattform heute hat (Bouquets, Lines, Pakete, Partnerkonten, Nodes, die API). Es sind konzeptionelle Zuordnungen, keine branchenspezifischen Funktionen, und ein Partnerkonto ist ein delegiertes Konto, kein isolierter Mandant.
Konzeptionelle Zuordnung
Nichts im Panel heißt Abonnement oder Point of Presence. Die Tabelle zeigt, welches Objekt welche Rolle übernimmt; die folgenden Kapitel richten sie in dieser Reihenfolge ein.
| In Ihrer Branche | Auf der Plattform | Wo im Panel |
|---|---|---|
| Konto eines Händlers oder regionalen Partners | Partnerkonto (Reseller): ein delegiertes Dashboard mit Credits, Berechtigungen und eigenen Lines | Users → Reseller hinzufügen; Groups für seine Berechtigungen |
| Kanalstufe oder Zusatzpaket | Bouquet: eine benannte Gruppe von Kanälen, Filmen oder Serien, die ein Paket freigibt | Bouquets, aus Streams und Movies / Series |
| Fernsehkanal | Live-Kanal: ein Stream mit seinen Quellen, EPG und Ausgabeformaten | Streams → Live-Stream hinzufügen (Quell-URL oder RTMP-Push) |
| VOD-Bibliothek | VOD-Katalog: Filme und Serien mit Staffeln und Folgen, Kategorien und Metadaten | Movies und Series oder der VOD-Ingest-Job |
| Fernsehzugang des Abonnenten | Line: ein Zugang mit Paket, Bouquets, Ablaufdatum, Verbindungslimit und Ausgaben | Lines → hinzufügen, oder Aktivierungscodes, oder die Reseller API |
| Ende des Abrechnungszeitraums | Ablaufdatum der Line, verlängert durch ein Paket, einen Credit oder die API | Das Ablaufdatum der Line und die Laufzeit des Pakets |
| Bildschirme pro Abonnement | Max. Verbindungen der Line: wie viele Geräte gleichzeitig schauen dürfen | Die max. Verbindungen der Line |
| Abrechnungs- und Provisioning-Integration | Reseller API und Webhooks: die Operationen des Panels aus Ihrem eigenen System | Reseller-API-Schlüssel und Webhooks im Dashboard des Resellers |
| Node eines Point of Presence | Streaming-Nodes: aus dem Panel registrierte Edge-Server, einer pro Standort oder Gebäude | Servers → Node hinzufügen, per SSH installiert |
Voraussetzungen
Was vor der Installation bereitstehen sollte.
- Ein Server am Kernstandort (Ubuntu 22.04 oder 24.04), der Installer, eine Domain oder Adresse, die Abonnenten erreichen können, und ein Server in jedem Point of Presence für die Nodes.
- Die lizenzierten Senderfeeds, die VOD-Bibliothek und das Abrechnungssystem, in dem die Abonnements liegen.
- Eine Entscheidung zu den Stufen, zur Dauer eines Abrechnungszeitraums und dazu, welche Händler ein Partnerkonto erhalten.
Infrastruktur bereitstellen
Der Kernstandort, dann die Points of Presence.
- Führen Sie den Installer auf dem Kernserver aus; stellen Sie das Panel hinter Ihren Reverse Proxy und setzen Sie TRUSTED_PROXIES, damit Logs und IP-Regeln die echte Adresse des Abonnenten sehen.
- Setzen Sie die Wiedergabe-Basis auf die öffentliche Adresse, die Abonnenten erreichen, und den Lizenzschlüssel auf dem Server.
- Registrieren Sie unter Servers einen Node pro Point of Presence; das Panel installiert ihn per SSH, oder der Node registriert sich mit einem Einmalcode, und leitet die Abonnenten in seiner Nähe zu ihm.
- Legen Sie ein Partnerkonto (Reseller) für den Support oder das Abrechnungsteam an, mit Berechtigungen nur für Lines.
Inhalte organisieren
Stufen und Pakete als Bouquets.
- Fügen Sie die Kanäle unter Streams und die VOD-Bibliothek unter Movies und Series hinzu, mit Kategorien und einer EPG-Quelle.
- Legen Sie Bouquets für die Basis-Senderliste, die Premium-Kanäle und die VOD-Bibliothek an.
- Legen Sie ein Paket pro Abo-Stufe an, mit den Bouquets, die es zuweist, dem Abrechnungszeitraum als Laufzeit und einem Preis in Credits.
- Legen Sie ein kurzes Testpaket für eine Aktion oder einen Neukunden an.
Partner-Konfiguration (Reseller)
Händler mit Credits.
- Legen Sie eine Gruppe für Händler mit Berechtigungen für ihre eigenen Lines an, ohne Zugriff auf den Katalog oder die Einstellungen.
- Fügen Sie jeden regionalen Händler als Partnerkonto mit dieser Gruppe, den Paketen, die er verkaufen darf, und einem Credit-Guthaben hinzu; ein Händler kann Sub-Reseller bis zu fünf Ebenen tief haben.
- Der Webhook credits.low und der Hinweis bei niedrigem Guthaben fordern einen Händler auf, aufzuladen, bevor der Verkauf stoppt.
Abonnenten-Lines konfigurieren
Eine Line pro Abonnement.
- Die Abrechnung legt eine Line an, wenn ein Abonnement beginnt, über einen Konnektor oder action=create_line der Reseller API mit dem Paket der Stufe und einer Request-ID.
- Setzen Sie die maximalen Verbindungen pro Stufe, die Zahl der Bildschirme, die ein Haushalt gleichzeitig nutzen darf.
- Binden Sie eine Line an die Adresse, das Land oder den ISP des Abonnenten, wo das Angebot nur für Ihr Netz gilt.
- Für einen Pilotbetrieb oder einen Supportfall fügen Sie Lines unter Lines → hinzufügen hinzu und geben die Zugangsdaten aus.
VOD-Bibliothek
Der On-Demand-Katalog.
- Fügen Sie Filme und Serien mit Staffeln und Folgen hinzu, übernommen mit dem VOD-Ingest-Job oder hochgeladen, mit TMDB-Metadaten für Poster und Beschreibungen.
- Gruppieren Sie die Titel in Bouquets nach Stufe oder Zusatzpaket, damit ein Paket genau das zuweist, was das Abonnement enthält.
- Die Nodes cachen die VOD-Dateien, sodass beliebte Titel vom Point of Presence in der Nähe des Abonnenten ausgeliefert werden.
Live-Kanäle
Die Senderliste.
- Fügen Sie jeden lizenzierten Kanal unter Streams mit seinem Feed hinzu und aktivieren Sie Catch-up oder Timeshift nur dort, wo die Rechte es erlauben.
- Fügen Sie eine EPG-Quelle hinzu, damit Apps und Boxen den Programmführer anzeigen.
- Jeder Node holt einen Live-Kanal einmal vom Origin und verteilt ihn an seine Abonnenten.
Ablauf, Verlängerung und Kündigung
Der Abrechnungszeitraum als Gültigkeit der Line.
- Eine Line gilt für den Zeitraum ihres Pakets; die Abrechnung verlängert sie jeden Zeitraum mit action=renew_line oder über den Konnektor.
- Wenn ein Abonnement ausläuft oder gekündigt wird, ruft die Abrechnung action=disable_line auf und aktiviert die Line bei Reaktivierung wieder.
- Abonnieren Sie die Webhooks für die Abrechnung, um ablaufende und abgelaufene Lines mit deren Unterlagen abzugleichen.
Anbindung an die Abrechnung
Die Abrechnung steuert den Zugang; der Player spielt ab.
- Installieren Sie den Konnektor für Ihr Abrechnungssystem auf dessen Seite (WHMCS, Blesta, Odoo und andere) oder rufen Sie die Reseller API mit einem Schlüssel und einer Request-ID aus Ihrem eigenen System auf.
- Es gibt kein Single Sign-on für Zuschauer: Ein Abonnent meldet sich an einer App oder Box mit den Zugangsdaten der Line an, die die Abrechnung im Kundenbereich anzeigen kann.
- Nutzen Sie für Reporting-Werkzeuge Admin-API-Schlüssel mit Nur-Lese-Flag, IP-Allowlist und Ablaufdatum.
Sicherheitsaspekte
Den Dienst den Abonnenten vorbehalten.
- Stellen Sie das Panel hinter den Reverse Proxy mit TLS und setzen Sie TRUSTED_PROXIES; halten Sie den Management-Traffic der Nodes in einem privaten Netz.
- Zwei-Faktor-Anmeldung für jedes Panel-Konto und Berechtigungsgruppen für Support und Händler; reCAPTCHA oder Turnstile bei der Anmeldung.
- Signierte und ablaufende Wiedergabelinks, ein Verbindungslimit pro Abonnement und eine Bindung an Adresse, Land oder ISP, wo sie passt.
- Verschlüsselte Datenbank-Backups mit einer Off-Site-Kopie und das Audit-Log für jede Änderung an Lines und Credits.
Fehlersuche
Die üblichen ersten Prüfungen.
- Ein Abonnent hat kein Fernsehen: Prüfen Sie, ob die Line aktiviert und nicht abgelaufen ist, dann den Aufruf der Abrechnung im Reseller-API-Aufruf-Log.
- Ein Kanal fehlt für eine Stufe: Prüfen Sie die Bouquets des Pakets dieser Stufe.
- Ein Point of Presence puffert: Prüfen Sie den Heartbeat seines Nodes und ob seine Abonnenten zu ihm geleitet werden.
- Ein Händler kann keine Line anlegen: Prüfen Sie seine Credits und ob das Paket eines ist, das er verkaufen darf.