tvproxy 📺

Un server proxy avanzato e dockerizzato basato su Flask e Requests, progettato per superare restrizioni e accedere a flussi M3U/M3U8 senza interruzioni con funzionalità avanzate di monitoraggio e ottimizzazione.

• 📥 Scarica e modifica flussi .m3u e .m3u8 al volo
• 🔁 Proxa i segmenti .ts mantenendo header personalizzati
• 🚫 Supera restrizioni comuni come Referer, User-Agent, ecc.
• 🐳 Facilmente dockerizzabile su qualsiasi macchina, server o piattaforma cloud
• 🧪 Dashboard web completa per amministrazione e monitoraggio in tempo reale
• ⚡ Sistema di pre-buffering per eliminare il buffering durante lo streaming
• 🌟 Proxy DaddyLive dedicati con gestione separata e blacklist automatica
• 🔍 Risoluzione Vavoo integrata per link Vavoo.to
• 📊 WebSocket real-time per statistiche live e aggiornamenti istantanei
• 🛡️ Sistema di blacklist intelligente per proxy con errori 429
• 🔧 Configurazione dinamica senza riavvio del server

• Configurazione Autenticazione
• Configurazione per Server con 1 GB di RAM
• Piattaforme di Deploy
• Setup Locale
• Dashboard di Amministrazione
• Utilizzo del Proxy
• Configurazione Proxy
• Proxy DaddyLive Dedicati
• Sistema di Pre-Buffering
• Risoluzione Vavoo
• Gestione Docker
• Caratteristiche Principali

⚠️ Obbligatorio: impostare ADMIN_PASSWORD e SECRET_KEY.
🔑 Usa un valore univoco per SECRET_KEY, ad esempio generato con:
openssl rand -hex 32
oppure:
python -c 'import secrets; print(secrets.token_hex(32))'

docker run -d -p 7860:7860 \
  -e ADMIN_PASSWORD=tua_password_sicura \
  -e SECRET_KEY=1f4d8e9a6c57bd2eec914d93cfb7a3efb9ae67f2643125c89cc3c50e75c4d4c3 \
  --name tvproxy tvproxy

ADMIN_PASSWORD=tua_password_sicura
SECRET_KEY=1f4d8e9a6c57bd2eec914d93cfb7a3efb9ae67f2643125c89cc3c50e75c4d4c3

# OBBLIGATORIO
ADMIN_PASSWORD=tua_password_sicura
SECRET_KEY=chiave_segreta_generata

# Ottimizzazioni memoria
REQUEST_TIMEOUT=30
KEEP_ALIVE_TIMEOUT=120
MAX_KEEP_ALIVE_REQUESTS=100
POOL_CONNECTIONS=5
POOL_MAXSIZE=10

# Cache ridotta
CACHE_TTL_M3U8=2
CACHE_TTL_TS=60
CACHE_TTL_KEY=60
CACHE_MAXSIZE_M3U8=50
CACHE_MAXSIZE_TS=200
CACHE_MAXSIZE_KEY=50

# Pre-buffering ridotto
PREBUFFER_ENABLED=true
PREBUFFER_MAX_SEGMENTS=2
PREBUFFER_MAX_SIZE_MB=20
PREBUFFER_MAX_MEMORY_PERCENT=15

Se vuoi disabilitare completamente la cache (ad esempio per streaming diretto e contenuti sempre aggiornati), puoi farlo aggiungendo questa riga al tuo file .env oppure dall'interfaccia web:

CACHE_ENABLED=False

1. Projects → New → Web Service → Public Git Repo.
2. Repository: https://github.com/nzo66/tvproxy → Connect.
3. Scegli un nome, Instance Type Free (o superiore).
4. Aggiungi le variabili ADMIN_PASSWORD e SECRET_KEY nell'area Environment.
5. (Opzionale) Aggiungi SOCKS5_PROXY, HTTP_PROXY, HTTPS_PROXY, DADDY_PROXY.
6. Create Web Service.

1. Crea un nuovo Space (SDK: Docker).
2. Carica DockerfileHF come Dockerfile.
3. Vai in Settings → Secrets e aggiungi ADMIN_PASSWORD e SECRET_KEY.
4. OBBLIGATORIO: Aggiungi DADDY_PROXY per servizi DaddyLive (SOCKS5 non supportato su HF).
5. (Opzionale) Aggiungi HTTP_PROXY + HTTPS_PROXY per proxy generali.
6. Dopo ogni modifica alle variabili fai Factory Rebuild.

Per HuggingFace Spaces, è OBBLIGATORIO utilizzare questa configurazione ottimizzata. Aggiungi le seguenti variabili nei Secrets del tuo Space:

# OBBLIGATORIO
ADMIN_PASSWORD=tua_password_sicura
SECRET_KEY=chiave_segreta_generata

# OBBLIGATORIO per HuggingFace - Proxy DaddyLive
DADDY_PROXY=http://user:pass@proxy1:8080,https://user:pass@proxy2:8080

# Cache Ottimizzata
CACHE_TTL_M3U8=5
CACHE_MAXSIZE_M3U8=500
CACHE_TTL_TS=600
CACHE_MAXSIZE_TS=8000
CACHE_TTL_KEY=600
CACHE_MAXSIZE_KEY=1000

# Pool di Connessioni Potenziato
POOL_CONNECTIONS=50
POOL_MAXSIZE=300
MAX_KEEP_ALIVE_REQUESTS=5000
KEEP_ALIVE_TIMEOUT=900
REQUEST_TIMEOUT=45

# Pre-buffering ottimizzato
PREBUFFER_ENABLED=true
PREBUFFER_MAX_SEGMENTS=3
PREBUFFER_MAX_SIZE_MB=50
PREBUFFER_MAX_MEMORY_PERCENT=25

# Domini senza proxy
NO_PROXY_DOMAINS=github.com,raw.githubusercontent.com

Perché questa configurazione?

• DADDY_PROXY Obbligatorio: HuggingFace richiede proxy HTTP/HTTPS per servizi DaddyLive
• Cache Ottimizzata: Valori più elevati per gestire meglio i flussi video frequenti
• Pool di Connessioni Potenziato: Gestisce più connessioni simultanee nell'ambiente cloud
• Timeout Bilanciati: Equilibrio tra stabilità e performance per connessioni di lunga durata
• Pre-buffering Intelligente: Riduce il buffering durante lo streaming

⚠️ IMPORTANTE: Su HuggingFace Spaces, i proxy SOCKS5 non sono supportati. Usa solo proxy HTTP/HTTPS per DADDY_PROXY.

git clone https://github.com/nzo66/tvproxy.git
cd tvproxy
docker build -t tvproxy .

docker run -d -p 7860:7860 \
  -e ADMIN_PASSWORD=tua_password_sicura \
  -e SECRET_KEY=chiave_segreta_generata \
  --name tvproxy tvproxy

pkg update && pkg upgrade
pkg install git python nano -y

git clone https://github.com/nzo66/tvproxy.git
cd tvproxy
pip install -r requirements.txt

echo "ADMIN_PASSWORD=tua_password_sicura" > .env
echo "SECRET_KEY=chiave_segreta_generata" >> .env

gunicorn app:app -w 4 --worker-class gevent -b 0.0.0.0:7860

git clone https://github.com/nzo66/tvproxy.git
cd tvproxy
pip install -r requirements.txt

echo "ADMIN_PASSWORD=tua_password_sicura" > .env
echo "SECRET_KEY=chiave_segreta_generata" >> .env

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

• 🏠 Home: http://<server-ip>:7860/
• 🔐 Login: http://<server-ip>:7860/login
• 📊 Dashboard: http://<server-ip>:7860/dashboard
• ⚙️ Config: http://<server-ip>:7860/admin/config
• 📝 Log: http://<server-ip>:7860/admin/logs
• 👥 Client: http://<server-ip>:7860/admin/clients
• 📈 API Stats: http://<server-ip>:7860/stats

• 📊 Statistiche Real-time: WebSocket per aggiornamenti istantanei
• 🛡️ Gestione Proxy: Monitoraggio blacklist e stato proxy
• ⚡ Pre-buffering: Controllo e configurazione del sistema di pre-buffering
• 💾 Gestione Memoria: Monitoraggio RAM e pulizia automatica
• 👥 Tracking Client: Statistiche sui client connessi e loro utilizzo
• 🔧 Configurazione Dinamica: Modifica impostazioni senza riavvio

Sostituisci <server-ip> con l'indirizzo del tuo server.

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

http://<server-ip>:7860/proxy/m3u?url=<URL_FLUSSO_M3U8>&h_<HEADER>=<VALORE>

Esempio:

.../proxy/m3u?url=https://example.com/stream.m3u8&h_user-agent=VLC/3.0.20&h_referer=https://example.com/

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

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

Esempio:

.../proxy/vavoo?url=https://vavoo.to/vavoo-iptv/play/277580225585f503fbfc87

http://<server-ip>:7860/proxy/prebuffer?m3u8_url=<URL_M3U8>&stream_id=<ID_STREAM>

http://<server-ip>:7860/proxy/key?url=<URL_CHIAVE>&h_<HEADER>=<VALORE>

Riconoscimento Automatico: Il sistema rileva automaticamente il tipo di proxy (SOCKS5, HTTP, HTTPS) e normalizza gli URL.

Esempio .env completo:

ADMIN_PASSWORD=tua_password_sicura
SECRET_KEY=chiave_segreta_generata

# Proxy Generali
SOCKS5_PROXY=socks5://user:pass@host1:1080,socks5://user:pass@host2:1080
HTTP_PROXY=http://user:pass@host:8080
HTTPS_PROXY=http://user:pass@host:8080

# Proxy DaddyLive Dedicati
DADDY_PROXY=socks5://user:pass@daddy1:1080,http://user:pass@daddy2:8080

# Domini senza proxy
NO_PROXY_DOMAINS=github.com,raw.githubusercontent.com,vavoo.to

Il sistema utilizza proxy dedicati per i servizi DaddyLive, identificati automaticamente da:

• Domini: newkso.ru (qualsiasi sottodominio)
• Path: URL che contengono /stream- nel percorso
• Fallback: Se i proxy DaddyLive non sono disponibili, usa i proxy normali

• 🎯 Ottimizzazione: Proxy dedicati per servizi specifici
• 🛡️ Blacklist Separata: Gestione errori 429 indipendente
• 📊 Statistiche Dedicati: Monitoraggio separato per proxy DaddyLive
• 🔄 Fallback Automatico: Passaggio ai proxy normali se necessario

# Proxy dedicati per DaddyLive
DADDY_PROXY=socks5://user:pass@daddy1:1080,http://user:pass@daddy2:8080,https://user:pass@daddy3:8080

• 🚀 Pre-scarica: I segmenti successivi vengono scaricati in background
• 💾 Gestione Memoria: Controllo automatico dell'uso RAM
• 🔄 Pulizia Automatica: Rimozione buffer inattivi
• ⚙️ Configurabile: Parametri personalizzabili dall'interfaccia web

# Pre-buffering
PREBUFFER_ENABLED=true
PREBUFFER_MAX_SEGMENTS=3
PREBUFFER_MAX_SIZE_MB=50
PREBUFFER_CLEANUP_INTERVAL=300
PREBUFFER_MAX_MEMORY_PERCENT=30
PREBUFFER_EMERGENCY_THRESHOLD=90

• 📊 Stato: /admin/prebuffer/status
• 🧹 Pulizia: /admin/prebuffer/clear
• 🧪 Test: /admin/prebuffer/test
• 💾 Memoria: /admin/memory/status

Il sistema include risoluzione automatica per link Vavoo:

• 🔗 Pattern Supportati:

  • https://vavoo.to/vavoo-iptv/play/[ID]
  • https://vavoo.to/play/[ID]

• 🎯 Endpoint Dedicato: /proxy/vavoo?url=<URL_VAVOO>

http://<server-ip>:7860/proxy/vavoo?url=https://vavoo.to/vavoo-iptv/play/277580225585f503fbfc87

• 🔄 Retry Automatico: Tentativi multipli per errori temporanei
• 🛡️ Gestione Errori: Fallback all'URL originale in caso di errore
• 📊 Logging Dettagliato: Tracciamento completo del processo di risoluzione

• ⏰ Blacklist Temporanea: 5 minuti per errori 429
• 🔒 Blacklist Permanente: 1 ora dopo 5 errori consecutivi
• 🔄 Pulizia Automatica: Rimozione automatica dei proxy scaduti
• 📊 Statistiche Separate: Conteggi distinti per proxy normali e DaddyLive

# Domini senza proxy (evitano blacklist)
NO_PROXY_DOMAINS=github.com,raw.githubusercontent.com,vavoo.to

docker logs -f tvproxy      # log in tempo reale
docker stop tvproxy         # ferma il container
docker start tvproxy        # avvia il container
docker rm -f tvproxy        # rimuovi il container

• ✅ Supporto automatico .m3u / .m3u8
• ✅ Headers personalizzati (Authorization, Referer, ...)
• ✅ Aggira restrizioni geografiche
• ✅ Compatibile con qualsiasi player IPTV
• ✅ Totalmente dockerizzato

• ✅ Dashboard web completa con statistiche, log, configurazioni
• ✅ Autenticazione sicura + whitelist IP
• ✅ Monitoraggio RAM / rete in tempo reale
• ✅ Cache intelligente M3U8 / TS / AES
• ✅ Configurazioni dinamiche senza riavvio

• ✅ Proxy DaddyLive dedicati con gestione separata
• ✅ Sistema di pre-buffering per eliminare il buffering
• ✅ Risoluzione Vavoo integrata
• ✅ WebSocket real-time per statistiche live
• ✅ Sistema di blacklist intelligente per proxy
• ✅ Tracking client con statistiche dettagliate
• ✅ Gestione memoria avanzata con pulizia automatica
• ✅ Retry logic per errori temporanei
• ✅ Riconoscimento automatico tipo proxy (SOCKS5, HTTP, HTTPS)
• ✅ Statistiche IP (IPv4, IPv6, hostname) separate per tipo proxy

Goditi i tuoi flussi preferiti ovunque, senza restrizioni, con controllo completo e monitoraggio avanzato. Il sistema ora include funzionalità enterprise per gestione proxy avanzata, pre-buffering intelligente e risoluzione automatica di servizi popolari.