Sfoglia la documentazione
Guide
Aggiorna la versione nightly, riduci le richieste simultanee, verifica Deno e poi prova i cookie e un IP di uscita funzionante.
In questa pagina
Prova questo prima
- Aggiornare di notte. Aggiornare l'ambiente Python utilizzato dal lavoratore fallito.
- Riduce il carico. Parallel lavoro in questo IP; testare un video e un fragmento contemporaneamente.
- Check Deno. Confirmare che il log verboso rileva il tempo di funzionamento.
- Tro cookie validi. Per un piccolo lavoro, utilizzare una sessione del browser che può giocare la fonte.
- Rimposta un IP rifiutato. Inizia una fresca estrazione attraverso una salutare host o una uscita 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"Run sul fallito operaio. Verifica la verboza Proxy map per la sua rotta reale. --ignore-config rimuove le opzioni salvate ma mantiene installati i plug-ins e i proxy ambientali.
Successo significa un file salvato. Una volta che l'audio funziona, testare il video con -f bv, quindi ripristinare le impostazioni di uscita complete. --simulate e -F non testare un trasferimento multimediale. Il capo 2M è un punto di partenza per la diagnosi.
1 Aggiornamento a notte
Un comando che funziona in precedenza improvvisamente fallisce: aggiornamento prima. i cambiamenti di giocatore di YouTube possono rompere gli estrattori più vecchi; l'ultimo notturno può già contenere la riparazione.
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 --versionRistrutturare e riavviare un contenitore se la sua immagine contiene un pacchetto vecchio; aggiornare Python sul host non aggiornano quel contenitore.
Rimuovere vecchi player_client, player_js_version e formati=missing_pot superridi per la linea di base. Un operaio di un vecchio incidente può ora selezionare un cliente inadeguato o esponere un flusso il cui token è ancora mancante. Il problema #14680 è un esempio di un cambiamento del giocatore in un upstream fisso; copiare il suo sovrido temporaneo indefinitamente non è il fisso.
2 Riduzione delle richieste concorrenti
Download funziona, poi fallisce come il volume aumenta: riduce la carica totale sull'IP di uscita.In esperienza di FlashData, i trasferimenti paralleli rapidi possono provocare il rifiuto.
| Fonte di carico | Prima diagnosi di impostazione |
|---|---|
| Video concorrenti di lavoro | Un video attivo per questo IP di uscita; fermare temporaneamente il resto della coda. |
| Richieste di fragmenti nativi | --concurrent-fragments 1. |
| aria2 o un altro download esterno | Torna a --downloader native. Se in seguito riattivi aria2, inizia con -x 1 -s 1 -j 1. |
| Media di banda | Prova --limit-rate 2M come test conservativo, poi aumenta gradualmente. |
| Extrazione e nuovi download | Utilizzare --sleep-requests 2 e --sleep-interval 5 --max-sleep-interval 10. |
| Ritorno Nested | Mantenere limitati i numeri di retrazione a livello di lavoro e di download; non moltiplicarli tra i lavoratori. |
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"Se il trasferimento a basso carico funziona, mantenere quella linea di base e aumentare una dimensione contemporaneamente mentre guardano i fallimenti. Se non è ancora in grado di farlo subito dopo i controlli nightly/runtime, non continuare a ridurre la larghezza di banda indefinitamente: testare un'IP di uscita diversa. Un percorso già segnato da YouTube può rimanere respinto dopo che il traffico che lo ha portato è stato interrotto.
3 Il controllo del deno
Check entrambe le dipendenze sul lavoratore: Deno corre le sfide; yt-dlp-ejs fornisce i script solver. Il [default] aggiuntivo installa gli scritti. Installare il Deno separatamente.
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"Leggi la linea di corrispondenza JS per Deno, e qualsiasi messaggio [jsc:deno] che risolve. Un tempo di esecuzione mancante o un avvertimento signature/n-challenge deve essere risolto prima di un altro grande esecuzione di download. Deno 2.3+ è il minimo attuale nella documentazione EJS in upstream; utilizzare una versione supportata aggiornata.
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"Il curl-cffi extra consente --impersonate="". Fornisce impronte digitali come il browser; non sostituisce Deno. Se il target del browser non è disponibile, installare l'eccesso nello stesso ambiente Python. Se l'impersonazione presenta un fallimento su una rotta di lavoro, confrontare la richiesta identica senza la bandiera.
Dopo il controllo della dipendenza, rerun la trasmissione dei media reali. Se la notte corrente ancora segnalare fallimento di firma-solvente per lo stesso giocatore, salvare l'ID del giocatore e il messaggio di solvente per il problema di upstream corrispondente. Se la soluzione è riuscita e i media ricevono 403, proseguire a session/IP controlli.
5. sostituire un IP di uscita rifiutato
Lo stesso video pubblico, le stesse impostazioni, il risultato differente per IP: sostituisce la uscita fallita. FlashData vede molti persistenti 403s causati da IP proxy poveri o flagellati. Ripristinare yt-dlp non ripara quella rotta.
- Mantenere la fonte, revisione notturna, Deno, cookie se necessario e il formato selettore lo stesso.
- Testare un'IP di uscita sostitutiva con una fresca estrazione e un vero trasferimento di media.
- Confirmare che il proxy ha effettivamente cambiato il suo IP di uscita. Un nuovo nome di host o credentiale di gateway può ancora portare alla stessa uscita.
- Mantenere una sessione proxy stretta durante l'estrazione, la generazione di token e il trasferimento dei media.
- Rimuovere o raffreddare la uscita fallita nella piscina.Rota verso un'altra uscita sana per un nuovo lavoro o una retrazione controllata.
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"| Risultato | Prossima azione |
|---|---|
| La stessa fonte riesce su un nuovo IP di uscita | Mantieni quella rotta e la sua basilica a basso carico. Quarantina la uscita fallita piuttosto che ritirarla per ogni video. |
| Il cambiamento delle credenziali proxy non ha effetto | Verifica la vera politica di ingresso IP e sessione; il proxy può ancora utilizzare la stessa uscita. |
| Il giocatore funziona, i media falliscono solo attraverso il proxy | Verifica l'accesso a googlevideo.com e che i media utilizzano lo stesso exit/session. |
| Una fonte fallisce su ogni percorso testato; il controllo funziona | Ricerca quella fonte, formato e stato di vita. Non etichettare l'intero pool proxy rotto da un video. |
Avanzato: mantenere l'estrazione e il trasferimento su un unico IP
Un bug di applicazione comune è quello di estrarre info['url'] su una macchina, memorizzarla in una coda e scaricarla in un altro luogo. Le URL dei media firmate scadono e possono dipendere dall'IP originale e dai titoli di richiesta. Un proxy rotativo può creare lo stesso divario anche all'interno di una sola applicazione.
Scopri l'ID video di YouTube e le impostazioni di uscita desiderate. Lascia che il lavoratore esegue una nuova estrazione e scarica insieme. Se il lavoratore utilizza un proxy, mantenere lo stesso progresso attraverso l'estrazione del giocatore, la generazione di token e le richieste dei media. Chiedi al fornitore di proxy per una sessione di stretto, invece di rotare ogni richiesta 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"])Se questo succede mentre requests.get(saved_media_url) o un processo separato FFmpeg fallisce, verifica che il disastro: URL età, titoli forniti da estrattore, cookie e effettivo progresso. Mantenere gli URL dei media fuori dai record di lavoro duraturo. Quando si ritirano i risultati di estrazione scaduto, chiedere URL fresche dall'ID video originale.
Avanzato: identificare la richiesta fallita
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F elenca i formati estratti; --simulate si ferma prima di salvare i media. Non dimostra nemmeno che il flusso selezionato restituirà i byti. Se il log raggiunge Downloading 1 format(s) e poi fallisce con un dati di media 403, cambiando il nome del file di uscita o installando FFmpeg non riparerà la richiesta HTTP.
I profili dei clienti di YouTube come mweb e web_safari cambiano le richieste di risposta del giocatore yt-dlp. Alcune risposte richiedono una trasformazione di firma o n-parametro; alcune richieste di media richiedono anche un GVS proof-of-origin token. Un token PO per la richiesta del giocatore non è scambiabile con uno per la consegna dei media o per i sottotitoli.
| Localizzazione Log | Interpretazione |
|---|---|
Unable to download API page / Unable to download webpage | Identificare che host prima di trattarlo come un fallimento del server media. |
unable to download video data: HTTP Error 403: Forbidden | La richiesta di media selezionata è stata respinta. Seguire le fili solver/token/route qui sotto. |
| Il segreto del messaggio di retry | Mantenere l'errore del fragmento e il protocollo; confrontare un altro formato disponibile invece di ritirare lo stesso fragmento indefinitamente. |
| FFmpeg dice HTTP 403 mentre legge un input | FFmpeg è un'eruzione di media remote, ad esempio per un clip. Verificare l'URL e la rete trasferita a FFmpeg; questo non è un errore di codec locale. |
Il caricamento sullo storage restituisce AccessDenied | Il file è arrivato alla fase di upload.Fix bucket access e retry che upload, non il download YouTube. |
Avanzato: installare un fornitore di PO-token
Utilizzare questa ramo quando i formati necessari sono scappati per un token GVS mancante, o il tuo token configurato è rifiutato. I tokens sono collegati a un contesto client/request e possono essere collegati all'ID video. Un token copiato per un video non è una credenziale riutilizzabile per un intero cavo. Utilizzare un fornitore per generare il token per la richiesta corrente.
Il seguente setup utilizza bgutil 2.0.2. Ha due parti: un plugin Python caricato da yt-dlp e un servizio JavaScript che genera token. Mantenere le versioni alineate durante l'aggiornamento. I seguenti esempi utilizzano un servizio raggiungibile sullo stesso host al porto 4416.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"Per yt-dlp eseguire sul host Docker. Pubblicare solo il port loopback.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2Require Git, Node 22+ e npm. Eseguire l'ultimo comando in un terminale separato e lasciarlo funzionare. Se la cartella esiste già, utilizzare il check-out esistente del rilascio corrispondente.
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%| Risultati osservati | Risolto |
|---|---|
PO Token Providers: none | Il plugin non è caricato. installarlo con lo stesso interprete Python; rimuovere --no-plugin-dirs. per binari indipendenti, utilizzare l'installazione del plugin documentato ZIP del fornitore invece di pip in un ambiente non correlato. |
Error reaching GET … /ping | Inizia il provider o corregge base_url. Controlla dal processo di download, non solo il tuo browser laptop. |
| Il fornitore è elencato, ma nessuna generazione si verifica | Leggi gli errori del giocatore precedente. LOGIN_REQUIRED può fermare la richiesta prima della fase di token. Un plugin caricato non dimostra che è stato utilizzato. |
| Un token viene generato, poi bot/sign-in rifiuto | Move a session/network diagnosi. generare un token non autentica il browser account. |
| mweb il token funziona, il vecchio cliente forzato ancora fallisce | Non riutilizzare il token di mweb per quel altro cliente. Lascia che il fornitore gesti il contesto selezionato, o ritorna alla configurazione del cliente lavorativo. |
Per due contenitori, 127.0.0.1 all'interno del lavoratore si riferisce al lavoratore stesso. Posare entrambi i servizi sulla stessa rete Docker e utilizzare il nome del servizio del fornitore, ad esempio http://bgutil-provider:4416. Non esponere pubblicamente il porto del fornitore.
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"Il problema #17681 registra un fallimento manuale-tocen risolto passando a un fornitore. Contiene anche una successiva ripresa: trattare il lavoro di fissaggio come prova di quel fallimento del token, non dimostrare che ogni successivo 403 ha la stessa causa.
Avanzato: un formato, clip o live stream fallisce
Il formato di lista con le stesse cookie, fornitori e opzioni di rete come il fallito download. Eseguire il formato fallito direttamente. Se un formato disponibile funziona diversamente, hai ridotto il fallimento a un percorso delivery/client; non hai stabilito che ogni risoluzione o codec sia rotto.
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"Gli avvertimenti di SABR riguardano i formati offerti da un cliente. Non è la stessa cosa di un fallimento n-challenge. Se un vecchio web override produce solo unavailable/unsupported formati, rimuovere il override o utilizzare la via documentata mweb/provider. Non aggiungere formats=missing_pot come un fisso: esponde i formati senza fornire il loro token mancante.
I video in diretta, recentemente terminati e ordinari caricati possono esponere diversi manifesti. Includere lo stato quando si cerca upstream. Se un flusso di recente terminato è ancora in fase di elaborazione, un formato alternativo attualmente disponibile o un'estrazione successiva può essere utile il prossimo test; aggiungere un codec globale di sovrappeso a ogni lavoratore non è.
Riflessioni su Un lavoratore
In primo luogo, ripetere la fonte fallita con la produzione richiesta originale video/audio. Poi riprendere un lavoratore utilizzando la politica manifesto, archivio e di uscita esistente. Se tutti i lavori condividono la stessa sessione o la stessa rotta fallita, riposa che cammina piuttosto che moltiplicare i suoi fallimenti.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txtUn 403 tornato su ogni tentativo ha bisogno di una condizione cambiata prima di ritirarsi. Non impostare infinite retrazioni di fragmenti o spostare ID falliti nell'archivio di successo. Se i media sono finiti e solo la consegna di archiviazione non è riuscita, riprendere l'invio del file salvato.
Fare un utile errore? - Fare un utile errore
- Ricevere il trasferimento fallito reale con --verbose, non solo una corsa di successo --simulate.
- Mantenere la revisione yt-dlp, runtime/EJS versioni, il fornitore caricato e il selezionato format/protocol.
- Include l'avvertimento prima dell'errore, se un token è stato richiesto e se l'errore è avvenuto prima o dopo la selezione dei media.
- Ricordate i risultati della stessa fonte su IPv4/direct/proxy solo per le confronti che effettivamente avete fatto.
- Rimuovere i contenuti dei cookie, le credenziali proxy, gli URL firmati e i token prima di condividere il log.
Cerca upstream utilizzando l'avvertimento specifico precedente e il tuo rilascio. Se una regressione di corrispondenza è ancora aperta, mantenere l'articolo fallito e utilizzare un percorso di lavoro confermato mentre traccia che ripara. Un logo pulito che dice solo '403' è meno utile che un breve record che mostra il quale richiesta e cambiamento controllato non è riuscito.