SPB Git

Repository Public

RELAY.md 11.2 KB 145 lines markdown

1# Relay Engine — moteur de relais vidéo de SP TV23Mis en service le 2026-11-17 sur m4mn. SP TV garde son fonctionnement d'origine — l'appareil lit le flux directement chez4le diffuseur — et y ajoute un moteur de relais **pour les seules sources que le propriétaire déclare autorisées** :5ses propres fichiers (« chaînes maison »), ses serveurs, un fournisseur dont les conditions permettent la rediffusion6privée, un flux sous licence libre. Pour ces sources, le serveur ouvre **une** connexion vers la source et la sert à7autant d'écrans que voulu.89## Ce que le moteur fait, et ce qu'il ne fait pas1011| Fait | Ne fait pas |12|---|---|13| une connexion entrante par chaîne, partagée entre les lecteurs | relayer une source non autorisée (refus 403, quelle que soit la demande) |14| copie du flux sans réencodage quand c'est du H.264 ; transcodage (VideoToolbox) sinon | contourner un DRM : un flux protégé échoue à l'analyse et le dit |15| démarrage à la demande, arrêt après le délai d'inactivité | forger des en-têtes (`Referer`, `User-Agent`) : ces flux ne sont pas relayés |16| tampon de lecture réglable, différé (retour en arrière) si l'enregistrement est autorisé | changer d'adresse IP ou de pays : l'ingestion part du nœud, rien d'autre |17| mesure réelle du processeur, de la mémoire et des débits | dépasser le nombre de connexions qu'une source permet |18| adresses de lecture temporaires, liées à la connexion du propriétaire | exposer MediaMTX : il n'écoute que sur 127.0.0.1 |1920## Architecture2122```23navigateur / télé ──HTTPS──▶ Caddy (BHS64) ──wg──▶ Next.js :867024                                                     │  /api/relay/open   session → URL temporaire25                                                     │  /relay/<jeton>/…  playlists, segments, différé26                                                     ▼27                                      MediaMTX 127.0.0.1:8672 (HLS) · 8673 (API) · 8674 (différé) · 8675 (RTSP)28                                                     ▲ publication RTSP locale29                              src/relay/ingest.ts ── FFmpeg ──▶ source autorisée (ou fichiers de la bibliothèque)30```3132| Service (brief) | Fichier | Rôle |33|---|---|---|34| `SourceManager` | `src/server/relay/sources.ts` | sources et leur autorisation, résolution de l'entrée d'un relais (adresse ou fichiers), contrôle de destination |35| `RelayManager` | `src/server/relay/relays.ts` | un relais par flux (ou par connexion si la source interdit le partage), limites, arrêt |36| `StreamSessionManager` | `src/server/relay/sessions.ts` | une session par lecteur, compteurs, expiration |37| `TranscodeManager` | `src/server/relay/transcode.ts` | analyse `ffprobe`, choix copie / transcodage, arguments FFmpeg |38| `StreamHealthMonitor` | `src/server/relay/health.ts` (dans le worker) | mesures toutes les 5 s, sessions muettes fermées, source figée relancée |39| `RelayAccessControl` | `src/server/relay/access.ts` | autorisation par source, éligibilité d'un flux, jetons de session |40| — | `src/server/relay/config.ts`, `mtx.ts`, `events.ts` | configuration générée de MediaMTX, client de son API, journal |41| — | `src/relay/ingest.ts` | processus d'ingestion lancé par MediaMTX (`runOnDemand`) |42| — | `src/app/relay/[...path]/route.ts` | seule porte d'entrée vers MediaMTX |4344**Déroulement** quand une chaîne relayée est choisie : 1. session SP TV vérifiée (`POST /api/relay/open`) ; 2. la source45autorise-t-elle le relais ? ; 3. un relais existe-t-il déjà pour ce flux ? il est réutilisé ; 4. sinon le flux est analysé46(`ffprobe`) et le relais préparé, limites vérifiées ; 5. une adresse `/relay/<jeton>/index.m3u8` est rendue ; 6. à la47première requête, MediaMTX lance l'ingestion ; 7. le worker mesure ; 8. sans lecteur pendant le délai d'inactivité,48MediaMTX arrête l'ingestion (SIGINT) et FFmpeg avec elle.4950Le relais publie toujours **H.264 + AAC** en HLS (segments MPEG-TS de 2 s), ce que lisent Safari (natif), hls.js et les51applications de télévision. Tables : `relays`, `relay_sessions`, `relay_events`, `relay_samples` ; colonne `sources.relay`52(migration 7).5354## Autoriser une source5556Administration → **Relay Engine** → « Sources et autorisation de relais ». Pour chaque source : le fondement de57l'autorisation (texte obligatoire), une déclaration à cocher, puis trois options — mutualiser le flux, autoriser58l'enregistrement (différé), nombre de connexions simultanées permises par la source. Retirer l'autorisation arrête les59relais en cours de cette source.6061**Chaîne maison** : Administration → Sources → « Chaîne maison (vos fichiers en boucle) ». Un film ou une série de la62bibliothèque personnelle devient une chaîne continue ; un seul fichier H.264 est recopié, plusieurs fichiers sont63réencodés en un format uniforme (720p).6465## Réglages (Administration → Relay Engine → Réglages)6667| Réglage | Défaut | Effet |68|---|---|---|69| Relais simultanés | 6 | au-delà : « Nombre maximal de relais simultanés atteint » (vérifié à l'ouverture et au démarrage de l'ingestion) |70| Transcodages simultanés | 2 | ne compte que les relais qui réencodent la vidéo |71| Lecteurs simultanés | 12 | tous relais confondus |72| Tampon de lecture | 12 s | retard volontaire sur le direct (hls.js) et fenêtre gardée par MediaMTX |73| Délai d'inactivité | 30 s | sans lecteur : arrêt du relais (observé : 35 à 60 s après le dernier lecteur) |74| Débit sortant par lecteur | 0 (sans limite) | limitation appliquée par la route `/relay` |75| Débit vidéo des transcodages | 4 500 kb/s | plafond ; 3 500 en 720p, 1 600 en 480p |76| Durée du différé | 120 min | enregistrements dans `~/data/sp-tv/relay/rec`, effacés par MediaMTX |77| Tentatives de reconnexion | 8 | délai croissant (1, 2, 4… 15 s) |7879Un changement réécrit `~/data/sp-tv/relay/mediamtx.yml`, que MediaMTX recharge seul.8081## Reconnexion8283- **Pendant le démarrage** (la source ne répond pas encore) : l'ingestion relance FFmpeg avec un délai croissant ; après84  le nombre maximal de tentatives le relais passe « En échec » et le lecteur reçoit l'erreur réelle.85- **En cours de lecture** : quand la source tombe, MediaMTX ferme le flux et ses lecteurs (son option86  « toujours disponible » est incompatible avec le démarrage à la demande — vérifié, erreur de configuration). Le87  lecteur de SP TV rouvre alors lui-même sa session, deux fois au plus, ce qui redémarre le relais.88- **Source figée** (connexion ouverte, plus aucune donnée pendant 20 s) : le moniteur termine le FFmpeg bloqué.89- Une application de télévision qui lit une playlist M3U redemande simplement l'adresse de la chaîne.9091## Sécurité9293- MediaMTX : toutes les écoutes sur `127.0.0.1` (HLS, API, différé, RTSP) ; RTMP, WebRTC, SRT, MoQ, métriques désactivés ;94  publication réservée à l'utilisateur `ingest` (secret dérivé d'`APP_SECRET`) depuis la boucle locale.95- Lecture : jeton aléatoire de 256 bits dans le chemin, dont seul le SHA-256 est stocké ; valable tant que la session96  dure (12 h au plus, fermée après silence) **et** tant que la connexion SP TV qui l'a ouverte existe — se déconnecter97  invalide aussitôt l'adresse (401, puis 410). HTTPS par Caddy.98- SSRF : adresse `http(s)` publique seulement, vérifiée sur le nom et sur chaque adresse résolue avant FFmpeg ; FFmpeg est99  lancé avec `-protocol_whitelist http,https,tcp,tls,crypto` (aucun accès aux fichiers locaux par une playlist).100- L'adresse réelle d'une source n'apparaît dans aucune réponse, page ou journal ; le journal du relais masque toute adresse.101- Limites : l'adresse de la source et le secret de publication sont visibles dans la liste des processus **du nœud**102  (arguments de FFmpeg) ; une redirection HTTP suivie par FFmpeg n'est pas revérifiée contre les adresses privées.103104## Exploitation105106```bash107ssh m4mn108pm2 logs sp-tv-relay            # MediaMTX109pm2 restart sp-tv-relay         # régénère la configuration puis relance (les relais en cours s'arrêtent)110bash ~/apps/sp-tv/scripts/relay-install.sh   # (ré)installe MediaMTX v1.21.4 dans ~/opt/mediamtx, somme vérifiée111curl -s http://127.0.0.1:8673/v3/paths/list  # ce que MediaMTX diffuse112```113114## Tests réels (2026-11-17)115116Sources utilisées : trois chaînes maison faites des films Blender de la bibliothèque (CC BY) et, en local, une mire117générée sur le poste. Aucun flux tiers n'a été relayé.118119| Scénario du brief | Test | Résultat |120|---|---|---|121| Une chaîne, un lecteur | production, Firefox + WebKit iPhone + iPad : image décodée, horloge qui avance, relais « En diffusion », débit entrant mesuré | réussi ; première image en 5 à 15 s (dépend de l'intervalle des images clés du fichier recopié) |122| Une chaîne, trois lecteurs | trois sessions de navigateur distinctes sur la même chaîne | 3 lus, **1** relais, **1** FFmpeg, 3 clients comptés |123| Plusieurs chaînes simultanées | 3 chaînes en même temps en production | 3 lues ; 61 % d'un cœur et 569 Mo au total (copie 360p : 3,7 % ; HEVC → H.264 240p : 14,6 % ; 3 fichiers 1080p → 720p : 39 %) |124| Déconnexion et reconnexion | FFmpeg tué sur le nœud pendant la lecture (production) ; source HTTP coupée 14 s puis rétablie (local) | lecture rétablie seule, sans message d'erreur, en 33 s environ (local) ; relais redémarré et lecture confirmée 54 s après la coupure (production) |125| Arrêt automatique | lecteur fermé, puis interrogation de l'administration | relais arrêté et 0 FFmpeg 35 à 60 s plus tard |126| Transcodage compatible | Sintel HEVC + AC-3 (MKV) → H.264 + AAC ; série de 3 fichiers → 720p uniforme | lus dans Firefox et WebKit |127| Authentification | sans session : 401 ; jeton inconnu : 410 ; adresse valide puis déconnexion : 401 puis 410 ; source non autorisée : 403 ; autorisation sans déclaration : 400 | réussi |128| Résistance aux erreurs réseau | voir « Déconnexion et reconnexion » ; MediaMTX injoignable hors boucle locale (connexion refusée depuis l'adresse LAN) | réussi |129| Différé | −30 s depuis l'enregistrement, puis retour au direct | réussi dans Firefox et WebKit (extrait servi par plages d'octets) |130131Suite automatisée : `tests/unit/relay.test.ts` (16 tests) et `tests/e2e/relay.spec.ts` — en production, 17 réussis et1323 exclus prévus (le Chromium de Playwright n'a pas de décodeur H.264) sur 20.133134## Non vérifié135136- Le relais d'une **source tierce réelle** (fournisseur à API Xtream, flux public sous licence) : aucune n'a été déclarée137  autorisée ; le chemin « adresse réseau » n'a été exercé qu'avec une mire locale.138- Un vrai téléphone, AirPlay, une application de télévision lisant une playlist M3U qui passe par le relais (la route est139  écrite et renvoie une adresse de session ; aucun appareil réel ne l'a lue).140- Une source non partageable (un relais par connexion) et le plafond de connexions d'une source : couverts par les tests141  unitaires seulement.142- La limitation du débit sortant en conditions réelles ; plus de 3 chaînes ou plus de 3 lecteurs simultanés.143- Un fichier recopié dont les images clés sont espacées de 10 s donne des segments de 10 s (MediaMTX prévient que la144  durée variable peut gêner iOS) : Big Buck Bunny est dans ce cas et a été lu sous WebKit, pas sur un vrai iPhone.145
Files main
Menu

Theme