Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Handleidingen

De fout 403 Forbidden in yt-dlp oplossen

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

  1. Opdateren 's nachts. Upgrade de Python-omgeving die door de failliete werknemer wordt gebruikt.
  2. Vermindering van de lading. Pauze parallelle werkzaamheden op deze IP; test één video en één fragment tegelijk.
  3. Check Deno. Bevestig dat de verbose log de werkingstroom detecteert.
  4. Kijk naar geldig cookies. Voor een kleine taak, gebruik een browser-sessie die de bron kan spelen.
  5. Vervang een afgewezen IP. Start een verse extractie door middel van een gezonde host of proxy-uitgang.
Update, dan de vereiste runtime controleren
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
Een bron, een lage lading transfer
python -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"
Gebruik uw failliete URL, dan een korte openbare video als een controle. Deze audio-only probe vermijdt FFmpeg en slaat voor elke poging een nieuw tijdstip bestandnaam op.

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.

Update van de Python-omgeving van de werknemer
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__)"
Als u de officiële uitvoerende in plaats daarvan gebruikt
yt-dlp --update-to nightly
yt-dlp --version
yt-dlp -U alleen updates binnen de huidige kanaal. Gebruik --update-to 's nachts om te schakelen van stabiel.

Herstellen 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 ladingEerste diagnose setting
Concurrent video jobsEen actieve video voor deze IP-uitgang; stop de rest van de reeks tijdelijk.
Vrijheid Fragment Requests--concurrent-fragments 1.
aria2 of een andere externe downloaderGa terug naar --downloader native. Als je later weer aria2 gebruikt, begin dan met -x 1 -s 1 -j 1.
Media bandbreedteProbeer --limit-rate 2M als een conservatieve test, dan verhoogt u geleidelijk.
Extractie en nieuwe downloadsGebruik --sleep-requests 2 en --sleep-interval 5 --max-sleep-interval 10.
Nested RetriesHoud zowel werk- en downloader-niveau retry-rekeningen beperkt; vermenigvuldigen ze niet over de werknemers.
Herstellen van de vereiste video-stromen bij lage lading
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.

Controleer de werknemers afhankelijkheid
deno --version
python -m pip show yt-dlp yt-dlp-ejs
python -m yt_dlp --list-impersonate-targets
Check runtime detection en challenge solving
python -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.

Linux-service met Deno buiten PATH
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Vervang /opt/deno/bin/deno met de werkelijke uitgevoegbaar. op macOS of Windows, gebruik dan die absolute Deno pad van de werknemer in plaats daarvan.

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.

4 Probeer geldig cookies voor een kleine baan

Test een bekende werkseizoen. Bevestig dat de browser de exacte bron kan spelen, probeer dan zijn cookies met dezelfde bestelling en route.

Gebruik de werkende Firefox-sessie
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies-from-browser firefox \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Gebruik een geëxporteerde sessie op een hoofdloze werknemer
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies private/youtube-cookies.txt \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Gebruik Netscape-formaten cookies. houd het bestand privé en geschreven voor dit werk; voor een leest-only secret, maak een per-job kopie.

Als cookies worden geladen, maar YouTube zegt dat ze niet langer geldig zijn, vervang dan de sessie in plaats van hetzelfde bestand herhaaldelijk door te brengen. Voor een paar video's kan het houden van een browser-login praktisch zijn. Voor een grote collectie van openbare video's is het vinden en verfrisseren van veel browser-sessie niet een afhankelijk scalingsstrategie.

Voor massale werk, beheren een pool van gebruikbare proxy-uitgang IP's en roteren op de arbeidsgrens, met een lage per-IP-verzoek budget. Houd accountcookies voor bronnen die daadwerkelijk accounttoegang vereisen. Een IP-wijziging geeft geen toegang tot een privé- of ontoegankelijke video.

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.

  1. Houd de bron, nachtelijke herziening, Deno, cookies indien nodig en format selector hetzelfde.
  2. Test een vervanging IP-uitgang met een verse extractie en een echte media overdracht.
  3. Bevestig de proxy eigenlijk veranderd zijn outbound IP. Een nieuwe gateway hostname of credential kan nog steeds leiden tot dezelfde uitgang.
  4. Houd een sticky proxy-sessie gedurende de extractie, tokengeneratie en media-overdracht.
  5. Verwijder of koel de mislukte uitgang in uw zwembad. roteren naar een andere gezonde uitgang voor een nieuwe baan of een gecontroleerde retry.
Probeer een vervangende proxy-sessie
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"
Vervang een echte sticky-session proxy privé. de verbose log kan proxy-certificaten blootstellen; schrijf het voor het delen.
Vergelijk direct host-toegang wanneer beschikbaar
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"
Dit blokkeert environment/configured proxy's voor de test. Skip het wanneer de host niet rechtstreeks YouTube kan bereiken.
Vergelijk de IPv4 route van de host
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"
Een werkende IPv4 route kan verschillen van de failliete IPv6 route. met een proxy, -4 selecteert niet noodzakelijkerwijs de outbound IP-familie van de proxy.
ResultaatVolgende actie
De bron succesvol op een nieuwe exit IPHoud 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 effectControleer de werkelijke egress IP en seissiebeleid; de proxy kan nog steeds dezelfde uitgang gebruiken.
De speler werkt, de media mislukken alleen via de proxyCheck googlevideo.com toegang en dat media hetzelfde gebruikt exit/session.
Een bron faalt op elke getest route; de controle werktOnderzoek 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.

Behoud extractie en overdracht in dezelfde Python-werk
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"])
Dit is een directe lokale download; het heeft geen API-toets nodig. Voeg uw gecontroleerde cookie/provider opties toe alleen als de eerdere tests ze vereisen.

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

De aanvraag sequentie
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 locatieInterpretatie
Unable to download API page / Unable to download webpageIdentificeer die host voordat het wordt behandeld als een mediaserverfout.
unable to download video data: HTTP Error 403: ForbiddenDe geselecteerde mediaverzoek is geweigerd. Volg de solver/token/route takken hieronder.
Fragment Retry berichtenBehoud 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 lezenFFmpeg 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 AccessDeniedDe 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.

Installeren van de connector in de Python-omgeving van yt-dlp
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"

Voor yt-dlp op de Docker-host. Publish alleen de loopback-poort.

Start de provider
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2
Controleer de service vanuit de omgeving van de downloader
python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"
Wacht HTTP 200. Doe dit binnen de werknemer container als dat waar yt-dlp loopt.
Vraag mweb media met de aanbieder
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"
Wat te zoeken in de log
PO Token Providers: bgutil:http-2.0.2 (external)
Generating a gvs PO Token for mweb client via bgutil HTTP server
[download] 100%
Deze zijn kortste lijnen van onze werkzame lokale run. Provider ontdekking, token generatie en media transfer zijn drie afzonderlijke checks.
Toonbaar resultaatRepareren
PO Token Providers: noneDe 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 … /pingStart de provider of correct base_url. Check uit het downloaderproces, niet alleen uw laptop browser.
Leverancier opgenomen, maar geen generatie gebeurtLees 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 weigeringVerplaats naar session/network diagnose. het genereren van een token authentiek de browser-account niet.
mweb token werkt, oude gedwongen client nog steeds faaltGebruik 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.

Gebruik een provider op het Docker-netwerk van de werknemer
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.

Lijst van de formaten voor dit verzoek context
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Test de failliete ID van die lijst
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"
Vervang YOUR_FORMAT_ID. Voor een gemengde selectie, test de video en audio ID's afzonderlijk. voor een clip, eerst een oncut stream testen.

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.

Apply pacing aan uw bestaande collectie configuratie
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
  --fragment-retries 3 --batch-file urls.txt
Gebruik de configuratie die de nu werkende runtime, provider, output en archiefopties bevat. de slaap ruimte vooraf instellen in dit proces verzoeken; het coördineren niet andere werknemers.

Een 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.