P2P LiveFree live streaming · peer-to-peer delivery

P2P Live — Benutzerhandbuch

Dieses Handbuch erklärt alles, was Sendende und Zuschauende brauchen: wie der Dienst funktioniert, wie man sich registriert, wie Ihr Stream beschaffen sein muss, wie Sie den Player einbetten, wie Sie prüfen, ob die Peer-to-Peer-Auslieferung (P2P) funktioniert, welche Grenzen gelten und wie Sie die häufigsten Probleme beheben.

Kurzfassung: Registrieren Sie sich, fügen Sie die Adresse Ihres HLS-Streams ein (eine .m3u8-URL), und Sie erhalten eine öffentliche Seite unter https://p2p.gia.tv/ihr_name sowie einen Einbettungscode. Die Zuschauer dieser Seite teilen das Video über ihre Browser miteinander, sodass Ihr Streaming-Server oder CDN den Stream einmal ausliefert statt einmal pro Zuschauer.

So funktioniert es

Jede Kanalseite enthält einen normalen HLS-Player (hls.js) mit einer angeschlossenen P2P-Engine.

  1. Der erste Zuschauer eines Kanals lädt die Playlist und die Videosegmente von Ihrem Ursprungsserver (der eingetragenen .m3u8-Adresse) – genau wie jeder andere Player.
  2. Jeder weitere Zuschauer öffnet dieselbe Seite. Die Player finden sich über den Signalisierungsserver dieser Website (einen kleinen WebSocket-Dienst) und verbinden sich direkt, von Browser zu Browser, über WebRTC-Datenkanäle.
  3. Jedes Videosegment wird von einem Zuschauer (dem Leiter des Schwarms) vom Ursprungsserver geladen und dann über die P2P-Verbindungen an die anderen weitergegeben. Kommt ein Segment nicht rechtzeitig von einem Peer, holt der Player es selbst vom Ursprungsserver – die Wiedergabe hängt also nie von Peers ab.
  4. Jedes Segment wird geprüft (Hash und Inhaltsprüfung), bevor es an den Player geht. Ein Peer kann keine fehlerhaften Daten in die Wiedergabe eines anderen einschleusen.
  5. Die Player melden anonyme Statistiken (Bytes vom Ursprung, Bytes von Peers, Aussetzer, verbundene Peers), damit Sie die Entlastungsquote in Ihrem Dashboard sehen.

Was das für Sie bedeutet:

Voraussetzungen

Ihr Stream muss diese Voraussetzungen erfüllen. Die Schaltfläche Stream jetzt prüfen im Dashboard testet die meisten davon für Sie.

VoraussetzungWarumSo prüfen Sie es
HLS (.m3u8-Playlist) über http:// oder https://Der Player ist ein HLS-Player. RTMP, RTSP, DASH, WebRTC-Ingest und einfache MP4-Dateien werden nicht direkt unterstützt.Öffnen Sie die URL im Browser: Es sollte eine kleine Textdatei heruntergeladen werden, die mit #EXTM3U beginnt.
CORS-Header Access-Control-Allow-Origin: * (oder genau https://p2p.gia.tv) auf Playlists und Segmenten, von jedem Edge-Server Ihres CDNBrowser lehnen seitenübergreifende Anfragen ohne ihn ab. Ohne CORS spielt der Stream überhaupt nicht, mit oder ohne P2P. Ein Header, der eine andere Website nennt, zählt nicht.Dashboard → Stream jetzt prüfen → „CORS“. Oder curl -sI -H 'Origin: https://p2p.gia.tv' IHRE_URL und nach dem Header suchen.
https://, wenn Ihre Zuschauer https verwenden (diese Website verwendet https)Browser blockieren http://-Medien auf https://-Seiten (gemischte Inhalte).Achten Sie darauf, dass die URL mit https:// beginnt.
Stabile Segment-URLsPeers tauschen Segmente anhand ihres Namens aus. Bekommt jeder Zuschauer für dasselbe Segment eine anders benannte URL (Token pro Zuschauer, Load-Balancer-Hinweise wie lb_backend_hint, absolute URLs auf wechselnden Backend-Hosts), können Peers nicht teilen.Dashboard → Stream jetzt prüfen → „Teilen“. Oder öffnen Sie die Medien-Playlist zweimal: Die Segmentnamen sollten gleich sein. Signierte URLs, die für alle Zuschauer gleich sind, sind in Ordnung.
Segmentdauer 2–10 sSehr kurze Segmente (< 1 s) erhöhen den Signalisierungsaufwand, sehr lange (> 10 s) verzögern das Teilen.#EXT-X-TARGETDURATION in der Medien-Playlist.
Codecs: H.264-Video, AAC- oder MP3-Audio (TS- oder fMP4-Segmente); H.265/HEVC nur, wo der Browser es unterstütztDie Decoder des Browsers.Mit der Diagnoseansicht oder der Prüfung im Dashboard.

Anforderungen an den Ursprungsserver

Die Stream-Prüfung testet die Playlist von diesem Server aus. Ein CDN oder Ursprungsserver, der Zuschauer je nach Land oder Netz unterschiedlich behandelt (Geoblocking, Hotlink-Schutz, regionale Edge-Server ohne CORS-Header), kann hier einwandfrei aussehen und bei manchen Zuschauern trotzdem scheitern. Diese Zuschauer sehen unter dem Player Stream-Fehler — der Ursprungsserver hat diesen Zuschauer abgewiesen: HTTP 403 …, und derselbe Grund erscheint für Sie unter Admin → Live-Analyse (wenn Sie die Website verwalten) — fragen Sie den Zuschauer nach dem angezeigten Grund oder nach dem Ereignisprotokoll der Diagnoseansicht.

CORS

Das mit Abstand häufigste Problem. Ihr Ursprungsserver muss Access-Control-Allow-Origin: * (oder genau den Ursprung der Website, https://p2p.gia.tv) bei jeder Antwort senden: bei der Master-Playlist, den Medien-Playlists und den Segmenten. Beispiele:

nginx

location /live/ {
    add_header Access-Control-Allow-Origin * always;
    add_header Access-Control-Allow-Headers Range always;
    add_header Access-Control-Expose-Headers Content-Length always;
    types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; video/mp4 m4s mp4; }
}

Apache (.htaccess im HLS-Verzeichnis)

Header always set Access-Control-Allow-Origin "*"
Header always set Access-Control-Allow-Headers "Range"

Wowza Streaming Engine: Application → Properties → Custom → cupertinoUserHTTPHeaders = Access-Control-Allow-Origin: * hinzufügen (Modul cupertinostreaming), oder die CORS-Einstellung des HTTP-Origins verwenden.

CDNs (Cloudflare, Akamai, CloudFront, Bunny …): Aktivieren Sie CORS in den Einstellungen des Origins bzw. der Pull-Zone, mit * als erlaubtem Ursprung. Bei Cloudflare kann „Transform Rules → Response headers“ den Header hinzufügen.

Test auf der Kommandozeile (der Header muss in der Ausgabe stehen):

curl -sI -H "Origin: https://p2p.gia.tv" https://your-server.example.com/live/stream/playlist.m3u8 | grep -i access-control

Quellen, die gut funktionieren

Registrierung

  1. Gehen Sie zu https://p2p.gia.tv/signup.
  2. Wählen Sie einen Benutzernamen: 3–20 Zeichen, Kleinbuchstaben, Ziffern und Unterstrich. Er wird Ihre öffentliche Adresse https://p2p.gia.tv/benutzername und kann später nicht geändert werden.
  3. Geben Sie Ihre E-Mail-Adresse und ein Passwort ein (mindestens 8 Zeichen).
  4. Fügen Sie optional schon jetzt Ihre .m3u8-Adresse und einen Kanaltitel ein, oder tragen Sie sie später im Dashboard nach.
  5. Akzeptieren Sie die Nutzungsbedingungen und die Nutzungsrichtlinie. Sie müssen die Rechte an allem besitzen, was Sie streamen.
  6. Klicken Sie auf Kanal erstellen. Sie sind sofort angemeldet und landen in Ihrem Dashboard.

Auf manchen Websites ist die Registrierung geschlossen; nutzen Sie dann die Kontaktseite.

Ihr Dashboard

https://p2p.gia.tv/dashboard zeigt:

Stream jetzt prüfen lädt Ihre Playlist serverseitig herunter und zeigt: online/offline, live oder VOD, Zieldauer, Varianten, beste Auflösung/Bitrate, Codecs und ob der CORS-Header vorhanden ist. Streams werden außerdem alle paar Minuten automatisch geprüft; die Startseite listet nur Kanäle, die online sind.

Wenn die Website E-Mails versendet, fragt Ihr Dashboard nach der Registrierung, ob Sie Ihre E-Mail-Adresse bestätigen (siehe Häufige Fragen).

Kanaloptionen

Ihre Kanalseite

https://p2p.gia.tv/benutzername zeigt den Player, Titel, Beschreibung, die aktuelle Zuschauerzahl, den Link zum Teilen, den Einbettungscode und einen kleinen Diagnosekasten.

Unter dem Video steht eine P2P-Statuszeile:

StatusBedeutung
P2P funktioniertDieser Zuschauer erhält Segmente von Peers (oder ist der Leiter des Schwarms und beliefert andere).
P2P: startetMit der Signalisierung verbunden, wartet auf Peers oder auf das erste geteilte Segment. Normal für den ersten Zuschauer und in den ersten 10–20 Sekunden.
P2P funktioniert nichtSiehe den Text daneben: WebRTC nicht verfügbar, native Wiedergabe (iOS Safari), Signalisierung nicht erreichbar oder alle Peers gescheitert. Das Video läuft weiter vom Ursprungsserver.

Die Seite blockiert die Wiedergabe nie wegen P2P. Geht etwas schief, sieht der Zuschauer einfach vom Ursprungsserver.

Mobil: Chrome und Firefox unter Android unterstützen P2P. iOS Safari spielt HLS nativ ab (ohne Media Source Extensions), daher spielen iPhones und iPads immer vom Ursprungsserver und nehmen nicht an P2P teil. Safari auf dem Desktop nimmt teil.

Einbetten

Kopieren Sie den Einbettungscode aus Ihrem Dashboard oder von Ihrer Kanalseite:

<iframe src="https://p2p.gia.tv/embed/user_name" width="854" height="480" frameborder="0" scrolling="no"
        allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>

Optionen:

<div style="position:relative;aspect-ratio:16/9;max-width:960px">
  <iframe src="https://p2p.gia.tv/embed/user_name" style="position:absolute;inset:0;width:100%;height:100%;border:0"
          allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>
</div>

Einen reinen Player ohne Website-Rahmen gibt es unter https://p2p.gia.tv/?src=IHRE_M3U8 (Produktion) und https://p2p.gia.tv/debug.html?src=IHRE_M3U8 (Diagnose). Sie nutzen dieselbe P2P-Engine und denselben Schwarm wie Ihre Kanalseite, weil der Schwarm aus der Stream-URL abgeleitet wird.

Testen

Um P2P zu sehen, brauchen Sie zwei Player; ein einzelner Zuschauer lädt immer vom Ursprungsserver.

  1. Öffnen Sie Ihre Kanalseite in einem Browser (z. B. Chrome). Warten Sie, bis das Video läuft.
  2. Öffnen Sie dieselbe Seite in einem zweiten Browser (Firefox, Edge, einem anderen Chrome-Profil, einem privaten Fenster oder auf einem anderen Computer/Telefon in einem beliebigen Netz).
  3. Innerhalb von etwa 10–20 Sekunden sollte die Statuszeile des zweiten Players P2P funktioniert zeigen. Der erste wird zum Leiter und zeigt, dass er Peers beliefert.
  4. Für Details öffnen Sie den Link Diagnoseansicht (auch https://p2p.gia.tv/debug.html?src=IHRE_M3U8). Sie zeigt jedes Segment mit seiner Quelle (ORIGIN oder PEER), die verbundenen Peers, die Bytes in jede Richtung, den Zustand der Signalisierung, einen Befund, der genau sagt, warum P2P funktioniert oder nicht, und eine eingebaute Testanleitung.

Hinweise:

Grenzen

PunktWertHinweise
Kanäle pro Konto1Legen Sie für weitere Streams weitere Konten an.
Zuschauer pro Kanal (Schwarm)standardmäßig bis zu 500Vom Administrator festgelegt. Über der Grenze sehen neue Zuschauer weiter vom Ursprungsserver, aber ohne P2P.
Peers pro Zuschauerbis zu 12Wird automatisch verwaltet (die Website kann die Zahl ändern).
Länge der Stream-Adresse1024 Zeichen
Titel / Beschreibung120 / 600 Zeichen
Last am Ursprungsserver1 bis wenige vollständige Downloads pro SchwarmDer Leiter plus Zuschauer, deren Peers zu langsam sind.
Upload des Playerspro Peer und insgesamt begrenztZuschauer mit langsamem Upload liefern automatisch weniger.

Fehlerbehebung

„Stream offline“ im Dashboard / gar kein Video

Bei mir läuft es, bei einem Zuschauer in einem anderen Land nicht

Läuft in VLC, aber nicht im Browser

„P2P funktioniert nicht: Signalisierung nicht erreichbar“

„P2P funktioniert nicht: kein WebRTC“ / „native Wiedergabe“

„P2P: startet“ dauerhaft bei zwei Zuschauern

Das Video stockt / puffert nach

Die Startseite zeigt meinen Kanal nicht

Die Einbettung zeigt ein schwarzes Bild

Ich habe mein Passwort vergessen

Ich habe meine E-Mail-Adresse geändert, aber die Einstellungen zeigen noch die alte

Häufige Fragen

Wird mein Video aufgezeichnet oder weitergestreamt? Nein. Die Website macht die Player nur miteinander bekannt. Das Video holen die Browser der Zuschauer von Ihrem Ursprungsserver und reichen es untereinander weiter. Auf dem Server wird nichts gespeichert.

Kann ich einen Stream eines anderen Anbieters verwenden (z. B. meinen Tulix-/SSH101-Kanal)? Ja, wenn Sie das Recht haben, ihn zu verbreiten, und der Ursprungsserver CORS-Header sendet. Die Seite SSH101-Verzeichnis zeigt eine Beispielintegration.

Ist es kostenlos? Ja. Der Dienst wird ohne Gewähr gemäß den Nutzungsbedingungen bereitgestellt. Missbrauch (Urheberrechtsverletzungen, illegale Inhalte) führt zur Sperrung; siehe die Nutzungsrichtlinie.

Wie viele Zuschauer kann ich haben? So viele, wie Ihr Ursprungsserver ohne P2P mit etwa 5–20 % der Last bedienen kann. In der Praxis gilt pro Kanal die vom Administrator eingestellte Schwarmgrenze (standardmäßig 500).

Können Zuschauer einander sehen? Nur technisch (IP-Adressen innerhalb von WebRTC, wie bei jedem P2P-Videodienst). Keine Namen, kein Chat, kein Verlauf.

Welche Browser? Chrome, Edge, Firefox, Opera, Brave (mit erlaubtem WebRTC), Safari auf dem Desktop, Chrome/Firefox unter Android. iOS Safari spielt ohne P2P.

Funktioniert es mit DRM / verschlüsseltem HLS? AES-128-verschlüsselte Playlists funktionieren (Segmente werden verschlüsselt geteilt; jeder Zuschauer holt den Schlüssel von Ihrem Schlüsselserver). FairPlay-/Widevine-DRM wird nicht unterstützt.

Kann ich meinen Benutzernamen ändern? Nein, er ist die dauerhafte Adresse Ihrer Seite. Legen Sie für einen neuen Namen ein neues Konto an.

Kann ich mein Konto löschen? Ja: Einstellungen → Konto löschen, mit Ihrem aktuellen Passwort. Konto und Kanalseite werden sofort gelöscht, zusehende Zuschauer werden getrennt, und an Ihre E-Mail-Adresse geht eine Benachrichtigung. Das lässt sich nicht rückgängig machen. (Administratorkonten löscht ein anderer Administrator.)

Warum bittet mich mein Dashboard, meine E-Mail-Adresse zu bestätigen? Wenn die Website E-Mails versendet, erhalten neue Konten einen Bestätigungslink (7 Tage gültig). Öffnen Sie ihn und drücken Sie Bestätigen; Link erneut senden im Dashboard schickt einen neuen (bis zu 3 pro Stunde). Manche Websites listen einen Kanal erst auf der Startseite, wenn seine Adresse bestätigt ist.

Kontakt

Fragen und Missbrauchsmeldungen: Kontaktseite · E-Mail: info@tulix.com · Missbrauch/DMCA: https://p2p.gia.tv/report.