Comment utiliser des proxies avec yt-dlp (HTTP, SOCKS5 & Tor)

yt-dlp est l’outil de téléchargement vidéo le plus puissant aujourd’hui, mais même lui a des limites. Vous pouvez rencontrer des vidéos géo-restreintes disponibles uniquement dans certains pays, ou des blocages IP sur des sites qui détectent trop de requêtes.

La solution consiste à faire passer votre trafic via un proxy. Ce guide couvre tout ce que vous devez savoir pour utiliser des proxies avec yt-dlp, des configurations HTTP simples jusqu’à la protection avancée de la vie privée avec Tor.

Pourquoi utiliser un proxy avec yt-dlp ?

Contourner le géo-blocage : regarder et télécharger du contenu limité à certaines régions (par ex. BBC iPlayer hors du Royaume-Uni, ou des catalogues Crunchyroll).
Éviter la limitation de débit : si vous archivez une chaîne ou téléchargez une playlist, des sites comme YouTube peuvent temporairement bloquer votre IP (Erreur 429). Les proxies rotatifs aident à éviter ça.
Vie privée : masquer votre IP personnelle vis-à-vis des sites avec lesquels vous interagissez.

Utilisation basique d’un proxy

L’option principale pour utiliser un proxy dans yt-dlp est --proxy. Elle supporte HTTP, HTTPS et SOCKS.

Proxies HTTP/HTTPS

C’est le type de proxy le plus courant.

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

Détail de la syntaxe :

http:// - Protocole (souvent optionnel, mais mieux vaut être explicite).
user:password - (Optionnel) Authentification si votre proxy l’exige.
@ - Séparateur entre identifiants et adresse serveur.
proxy.example.com - IP ou nom d’hôte du serveur proxy.
8080 - Numéro de port.

Proxies SOCKS5

SOCKS5 est souvent préféré pour un tunneling plus polyvalent.

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

Utiliser yt-dlp avec Tor

Pour un maximum de confidentialité, ou pour contourner des censures difficiles, vous pouvez faire passer yt-dlp via le réseau Tor.

Prérequis : le service Tor doit être installé et en cours d’exécution sur votre machine. Par défaut, Tor expose un proxy SOCKS5 sur le port 9050.

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

Note : télécharger via Tor sera nettement plus lent qu’une connexion standard. À réserver au contenu inaccessible autrement.

Configuration permanente

Taper l’URL du proxy à chaque fois est fastidieux. Vous pouvez enregistrer les paramètres dans un fichier de configuration.

Créez ou éditez votre fichier de config :
- Linux/macOS : ~/.config/yt-dlp/config
- Windows : %APPDATA%\yt-dlp\config
Ajoutez la ligne proxy :

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

Ensuite, à chaque exécution, yt-dlp utilisera automatiquement ce proxy.

Gérer l’erreur “429 Too Many Requests”

Si vous scrappez des données ou téléchargez d’énormes playlists, un seul proxy peut se faire bannir. Dans ce cas, il vous faut une stratégie de rotation de proxies.

Même si yt-dlp n’a pas de “rotateur” intégré, vous pouvez obtenir le même résultat en utilisant un fournisseur de proxy qui gère la rotation côté serveur (un point d’entrée unique qui change les IP de sortie), ou en écrivant un petit script wrapper qui alterne une liste de proxies.

Exemple : utiliser un service de proxy rotatif

De nombreux services premium proposent une passerelle “sticky” ou “rotating”.

# Exemple pour un service qui change d’IP à chaque requête
yt-dlp --proxy "http://rotating-gateway.provider.com:port" ...

Dépannage

“Connection Refused”

Vérifiez que l’IP et le port du proxy sont corrects.
Vérifiez si votre pare-feu bloque la connexion.
Si vous utilisez Tor, assurez-vous que le navigateur Tor ou le service en arrière-plan tourne réellement.

“Proxy Authentication Required”

Assurez-vous d’avoir inclus la partie user:password dans l’URL.
Si votre mot de passe contient des caractères spéciaux (comme @ ou :), vous devez les encoder en URL (par ex. @ devient %40).

La géo-restriction persiste

Certains proxies gratuits fuient votre DNS réel ou votre IPv6. Utilisez --force-ipv4 pour forcer le tunnel via IPv4.
Vérifiez la localisation de l’IP proxy avec un outil comme curl --proxy ... ipinfo.io.