Como usar Proxies no yt-dlp (HTTP, SOCKS5 e Tor)

O yt-dlp é o downloader de vídeo mais poderoso atualmente, mas mesmo ele tem limites. Pode encontrar vídeos com restrição geográfica disponíveis apenas em certos países, ou bans por IP em sites que detetam demasiados pedidos.

A solução é encaminhar o seu tráfego através de um proxy. Este guia cobre tudo o que precisa de saber para usar proxies com o yt-dlp, desde configurações HTTP simples até proteção avançada de privacidade com Tor.

Por que usar um proxy com yt-dlp?

Contornar geo-bloqueios: ver e descarregar conteúdo restrito a regiões específicas (por ex. BBC iPlayer fora do Reino Unido, ou bibliotecas Crunchyroll).
Evitar rate limiting: se estiver a arquivar um canal ou a descarregar uma playlist, sites como o YouTube podem bloquear temporariamente o seu IP (Erro 429). Proxies rotativos ajudam a evitar isso.
Privacidade: ocultar o seu IP doméstico dos sites com que interage.

Uso básico de proxy

A flag principal para usar um proxy no yt-dlp é --proxy. Ela suporta protocolos HTTP, HTTPS e SOCKS.

Proxies HTTP/HTTPS

Este é o tipo de proxy mais comum.

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

Detalhe da sintaxe:

http:// - Protocolo (muitas vezes pode ser omitido, mas é melhor ser explícito).
user:password - (Opcional) Autenticação se o proxy exigir.
@ - Separador entre credenciais e endereço do servidor.
proxy.example.com - IP ou hostname do servidor proxy.
8080 - Porta.

Proxies SOCKS5

SOCKS5 é frequentemente preferido para tunelamento de tráfego mais versátil.

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

Usar yt-dlp com Tor

Para máxima privacidade, ou para contornar censura difícil, pode encaminhar o yt-dlp através da rede Tor.

Pré-requisito: deve ter o serviço Tor instalado e a correr. Por defeito, o Tor abre um proxy SOCKS5 na porta 9050.

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

Nota: descarregar via Tor será significativamente mais lento do que uma ligação normal. É melhor reservar para conteúdos que não pode aceder de outra forma.

Configuração permanente

Digitar o URL do proxy todas as vezes é aborrecido. Pode guardar as definições num ficheiro de configuração.

Crie ou edite o ficheiro de config:
- Linux/macOS: ~/.config/yt-dlp/config
- Windows: %APPDATA%\\yt-dlp\\config
Adicione a linha do proxy:

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

Agora, sempre que executar yt-dlp, ele utilizará automaticamente esse proxy.

Lidar com “429 Too Many Requests”

Se estiver a fazer scraping de dados ou a descarregar playlists enormes, um único proxy pode ser banido. Neste caso, precisa de uma estratégia de rotação de proxies.

Embora o yt-dlp não tenha um “rotator” embutido, pode conseguir isso usando um fornecedor que faz rotação do lado deles (um único gateway que muda o IP de saída), ou escrevendo um pequeno script wrapper que alterna uma lista de proxies.

Exemplo: usar um serviço de proxy rotativo

Muitos serviços premium fornecem um gateway “sticky” ou “rotating”.

# Exemplo de um serviço que roda o IP a cada pedido
yt-dlp --proxy "http://rotating-gateway.provider.com:port" ...

Troubleshooting

“Connection Refused”

Verifique se o IP e a porta do proxy estão corretos.
Verifique se a firewall está a bloquear a ligação.
Se usar Tor, confirme que o Tor Browser ou o serviço em background está realmente a correr.

“Proxy Authentication Required”

Certifique-se de que incluiu user:password no URL.
Se a sua password tiver caracteres especiais (como @ ou :), deve URL encode (por ex. @ vira %40).

A geo-restrição persiste

Alguns proxies grátis fazem leak do seu DNS real ou IPv6. Use --force-ipv4 para garantir o túnel via IPv4.
Verifique a localização do IP do proxy com uma ferramenta como curl --proxy ... ipinfo.io.