Cómo usar proxies con yt-dlp (HTTP, SOCKS5 y Tor)

yt-dlp es el descargador de vídeo más potente hoy en día, pero incluso él tiene límites. Puedes encontrarte con vídeos con restricción geográfica disponibles solo en ciertos países, o con bans por IP en sitios que detectan demasiadas solicitudes.

La solución es enrutar tu tráfico a través de un proxy. Esta guía cubre todo lo que necesitas saber para usar proxies con yt-dlp, desde configuraciones HTTP sencillas hasta protección avanzada de privacidad con Tor.

¿Por qué usar un proxy con yt-dlp?

Evitar geo-bloqueos: ver y descargar contenido restringido a regiones específicas (p. ej. BBC iPlayer fuera del Reino Unido, o catálogos de Crunchyroll).
Evitar rate limiting: si estás archivando un canal o descargando una playlist, sitios como YouTube pueden bloquear temporalmente tu IP (Error 429). Rotar proxies ayuda a evitarlo.
Privacidad: oculta tu IP doméstica frente a los sitios con los que interactúas.

Uso básico de proxy

La opción principal para usar un proxy en yt-dlp es --proxy. Soporta protocolos HTTP, HTTPS y SOCKS.

Proxies HTTP/HTTPS

Este es el tipo de proxy más común.

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

Desglose de la sintaxis:

http:// - Protocolo (a veces se puede omitir, pero es mejor ser explícito).
user:password - (Opcional) Autenticación si tu proxy lo requiere.
@ - Separador entre credenciales y dirección del servidor.
proxy.example.com - IP o hostname del servidor proxy.
8080 - Número de puerto.

Proxies SOCKS5

SOCKS5 suele preferirse por un túnel de tráfico más versátil.

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

Usar yt-dlp con Tor

Para máxima privacidad, o para sortear censura complicada, puedes enrutar yt-dlp a través de la red Tor.

Requisito previo: debes tener el servicio Tor instalado y en ejecución. Por defecto, Tor abre un proxy SOCKS5 en el puerto 9050.

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

Nota: descargar a través de Tor será significativamente más lento que una conexión estándar. Es mejor reservarlo para contenido que no se puede acceder de otra manera.

Configuración permanente

Escribir la URL del proxy cada vez es tedioso. Puedes guardar la configuración en un archivo de configuración.

Crea o edita tu archivo de config:
- Linux/macOS: ~/.config/yt-dlp/config
- Windows: %APPDATA%\yt-dlp\config
Añade la línea del proxy:

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

Ahora, cada vez que ejecutes yt-dlp, usará automáticamente ese proxy.

Cómo lidiar con “429 Too Many Requests”

Si estás haciendo scraping de datos o descargando playlists masivas, un solo proxy puede ser baneado. En ese caso, necesitas una estrategia de rotación de proxies.

Aunque yt-dlp no tiene un “rotador” integrado, puedes lograrlo usando un proveedor que gestione la rotación por su cuenta (un único gateway que cambia las IP de salida), o escribiendo un pequeño script wrapper que vaya rotando una lista de proxies.

Ejemplo: usar un servicio de proxy rotativo

Muchos servicios premium de proxies ofrecen un gateway “sticky” o “rotating”.

# Ejemplo de un servicio que rota la IP en cada solicitud
yt-dlp --proxy "http://rotating-gateway.provider.com:port" ...

Solución de problemas

“Connection Refused”

Verifica que la IP y el puerto del proxy son correctos.
Comprueba si tu firewall está bloqueando la conexión.
Si usas Tor, asegúrate de que Tor Browser o el servicio en segundo plano esté realmente ejecutándose.

“Proxy Authentication Required”

Asegúrate de incluir la parte user:password en la URL.
Si tu contraseña contiene caracteres especiales (como @ o :), debes codificarlos en URL (p. ej. @ se convierte en %40).

La restricción geográfica persiste

Algunos proxies gratuitos filtran tu DNS real o tu IPv6. Usa --force-ipv4 para asegurar que el tráfico va por el túnel IPv4 del proxy.
Verifica la ubicación de tu IP de proxy con una herramienta como curl --proxy ... ipinfo.io.