Przeglądaj dokumentację
Poradniki
Zaktualizuj wersję nightly, ogranicz współbieżność, sprawdź Deno, a następnie przetestuj pliki cookie i działający wyjściowy adres IP.
Na tej stronie
Spróbuj to najpierw
- Uaktualnij w nocy. Uaktualnij środowisko Python wykorzystywane przez nieudanej pracownika.
- Zmniejszenie obciążenia. Zatrzymaj pracę równoległą na tym IP; testuj jeden film i jeden fragment naraz.
- Poznaj Deno. Potwierdź, że log verbowy wykrywa czas pracy.
- Wykorzystaj ważne pliki cookie. W przypadku małej pracy użyj sesji przeglądarki, która może odtwarzać źródło.
- Zastąpić odrzucone IP. Rozpocznij świeżą ekstrakcję poprzez zdrowy host lub wyjście proxy.
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --versionpython -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --downloader native \
--concurrent-fragments 1 --limit-rate 2M --sleep-requests 2 \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Przekieruj nieudany pracownik. Sprawdź wskaźnik Proxy map dla jego rzeczywistej trasy. --ignore-config usuwa zapisane opcje, ale utrzymuje zainstalowane wtyczki i proxy środowiska.
Sukces oznacza zapisany plik. Po pracy audio, przetestować wideo z -f bv, a następnie przywrócić pełne ustawienia wyjścia. --simulate i -F nie przetestować transferu medialnego. Kapa 2M jest punktem wyjścia dla diagnozy.
1 Aktualizacja do nocnej
Przedstawiany dowód nagle się nie powiodł: aktualizacja najpierw. zmiany odtwarzacza YouTube mogą złamać starsze ekstraktory; ostatnie nocy mogą już zawierać poprawkę.
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
python -c "import sys, yt_dlp; print(sys.executable); print(yt_dlp.__file__)"yt-dlp --update-to nightly
yt-dlp --versionOdbuduj i ponownie uruchom konta, jeśli jego obraz zawiera starszy pakiet; aktualizacja Python na hostingu nie aktualizuje tego konta.
Wystarczy, że wyciągniesz stare player_client, player_js_version i formaty=missing_pot przewody dla linii podstawowej. Pracownik z starego incydentu może teraz wybrać nieodpowiedniego klienta lub wystawić strumień, którego token nadal brakuje. Problem #14680 jest przykładem zmiany gracza stałego upstream; kopiowanie jego tymczasowego przepływy nieograniczone nie jest naprawą.
2 Zmniejszenie liczby wniosków
Downloads działa, a następnie nie działa, gdy objętość wzrasta: zmniejsza całkowitą obciążenie IP wyjścia.W doświadczeniu FlashData, szybkie przesyłki równoległe mogą wywołać odrzucenie.
| Źródło obciążenia | Pierwsza diagnostyka |
|---|---|
| Konkurencyjne zajęcia wideo | Jeden aktywny wideo dla tego wyjścia IP; tymczasowo zatrzymać resztę paska. |
| Wnioski fragmentowe | --concurrent-fragments 1. |
| aria2 lub inny zewnętrzny pobieracz | Wróć do --downloader native. Jeśli później ponownie użyjesz aria2, zacznij od -x 1 -s 1 -j 1. |
| Media Wielkość | Spróbuj --limit-rate 2M jako test konserwatywny, a następnie stopniowo zwiększ. |
| Wyciągnięcie i nowe pobieranie | Użyj --sleep-requests 2 i --sleep-interval 5 --max-sleep-interval 10. |
| Niespodziany powrót | Trzymaj obie liczby zatrudnienia na poziomie pracy i na poziomie pobierania ograniczone; nie mnoż je w przeciągu pracowników. |
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--downloader native --concurrent-fragments 1 --limit-rate 2M --sleep-requests 2 \
--sleep-interval 5 --max-sleep-interval 10 --retries 1 --fragment-retries 1 -f bv \
-o "diagnostics/%(id)s-%(epoch)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"Jeśli niskopłata transfer działa, trzymaj się tej bazy i zwiększyć jedną wymiar w tym samym czasie podczas obserwacji porażek. Jeśli nadal nie działa natychmiast po sprawdzeniu nightly/runtime, nie kontynuuj redukcji szerokości prądu na czas: sprawdź inny IP wyjścia. Droga, która została już zaprezentowana przez YouTube, może pozostać odrzucona po tym, jak ruch, który ją wywołał, został zatrzymany.
3 Sprawdź Deno
Sprawdź obie zależności na pracowniku: Deno prowadzi wyzwania; yt-dlp-ejs dostarcza skrypty rozdzielczości. [default] dodatkowo instaluje skrypty.
deno --version
python -m pip show yt-dlp yt-dlp-ejs
python -m yt_dlp --list-impersonate-targetspython -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"Przeczytaj linię JS Runtime dla Deno i wszelkie [jsc:deno] rozstrzygające wiadomości. Brak czasu pracy lub ostrzeżenie signature/n-challenge musi być naprawione przed kolejnym dużym uruchomieniem pobrania. Deno 2.3+ jest aktualnym minimum w dokumentacji EJS; użyj aktualizacji obsługiwanej wersji.
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"curl-cffi dodatkowo umożliwia --impersonate="". Zapewnia odcisków palców podobnych do przeglądarki; nie zastępuje Deno. Jeśli cel przeglądarki nie jest dostępny, zainstaluj dodatek w tym samym środowisku Python. Jeśli impersonalizacja wprowadza porażkę na trasy roboczej, porównaj tę samą prośbę bez flagi.
Po sprawdzeniu uzależnienia, rewelacja rzeczywistej transferu mediów. Jeśli bieżąca nocna nadal zgłasza porażkę rozwiązywania podpisów dla tego samego gracza, zapisuj identyfikator gracza i wiadomość rozdzielcza dla problemu dopasowanego do upstream. Jeśli rozwiązanie się uda i media otrzymują 403, kontynuuj session/IP kontrolę.
5 Zastąpienie odrzuconego wyjścia IP
Taki sam publiczny film, te same ustawienia, inny wynik przez IP: zastąpi nieudany wyjście. FlashData widzi wiele trwałych 403s spowodowanych słabym lub złamanymi proxy IP. Ponowna instalacja yt-dlp nie naprawi tej trasy.
- Utrzymuj źródło, nocną rewizję, Deno, pliki cookie w razie potrzeby i format selektora jest taki sam.
- Test 1 wyjścia zastępczego IP z świeżym ekstrakcją i prawdziwym przekazem mediów.
- Potwierdź, że proxy rzeczywiście zmienił swój wyjściowy IP. Nowe nazwy hostów lub identyfikator portów mogą nadal prowadzić do tego samego wyjścia.
- Utrzymuj przytłaczającą sesję proxy w trakcie ekstrakcji, generacji tokenów i transferu mediów.
- Usuń lub schłodzić nieudane wyjście w basenie. Przejdź do innego zdrowego wyjścia na nową pracę lub kontrolowaną rezygnację.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --proxy "http://USER:PASSWORD@HOST:PORT" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --proxy "" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
--force-ipv4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"| Wynik | Następna akcja |
|---|---|
| To samo źródło odniosło sukces w nowym wyjściu IP | Trzymaj tę trasę i jej niską bazę. kwarantynuj nieudany wyjście, zamiast odciąć go za każdy film. |
| Zmiana proxy nie ma żadnego efektu | Sprawdź rzeczywiste zasady IP i zasady sesji; proxy mogą nadal korzystać z tego samego wyjścia. |
| Gracz działa, media nie działają tylko za pośrednictwem proxy | Sprawdź dostęp do googlevideo.com i że media używają tego samego exit/session. |
| Jeden źródło nie działa na każdym sprawdzonym trybie; kontrolny działa | Badanie tego źródła, formatu i stanu na żywo. nie etykietuj całego płytu proxy złamanej z jednego wideo. |
Zaawansowany: utrzymanie ekstrakcji i transferu na jednym IP
Najczęstszym błędem aplikacji jest wydobycie info['url'] na jednym urządzeniu, przechowywanie go w cegiełce i później pobieranie go gdzie indziej. Podpisane adresy URL mediów wygasają i mogą być zależne od oryginalnego adresu IP i nagłówków zapytania. Proxy rotujące mogą tworzyć ten sam podział nawet w jednej aplikacji.
Włącz identyfikator wideo YouTube i pożądane ustawienia wyjścia. Niech pracownik wykonuje świeżą ekstrakcję i pobiera razem. Jeśli pracownik korzysta z proxy, trzymaj ten sam grę poprzez ekstrakcję gracza, generację tokenów i żądania medialne. Zapytaj dostawcę proxy o przytłaczającą sesję zamiast obracać każde żądanie HTTP.
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget
options = {
"js_runtimes": {"deno": {}},
"impersonate": ImpersonateTarget(),
"format": "ba",
"outtmpl": "diagnostics/%(id)s-%(epoch)s.%(ext)s",
"noplaylist": True,
"verbose": True,
# If required, configure one sticky proxy for the entire job:
# "proxy": "http://USER:PASSWORD@HOST:PORT",
}
with YoutubeDL(options) as downloader:
downloader.download(["https://www.youtube.com/watch?v=jNQXAC9IVRw"])Jeśli to się uda podczas requests.get(saved_media_url) lub niepowodzenia oddzielnego FFmpeg procesu, sprawdź, że brak: wiek URL, nagłówki dostarczone przez ekstraktor, pliki cookie i rzeczywiste postępy. Utrzymuj URL medialne z trwałych rekordów pracy. Po wycofaniu wygaśniętych wyników ekstrakcji, poproś o świeże adresy URL z oryginalnego identyfikatoru wideo.
Zaawansowany: identyfikacja nieudanej prośby
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F wykazuje wyciągnięte formaty; --simulate zatrzymuje się przed oszczędzaniem mediów. Nie udowadnia też, że wybrany strumień przywróci bajty. Jeśli log dotrze do Downloading 1 format(s), a następnie nie spełnia danych medialnych 403, zmiana nazwy pliku wyjścia lub instalacja FFmpeg nie naprawi żądania HTTP.
Profily klienta YouTube, takie jak mweb i web_safari zmieniają, które odtwarzacze odpowiedzi yt-dlp żądają. Niektóre odpowiedzi wymagają podpisów lub transformacji n-parametry; niektóre żądania medialne wymagają również tokenu GVS dowodu pochodzenia. Token PO na żądanie gracza nie jest wymienny z jednym na dostawę mediów lub podtytuły.
| Lokalizacja log | Interpretacja |
|---|---|
Unable to download API page / Unable to download webpage | Zidentyfikuj ten host przed traktowaniem go jako niepowodzenie serwera medialnego. |
unable to download video data: HTTP Error 403: Forbidden | Wniosek o wybrane media został odrzucony. śledź solver/token/route gałęzie poniżej. |
| Fragmenty Retry wiadomości | Utrzymanie błędu fragmentu i protokołu; porównanie innego dostępnego formatu zamiast odtwarzania tego samego fragmentu na czas nieokreślony. |
| FFmpeg mówi HTTP 403 podczas czytania wpisu | FFmpeg jest uderzenie w media zdalne, na przykład dla klipu. sprawdź adres URL i sieć przeniesiona do FFmpeg; nie jest to błąd lokalnego kodek. |
Przesyłka do magazynu powraca do programu AccessDenied | Plik dotarł do fazy przesyłania. naprawić dostęp bucket i odwracać, że przesyłać, a nie pobieranie YouTube. |
Zaawansowany: zainstaluj dostawcę PO-token
Użyj tej gałęzi, gdy wymagane formaty są przeniesione do braku tokenu GVS lub Twój skonfigurowany token jest odrzucony. Tokeny są powiązane z kontekstem client/request i mogą być powiązane z identyfikatorem wideo. Kopiowany token na jeden film nie jest ponownie wykorzystywany jako potwierdzający dla całej czołgi. Użyj dostawcy, aby wygenerować token dla bieżącego żądania.
Następujące ustawienie wykorzystuje bgutil 2.0.2. Posiada dwie części: wtyczkę Python pobraną przez yt-dlp i usługę JavaScript, która generuje tokeny. Trzymaj ich wersje dopasowane podczas aktualizacji. Poniższe przykłady wykorzystują usługę dostępną na tym samym hostingu w porcie 4416.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"W przypadku yt-dlp prowadzenia na hostingu Docker. publikuj tylko port loopback.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2Wymaga Git, Node 22+ i npm. Wypełnij ostatnią polecenie w oddzielnym terminalu i pozwól mu działać. Jeśli folder już istnieje, użyj istniejącego czekiwania z rysunku dopasowania.
git clone --depth 1 --branch 2.0.2 https://github.com/Brainicism/bgutil-ytdlp-pot-provider.git
cd bgutil-ytdlp-pot-provider/server
npm ci
npx tsc
node build/main.js --host 127.0.0.1 --port 4416python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
--extractor-args "youtube:player_client=mweb" \
--extractor-args "youtubepot-bgutilhttp:base_url=http://127.0.0.1:4416" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"PO Token Providers: bgutil:http-2.0.2 (external)
Generating a gvs PO Token for mweb client via bgutil HTTP server
[download] 100%| Zauważony wynik | Napraw |
|---|---|
PO Token Providers: none | Plugin nie jest ładowany. zainstaluj go przy użyciu tego samego tłumacza Python; usunąć --no-plugin-dirs. Dla pojedynczych binarów, użyj udokumentowanej instalacji zintegrowanej ZIP w zamian za pomocą pipa do nieprzywiązanej środowiska. |
Error reaching GET … /ping | Rozpocznij dostawcę lub popraw base_url. sprawdź z procesu pobierania, nie tylko przeglądarki laptopowej. |
| Dostawca wymieniony, ale żadna generacja nie zdarza się | Przeczytaj wcześniejsze błędy gracza. LOGIN_REQUIRED może zatrzymać żądanie przed etapem token. ładowany wtyczka nie udowadnia, że został on używany. |
| Został on wyznaczony, a następnie bot/sign-in odrzucenie | Przeprowadzenie do diagnozy session/network. generowanie tokenu nie autentykuje konta przeglądarki. |
| mweb token działa, stary klient zmuszony nadal nie działa | Nie ponownie używaj tokenu mweb dla tego innego klienta. pozwól dostawcy obsługiwać wybrany kontekst lub wrócić do konfiguracji klienta roboczego. |
W przypadku dwóch pojemników 127.0.0.1 w środku pracownika punkt do samego pracownika. Umieść zarówno usługi w tej samej sieci Docker, a także użyj nazwy usług dostawcy, na przykład http://bgutil-provider:4416. Nie wystawiaj portów dostawców publicznie.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
--extractor-args "youtube:player_client=mweb" \
--extractor-args "youtubepot-bgutilhttp:base_url=http://bgutil-provider:4416" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Problem #17681 rejestruje niepowodzenie ręcznego tokenowego rozwiązane przez przejście do dostawcy. Zawiera również późniejszy powtórzenie: traktuje funkcję naprawy jako dowód tego niepowodzenia tokenu, nie dowodząc, że każdy późniejszy 403 ma tę samą przyczynę.
Zaawansowany: jeden format, klip lub strumień na żywo nie działa
Formaty listy z tymi samymi plikami cookie, dostawcy i opcjami sieciowymi, jak nieudane pobieranie. Wprowadź nieudany format bezpośrednio. Jeśli działa inny dostępny format, skrócił się niepowodzenie do delivery/client ścieżki; nie ustalił, że każda rozdzielczość lub kodek jest złamany.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-F "https://www.youtube.com/watch?v=jNQXAC9IVRw"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f YOUR_FORMAT_ID -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Ostrzeżenia SABR dotyczą formatów oferowanych przez klienta. Nie jest to jednak porażka n-challenge. Jeśli stary web nadmiar produkuje tylko unavailable/unsupported formaty, usunąć nadmiar lub użyć udokumentowanej mweb/provider drogi. Nie dodaj formats=missing_pot jako korekty: wyświetla formaty bez dostarczania ich brakujących tokenów.
Żywe, niedawno zakończone i zwykłe nagrane filmy mogą wyświetlać różne manifeste. Włącz ten stan podczas wyszukiwania upstream. Jeśli niedawno zakończony strumień jest nadal w trakcie przetwarzania, alternatywny format dostępny obecnie lub późniejsza ekstrakcja może być przydatnym następnym testem; dodawanie globalnego kodeków nadryżek dla każdego pracownika nie jest.
Zrób sobie jeden pracownik
Najpierw powtórz nieudane źródło z oryginalnym wymaganymi wydaniem video/audio. Następnie powróć jeden pracownik za pomocą istniejącej polityki manifestu, archiwum i wyjścia. Jeśli wszystkie prace dzielą się tą samą niepowodzoną sesją lub trasą, przerwa ta krzyża zamiast mnożyć jej niepowodzenia.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txt403 powrócił na każdym próbie wymaga zmiany stanu przed przejściem na emeryturę. Nie ustaw nieskończonych fragmentów odwrotnych lub przenieść nieudanych identyfikatorów do archiwum sukcesu. Jeśli media są zakończone i tylko dostawa pamięci masowej nie powiodła się, ponownie przesyłanie zapisanych plików.
Czy to nie jest możliwe? - przygotuj przydatny raport błędu
- Zatrzymaj faktyczny niepowodzony transfer z --verbose, nie tylko udany --simulate bieganie.
- Utrzymuj yt-dlp przegląd, runtime/EJS wersje, ładowany dostawca i wybrany format/protocol.
- Włącz ostrzeżenie przed błąd, czy token został poproszony, i czy porażka miała miejsce przed lub po wyborze mediów.
- Zapisz wyniki tego samego źródła w IPv4/direct/proxy tylko dla porównania, które rzeczywiście wykonałeś.
- Usuń treści cookie, zaufania proxy, podpisane adresy URL i tokeny przed udostępnianiem logów.
Wyszukaj upstream za pomocą konkretnego ostrzeżenia poprzedzającego i uwolnienia. Jeśli regresja dopasowana jest nadal otwarta, zachowaj nieudany element i użyj potwierdzonej ścieżki pracy podczas śledzenia tego naprawy. Czyste dziennik, który mówi tylko "403" jest mniej przydatne niż krótki rekord, który pokazuje, że żądanie i kontrolowane zmiany nie powiodły się.