Explorar documentação
Guias
Resolva “Sign in to confirm you’re not a bot” com a versão nightly, o Deno, uma sessão válida e um IP de saída que funcione.
Nesta página
Comece com estes quatro cheques
- Atualiza-se à noite.Agrima o trabalhador falhado, depois reteste uma fonte.
- Check Deno. Confirmar o tempo de execução aparece no log verbo.
- Tre uma sessão válida. Cookies do navegador podem ajudar com um pequeno trabalho de download.
- Teste outro IP de saída. Se a mesma fonte pública funciona lá, mova os trabalhos fora da rota flagrada.
Diferente mensagem? escolha a solução certa
| Mensagem ou comportamento | Onde ir para a próxima |
|---|---|
Sign in to confirm you’re not a bot / LOGIN_REQUIRED | Verifique nocturno e Deno, em seguida, compare IPs de saída e uma sessão válida. |
The provided YouTube account cookies are no longer valid | Substituir a sessão exportada usando o procedimento de renovação abaixo. |
| HTTP 429 | Parar a saída afetada e a frequência de pedido mais baixa; use a guia separada 429. |
Could not copy Chrome cookie database / Failed to decrypt with DPAPI | Corrigir o falha de carregamento de cookies local; a solicitação autenticada pretendida ainda não ocorreu. |
| Formatos selecionados, em seguida, os meios HTTP 403 | Siga a Guia 403 para o contexto de concorrência, IP e demanda de mídia. |
1. atualizar e testar uma fonte
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --versionUse Deno 2.3+ e confirme a sua detecção no log verbo; é exigido por este fluxo de trabalho. O [default] extra fornece o solvente EJS correspondente. Para um binário oficial, use yt-dlp --update-to à noite e substitui Python -m yt_dlp com yt-dlp. Mantenha a mesma fonte e rede para ambos os testes abaixo.
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 Resultado | O que mudar? |
|---|---|
| A obra; B falha | Remova opções de cookies desnecessárias do seu trabalho público-vídeo. a sessão selecionada ou o caminho do cliente autenticado está introduzindo o fracasso. renova-o apenas para trabalho que precisa de acesso à conta. |
| A falha; B trabalha | Para um trabalhador sem cabeça, exportar a sessão com o procedimento abaixo e retestar no trabalhador. |
| B não pode copy/decrypt cookies | Resolva o erro do arquivo de navegador local primeiro. você ainda não testou o acesso autenticado. |
| Ambos falham no servidor; o mesmo teste funciona localmente | Verifique o runtime/config do trabalhador, em seguida, compare a sua rede de saída e o volume total de solicitação. |
| Ambos falham por uma fonte; um controle público sucede | Verifique a disponibilidade exata da fonte e o acesso à conta. um sucesso de vídeo público diferente não estabelece acesso a este. |
Mantenha o velho player_client sobrepondo fora desta base. Os clientes de default autenticados e anônimos podem diferir. O fornecimento de cookies é, portanto, uma mudança significativa tanto no contexto da sessão como na seleção do cliente, não apenas adicionando uma bandeira universal de descartamento.
2. substituir um IP persistentemente flagrado
Use esta rama quando muitos vídeos públicos falham em um trabalhador, mas a mesma configuração sucede em outro lugar. Teste uma extração de fonte fresca e download de mídia através de uma saída de hospedagem ou proxy diferente. Mudar o IP fonte é a recuperação prática quando esse IP é a condição que o YouTube continua rejeitando.
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"Verifique que a substituição realmente tem um IP de saída diferente. Os serviços de proxy podem manter a mesma saída atrás de uma porta ou nome de usuário alterado. Para grandes coleções, mantenha uma piscina de saídas testadas, limite a concorrência por saída e mova novos empregos longe de um flagrado. Rotar antes de uma nova extração ou após um trabalho falhado, não entre a solicitação do jogador e a transferência de mídia.
| Comparação | Ação |
|---|---|
| Nova saída funciona; a antiga saída ainda pede para assinar | Mantenha a rota de trabalho e refresque down/quarantine a antiga saída. mais retrases na antiga saída não renovarão sua reputação. |
| Cookies funcionam para alguns vídeos | Use essa sessão para o pequeno trabalho. não escale, compartilhando-a entre muitos trabalhadores ocupados. |
| O navegador trabalha em casa; o trabalhador ainda falha | O lar IP/session não é o servidor IP/session. Repita o mesmo teste de vídeo em uma rota real do trabalhador. |
| Um vídeo falha em cada rota | Verifique a disponibilidade da fonte e os requisitos de conta separadamente do controle público de vídeo. |
Um cookie de navegador é útil para baixas limitadas, mas um grande conjunto de dados não pode depender de encontrar e refrescar continuamente muitas sessões de conta. Para o trabalho de vídeo público em massa, investir na qualidade de saída-IP, rotação e pacagem por IP. Mantenha cookies para acesso que necessita de uma conta; um proxy não concede acesso privado de vídeo.
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 Renova uma sessão expirada
The provided YouTube account cookies are no longer valid
playability status: LOGIN_REQUIREDPara um arquivo de cookie salvo, o upstream recomenda exportar uma sessão privada dedicada e, em seguida, deixar essa sessão fechada. Uma tab de YouTube normal pode rotar a sessão após a exportação.
- Abra uma nova janela private/incognito e assine na conta que pode acessar a fonte.
- Na mesma tabela, abra https://www.youtube.com/robots.txt. Mantenha-o como a única tabela na sessão privada.
- Exportar cookies youtube.com a partir dessa sessão privada usando uma extensão de exportação de cookies ligada na FAQ superior, com acesso às janelas private/incognito ativadas.
- Feche toda a janela privada após exportar. não continue usando essa sessão exportada no navegador.
- Mantenha a exportação em privado e execute o teste de código único com --cookies indicando o novo arquivo.
Combinar --cookies-from-browser com --cookies exporta o perfil do navegador comum; não capta essa sessão privada. Mudar as colunas de expiração do arquivo também não renova uma sessão que o servidor invalidou.
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"Se a notificação de cookie inadvertidor permanecer, o trabalhador confirma que recebeu o arquivo recentemente exportado e que a exportação veio da sessão privada pretendida. Se o alerta desaparecer, mas LOGIN_REQUIRED permanece, vá para a comparação network/source abaixo. Se a seleção de mídia for bem sucedida e a transferência agora retorna 403, use o token GVS e os cheques de transferência.
Linux / Docker: copiar um segredo de cookie apenas lido
--cookies também é um caminho de saída: yt-dlp salva sua barra de cookies quando a instância fecha. Indicar diretamente em um segredo apenas leído pode produzir um erro do sistema de arquivos, mesmo após uma transferência. Muitos trabalhadores que escreveram o mesmo arquivo exportado também podem sobreescrever o estado uns dos outros.
Mantenha a exportação fornecida privada e copia-a no diretório temporário de cada trabalho. O exemplo Python seguinte usa Deno para desafios e descarga um fluxo de áudio. Substitui o caminho do arquivo de cookie com o seu caminho secreto montado; não é necessário nenhum chave API.
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"])Para um serviço de longa duração, distribua uma nova exportação através do seu processo de gestão secreto existente e comece novos empregos com ele. Não compartilhe cegamente um arquivo de cookie mutável em trabalhos concorrentes. Mantenha qualquer renovação de sessão separada do arquivo de download bem sucedido.
O provedor de PO-token carregado, mas ainda bloqueado
Verifique se o provedor foi simplesmente descoberto ou gerou um token. Para um token GVS, o extractor normalmente precisa de um resultado de jogador usável primeiro. Se o cliente retornar LOGIN_REQUIRED antes, ele pode nunca alcançar a solicitação de token de mídia.
| Log evidência | Próxima ação |
|---|---|
PO Token Providers inclui bgutil, mas o registro não mostra a geração de um token | Leia erros do jogador anterior. um plugin carregado não é prova de autenticação bem sucedida ou geração de tokens. |
Error reaching GET … /ping | Em um contêiner de trabalhadores, localhost é o trabalhador; use o nome de serviço do provedor em uma rede compartilhada. |
Generating a gvs PO Token seguido de LOGIN_REQUIRED | Verifique a sessão e o itinerário do trabalhador. Reinstalar o mesmo provedor não muda a conta ou a rede de saída. |
| Tócodos gerados, formatos selecionados, e medias 403 | Verifique o contexto de token do cliente selecionado e a rota extraction/transfer no guia 403. |
O projeto do fornecedor documenta um caso de centro de dados onde um token foi gerado e o erro de inscrição persistiu. É por isso que o check de sucesso deve incluir a resposta do jogador e uma transferência de mídia real, não apenas a linha de start-up do fornecedor.
Resumo com menos solicitações
A mensagem separada This content isn't available, try again later é documentada como um limite de taxa de pedido guest/account. Pare os trabalhadores usando essa sessão, mantenha seus IDs falhados e deixe a rejeição clara antes de retirar uma única fonte. Não há razão útil para reproduzir o manifesto completo enquanto cada item recebe a mesma resposta.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txt| Controle | Quais mudanças |
|---|---|
| -t sleep | Aplique a preposição de pacagem yt-dlp dentro deste processo. Inspira a configuração verbo para os valores do sono eficazes. |
| --sleep-requests | Permitir pedidos de extração.Relativo para metadata/player pedidos, incluindo fluxos de trabalho que nunca baixar mídia. |
| --sleep-interval | Espera antes de baixar os meios de comunicação. não acelera um círculo separado de metadados-só pedidos. |
| --limit-rate | Limita a largura de banda de transferência; não limita a frequência de pedido do jogador. |
| Queixar a concorrência | Limite o trabalho combinado em todos os seus processos. Dez trabalhadores paced ainda podem sobrepegar por uma sessão. |
Mantenha o orçamento de retorno de aplicação separado das configurações de retorno de yt-dlp. Dez retrasos de trabalho, cada um lançando outro downloader com suas próprias retrasas, pode multiplicar as solicitações. Tratar uma sessão expirada como uma tarefa de renovação e uma fonte persistentemente inacessível como um item falhado, em vez de imediatamente requeir ambos.
Verifique se o fracasso original está resolvido
- Falta de carregamento de cookies: verifica copying/parsing/decryption sucede antes de interpretar a resposta do YouTube.
- Sessão invalida: verificar o aviso de cookie invalido desaparece e a fonte exata produz uma resposta do jogador usável.
- Fala do fornecedor: verifica a descoberta, a acessibilidade do serviço e um evento de geração de token quando necessário.
- Fala de download: verificar o fluxo video/audio pretendido realmente chega ao arquivo de saída; simulação só não é a conclusão.
- Fala de coleta: reencontrar um trabalhador com o arquivo existente e verificar itens falhados antes de restaurar a corda normal.
Não use cache deletion, certificado-check disabilitando ou um User-Agente arbitrário como substituto para esses cheques. Eles não renovar uma sessão rejeitada pelo servidor ou descriptografar uma base de dados do navegador. Mantenha as versões de mudança de trabalho e dependência exatas com a configuração do trabalhador.