📺 tvproxy

🚀 M3U8 Proxy Dockerizzato

Un server proxy leggero basato su Flask e Requests, progettato per:

📥 Scaricare e modificare flussi .m3u / .m3u8
🔁 Proxare i segmenti .ts, mantenendo header personalizzati
🚫 Superare restrizioni come Referer, User-Agent, ecc.
🐳 Essere facilmente dockerizzabile su qualsiasi macchina o server

☁️ Deploy su Render

Vai su Projects → Deploy a Web Service → Public Git Repo
Inserisci il repo: https://github.com/nzo66/tvproxy → Connect
Dai un nome a piacere
Imposta Instance Type su Free
Clicca su Deploy Web Service

🤗 Deploy su HuggingFace

ricora di fare factory rebuild per aggiornare il proxy se ci sono aggiornamenti!

Crea un nuovo Space
Scegli un nome qualsiasi e imposta Docker come tipo
Lascia Public e crea lo Space
Vai in alto a destra → ⋮ → Files → carica DockerfileHF rinominandolo Dockerfile
Infine vai su ⋮ → Embed this Space per ottenere il Direct URL

🐳 Docker (Locale o Server)

✅ Costruzione e Avvio

git clone https://github.com/nzo66/tvproxy.git
cd tvproxy
docker build -t tvproxy .
docker run -d -p 7860:7860 --name tvproxy tvproxy

🐧 Termux (Dispositivi Android)

✅ Costruzione e Avvio

pkg install git python -y
git clone https://github.com/nzo66/tvproxy.git
cd tvproxy
pip install -r requirements.txt'
gunicorn app:app -w 4 --worker-class gevent --worker-connections 100 -b 0.0.0.0:7860 --timeout 120 --keep-alive 5 --max-requests 1000 --max-requests-jitter 100

🐍 Avvio con Python (Locale)

✅ Setup e Avvio

# Clona il repository
git clone https://github.com/nzo66/tvproxy.git
cd tvproxy

# Installa le dipendenze
pip install -r requirements.txt

# Avvia il server
gunicorn app:app -w 4 --worker-class gevent --worker-connections 100 -b 0.0.0.0:7860 --timeout 120 --keep-alive 5 --max-requests 1000 --max-requests-jitter 100

🛠️ Gestione Docker

📄 Logs: docker logs -f tvproxy
⛔ Stop: docker stop tvproxy
🔄 Start: docker start tvproxy
🧹 Rimozione: docker rm -f tvproxy

🛠️ Come Utilizzare

Assicurati di sostituire i placeholder come <server-ip> con l'indirizzo IP o l'hostname effettivo del tuo server e <URL_...> con gli URL specifici.

1. Proxy per Liste M3U Complete 📡

Questo endpoint è progettato per proxare l'intera lista M3U. È particolarmente utile per garantire compatibilità e stabilità, con supporto menzionato per formati come Vavoo e Daddylive.

Formato URL:

http://<server-ip>:7860/proxy?url=<URL_LISTA_M3U>

Dove:

<server-ip>: L'indirizzo IP o hostname del tuo server proxy.
<URL_LISTA_M3U>: L'URL completo della lista M3U che vuoi proxare.

📝 Nota: Questo endpoint è ideale per gestire l'intera collezione di flussi contenuta in un file M3U.

2. Proxy per Singoli Flussi M3U8 (con Headers Personalizzati) 📺✨

Questo endpoint è specifico per proxare singoli flussi video .m3u8. La sua caratteristica distintiva è la capacità di inoltrare headers HTTP personalizzati, essenziale per scenari che richiedono autenticazione specifica o per simulare richieste da client particolari.

Formato URL Base:

http://<server-ip>:7860/proxy/m3u?url=<URL_FLUSSO_M3U8>

Esempio:

http://<server-ip>:7860/proxy/m3u?url=https://example.com/stream.m3u8

Dove:

<server-ip>: L'indirizzo IP o hostname del tuo server proxy.
<URL_FLUSSO_M3U8>: L'URL completo del singolo flusso M3U8.

🎯 Aggiungere Headers HTTP Personalizzati (Opzionale)

Per includere headers personalizzati nella richiesta al flusso M3U8, accodali all'URL del proxy. Ogni header deve essere prefissato da &h_, seguito dal nome dell'header, un segno di uguale (=), e il valore dell'header.

Formato per gli Headers:

&h_<NOME_HEADER>=<VALORE_HEADER>

Esempio con Headers Personalizzati:

http://<server-ip>:7860/proxy/m3u?url=https://example.com/stream.m3u8&h_user-agent=Mozilla/5.0...&h_referer=https://ilovetoplay.xyz/&h_origin=https://ilovetoplay.xyz

⚠️ Attenzione:

Ricorda di sostituire Mozilla/5.0... con lo User-Agent completo che intendi utilizzare.

Se i valori degli header contengono caratteri speciali (es. spazi, due punti), assicurati che siano correttamente URL-encoded per evitare errori.

✅ Caratteristiche

📁 Supporta .m3u e .m3u8 automaticamente
🧾 Inoltra gli HTTP Headers necessari (Auth, Referer, etc.)
🔓 Supera restrizioni geografiche o di accesso
🖥️ Compatibile con qualsiasi player IPTV
🐳 Totalmente dockerizzato, pronto per il deploy
🐍 Avviabile anche direttamente con Python

🎉 Fine!

Ora puoi guardare flussi M3U8 ovunque, senza restrizioni!
Enjoy the Stream 🚀