Jak używać proxy z yt-dlp (HTTP, SOCKS5 i Tor)

yt-dlp to dziś najpotężniejszy downloader wideo, ale nawet on ma swoje ograniczenia. Możesz trafić na filmy z blokadą regionalną, dostępne tylko w wybranych krajach, albo na bany IP na stronach, które wykrywają zbyt wiele żądań.

Rozwiązaniem jest skierowanie ruchu przez proxy. Ten przewodnik obejmuje wszystko, co musisz wiedzieć o używaniu proxy z yt-dlp — od prostych konfiguracji HTTP po zaawansowaną ochronę prywatności z Tor.

Dlaczego warto używać proxy z yt-dlp?

Omijanie geo-blokad: oglądanie i pobieranie treści ograniczonych do konkretnych regionów (np. BBC iPlayer poza UK lub biblioteki Crunchyroll).
Unikanie rate limiting: jeśli archiwizujesz kanał lub pobierasz playlistę, serwisy takie jak YouTube mogą tymczasowo zablokować Twoje IP (Error 429). Rotacja proxy pomaga tego uniknąć.
Prywatność: ukrycie domowego adresu IP przed stronami, z którymi się łączysz.

Podstawowe użycie proxy

Główna flaga do używania proxy w yt-dlp to --proxy. Obsługuje protokoły HTTP, HTTPS oraz SOCKS.

Proxy HTTP/HTTPS

To najczęstszy typ proxy.

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

Składnia:

http:// - Protokół (często można pominąć, ale lepiej podać jawnie).
user:password - (Opcjonalnie) Dane logowania, jeśli proxy tego wymaga.
@ - Separator między danymi logowania a adresem serwera.
proxy.example.com - IP lub hostname serwera proxy.
8080 - Port.

Proxy SOCKS5

SOCKS5 jest często preferowane ze względu na bardziej uniwersalne tunelowanie.

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

Używanie yt-dlp z Tor

Dla maksymalnej prywatności lub w celu obejścia trudnej cenzury możesz kierować yt-dlp przez sieć Tor.

Wymaganie: musisz mieć zainstalowaną i uruchomioną usługę Tor. Domyślnie Tor udostępnia proxy SOCKS5 na porcie 9050.

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

Uwaga: pobieranie przez Tor będzie znacząco wolniejsze niż przez standardowe łącze. Najlepiej używać tego tylko wtedy, gdy nie ma innej opcji.

Konfiguracja na stałe

Wpisywanie URL proxy za każdym razem jest uciążliwe. Możesz zapisać ustawienia w pliku konfiguracyjnym.

Utwórz lub edytuj plik konfiguracyjny:
- Linux/macOS: ~/.config/yt-dlp/config
- Windows: %APPDATA%\\yt-dlp\\config
Dodaj linię proxy:

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

Od teraz yt-dlp będzie automatycznie używać tego proxy przy każdym uruchomieniu.

Jak radzić sobie z “429 Too Many Requests”

Jeśli scrapujesz dane lub pobierasz ogromne playlisty, pojedyncze proxy może zostać zbanowane. Wtedy potrzebujesz strategii rotacji proxy.

Chociaż yt-dlp nie ma wbudowanego “rotatora”, możesz osiągnąć rotację, korzystając z dostawcy proxy, który obsługuje ją po swojej stronie (jedno wejście, które zmienia IP wyjściowe), albo napisać prosty skrypt, który cyklicznie przełącza listę proxy.

Przykład: użycie usługi rotującego proxy

Wiele płatnych usług proxy oferuje bramkę “sticky” lub “rotating”.

# Przykład dla usługi, która rotuje IP przy każdym żądaniu
yt-dlp --proxy "http://rotating-gateway.provider.com:port" ...

Rozwiązywanie problemów

“Connection Refused”

Sprawdź, czy IP i port proxy są poprawne.
Sprawdź, czy firewall nie blokuje połączenia.
Jeśli używasz Tor, upewnij się, że Tor Browser lub usługa w tle naprawdę działa.

“Proxy Authentication Required”

Upewnij się, że dodałeś część user:password w URL.
Jeśli hasło zawiera znaki specjalne (np. @ lub :), musisz je URL-enkodować (np. @ → %40).

Geo-restrykcja nadal działa

Niektóre darmowe proxy “przeciekają” Twój prawdziwy DNS lub IPv6. Użyj --force-ipv4, aby wymusić ruch przez tunel IPv4 proxy.
Sprawdź lokalizację IP proxy np. poleceniem curl --proxy ... ipinfo.io.