Documentatie bekijken
Handleidingen
Werk de nightly-versie bij, beperk gelijktijdige verzoeken, controleer Deno en test daarna cookies en een werkend uitgaand IP-adres.
Op deze pagina
Probeer dit eerst
- Opdateren 's nachts. Upgrade de Python-omgeving die door de failliete werknemer wordt gebruikt.
- Vermindering van de lading. Pauze parallelle werkzaamheden op deze IP; test één video en één fragment tegelijk.
- Check Deno. Bevestig dat de verbose log de werkingstroom detecteert.
- Kijk naar geldig cookies. Voor een kleine taak, gebruik een browser-sessie die de bron kan spelen.
- Vervang een afgewezen IP. Start een verse extractie door middel van een gezonde host of proxy-uitgang.
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"Run op de mislukte werknemer. Check de verbose Proxy map voor zijn werkelijke route. --ignore-config verwijdert bewaard opties maar houdt geïnstalleerde plugins en milieu-proxy's.
Success betekent een opgeslagen bestand. Eenmaal audio werkt, test video met -f bv en herstelt vervolgens uw volledige output-instellingen. --simulate en -F testen geen media overdracht. De 2M cap is een uitgangspunt voor de diagnose.
1. update naar nachtelijk
Een voorafgaand werkend commando ontbreekt plotseling: update first. YouTube-speler veranderingen kunnen oudere extractors breken; de laatste nachtelijk kan al de fix bevatten.
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 --versionHerstellen en herstarten van een container als de afbeelding een oudere pakket bevat; bijwerken van Python op de host updateert die container niet. Houd de exacte herziening in de werklog en draai de dezelfde bron weer voordat je andere instellingen wijzigt.
Verwijder oude player_client, player_js_version en formaten=missing_pot overrides voor de baseline. Een workaround uit een oude incident kan nu een ongepaste klant selecteren of een stroom blootstellen wiens token nog steeds ontbreekt. Issue #14680 is een voorbeeld van een speler verandert vast upstream; het kopiëren van zijn tijdelijke override onbepaalde is niet de fix.
2 Vermindering van concurrerende verzoeken
Downloads werken, dan falen als het volume stijgt: vermindert de totale lading op de exit IP. In FlashData ervaring kunnen snelle parallelle overdrachten ontwijking veroorzaken.
| Bron van de lading | Eerste diagnose setting |
|---|---|
| Concurrent video jobs | Een actieve video voor deze IP-uitgang; stop de rest van de reeks tijdelijk. |
| Vrijheid Fragment Requests | --concurrent-fragments 1. |
| aria2 of een andere externe downloader | Ga terug naar --downloader native. Als je later weer aria2 gebruikt, begin dan met -x 1 -s 1 -j 1. |
| Media bandbreedte | Probeer --limit-rate 2M als een conservatieve test, dan verhoogt u geleidelijk. |
| Extractie en nieuwe downloads | Gebruik --sleep-requests 2 en --sleep-interval 5 --max-sleep-interval 10. |
| Nested Retries | Houd zowel werk- en downloader-niveau retry-rekeningen beperkt; vermenigvuldigen ze niet over de werknemers. |
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"Als de lage ladingoverdracht werkt, houd dan die basislijn vast en verhoog een dimensie tegelijk terwijl je mislukkingen kijkt. Als het nog steeds mislukt onmiddellijk na nightly/runtime-checks, blijven we niet de bandbreedte onbepaalde tijd verminderen: een andere uitgang IP testen. Een route die al door YouTube is gebleken, kan worden afgewezen nadat het verkeer dat het heeft veroorzaakt is gestopt.
3 Check Deno
Kijk beide afhankelijkheden op de werknemer: Deno loopt de uitdagingen; yt-dlp-ejs levert de oplosschrift. [default] extra installeert de scripts.
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"Lees de JS runtime-lijn voor Deno en alle [jsc:deno] oplosbare berichten. Een mislevende runtime of signature/n-challenge waarschuwing moet worden opgelost voordat een andere grote download wordt uitgevoerd. Deno 2.3+ is het huidige minimum in upstream EJS documentatie; gebruik een up-to-date ondersteunde versie.
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"De curl-cffi extra maakt --impersonate=" mogelijk. Het biedt browser-like verzoek vingerafdrukken; het vervangt niet Deno. Als de browserdoel niet beschikbaar is, installeren we de extra in dezelfde Python-omgeving. Als de personalisatie een falen op een werkroute invoert, vergelijk dan hetzelfde verzoek zonder de vlag.
Na de afhankelijkheid check, de echte media overdracht. Als de huidige nacht nog steeds meldt signature-oplossingsfalen voor dezelfde speler, bewaar het speler ID en oplosmedeal voor het matching upstream probleem. Als het oplossen succesvol is en de media 403 krijgen, ga dan door naar session/IP checks.
5. vervangt een afgewezen IP-uitgang
Zelfde openbare video, dezelfde instellingen, verschillend resultaat door IP: vervangt de mislukte uitgang. FlashData ziet veel blijvende 403s veroorzaakt door slechte of vlaggen proxy IP's. Het herinstalleren van yt-dlp herstelt deze route niet.
- Houd de bron, nachtelijke herziening, Deno, cookies indien nodig en format selector hetzelfde.
- Test een vervanging IP-uitgang met een verse extractie en een echte media overdracht.
- Bevestig de proxy eigenlijk veranderd zijn outbound IP. Een nieuwe gateway hostname of credential kan nog steeds leiden tot dezelfde uitgang.
- Houd een sticky proxy-sessie gedurende de extractie, tokengeneratie en media-overdracht.
- Verwijder of koel de mislukte uitgang in uw zwembad. roteren naar een andere gezonde uitgang voor een nieuwe baan of een gecontroleerde retry.
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"| Resultaat | Volgende actie |
|---|---|
| De bron succesvol op een nieuwe exit IP | Houd die route en de baseline met lage belasting. kwarantineer de failliete uitgang in plaats van het terug te trekken voor elke video. |
| Het wijzigen van proxy-credentials heeft geen effect | Controleer de werkelijke egress IP en seissiebeleid; de proxy kan nog steeds dezelfde uitgang gebruiken. |
| De speler werkt, de media mislukken alleen via de proxy | Check googlevideo.com toegang en dat media hetzelfde gebruikt exit/session. |
| Een bron faalt op elke getest route; de controle werkt | Onderzoek dat bron, format en live-status. Niet het hele proxy pool te markeren gebroken uit één video. |
Geavanceerd: houden van extractie en overdracht op één IP
Een gebruikelijke applicatie-bug is het extraheren van info['url'] op een machine, het opslaan in een kooi en het later elders downloaden. De ondertekend media-URL's zijn uitgestorven en kunnen afhangen van de oorspronkelijke IP en verzoekhoofden. Een rotating proxy kan dezelfde split maken, zelfs binnen één applicatie.
Kijk naar de YouTube-video-ID en de gewenste output-instellingen. Laat de werknemer een verse extractie uitvoeren en samen downloaden. Als de werknemer een proxy gebruikt, houdt hij dezelfde egress door middel van spelerextractie, tokengeneratie en de media-verzoeken. Vraag de proxy provider voor een sticky sessie in plaats van elke HTTP verzoek te roteren.
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"])Als dit succesvol is terwijl requests.get(saved_media_url) of een afzonderlijke FFmpeg proces mislukt, controleer dan dat mislukt: URL-leeftijd, extract-toegedeelde header, cookies en werkelijke progress. Houd de media-URL's uit duurzame werkrecords. Bij het terugdringen van uitgestelde extractie resultaten, vragen ze voor nieuwe URL's van de oorspronkelijke video-ID.
Advanced: het identificeren van de failliete aanvraag
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F lijsten geëxtraheerde formaten; --simulate stopt voordat de media worden opgeslagen. Ook bewijst het niet dat de geselecteerde stroom byten terug zal geven. Als de log Downloading 1 format(s) bereikt en dan mislukt met een media-data 403, veranderen van de uitgangsbestandnaam of installeren FFmpeg zal niet die HTTP verzoek herstellen.
YouTube-clientprofielen zoals mweb en web_safari veranderen welke speler antwoord yt-dlp vraagt. Sommige antwoorden vereisen een signatuur of n-parameters transformatie; sommige media-verzoeken vereisen ook een GVS-bewijs-of-original token. Een PO-toeken voor de spelerverzoek is niet uitwisseld met een voor media levering of ondertitels.
| Log locatie | Interpretatie |
|---|---|
Unable to download API page / Unable to download webpage | Identificeer die host voordat het wordt behandeld als een mediaserverfout. |
unable to download video data: HTTP Error 403: Forbidden | De geselecteerde mediaverzoek is geweigerd. Volg de solver/token/route takken hieronder. |
| Fragment Retry berichten | Behoud de fragmentfout en protocol; vergelijk een andere beschikbare formats in plaats van hetzelfde fragment onbepaalde tijd terug te trekken. |
| FFmpeg zegt HTTP 403 terwijl een inleiding lezen | FFmpeg is het vangen van afstandsmedia, bijvoorbeeld voor een clip. Check de URL en het netwerk overgegaan naar FFmpeg; dit is geen lokale codec fout. |
Opslag opladen terugkeert AccessDenied | De bestand bereikte uw upload-stap. Fix bucket access and retry that upload, not the YouTube download. |
Advanced: installeren van een PO-token provider
Gebruik deze tak wanneer de benodigde formaten worden overgedragen voor een ontbrekende GVS-toeken, of uw geconfigureerde token wordt afgewezen. Tokens zijn gebonden aan een client/request context en kunnen worden gebonden aan de video-ID. Een token gecopierd voor één video is geen hergebruikbare credential voor een hele reeks. Gebruik een provider om de token voor de huidige aanvraag te genereren.
De volgende setup gebruikt bgutil 2.0.2. Het heeft twee delen: een Python-plugin die wordt geladen door yt-dlp en een JavaScript-service die tokens genereert. Houd uw versies bij het upgraden aan de hand. De onderstaande voorbeelden gebruiken een service die op dezelfde host op de haven 4416 kan worden bereikt.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"Voor yt-dlp op de Docker-host. Publish alleen de loopback-poort.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2Verplicht Git, Node 22+ en npm. Voer de laatste opdracht uit in een afzonderlijk terminal en laat het lopen. Als de map al bestaat, gebruik dan uw bestaande checkout van de matching release.
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%| Toonbaar resultaat | Repareren |
|---|---|
PO Token Providers: none | De plugin is niet geladen. installeren met dezelfde Python-interpreter; verwijderen --no-plugin-dirs. voor een aparte binaire, gebruik de gedocumenteerde plugin ZIP installatie van de provider in plaats van pip in een ongerelateerde omgeving. |
Error reaching GET … /ping | Start de provider of correct base_url. Check uit het downloaderproces, niet alleen uw laptop browser. |
| Leverancier opgenomen, maar geen generatie gebeurt | Lees eerder de spelerfouten. LOGIN_REQUIRED kan de aanvraag stoppen voordat de tokenfase. een geladen plugin bewijst niet dat het is gebruikt. |
| Een token wordt gegenereerd, dan bot/sign-in weigering | Verplaats naar session/network diagnose. het genereren van een token authentiek de browser-account niet. |
| mweb token werkt, oude gedwongen client nog steeds faalt | Gebruik niet opnieuw de mweb-toeken voor die andere client. laat de provider het geselecteerde context beheren of terug naar de werkende clientconfiguratie. |
Voor twee containers, 127.0.0.1 binnen de werknemer punt aan de werknemer zelf. Plaats beide diensten op hetzelfde Docker-netwerk en gebruik de dienstnaam van de aanbieder, bijvoorbeeld http://bgutil-provider:4416. Laat de aanbieder niet openbaar worden gepresenteerd.
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"Issue #17681 opent een handmatige tekensfout opgelost door te schakelen naar een provider. Het bevat ook een latere herhaling: behandel de werkfix als bewijs voor dat tokenfalen, niet bewijs dat elke later 403 dezelfde oorzaak heeft.
Advanced: één format, clip of live stream misleiden
Lijstformaten met dezelfde cookies, provider en netwerkopties als de mislukte downloaden. Voer het failliete format rechtstreeks uit. Als een andere beschikbare formaten werken, hebt u het falen op een delivery/client pad gesneden; u heeft niet vastgesteld dat elke resolutie of codec is gebroken.
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"SABR-waarschuwingen betrekking hebben op de formaten die door een klant worden aangeboden. Het is niet hetzelfde als een n-challenge mislukking. Als een oude web override slechts unavailable/unsupported-formaten produceert, verwijder dan de override of gebruik de gedocumenteerde mweb/provider pad. Voeg formats=missing_pot niet toe als een fix: het blootstelt formaten zonder hun missende token te leveren.
Live, recent afgerond en gewone opgeladen video's kunnen verschillende manifestaties blootstellen. Incluseren van die staat bij het zoeken naar upstream. Als een onlangs afgerond stroom nog steeds wordt verwerkt, kan een alternatieve huidige format of een latere extractie de nodige volgende test zijn; het toevoegen van een wereldwijde codec override aan elke werknemer is niet.
Een werknemer herhalen
Herhaal eerst de failliete bron met de oorspronkelijke vereiste video/audio-uitgang. Dan herstelt een werknemer met behulp van het bestaande manifest, archief en output beleid. Als alle banen dezelfde mislukte sessie of route delen, stop dan in plaats van de mislukkingen te vermenigvuldigen.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txtEen 403 teruggekeerd op elke poging heeft een veranderd toestand nodig voordat hij teruggaat. Stel niet onbeperkt fragment retries of verplaats mislukte ID's naar het succesarchief. Als de media zijn afgerond en alleen de opslaglevering mislukt, heroplaad de opgeslagen bestand.
Nog steeds mislukken? een nuttig foutrapport voorbereiden
- De werkelijke mislukte overdracht met --verbose, niet alleen een succesvolle --simulate run.
- Houd de yt-dlp herziening, runtime/EJS versies, geladen provider en de geselecteerde format/protocol.
- Inclusie van de waarschuwing voor de fout, of een token is gevraagd en of de mislukking plaatsvond vóór of na de media selectie.
- Verwijder de resultaten van dezelfde bron over IPv4/direct/proxy alleen voor de vergelijkingen die je eigenlijk hebt uitgevoerd.
- Verwijder cookies, proxy-certificaten, gesignaleerde URL's en tokens voordat u het log gedeelt.
Zoek upstream met behulp van de specifieke voorafgaande waarschuwing en uw release. Als een matching regressie nog steeds open is, behoud het failliete item en gebruik een bevestigde werkpad terwijl je dat fix volgt. Een schoon log dat alleen '403' zegt is minder nuttig dan een korte record die laat zien welke verzoek en gecontroleerde wijziging mislukt.