Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Guias

Como corrigir o erro 403 Forbidden do yt-dlp

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

  1. Atualiza-se à noite. Atualiza o ambiente de Python usado pelo trabalhador falhado.
  2. Reduzir a carga. Paralelar trabalhos neste IP; testar um vídeo e um fragmento ao mesmo tempo.
  3. Check Deno. Confirmar que o log verbo detecta o tempo de trabalho.
  4. Tre cookies válidos. Para um pequeno trabalho, use uma sessão de navegador que pode jogar a fonte.
  5. Respondem um IP rejeitado. Iniciar uma extração fresca através de uma saída saudável ou de proxy.
Atualização, depois verifique o tempo de execução necessário
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
Uma fonte, uma transferência de baixo carregamento
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"
Use seu URL falhado, em seguida, um vídeo público curto como controle. esta sonda de áudio só evita FFmpeg e salva um novo nome de arquivo timestampado para cada tentativa.

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.

Atualização do ambiente Python do trabalhador
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__)"
Se você usar o executável oficial em vez
yt-dlp --update-to nightly
yt-dlp --version
yt-dlp -U apenas atualizações dentro do canal atual. Use --update-to à noite para mudar de estável.

Reconstruir 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 cargaPrimeiro diagnóstico de configuração
Concurrentes videogamesUm 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 externoVolte para --downloader native. Se voltar a usar o aria2 depois, comece com -x 1 -s 1 -j 1.
Banda de mídiaTente --limit-rate 2M como um teste conservador, depois aumenta gradualmente.
Extracção e novas downloadsUsar --sleep-requests 2 e --sleep-interval 5 --max-sleep-interval 10.
Retrato de NestesMantenha os números de retorno de nível de trabalho e de nível de downloader limitados; não os multiplique entre os trabalhadores.
Retire o vídeo necessário em baixo carregamento
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.

Verifique as dependências dos trabalhadores
deno --version
python -m pip show yt-dlp yt-dlp-ejs
python -m yt_dlp --list-impersonate-targets
Verificar a detecção do tempo de trabalho e solução de desafios
python -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.

Serviço Linux com Deno fora do PATH
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Substituir /opt/deno/bin/deno com o real executável. no macOS ou Windows, use esse caminho absoluto de Deno do trabalhador em vez disso.

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.

4. tente cookies válidos para um pequeno trabalho

Teste uma sessão conhecida. Confirme que o navegador pode jogar a fonte exata, depois tente seus cookies com o mesmo comando e rota.

Use a sessão de Firefox
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"
Use uma sessão exportada em um trabalhador sem cabeça
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"
Use cookies de formato Netscape.Mantenha o arquivo privado e escrito para este trabalho; para um segredo de leitura, faça uma cópia por trabalho.

Se os cookies carregarem, mas o YouTube diz que não são mais válidos, substituir a sessão em vez de passar repetidamente o mesmo arquivo. Para alguns vídeos, manter um login do navegador pode ser prático. Para uma grande coleção de vídeo público, encontrar e refrescar muitas sessões de navegador não é uma estratégia de escalagem dependente.

Para trabalho em massa, gerencie um poço de IPs de saída de proxy usáveis e rote nas fronteiras de trabalho, com um baixo orçamento por pedido IP. Mantenha cookies de conta para fontes que realmente exigem acesso à conta. Uma mudança de IP não permite o acesso a um vídeo privado ou não disponível.

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.

  1. Mantenha a fonte, revisão noturna, Deno, cookies se necessário e o formato selector o mesmo.
  2. Teste uma saída de IP de substituição com uma extração fresca e uma transferência de mídia real.
  3. 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.
  4. Mantenha uma sessão de proxy estressante durante a extracção, geração de tokens e transferência de mídia.
  5. 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.
Testar uma sessão de substituição proxy
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"
Substituir um proxy de sessão real em privado. o log verbo pode expor credenciais de proxy; escreva-o antes de compartilhar.
Compare o acesso de hospedagem direto quando disponível
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"
Isso desabilita environment/configured proxy para o teste. remova-o quando o anfitrião não pode acessar o YouTube diretamente.
Compare a rota IPv4 do anfitrião
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"
Uma rota IPv4 em funcionamento pode diferir da rota IPv6 falha. com um proxy, -4 não necessariamente seleciona a família IP de saída do proxy.
ResultadoPróxima ação
A mesma fonte sucede em um novo IP de saídaMantenha 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 efeitoVerifique 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 proxyVerifique 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 funcionaInvestigue 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.

Mantenha a extração e a transferência no mesmo trabalho de Python
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"])
Este é um download local direto; não precisa de chave API. Adicione as opções verificadas cookie/provider apenas se os testes anteriores os exigirem.

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

A sequência de solicitação
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çãoInterpretação
Unable to download API page / Unable to download webpageIdentificar esse host antes de tratá-lo como um erro de servidor de mídia.
unable to download video data: HTTP Error 403: ForbiddenA solicitação de mídia selecionada foi rejeitada. siga as ramas solver/token/route abaixo.
Fragmento de mensagens retraMantenha 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 entradaFFmpeg é 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 AccessDeniedFixar 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.

Instale o conector no ambiente de Python yt-dlp
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.

Inicie o fornecedor
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2
Verifique o serviço do ambiente do downloader
python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"
Espere HTTP 200. execute isso dentro do recipiente do trabalhador se é onde yt-dlp corre.
Request mweb mídia com o fornecedor
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"
O que procurar no log
PO Token Providers: bgutil:http-2.0.2 (external)
Generating a gvs PO Token for mweb client via bgutil HTTP server
[download] 100%
Estas são linhas curtas do nosso trabalho local. a descoberta do provedor, a geração de tokens e a transferência de mídia são três verificações separadas.
Resultado observadoConsertar
PO Token Providers: noneO 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 … /pingComece 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 aconteceLeia 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çãoMover 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 falhaNã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.

Use um provedor na rede Docker do trabalhador
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.

Lista dos formatos para este contexto de solicitação
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Teste o ID falhado desta lista
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"
Substituir YOUR_FORMAT_ID. Para uma seleção combinada, teste os IDs de vídeo e áudio separadamente. Para um clipe, primeiro teste um fluxo não cortado.

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.

Aplique pacing para a sua configuração de coleção existente
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
  --fragment-retries 3 --batch-file urls.txt
Use a configuração que contém as opções de trabalho, fornecedor, saída e arquivo atualmente em funcionamento. o sono pre-set espaços de solicitações dentro deste processo; não coordena outros trabalhadores.

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