P2P Live — Manuale utente
Questo manuale spiega tutto ciò che serve a chi trasmette e a chi guarda: come funziona il servizio, come registrarsi, come deve essere il tuo flusso, come incorporare il player, come verificare che la distribuzione peer-to-peer (P2P) funzioni, quali sono i limiti e come risolvere i problemi più comuni.
In breve: registrati, incolla l’indirizzo del tuo flusso HLS (un URL
.m3u8) e ottieni una pagina pubblica all’indirizzohttps://p2p.gia.tv/tuo_nomepiù un codice di incorporamento. Gli spettatori di quella pagina condividono il video tra loro attraverso i browser, così il tuo server di streaming o la tua CDN consegna il flusso una volta invece che una volta per spettatore.
Come funziona
Ogni pagina di canale contiene un player HLS standard (hls.js) con un motore P2P collegato.
- Il primo spettatore di un canale scarica la playlist e i segmenti video dal tuo server di origine (l’indirizzo
.m3u8che hai inserito), esattamente come qualsiasi altro player. - Ogni spettatore successivo apre la stessa pagina. I player si trovano tramite il server di segnalazione di questo sito (un piccolo servizio WebSocket) e si collegano direttamente, da browser a browser, attraverso canali dati WebRTC.
- Ogni segmento video viene scaricato dall’origine da un solo spettatore (il leader dello sciame) e poi inoltrato agli altri attraverso le connessioni P2P. Se un segmento non arriva in tempo da un peer, il player lo scarica da solo dall’origine: la riproduzione non dipende mai dai peer.
- Ogni segmento viene verificato (hash e analisi del contenuto) prima di essere passato al player. Un peer non può inserire dati errati nella riproduzione di un altro spettatore.
- I player inviano statistiche anonime (byte dall’origine, byte dai peer, interruzioni, peer collegati), così vedi la quota di alleggerimento nella tua dashboard.
Cosa significa per te:
- Banda: con 50 spettatori la tua origine sostiene all’incirca il carico di 1–3 spettatori. Più spettatori ha un canale, più alto è l’alleggerimento (di solito 80–97 %).
- Qualità: gli spettatori guardano lo stesso flusso HLS con la stessa qualità. Il P2P cambia solo la provenienza dei byte.
- Affidabilità: se i peer sono lenti o spariscono, il player torna all’origine senza che si noti. Per questo l’origine deve essere sempre raggiungibile; il P2P ne riduce il carico, non la sostituisce.
- Privacy: i peer si scambiano solo segmenti video e piccoli messaggi di controllo. Tra gli spettatori non vengono scambiati dati personali. Tramite WebRTC gli spettatori possono vedere gli indirizzi IP degli altri, come in qualsiasi servizio video P2P.
Requisiti
Il tuo flusso deve soddisfare questi requisiti. Il pulsante Controlla il flusso ora nella dashboard ne verifica la maggior parte per te.
| Requisito | Perché | Come verificarlo |
|---|---|---|
HLS (playlist .m3u8) su http:// o https:// | Il player è un player HLS. RTMP, RTSP, DASH, l’ingest WebRTC e i semplici file MP4 non sono supportati direttamente. | Apri l’URL in un browser: deve scaricarsi un piccolo file di testo che inizia con #EXTM3U. |
Intestazione CORS Access-Control-Allow-Origin: * (o esattamente https://p2p.gia.tv) sulle playlist e sui segmenti, da ogni nodo della tua CDN | Senza di essa i browser rifiutano le richieste tra siti diversi. Senza CORS il flusso non si riproduce affatto, con o senza P2P. Un’intestazione che indica un altro sito non vale. | Dashboard → Controlla il flusso ora → «CORS». Oppure curl -sI -H 'Origin: https://p2p.gia.tv' TUO_URL e cerca l’intestazione. |
| https:// se i tuoi spettatori usano https (questo sito usa https) | I browser bloccano i contenuti http:// nelle pagine https:// (contenuto misto). | Assicurati che l’URL inizi con https://. |
| URL dei segmenti stabili | I peer si scambiano i segmenti per nome. Se ogni spettatore riceve un URL con un nome diverso per lo stesso segmento (token per spettatore, indicazioni del bilanciatore come lb_backend_hint, URL assoluti su server che cambiano), i peer non possono condividere. | Dashboard → Controlla il flusso ora → «Condivisione». Oppure apri due volte la playlist media: i nomi dei segmenti devono essere uguali. Gli URL firmati uguali per tutti gli spettatori vanno bene. |
| Durata dei segmenti 2–10 s | Segmenti molto corti (< 1 s) aumentano la segnalazione; molto lunghi (> 10 s) ritardano la condivisione tra peer. | #EXT-X-TARGETDURATION nella playlist media. |
| Codec: video H.264, audio AAC o MP3 (segmenti TS o fMP4); H.265/HEVC solo dove il browser lo supporta | I decodificatori del browser. | Con la vista diagnostica o il controllo della dashboard. |
Requisiti dell’origine
Il controllo verifica la playlist da questo server. Una CDN o un’origine che tratta gli spettatori in modo diverso a seconda del paese o della rete (blocco geografico, protezione dall’hotlinking, nodi regionali senza intestazioni CORS) può sembrare a posto qui e fallire comunque per alcuni spettatori. Questi spettatori vedono sotto il player Errore del flusso — l’origine ha rifiutato questo spettatore: HTTP 403 …, e lo stesso motivo compare a te in Amministrazione → Analisi in diretta (se amministri il sito): chiedi allo spettatore il motivo mostrato, o il registro eventi della vista diagnostica.
CORS
È di gran lunga il problema più frequente. La tua origine deve inviare Access-Control-Allow-Origin: * (o esattamente l’origine del sito, https://p2p.gia.tv) in ogni risposta: la playlist principale, le playlist media e i segmenti. Esempi:
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 nella cartella HLS)
Header always set Access-Control-Allow-Origin "*"
Header always set Access-Control-Allow-Headers "Range"
Wowza Streaming Engine: Application → Properties → Custom → aggiungi cupertinoUserHTTPHeaders = Access-Control-Allow-Origin: * (modulo cupertinostreaming), oppure usa l’impostazione CORS dell’origine HTTP.
CDN (Cloudflare, Akamai, CloudFront, Bunny…): attiva CORS nelle impostazioni dell’origine o della pull zone, con * come origine consentita. Su Cloudflare, «Transform Rules → Response headers» può aggiungere l’intestazione.
Prova dalla riga di comando (l’intestazione deve comparire nell’output):
curl -sI -H "Origin: https://p2p.gia.tv" https://your-server.example.com/live/stream/playlist.m3u8 | grep -i access-control
Sorgenti che funzionano bene
- Wowza, nginx-rtmp / nginx con il modulo HLS, Ant Media, Red5, MistServer, SRS, OvenMediaEngine (uscita HLS), Unified Streaming, Flussonic.
- OBS / vMix / encoder hardware → RTMP → uno dei precedenti → HLS.
- Qualsiasi CDN che prende il segnale dai precedenti, compresa la rete Tulix / SSH101.
- FFmpeg che scrive HLS su un server web:
ffmpeg -re -i input -c:v libx264 -preset veryfast -g 60 -c:a aac -f hls -hls_time 4 -hls_list_size 10 -hls_flags delete_segments /var/www/live/stream.m3u8. - Anche l’HLS on demand (una playlist con
#EXT-X-ENDLIST) funziona; lì il P2P va persino meglio, perché gli spettatori sono in punti diversi e possono condividere di più.
Registrazione
- Vai su https://p2p.gia.tv/signup.
- Scegli un nome utente: 3–20 caratteri, lettere minuscole, cifre e trattino basso. Diventa il tuo indirizzo pubblico
https://p2p.gia.tv/nome_utentee non potrà essere cambiato in seguito. - Inserisci la tua e-mail e una password (almeno 8 caratteri).
- Se vuoi, incolla subito il tuo indirizzo
.m3u8e un titolo per il canale, oppure aggiungili più tardi nella dashboard. - Accetta i Termini di utilizzo e la Politica di utilizzo accettabile. Devi possedere i diritti su tutto ciò che trasmetti.
- Fai clic su Crea il canale. Accedi subito e arrivi alla tua dashboard.
Su alcuni siti la registrazione è chiusa; in quel caso usa la pagina dei contatti.
La tua dashboard
https://p2p.gia.tv/dashboard mostra:
- lo stato del flusso (online/offline), quando è stato controllato l’ultima volta e l’errore se il controllo è fallito;
- gli spettatori ora e il picco di spettatori contemporanei;
- l’alleggerimento P2P: la quota di byte video che gli spettatori hanno ricevuto da altri spettatori invece che dalla tua origine, e i totali;
- la qualità: risoluzione, bitrate, numero di varianti, codec e risultato del controllo CORS, come rilevati dalla tua playlist;
- il modulo delle impostazioni del flusso: indirizzo, titolo, descrizione, URL della miniatura, indicatore 18+, indicatore «non elencato»;
- Condividi e incorpora: l’URL della tua pagina, il codice di incorporamento, l’URL di incorporamento e un link alla vista diagnostica;
- un grafico degli spettatori sulle 24 ore (non appena qualcuno ha guardato).
Controlla il flusso ora scarica la tua playlist lato server e mostra: online/offline, diretta o VOD, durata obiettivo, varianti, migliore risoluzione/bitrate, codec e se l’intestazione CORS è presente. I flussi vengono controllati anche automaticamente ogni pochi minuti; la pagina iniziale elenca solo i canali online.
Quando il sito invia e-mail, dopo la registrazione la dashboard ti chiede di confermare il tuo indirizzo e-mail (vedi Domande frequenti).
Opzioni del canale
- Titolo / descrizione / miniatura compaiono sulla tua pagina e nella griglia dei canali della pagina iniziale. La miniatura deve essere un URL di immagine https (JPEG/PNG/WebP, consigliato 16:9).
- Contenuti per adulti (18+) contrassegna il tuo canale. I canali per adulti sono nascosti dalla pagina iniziale se l’amministratore non li abilita; la pagina e l’incorporamento funzionano sempre. Trasmettere contenuti per adulti senza questo indicatore viola la Politica di utilizzo accettabile.
- Non elencato toglie il canale dalla pagina iniziale e dalla sitemap. La pagina e l’incorporamento continuano a funzionare. Utile per eventi privati o durante le prove.
La tua pagina di canale
https://p2p.gia.tv/nome_utente mostra il player, il titolo, la descrizione, il numero attuale di spettatori, il link di condivisione, il codice di incorporamento e un piccolo riquadro diagnostico.
Sotto il video c’è una riga di stato P2P:
| Stato | Significato |
|---|---|
| P2P funziona | Questo spettatore riceve segmenti dai peer (o è il leader dello sciame e ne serve altri). |
| P2P: avvio | Collegato alla segnalazione, in attesa di peer o del primo segmento condiviso. Normale per il primo spettatore e nei primi 10–20 secondi. |
| P2P non funziona | Vedi il testo accanto: WebRTC non disponibile, riproduzione nativa (Safari su iOS), segnalazione irraggiungibile o tutti i peer falliti. Il video continua a essere riprodotto dall’origine. |
La pagina non blocca mai la riproduzione a causa del P2P. Se qualcosa va storto, lo spettatore guarda semplicemente dall’origine.
Mobile: Chrome e Firefox su Android supportano il P2P. Safari su iOS riproduce l’HLS in modo nativo (senza Media Source Extensions), quindi iPhone e iPad riproducono sempre dall’origine e non partecipano al P2P. Safari su desktop partecipa.
Incorporamento
Copia il codice di incorporamento dalla dashboard o dalla pagina del canale:
<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>
Opzioni:
- Responsive: inserisci l’iframe in un contenitore e fallo riempire:
<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>
- Senza riproduzione automatica:
https://p2p.gia.tv/embed/user_name?autoplay=0mostra un pulsante di riproduzione. - La riproduzione automatica parte senza audio (i browser lo richiedono); un tocco su «Attiva audio» attiva il suono.
- WordPress: incolla l’iframe in un blocco «HTML personalizzato». Wix/Squarespace/Webflow: usa il loro elemento «codice di incorporamento».
- L’attributo
allow="autoplay …"è importante: senza di esso molti browser rifiutano la riproduzione automatica dentro un iframe. - Gli spettatori del player incorporato e quelli della pagina del canale sono nello stesso sciame; condividono segmenti tra loro.
Un player essenziale senza la grafica del sito si trova a https://p2p.gia.tv/?src=TUO_M3U8 (produzione) e https://p2p.gia.tv/debug.html?src=TUO_M3U8 (diagnostica). Usano lo stesso motore P2P e lo stesso sciame della tua pagina di canale, perché lo sciame è ricavato dall’URL del flusso.
Prove
Per vedere il P2P servono due player; un solo spettatore scarica sempre dall’origine.
- Apri la pagina del canale in un browser (ad esempio Chrome). Aspetta che il video parta.
- Apri la stessa pagina in un secondo browser (Firefox, Edge, un altro profilo di Chrome, una finestra in incognito o un altro computer/telefono su qualsiasi rete).
- Entro 10–20 secondi circa, la riga di stato del secondo player dovrebbe indicare P2P funziona. Il primo diventa il leader e mostra che serve dei peer.
- Per i dettagli apri il link Vista diagnostica (anche
https://p2p.gia.tv/debug.html?src=TUO_M3U8). Mostra ogni segmento con la sua provenienza (ORIGIN o PEER), i peer collegati, i byte in ciascuna direzione, lo stato della segnalazione, un riquadro di verifica che dice esattamente perché il P2P funziona o no, e una procedura di prova integrata.
Note:
- Funzionano anche due schede dello stesso browser, ma i browser rallentano le schede in secondo piano; tienile entrambe visibili.
- Le reti aziendali e alcuni operatori mobili bloccano WebRTC (UDP). Un server TURN (configurato dall’amministratore del sito) aiuta nella maggior parte di questi casi.
- Il primo spettatore mostra sempre download dall’origine; è normale. Guarda il secondo spettatore.
- La riproduzione dall’origine mentre lo stato indica «P2P: avvio» è normale per i primi segmenti.
Limiti
| Voce | Valore | Note |
|---|---|---|
| Canali per account | 1 | Crea altri account per altri flussi. |
| Spettatori per canale (sciame) | fino a 500 per impostazione predefinita | Stabilito dall’amministratore. Oltre il limite, i nuovi spettatori guardano ancora dall’origine, ma senza P2P. |
| Peer per spettatore | fino a 12 | Gestito automaticamente (il sito può cambiare il numero). |
| Lunghezza dell’indirizzo del flusso | 1024 caratteri | |
| Titolo / descrizione | 120 / 600 caratteri | |
| Carico sull’origine | da 1 a pochi download completi per sciame | Il leader più gli spettatori i cui peer sono troppo lenti. |
| Upload del player | limitato per peer e in totale | Gli spettatori con upload lento ne servono automaticamente meno. |
Risoluzione dei problemi
«Flusso offline» nella dashboard / nessun video
- Apri la tua
.m3u8in un browser: deve scaricarsi un file di testo con#EXTM3U. In caso contrario, la tua origine non risponde o l’URL è sbagliato. - Esegui Controlla il flusso ora e leggi l’errore.
403/404indicano che l’URL è sbagliato o protetto;timeout, che il server non risponde da Internet;no segments, che la playlist è vuota (l’encoder non è in funzione). - L’indirizzo deve iniziare con
https://quando gli spettatori usano questo sito in https (i browser bloccano il contenuto misto).
Funziona per me ma non per uno spettatore in un altro paese
- Chiedi allo spettatore cosa dice la riga di stato sotto il player. Errore del flusso — HTTP 403 o impossibile raggiungere il flusso significa che la tua origine o CDN tratta quella regione diversamente (restrizione geografica, protezione dall’hotlinking, un nodo senza intestazioni CORS); il controllo da questo server non può vederlo. Questo browser non riesce a decodificare il flusso è un problema di codec sul suo dispositivo. P2P: avvio o P2P non funziona mentre il video scorre va bene: il P2P è facoltativo.
- L’amministratore del sito vede gli stessi motivi per spettatore in Analisi in diretta.
- Dalla 2.1.0 la libreria del player è servita da questo sito stesso (nessuna CDN di terzi), quindi una CDN di script bloccata non è più una causa.
Funziona in VLC ma non nel browser
- Quasi sempre è CORS. Vedi CORS. VLC non ha bisogno di CORS, i browser sì.
- Oppure il codec: i browser di solito non riproducono video MPEG-2, HEVC senza supporto hardware o audio AC-3/E-AC-3. Usa H.264 + AAC.
«P2P non funziona: segnalazione irraggiungibile»
- La rete dello spettatore blocca le connessioni WebSocket, o interferisce un’estensione del browser. Il video continua dall’origine.
- Se succede a tutti, il sito si sta riavviando oppure un proxy davanti a esso non lascia passare le connessioni WebSocket (questione per l’amministratore).
«P2P non funziona: niente WebRTC» / «riproduzione nativa»
- Browser molto vecchi, alcuni browser orientati alla privacy con WebRTC disattivato, e Safari su iOS. Da parte tua non c’è nulla da fare.
«P2P: avvio» all’infinito con due spettatori
- Entrambi gli spettatori sono dietro NAT o firewall restrittivi e non c’è un server TURN. Chiedi all’amministratore di configurare TURN.
- I nomi dei segmenti cambiano a seconda dello spettatore (token di sessione negli URL). I peer annunciano i segmenti per nome; se i nomi sono diversi non si trovano. Usa un URL identico per tutti gli spettatori.
- I due player non sono nello stesso sciame: devono usare esattamente lo stesso URL del flusso (l’identificativo dello sciame si ricava da esso). Un
?token=diverso, ohttpinvece dihttps, crea sciami diversi.
Il video si blocca / va in buffering
- Controlla prima l’origine: se il flusso si blocca già per il primo spettatore, l’origine o l’encoder sono troppo lenti. Riduci il bitrate o correggi l’encoder.
- Mantieni i segmenti brevi (2–4 s) e la finestra della playlist ad almeno 6 segmenti; con una finestra di 3 segmenti non c’è margine per recuperare.
- I peer troppo lenti vengono ignorati automaticamente; il player scarica dall’origine entro la scadenza.
La pagina iniziale non mostra il mio canale
- Il canale deve essere online (controllato ogni pochi minuti; usa Controlla il flusso ora), non «non elencato», non 18+ (a meno che l’amministratore non lo abiliti), non bloccato, e l’account non deve essere disattivato. Alcuni siti elencano un canale solo dopo che il suo indirizzo e-mail è stato confermato.
L’incorporamento mostra un riquadro nero
- Usa esattamente il codice dell’iframe, compreso
allow="autoplay; …". Controlla nella console del browser se ci sono errori di contenuto misto o di CORS. Prova?autoplay=0.
Ho dimenticato la password
- https://p2p.gia.tv/reset se il sito ha configurato l’e-mail; altrimenti contatta l’amministratore.
Ho cambiato il mio indirizzo e-mail, ma le Impostazioni mostrano ancora quello vecchio
- È voluto: quando il sito invia e-mail, un nuovo indirizzo vale solo dopo che hai aperto il link di conferma che gli abbiamo inviato (entro 24 ore) e premuto Conferma. Fino ad allora le Impostazioni mostrano l’indirizzo come in attesa e il tuo account mantiene quello vecchio. Anche il vecchio indirizzo riceve un avviso. Per annullare una modifica, salva il modulo con il tuo indirizzo attuale.
Domande frequenti
Il mio video viene registrato o ritrasmesso? No. Il sito si limita a mettere in contatto i player. Il video viene preso dalla tua origine dai browser degli spettatori e passato tra loro. Sul server non viene salvato nulla.
Posso usare un flusso di un altro fornitore (ad esempio il mio canale Tulix/SSH101)? Sì, se hai il diritto di distribuirlo e l’origine invia le intestazioni CORS. La pagina dell’elenco SSH101 mostra un esempio di integrazione.
È gratuito? Sì. Il servizio è fornito così com’è, secondo i Termini di utilizzo. Gli abusi (violazione del diritto d’autore, contenuti illegali) portano al blocco; vedi la Politica di utilizzo accettabile.
Quanti spettatori posso avere? Quanti la tua origine potrebbe servirne senza P2P con circa il 5–20 % del carico. In pratica vale per ogni canale il limite di sciame fissato dall’amministratore (500 per impostazione predefinita).
Gli spettatori possono vedersi tra loro? Solo tecnicamente (indirizzi IP all’interno di WebRTC, come in qualsiasi servizio video P2P). Niente nomi, niente chat, nessuna cronologia.
Quali browser? Chrome, Edge, Firefox, Opera, Brave (con WebRTC consentito), Safari su desktop, Chrome/Firefox su Android. Safari su iOS riproduce senza P2P.
Funziona con DRM / HLS cifrato? Le playlist cifrate con AES-128 funzionano (i segmenti vengono condivisi cifrati; ogni spettatore prende la chiave dal tuo server delle chiavi). I DRM FairPlay/Widevine non sono supportati.
Posso cambiare il mio nome utente? No, è l’indirizzo permanente della tua pagina. Crea un nuovo account per un nuovo nome.
Posso eliminare il mio account? Sì: Impostazioni → Elimina account, con la password attuale. L’account e la pagina del canale vengono eliminati subito, gli spettatori collegati vengono disconnessi e al tuo indirizzo e-mail arriva un avviso. Non si può annullare. (Gli account amministratore vengono eliminati da un altro amministratore.)
Perché la dashboard mi chiede di confermare il mio indirizzo e-mail? Quando il sito invia e-mail, i nuovi account ricevono un link di conferma (valido 7 giorni). Aprilo e premi Conferma; Invia di nuovo il link nella dashboard ne invia uno nuovo (fino a 3 all’ora). Alcuni siti elencano un canale nella pagina iniziale solo dopo che il suo indirizzo è stato confermato.
Contatti
Domande e segnalazioni di abusi: pagina dei contatti · e-mail: info@tulix.com · abusi/DMCA: https://p2p.gia.tv/report.