P2P LiveFree live streaming · peer-to-peer delivery

Apprendre

Comment ce système fonctionne et comment le configurer — aucune connaissance préalable requise.

Comment fonctionne la diffusion pair-à-pair

Un serveur, beaucoup de spectateurs

Sans pair-à-pair, chaque spectateur télécharge chaque seconde de vidéo depuis votre serveur d'origine. Dix spectateurs, c'est dix fois la bande passante. Mille spectateurs, mille fois.

La vidéo arrive par morceaux

Un flux HLS est une liste de petits fichiers de quelques secondes. Comme tous les spectateurs veulent les mêmes fichiers dans le même ordre, celui qui en a déjà un peut le donner à celui qui ne l'a pas.

Les spectateurs s'entraident

Avec le pair-à-pair, le premier spectateur récupère un morceau de vidéo depuis l'origine puis le transmet directement aux autres, de navigateur à navigateur. L'origine envoie chaque morceau bien moins souvent.

Un spectateur mène

L'essaim choisit un spectateur comme meneur. Le meneur reste légèrement en avance, télécharge depuis l'origine et alimente les autres. S'il ferme l'onglet, un autre prend le relais en bien moins d'une seconde.

Rien ne dépend jamais d'un pair

Si un morceau n'arrive pas à temps d'un autre spectateur, le navigateur va simplement le chercher à l'origine. Le pair-à-pair ne peut que réduire le coût de la diffusion, jamais sa fiabilité.

Premiers pas

Pour commencer, il vous faut une seule chose : l’adresse web d’une playlist HLS. Elle se termine par .m3u8 et doit être accessible depuis internet. Tout ce qui suit explique comment obtenir une telle adresse, selon ce dont vous disposez aujourd’hui.

Si vous avez déjà une adresse HLS

  1. Connectez-vous et ouvrez Ma chaîne.
  2. Collez l’adresse dans Adresse du flux HLS (.m3u8). Elle doit commencer par http:// ou https://.
  3. Donnez un titre à la chaîne, puis cliquez sur Enregistrer.
  4. Cliquez sur Vérifier le flux maintenant. En quelques secondes, l’état passe à EN LIGNE.
  5. Ouvrez la page de votre chaîne et lancez la lecture. Ouvrez ensuite la même page dans un second navigateur : c’est à ce moment que le pair-à-pair démarre, car il faut deux spectateurs pour qu’il y ait quelqu’un avec qui partager.

Si la vérification indique que le flux est inaccessible, la cause est presque toujours l’une de ces deux : l’adresse n’est pas accessible depuis l’extérieur de votre propre réseau, ou l’origine n’envoie pas l’en-tête Access-Control-Allow-Origin. Sans lui, les navigateurs refusent de lire un flux provenant d’un autre serveur.

Si votre source est RTMP (la plupart des encodeurs, OBS)

Votre encodeur envoie du RTMP à un serveur, et ce serveur écrit du HLS. nginx-rtmp, MediaMTX, Flussonic ou ffmpeg savent tous le faire. La version minimale avec ffmpeg, sur la machine qui reçoit le flux :

ffmpeg -listen 1 -i rtmp://0.0.0.0:1935/live/mystream \
       -c copy -f hls \
       -hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
       /var/www/live/mystream/playlist.m3u8

Servez /var/www/live avec n’importe quel serveur web, ajoutez l’en-tête CORS et utilisez https://yourhost/live/mystream/playlist.m3u8 comme adresse du flux ici.

-c copy signifie que la vidéo n’est pas réencodée : cela ne coûte presque aucun temps de calcul. Utilisez-le chaque fois que votre encodeur produit déjà du H.264 et de l’AAC, ce que font presque tous les encodeurs.

Si votre source est SRT

SRT est un transport de contribution : il achemine un flux de manière fiable entre serveurs, mais aucun navigateur ne sait le lire. Recevez-le et empaquetez-le de la même façon :

ffmpeg -i "srt://0.0.0.0:9000?mode=listener&latency=200" \
       -c copy -f hls \
       -hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
       /var/www/live/mystream/playlist.m3u8

Si votre source est en multicast (UDP ou RTP)

Ce système ne peut pas lire une adresse multicast, et aucun navigateur ne le peut non plus. Ce n’est pas une fonction manquante : c’est la nature même du multicast. Le multicast livre une seule copie d’un flux à de nombreux récepteurs sur un réseau configuré pour le transporter ; c’est pourquoi il fonctionne à merveille à l’intérieur du réseau d’un opérateur et n’existe pas du tout sur l’internet public. Un navigateur n’a aucun moyen de rejoindre un groupe multicast.

Le multicast est donc converti une seule fois, sur une machine située à l’intérieur du réseau qui le reçoit, et c’est le résultat HLS qui est mis en ligne :

ffmpeg -i "udp://@239.0.0.1:1234?fifo_size=1000000&overrun_nonfatal=1" \
       -c copy -f hls \
       -hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
       /var/www/live/channel1/playlist.m3u8

Pour le RTP, utilisez plutôt rtp://@239.0.0.1:1234. Si la source multicast est en MPEG-2 ou dans un autre codec que les navigateurs ne savent pas lire, remplacez -c copy par un véritable encodage :

-c:v libx264 -preset veryfast -b:v 3000k -g 100 -c:a aac -b:a 128k

Une seule conversion sert un nombre quelconque de spectateurs, car à partir de là c’est l’essaim pair-à-pair qui assure la distribution.

Si votre source est une caméra IP (RTSP)

ffmpeg -rtsp_transport tcp -i rtsp://user:password@camera.local/stream1 \
       -c:v libx264 -preset veryfast -g 50 -c:a aac \
       -f hls -hls_time 2 -hls_list_size 5 -hls_flags delete_segments \
       /var/www/live/camera1/playlist.m3u8

L’en-tête CORS, une fois pour toutes

Quel que soit ce qui produit votre HLS, le serveur web qui le livre aux spectateurs doit envoyer :

Access-Control-Allow-Origin: *

Dans nginx :

location /live/ {
    add_header Access-Control-Allow-Origin * always;
    add_header Cache-Control "no-cache" always;
    types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; }
    root /var/www;
}

Sans lui, la vérification du flux signale que CORS est absent, et aucun navigateur ne lira le flux — avec ou sans pair-à-pair.

D'où vient votre flux

Pris en charge directement

HLS en HTTP ou HTTPS

Collez l'adresse de la playlist dans votre tableau de bord. Rien d'autre n'est nécessaire.

https://origin.example.com/live/stream/playlist.m3u8

Un fichier enregistré

Servez-le en HLS sur HTTP. N'importe quel serveur web convient.

https://files.example.com/vod/show/playlist.m3u8

À convertir d'abord

Multicast (UDP ou RTP)

Les navigateurs ne peuvent pas rejoindre un groupe multicast, donc ce serveur non plus. Convertissez-le d'abord en HLS sur votre propre réseau.

udp://@239.0.0.1:1234 → HLS

SRT

Un transport de contribution. Recevez-le sur un serveur, packagez-le en HLS, puis pointez ce système vers cette playlist.

srt://host:9000 → HLS

RTMP

Envoyez-le vers un serveur qui produit du HLS, puis utilisez ici l'adresse de cette playlist.

rtmp://host/app/key → HLS

RTSP (caméras)

Typique des caméras IP. Convertissez en HLS avec ffmpeg ou un serveur média, puis utilisez cette adresse.

rtsp://camera/stream → HLS

Pourquoi cette distinction existe

Tout ce qu’un spectateur lit est récupéré par son navigateur, en HTTP, sous forme de fichier doté d’une URL. C’est tout le fondement de la partie pair-à-pair : deux spectateurs ne peuvent partager un morceau de vidéo que s’ils peuvent tous deux le nommer de la même façon. Une URL est ce nom.

Le multicast, SRT, RTMP et RTSP sont tous des transports : ils acheminent un flux d’une machine à une autre. Aucun ne produit de fichiers adressables, et aucun navigateur ne parle l’un d’eux. C’est pourquoi ils sont d’abord convertis, et pourquoi la conversion se fait une fois et non pour chaque spectateur.

Choisir la durée des segments

-hls_time fixe la durée de chaque morceau. C’est le seul réglage qui mérite réflexion :

  • 2 secondes — latence plus faible, davantage de requêtes, moins de temps pour qu’un pair partage un morceau avant qu’il ne soit nécessaire.
  • 4 secondes — une bonne valeur par défaut, celle qu’utilisent les exemples ci-dessus.
  • 6 secondes ou plus — les meilleures chances que le pair-à-pair fonctionne bien, au prix de la latence.

Le pair-à-pair fonctionne mieux avec des segments plus longs, car un spectateur a plus de temps pour transmettre un morceau à un autre avant que la lecture n’en ait besoin. Si vous n’avez pas d’exigence stricte de latence, quatre secondes sont un point de départ raisonnable.

Garder des URL de segments stables

Deux spectateurs ne partagent un morceau de vidéo que s’ils demandent tous deux la même URL. Si votre CDN donne à chaque spectateur une adresse différente pour le même segment — un jeton par spectateur, un nom d’hôte par serveur —, alors deux spectateurs ne reconnaissent jamais un morceau comme étant le même, et l’essaim ne livre rien. La vérification du flux vous en avertit lorsqu’elle peut le détecter.

Surveiller votre flux

Ce que signifie le délestage

C'est la part de vidéo que vos spectateurs se sont livrée entre eux. Avec deux ou trois spectateurs elle est faible ; avec des dizaines, elle dépasse souvent la moitié.

Sur la page de votre chaîne

La ligne d’état sous le lecteur vous dit ce qui se passe, en termes simples : si le pair-à-pair est actif, si vous êtes le seul spectateur et si la lecture rencontre un problème. Si elle indique que le flux est inaccessible, la raison est affichée aussi.

Dans votre tableau de bord

Vérifier le flux maintenant lance immédiatement la vérification du flux : elle récupère votre playlist comme le ferait un navigateur et indique si elle est accessible, si CORS est configuré et ce qu’elle a trouvé à l’intérieur.

À quoi ressemble un bon fonctionnement

  • Deux spectateurs — le pair-à-pair se connecte, mais le délestage reste faible. Un spectateur doit télécharger depuis l’origine pour que l’autre ait quelque chose à recevoir.
  • Dix spectateurs — le délestage atteint couramment un tiers à la moitié.
  • Des dizaines de spectateurs — un délestage supérieur à la moitié est normal, et le trafic de l’origine cesse de croître au même rythme que votre audience. C’est tout l’intérêt.

Un délestage nul alors que plusieurs spectateurs regardent mérite une enquête : cela signifie généralement que les spectateurs ne parviennent pas à se joindre, ce qu’un relais TURN résout. Les réseaux mobiles sont le cas le plus courant.

Si des spectateurs signalent des erreurs

La page Analyse en direct de l’administrateur liste les erreurs signalées par les spectateurs, par flux, y compris le protocole HTTP utilisé par la requête en échec. Un flux qui se lit bien depuis votre propre machine mais échoue pour des spectateurs ailleurs a généralement un problème de CDN ou de géographie plutôt qu’un défaut dans le flux, et c’est cette colonne qui permet de faire la différence.

Glossaire

HLS
HTTP Live Streaming. Une façon d'envoyer de la vidéo sous forme de liste de petits fichiers que tout navigateur peut télécharger en HTTP ordinaire.
Playlist (.m3u8)
Le fichier texte qui énumère dans l'ordre les morceaux de votre flux. C'est cette adresse que vous collez dans votre tableau de bord.
Segment
Un petit fichier vidéo, en général de 2 à 6 secondes. C'est ce que les spectateurs se partagent.
Origine
Le serveur d'où vient réellement votre flux : votre encodeur, votre packager ou votre CDN. Le pair-à-pair réduit ce qu'il doit envoyer.
Essaim
Tous ceux qui regardent le même flux en même temps. Ils échangent des segments entre eux.
Meneur
Le spectateur que l'essaim a choisi pour télécharger depuis l'origine et alimenter les autres.
Pair
Un autre spectateur auquel votre navigateur est directement connecté.
WebRTC
La technologie de navigateur qui permet à deux spectateurs de s'envoyer des données sans passer par un serveur.
STUN
Un petit service qui indique à un navigateur à quoi ressemble sa propre adresse vue de l'extérieur, pour que deux spectateurs puissent se trouver.
TURN
Un relais utilisé quand deux spectateurs ne peuvent pas s'atteindre directement, ce qui est fréquent sur les réseaux mobiles. Ce serveur peut en héberger un.
Délestage
La part de la vidéo livrée par les spectateurs plutôt que par votre origine. Plus c'est élevé, moins c'est cher.
CORS
Une règle qui autorise une page web à lire des fichiers sur un autre serveur. Votre origine doit l'autoriser, sinon les navigateurs refuseront de lire le flux.
Multicast
Une façon d'envoyer une seule copie d'un flux à de nombreux récepteurs sur un réseau géré. Les navigateurs ne peuvent pas la recevoir : il faut d'abord convertir en HLS.
SRT
Un transport pour acheminer un flux de façon fiable entre serveurs sur l'internet public. C'est un format de contribution, pas quelque chose qu'un navigateur peut lire.
RTMP
Un protocole plus ancien, encore très utilisé pour envoyer un flux d'un encodeur vers un serveur. Les navigateurs ne peuvent pas le lire directement.
Transcoder
Ré-encoder la vidéo dans un autre format ou une autre qualité. Nécessaire quand votre source n'est pas déjà lisible par les navigateurs.
Packager
Découper un flux entrant en segments HLS et écrire la playlist, sans forcément ré-encoder la vidéo.