Come usare i proxy con yt-dlp (HTTP, SOCKS5 e Tor)

yt-dlp è il downloader video più potente oggi, ma anche lui ha dei limiti. Potresti incontrare video geo-limitati disponibili solo in alcuni paesi, oppure ban IP da parte dei siti che rilevano troppe richieste.

La soluzione è instradare il traffico attraverso un proxy. Questa guida copre tutto ciò che devi sapere per usare i proxy con yt-dlp, dalle configurazioni HTTP più semplici fino alla protezione avanzata della privacy con Tor.

Perché usare un proxy con yt-dlp?

Aggirare il geo-blocking: guardare e scaricare contenuti limitati a regioni specifiche (ad es. BBC iPlayer fuori dal Regno Unito o cataloghi Crunchyroll).
Evitare il rate limiting: se stai archiviando un canale o scaricando una playlist, siti come YouTube potrebbero bloccare temporaneamente il tuo IP (Errore 429). La rotazione dei proxy aiuta a evitarlo.
Privacy: nascondere il tuo IP domestico dai siti con cui interagisci.

Uso base dei proxy

Il flag principale per usare un proxy in yt-dlp è --proxy. Supporta protocolli HTTP, HTTPS e SOCKS.

Proxy HTTP/HTTPS

È il tipo di proxy più comune.

yt-dlp --proxy "http://user:[email protected]:8080" "https://www.youtube.com/watch?v=..."

Dettaglio della sintassi:

http:// - Protocollo (spesso può essere omesso, ma è meglio essere espliciti).
user:password - (Opzionale) Autenticazione se il proxy lo richiede.
@ - Separatore tra credenziali e indirizzo del server.
proxy.example.com - IP o hostname del server proxy.
8080 - Numero di porta.

Proxy SOCKS5

SOCKS5 è spesso preferito per un tunneling del traffico più versatile.

yt-dlp --proxy "socks5://user:[email protected]:1080" "https://..."

Usare yt-dlp con Tor

Per massima privacy, o per aggirare censure difficili, puoi instradare yt-dlp attraverso la rete Tor.

Prerequisito: devi avere il servizio Tor installato e in esecuzione. Per impostazione predefinita, Tor apre un proxy SOCKS5 sulla porta 9050.

yt-dlp --proxy "socks5://127.0.0.1:9050" "https://www.youtube.com/watch?v=..."

Nota: scaricare tramite Tor sarà significativamente più lento di una connessione standard. È meglio riservarlo a contenuti a cui non puoi accedere in altro modo.

Configurazione permanente

Digitare l’URL del proxy ogni volta è noioso. Puoi salvare le impostazioni in un file di configurazione.

Crea o modifica il file di config:
- Linux/macOS: ~/.config/yt-dlp/config
- Windows: %APPDATA%\\yt-dlp\\config
Aggiungi la riga del proxy:

--proxy "http://user:[email protected]:8080"

Ora, ogni volta che esegui yt-dlp, userà automaticamente quel proxy.

Gestire “429 Too Many Requests”

Se stai facendo scraping di dati o scaricando playlist enormi, un singolo proxy può essere bannato. In questo caso, serve una strategia di rotazione dei proxy.

Anche se yt-dlp non ha un “rotator” integrato, puoi ottenere lo stesso risultato usando un provider che gestisce la rotazione lato loro (un unico gateway che cambia IP di uscita), oppure scrivendo un piccolo wrapper script che cicla una lista di proxy.

Esempio: usare un servizio di proxy rotante

Molti servizi premium offrono un gateway “sticky” o “rotating”.

# Esempio per un servizio che ruota IP a ogni richiesta
yt-dlp --proxy "http://rotating-gateway.provider.com:port" ...

Troubleshooting

“Connection Refused”

Verifica che IP e porta del proxy siano corretti.
Controlla se il firewall sta bloccando la connessione.
Se usi Tor, assicurati che Tor Browser o il servizio in background sia davvero in esecuzione.

“Proxy Authentication Required”

Assicurati di aver incluso la parte user:password nell’URL.
Se la password contiene caratteri speciali (come @ o :), devi URL-encodarla (ad es. @ diventa %40).

La geo-restrizione persiste

Alcuni proxy gratuiti fanno leak del tuo DNS reale o IPv6. Usa --force-ipv4 per assicurarti che il traffico passi nel tunnel IPv4 del proxy.
Verifica la posizione dell’IP proxy con uno strumento come curl --proxy ... ipinfo.io.