Explorar documentação
Guias
Atualize a versão nightly, reduza a concorrência, confira o Deno e depois teste os cookies e um IP de saída que funcione.
Nesta página
Tente isso primeiro
- Atualiza-se à noite. Atualiza o ambiente de Python usado pelo trabalhador falhado.
- Reduzir a carga. Paralelar trabalhos neste IP; testar um vídeo e um fragmento ao mesmo tempo.
- Check Deno. Confirmar que o log verbo detecta o tempo de trabalho.
- Tre cookies válidos. Para um pequeno trabalho, use uma sessão de navegador que pode jogar a fonte.
- Respondem um IP rejeitado. Iniciar uma extração fresca através de uma saída saudável ou de 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 sobre o trabalhador falhado. Verifique a verboza Proxy map para sua rota real. --ignore-config remove opções salvas, mas mantém plugins e proxies de ambiente instalados.
Sucesso significa um arquivo salvo. Uma vez que o áudio funciona, teste o vídeo com -f bv, e depois restaura as configurações de saída completas. --simulate e -F não teste uma transferência de mídia. A cap 2M é um ponto de partida para o diagnóstico.
1 - Atualização para noite
Um comando de trabalho anterior sozinho falha: atualizar primeiro. alterações no jogador do YouTube podem quebrar extractores mais antigos; o último nocturno pode já conter a fixação.
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 --versionReconstruir e reiniciar um conterno se a imagem contém um pacote mais antigo; atualizar Python no host não atualizará esse conterno. manter a revisão exata no log de trabalho e executar a mesma fonte novamente antes de alterar outras configurações.
Remova os antigos player_client, player_js_version e os formatos=missing_pot sobrecostas para a linha de base. Um trabalhador de um antigo incidente pode agora selecionar um cliente inadequado ou expor um fluxo cujo token ainda está faltando. A questão #14680 é um exemplo de uma mudança de jogador fixado upstream; copiar seu sobre-rido temporário indefinidamente não é a fixa.
2 Reduzir as solicitações concorrentes
Download funciona, então falha como o volume aumenta: reduz a carga total na IP de saída.Na experiência do FlashData, transferências paralelas rápidas podem desencadear rejeição.
| Fonte de carga | Primeiro diagnóstico de configuração |
|---|---|
| Concurrentes videogames | Um vídeo ativo para esta saída IP; parar o resto da corda temporariamente. |
| Pedidos de fragmento nativo | --concurrent-fragments 1. |
| aria2 ou outro download externo | Volte para --downloader native. Se voltar a usar o aria2 depois, comece com -x 1 -s 1 -j 1. |
| Banda de mídia | Tente --limit-rate 2M como um teste conservador, depois aumenta gradualmente. |
| Extracção e novas downloads | Usar --sleep-requests 2 e --sleep-interval 5 --max-sleep-interval 10. |
| Retrato de Nestes | Mantenha os números de retorno de nível de trabalho e de nível de downloader limitados; não os multiplique entre os trabalhadores. |
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 a transferência de baixo carregamento funciona, mantenha essa base e aumenta uma dimensão ao mesmo tempo enquanto observa falhas. Se ainda falhar imediatamente após nightly/runtime verificações, não continue a reduzir a largura de banda indefinidamente: testar um IP de saída diferente. Uma rota já flagrada pelo YouTube pode permanecer rejeitada depois que o tráfego que o desencadeou tenha parado.
3 – Verifique o seu
Verifique ambas as dependências sobre o trabalhador: Deno corre os desafios; yt-dlp-ejs fornece os scripts de solução. O [default] extra instala os scripts. Instale o Deno separadamente.
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"Leia a linha de execução JS para Deno, e qualquer mensagem [jsc:deno] resolvente. Um tempo de execução perdido ou signature/n-challenge alerta precisa ser corrigido antes de outro grande download. O Deno 2.3+ é o mínimo atual na documentação EJS; use uma versão atualizada suportada.
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"O curl-cffi extra permite --impersonate="". Ele fornece impressões digitais de pedido como o navegador; não substitui o Deno. Se o objetivo do navegador não estiver disponível, instale o extra no mesmo ambiente Python. Se a personalização introduzir um fracasso em uma rota de trabalho, compare a solicitação idêntica sem a bandeira.
Após o check de dependência, a transferência de mídia real é revertida. Se o atual nocturno ainda relata falha de resolução de assinatura para o mesmo jogador, salve o ID do jogador e a mensagem de solução para o problema de corrente. Se a solução sucede e os meios de comunicação recebem 403, continue para session/IP verificações.
5. substituir um IP de saída rejeitada
O mesmo vídeo público, as mesmas configurações, o resultado diferente por IP: substitui a saída falha. O FlashData vê muitos persistentes 403s causados por IPs proxy pobres ou flagrados. Reinstalar yt-dlp não repara essa rota.
- Mantenha a fonte, revisão noturna, Deno, cookies se necessário e o formato selector o mesmo.
- Teste uma saída de IP de substituição com uma extração fresca e uma transferência de mídia real.
- Confirmar que o proxy realmente mudou seu IP de saída. um novo nome de hospedagem ou credencial de gateway ainda pode levar à mesma saída.
- Mantenha uma sessão de proxy estressante durante a extracção, geração de tokens e transferência de mídia.
- Remova ou arrefece a saída falha em sua piscina. Rotar para outra saída saudável para um novo emprego ou uma retração controlada.
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"| Resultado | Próxima ação |
|---|---|
| A mesma fonte sucede em um novo IP de saída | Mantenha essa rota e sua base de baixo carregamento. quarentine a saída falha em vez de retire-a para cada vídeo. |
| Mudança de credenciais proxy não tem efeito | Verifique a política de IP e sessão do progresso; o proxy ainda pode usar a mesma saída. |
| O jogador funciona, os meios de comunicação falham apenas através do proxy | Verifique o acesso googlevideo.com e que os meios de comunicação usam o mesmo exit/session. |
| Uma fonte falha em cada rota testada; o controle funciona | Investigue a fonte, o formato e o estado de vida. Não etique toda a piscina de proxy quebrada de um vídeo. |
Avançado: manter a extração e transferência em um único IP
Um erro de aplicativo comum é extrair info['url'] em uma máquina, armazená-lo em uma cova e baixar-lo mais tarde noutro lugar. Os URLs de mídia assinados expiram e podem depender do IP original e dos cabeçalhos de solicitação. Um proxy de rotação pode criar a mesma divisão mesmo dentro de uma aplicação.
Verifique o ID de vídeo do YouTube e as configurações de saída desejadas. Que o trabalhador faça uma extração fresca e baixe juntos. Se o trabalhador usa um proxy, mantenha o mesmo egress através da extração do jogador, geração de tokens e as solicitações de mídia. Peça ao provedor de proxy para uma sessão de toque em vez de rotar cada pedido 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 isso sucede enquanto requests.get(saved_media_url) ou um processo separado FFmpeg falha, inspire que falha: URL idade, cabeças fornecidas por extractor, cookies e erros reais. Mantenha URLs de mídia fora dos registros de trabalho duradouros. Quando retrair resultados de extração expirado, peça URLs frescos do ID original do vídeo.
Avançado: identificar a solicitação falha
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F lista os formatos extraídos; --simulate parou antes de salvar mídia. Também não prova que o fluxo selecionado retornará bytes. Se o log alcançar Downloading 1 format(s) e, em seguida, falhar com um dados de mídia 403, mudar o nome de arquivo de saída ou instalar FFmpeg não irá corrigir a solicitação HTTP.
Os perfis do cliente do YouTube, como mweb e web_safari, mudam as perguntas que o jogador responde yt-dlp. Algumas respostas precisam de uma transformação de assinatura ou n-parâmetro; algumas solicitações de mídia também precisam de um token de origem GVS. Um token PO para a solicitação do jogador não é intercambiável com um para entrega de mídia ou subtitulos.
| Log Localização | Interpretação |
|---|---|
Unable to download API page / Unable to download webpage | Identificar esse host antes de tratá-lo como um erro de servidor de mídia. |
unable to download video data: HTTP Error 403: Forbidden | A solicitação de mídia selecionada foi rejeitada. siga as ramas solver/token/route abaixo. |
| Fragmento de mensagens retra | Mantenha o erro de fragmento e protocolo; Compare outro formato disponível em vez de retire o mesmo fragmento indefinidamente. |
| FFmpeg diz HTTP 403 enquanto lê uma entrada | FFmpeg é capturar mídia remoto, por exemplo para um clipe. verifique a URL e rede passada para FFmpeg; este não é um erro de codec local. |
Armazém de upload de volta AccessDenied | Fixar o acesso bucket e retry que upload, não o download do YouTube. |
Avançado: instalar um provedor de PO-token
Use esta ramo quando os formatos necessários são excluídos para um token GVS ausente, ou seu token configurado é rejeitado. Os tokens estão ligados a um contexto client/request e podem ser ligados ao ID de vídeo. Um token copiado para um vídeo não é uma credencial reutilizável para uma corda inteira. Use um provedor para gerar o token para a solicitação atual.
A seguir, o conjunto de configurações usa bgutil 2.0.2. Ele tem duas partes: um plugin Python carregado por yt-dlp e um serviço de JavaScript que gera tokens. Mantenha as suas versões alinhadas ao atualizar. Os exemplos abaixo usam um serviço acessível no mesmo host no porto 4416.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"Para yt-dlp executar no hospedador do Docker. Publica apenas o portão de volta ao caminho.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2Requer Git, Node 22+ e npm. Execute o último comando em um terminal separado e deixe que ele funcione. Se a pasta já existe, use o check-out existente do relevo de correspondência.
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%| Resultado observado | Consertar |
|---|---|
PO Token Providers: none | O plugin não é carregado. instale-o com o mesmo intérprete Python; remova --no-plugin-dirs. Para binárias independentes, use a instalação documentada do plugin ZIP do provedor em vez de pip em um ambiente não relacionado. |
Error reaching GET … /ping | Comece o provedor ou corrija base_url. Verifique do processo de download, não apenas seu navegador de computador portátil. |
| Fornizador listado, mas nenhuma geração acontece | Leia erros anteriores do jogador. LOGIN_REQUIRED pode parar a solicitação antes da etapa do token. um plugin carregado não prova que foi usado. |
| Um token é gerado, depois bot/sign-in rejeição | Mover para o diagnóstico session/network. gerar um token não autentica a conta do navegador. |
| mweb o token funciona, o velho cliente forçado ainda falha | Não reutilize o token mweb para aquele outro cliente. Deixe que o fornecedor gerencie o contexto selecionado, ou volte à configuração do cliente em trabalho. |
Para dois contêineres, 127.0.0.1 no interior do trabalhador ponta para o trabalhador em si. Coloque os dois serviços na mesma rede do Docker e use o nome de serviço do fornecedor, por exemplo http://bgutil-provider:4416. Não expor o porto do fornecedor publicamente.
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"O problema #17681 registra um falha de token manual resolvido ao mudar para um provedor. Também contém uma recorrência posterior: trata a fixação de trabalho como evidência para esse fracasso do token, não prova que cada 403 posterior tem a mesma causa.
Avançado: um formato, clipe ou streaming ao vivo falha
Os formatos de lista com os mesmos cookies, provedores e opções de rede que o download falhado. Execute o formato falhado diretamente. Se um formato disponível diferente funciona, você estreitou o fracasso para um caminho delivery/client; você não estabeleceu que cada resolução ou codec é quebrado.
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"A SABR advertem sobre os formatos oferecidos por um cliente. Não é o mesmo que um fracasso de n-challenge. Se um velho web sobre-rida produz apenas unavailable/unsupported formatos, remova o sobre-rida ou use o caminho documentado mweb/provider. Não adicione formats=missing_pot como uma fixação: expõe formatos sem fornecer o seu token perdido.
Vídeos ao vivo, recentemente concluídos e normalmente carregados podem expor diferentes manifestos. Incluir esse estado quando você está procurando upstream. Se um fluxo recentemente finalizado ainda está sendo processado, um formato alternativo atualmente disponível ou uma extração posterior pode ser o útil teste seguinte; adicionar um codec global sobrerida a cada trabalhador não é.
Resumo de um trabalhador
Primeiro, repita a fonte falha com a saída original requerida video/audio. Em seguida, reencarna um trabalhador usando a política existente de manifesto, arquivo e saída. Se todos os trabalhos compartilham a mesma sessão ou rota falha, pausa que quebra em vez de multiplicar seus fracassos.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txtUm 403 retornado em cada tentativa precisa de uma condição alterada antes de se aposentar. Não coloque retras infinitas de fragmentos ou mova os IDs falhados no arquivo de sucesso. Se os meios de comunicação estiverem terminados e apenas a entrega de armazenamento falhar, reencarregue o upload do arquivo salvo.
Ainda falha? preparar um relatório de erro útil
- Capturar a transferência falha real com --verbose, não apenas uma corrida bem sucedida --simulate.
- Mantenha a revisão yt-dlp, as versões runtime/EJS, o provedor carregado e o selecionado format/protocol.
- Inclua o alerta antes do erro, se um token foi solicitado e se o fracasso ocorreu antes ou depois da seleção de mídia.
- Recordar os resultados da mesma fonte sobre IPv4/direct/proxy apenas para as comparações que você realmente fez.
- Remova o conteúdo de cookies, credenciais de proxy, URLs assinados e tokens antes de compartilhar o log.
Busque upstream usando o alerta específico anterior e seu lançamento. Se uma regressão de correspondência ainda está aberta, mantenha o item falhado e use um caminho de trabalho confirmado enquanto rastreia essa correção. Um log limpo que diz apenas '403' é menos útil do que um registro curto que mostra que a solicitação e a mudança controlada falhou.