Documentatie bekijken
Handleidingen
Los ‘Sign in to confirm you’re not a bot’ op met de nightly-versie, Deno, een geldige sessie en een werkend uitgaand IP-adres.
Op deze pagina
Begin met deze vier controles
- Opdateren 's nachts. Upgrade de failliete werknemer, dan herstelt u een bron.
- Check Deno. Bevestig de runtime verschijnt in het verbose log.
- Probeer een geldig seizoen. Browser cookies kunnen helpen met een kleine downloadwerk.
- Test een andere IP-uitgang. Als dezelfde openbare bron daar werkt, verplaatsen werkzaamheden van de gevlogen route.
Een andere boodschap? kies de juiste fix
| boodschap of gedrag | Waar te gaan volgende |
|---|---|
Sign in to confirm you’re not a bot / LOGIN_REQUIRED | Controleer 's nachts en Deno, dan vergelijk de uitgang IP's en een geldig seizoen. |
The provided YouTube account cookies are no longer valid | Vervang de uitgevoerde sessie met behulp van de onderhavige vernieuwingsprocedure. |
| HTTP 429 | Stop de getroffen uitgang en lagere verzoekfrequentie; gebruik de afzonderlijke 429 gids. |
Could not copy Chrome cookie database / Failed to decrypt with DPAPI | Het lokale cookie-loadingfout is opgelost; de bedoelde geauthenticate verzoek is nog niet plaatsgevonden. |
| De geselecteerde formaten, vervolgens de media HTTP 403 | Volg de 403 gids voor concurrentie, IP en media-verzoek context. |
1. update en test één bron
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --versionGebruik Deno 2.3+ en bevestigt de detectie in de verbose log; dit is vereist door deze werkstrom. De [default] extra biedt de matching EJS solver. Voor een officiële standalone binaire, gebruik yt-dlp --update-to 's nachts en vervang python -m yt_dlp met yt-dlp. Houd dezelfde bron en netwerk voor beide tests hieronder.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--cookies-from-browser firefox --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"| A / B resultaat | Wat te veranderen |
|---|---|
| Een werk; B faalt | Verwijder onnodige cookies opties van uw openbare video-werk.De geselecteerde sessie of geauthenticated client path introduceert de faillite. |
| Een mislukte; B werkt | Houd die werkseizoen bron in de baan.Voor een hoofdloze werknemer, exporteer de sessie met de procedure hieronder en re-test op de werknemer. |
| B kan niet copy/decrypt cookies | Eerst het lokale browser-bestand fout oplossen. u hebt nog geen geauthenticated access getest. |
| Beide mislukken op de server; dezelfde test werkt lokaal | Controleer de runtime/config van de werknemer, dan vergelijk zijn outbound netwerk met het totale vraagvolume. |
| Beide mislukken voor één bron; een openbare controle slaagt | Controleer de exacte beschikbaarheid van de bron en de toegang tot het account. Een andere publieke video succes maakt geen toegang tot deze. |
Houd de oude player_client overrides uit deze baseline. De geauthenticated en anonieme default cliënten kunnen verschillen. Het verstrekken van cookies is dus een zinvolle verandering in zowel de seissituatie als de selectie van de klant, niet alleen het toevoegen van een universele ontgrendelingsvlag.
2. vervangt een voortdurend gevlagde IP
Gebruik deze branche wanneer veel openbare video's op één werknemer mislukken, maar dezelfde configuratie andersom succesvol is. Test een verse bron-extractie en media-download via een andere host of proxy-uitgang. Het veranderen van de bronnen IP is de praktische herstel wanneer dat IP is de voorwaarde YouTube blijft weigeren.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--proxy "http://USER:PASSWORD@HOST:PORT" -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Controleer de vervanging heeft echt een andere uitgang IP. Proxy-diensten kunnen dezelfde uitgang achter een gewijzigde gateway of gebruikersnaam houden. Voor grote collecties, houd een pool van getest uitgangen, beperk de concurrentie per uitgang en verplaats nieuwe banen weg van een gevlogen. Roteren vóór een nieuwe extractie of na een mislukte baan, niet tussen de spelerverzoek en de media overdracht.
| Vergelijking | Actie |
|---|---|
| Nieuwe uitgang werkt; oude uitgang vraagt nog steeds om sign-in | Houd de werkroute vast en koel down/quarantine de oude uitgang. Meer retries op de oude uitgang vernieuwen zijn reputatie niet. |
| Cookies werken voor een paar video's | Gebruik die sessie voor het kleine werk. Niet scaleer door het te delen over vele drukke werknemers. |
| Browser werkt thuis; werknemer nog steeds faalt | De thuisbasis IP/session is niet de server IP/session. Herhaal dezelfde een-video test op de werker's werkelijke route. |
| Een specifieke video mislukt op elke route | Controleer de beschikbaarheid van de bron en de accountvereisten afzonderlijk van de openbare video-controle. |
Een browser cookie workaround is nuttig voor beperkte downloads, maar een groot dataset kan niet afhangen van voortdurend vinden en verfrissend veel account-sessieën. Voor massale openbare video-werk, investeren in exit-IP kwaliteit, rotatie en per-IP pacing. Houd cookies voor toegang die een account nodig heeft; een proxy geeft geen privé-video-toegang.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--force-ipv4 -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"4 Een verlengde sessie herstellen
The provided YouTube account cookies are no longer valid
playability status: LOGIN_REQUIREDVoor een bewaard cookie bestand, upstream adviseert het exporteren van een toegewijde privé-sessie en laat dan die sessie gesloten. Een normale YouTube-tab kan de sessie na export roteren. Gebruik deze volgorde:
- Open een nieuw private/incognito venster en merk in het account dat de bron kan bereiken.
- In dezelfde tab opent u https://www.youtube.com/robots.txt. Houd het als de enige tab in de privé-sessie.
- Exporteer cookies van youtube.com uit die privé-sessie met behulp van een cookie-export-extensie gekoppeld in de upstream FAQ, met toegang tot private/incognito-vensters geactiveerd.
- Sluit het hele privévenster na export. Gebruik niet de uitgevoerde sessie in de browser.
- Bewaar de export privé en voer de single-source test uit met --cookies met de wijze op het nieuwe bestand.
Combineren --cookies-from-browser met --cookies exporteert het gewone browserprofiel; het captureert niet dat privé-sessie. Het wijzigen van de uiterste kolommen van het bestand vernieuwt ook geen sessie die door de server is geannuleerd.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--cookies private/youtube-cookies.txt -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Als de ongeldig cookie-waarschuwing blijft, bevestigt de werknemer het nieuw geëxporteerde bestand en dat de export van de bedoelde privé-sessie is gekomen. Als de waarschuwing verdwijnt, maar LOGIN_REQUIRED blijft, ga dan naar network/source vergelijking hieronder. Als de media selectie succesvol is en de overdracht nu terugkomt 403, gebruik dan de GVS-token en overdrachtchecks.
Linux / Docker: kopieer een leest-only cookie secret
--cookies is ook een uitgangspunt: yt-dlp slaat zijn cookie-bar op wanneer het voorbeeld sluit. Het wijzen ervan rechtstreeks op een leest-only secret kan een bestandsysteem fout veroorzaken, zelfs na een overdracht. Veel werknemers die dezelfde geëxporteerde bestand schrijven, kunnen ook de staat van elkaar overschrijven.
Houd de geleverde export privé en kopieer het in de tijdelijke directory van elk werk. Het volgende Python-exemple gebruikt Deno voor uitdagingen en downloads één audio stream. Vervang de cookie-bestandpad met uw geheim pad; geen API-toets is vereist.
from pathlib import Path
from shutil import copyfile
from tempfile import TemporaryDirectory
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget
source_cookie_file = Path("/run/secrets/youtube-cookies.txt")
with TemporaryDirectory(prefix="yt-session-") as temporary:
job_cookies = Path(temporary) / "cookies.txt"
copyfile(source_cookie_file, job_cookies)
options = {
"cookiefile": str(job_cookies),
"js_runtimes": {"deno": {}},
"impersonate": ImpersonateTarget(),
"noplaylist": True,
"format": "ba",
"outtmpl": "downloads/%(id)s.%(ext)s",
}
with YoutubeDL(options) as downloader:
downloader.download(["https://www.youtube.com/watch?v=jNQXAC9IVRw"])Voor een langdurig service, distribueer een nieuwe export door uw bestaande secret management proces en start nieuwe banen met het. Niet blind delen van een mutabele cookie-bestand over concurrerende banen. Houd elke sessie verlenging gescheiden van de succesvolle download archief.
PO-token provider geladen, maar nog steeds geblokkeerd
Controleer of de provider gewoon ontdekt is of een token heeft geproduceerd. Voor een GVS token, de extractor normaal gesproken een gebruikelijke speler resultaat eerst nodig. Als dat client LOGIN_REQUIRED eerder terugkeert, kan het nooit de mediateekende verzoek bereiken.
| Log bewijzen | Volgende actie |
|---|---|
PO Token Providers vermeldt bgutil, maar het logboek toont geen tokenaanmaak | Een geladen plugin is geen bewijs van een succesvolle authenticatie of token generatie. |
Error reaching GET … /ping | In een werknemer container is de localmotelaar de werknemer; gebruik de dienstnaam van de aanbieder op een gedeelde netwerk. |
Generating a gvs PO Token wordt gevolgd door LOGIN_REQUIRED | Controleer de sessie en de werknemerroute. herinstalleren van dezelfde provider verandert niet het account of het outbound netwerk. |
| Token geïntroduceerd, geselecteerde formaten, vervolgens media 403 | Bekijk de tokencontext en extraction/transfer route van de gekozen client in de 403 gids. |
De provider project documenteren een datacenter case waar een token werd gegenereerd en de sign-in fout bleef. Daarom moet de succescheck de spelerrespons en een echte mediaoverdracht omvatten, niet alleen de provider startlijn.
Samenvatting met minder verzoeken
De afzonderlijke boodschap This content isn't available, try again later wordt gedocumenteerd als een guest/account-verzoek-rate limit. Stoppen met het gebruik van die sessie, behoud hun mislukte ID's en laat de weigering duidelijk voordat ze een enkele bron terugtrekken. Er is geen nuttige reden om het volledige manifest te herspelen, terwijl elk item dezelfde reactie krijgt.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txt| Controleer | Wat voor veranderingen |
|---|---|
| -t sleep | Voer de yt-dlp-pacing vooruitstelling toe binnen dit proces. Inspecteer de verbose configuratie voor de effectieve slaapwaarden. |
| --sleep-requests | Relevant voor metadata/player-verzoeken, inclusief werkstromen die nooit media downloaden. |
| --sleep-interval | Wacht voordat de media downloads. Het tempo niet een aparte strakke loop van metadata-alleen verzoeken. |
| --limit-rate | Het beperkt de bandbreedte van de overdracht; het beperkt de frequentie van de speler-verzoek. |
| Controleer de concurrentie | Beperk het gecombineerde werk door uw processen. Tien gepassioneerde werknemers kunnen nog steeds overlapen door één sessie. |
Houd de aanvraag-retry budget afzonderlijk van de retry-instellingen van yt-dlp. Tien werkverzekeringen, elk met een andere downloader met zijn eigen retries, kan de verzoeken vermenigvuldigen. Behandel een verlengde sessie als een vernieuwingsopgave en een voortdurend ontoegankelijke bron als een mislukte item, in plaats van onmiddellijk beide te herhalen.
Controleer of de oorspronkelijke fout is opgelost
- Cookie-loading mislukking: verifieer copying/parsing/decryption succesvol voordat u de reactie van YouTube interpreteren.
- Invalid session: controleer de invalid-cookie waarschuwing verdwijnt en de exacte bron produceert een gebruikelijke speler reactie.
- Leverancierfout: verificatie van de ontdekking, service-toegangbaarheid en een token-generatie-event wanneer nodig.
- Downloadfalen: controleer de bedoelde video/audio stroom bereikt de output bestand; alleen simulatie is niet voltooid.
- Verzamelfalen: herstellen van een werknemer met de bestaande archief en inspecteren van gebleven items voordat het normale kooi wordt hersteld.
Gebruik geen cache verwijdering, certificate-check-deactivatie of een arbitrarische User-Agent als vervanging voor deze checks. Ze vernieuwen geen serververwijderde sessie of decrypt een browserdatabase. Houd de exacte werkende verandering en versies van afhankelijkheid bij de werkgeverconfiguratie.