Explorar documentação
Guias
Pause as tarefas no IP de saída afetado, reduza a frequência de pedidos de extração e legendas e retome um único processo.
Nesta página
Descanse, arrefece e depois teste uma vez
- Por causa do IP afetado. Parar todos os trabalhadores e aposentadorias imediatas compartilhar essa saída.
- Atualiza-se à noite. Verifique o pacote do trabalhador e o Deno durante a pausa.
- Dê uma cooldown. Começa com alguns minutos; honra
Retry-Afterquando fornecido e espera mais tempo se necessário. - Teste uma fonte. Resume um trabalhador embalado somente depois que o teste seja bem sucedido.
- Respondo a saída se necessário. Mantenha a taxa de solicitação mais baixa no novo IP também.
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 \
--sleep-requests 3 --extractor-retries 1 --skip-download --write-info-json -P diagnostics \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Permite obter 429? Espere mais tempo ou altera a saída.Atualização yt-dlp não restaura um limite de taxa IP existente; testando o manifesto completo só adiciona carga.
Encontre a solicitação sendo taxa limitada
| Trabalho falhado | Por que pode gerar muitas solicitações | Primeira redução |
|---|---|---|
| Video metadados / pedidos de jogador | Uma extração completa pode capturar várias respostas de jogador e recursos de suporte. | Uma extração por fonte; reutilizar o resultado dentro do mesmo trabalho. |
| Search / canal / playlist enumeration | Os grandes conjuntos de resultados exigem pedidos repetidos de continuação. | Limite os resultados solicitados, persiste os IDs descobertos e evite repetir toda a escaneamento. |
| Transcript / Track de Ação | Cada idioma ou tradução solicitado pode adicionar uma solicitação de nota. | Solicite apenas as línguas necessárias e adicione sono específico de subtitulo. |
| Mídia / Fragmentos | Vídeos paralelos e fluxos fragmentados compartilham o orçamento de solicitação de saída. | Reduzir os trabalhadores, a concorrência de fragmentos e as conexões de download externos. |
Leia o nome do anfitrião e a linha imediatamente antes 429. Um erro timedtext/caption deve enviar-lhe para o pacing de subtitulos; um pedido de jogador deve enviar-lhe para o pacing de extração. Mudar codecs MP4 ou limitar mídias de bytes não retarda um metadados-somente loop.
Se o yt-dlp exibir Sign in to confirm you’re not a bot, siga o guia de verificação de bot. Um IP sinalizado pode ficar bloqueado por mais tempo que um limite temporário. Para um erro 403 no download de mídia, siga o guia específico de erros 403.
Use o controle de taxa adequado
| Controle | Escopo | O que não resolve |
|---|---|---|
| --sleep-requests 3 | Retardar entre os pedidos de extração dentro deste download. | Coordenação entre outros funcionários ou todas as chamadas API separadas na sua aplicação. |
| --sleep-subtitles 5 | Retardar antes de cada subtítulo de download. | Uma corda ainda requerendo cada língua disponível em muitos trabalhadores. |
| --sleep-interval 5 --max-sleep-interval 10 | Espere antes de baixar o vídeo. | Um loop usando download=False ou --skip-download para metadados apenas. |
| --concurrent-fragments 1 | A concorrência de fragmentos nativos dentro de um trabalho de mídia. | O número de processos separados yt-dlp. |
| --limit-rate 2M | Transmissão de banda de mídia. | Frequência de solicitação de busca, jogador ou transcript. |
| Uma quebra de saída compartilhada | Total de empregos ativos e solicitação brotar através de um único IP de saída. | Uma taxa IP já está limitada por inquilinos ou empregos não relacionados. |
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--skip-download --write-subs --write-auto-subs --sub-langs "en.*" --sub-format "vtt/best" \
--sleep-requests 3 --sleep-subtitles 5 -P captions -o "%(id)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Os números acima são as configurações de início para uma recuperação controlada, não publicações de quotas. Aumente o espaço quando a rejeição retorna. Recordar o IP de saída efetivo e o número de trabalhadores ao lado de erros para que um trabalhador recém-iniciado ou um proxy compartilhado não multiplique silenciosamente a taxa de solicitação.
Exemplo de Python: tempo metadados-só trabalhos
Com download=False, os sonhos de download de mídia não são um programa de trabalho. Adicione um atraso entre as fontes e sleep_interval_requests dentro yt-dlp. Comece seqüentemente, pare de um fracasso e classifique o erro antes de decidir quando retire-o.
import json
import random
import time
from pathlib import Path
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget
from yt_dlp.utils import DownloadError
sources = list(dict.fromkeys(
line.strip() for line in Path("urls.txt").read_text().splitlines()
if line.strip() and not line.lstrip().startswith("#")
))
options = {
"js_runtimes": {"deno": {}},
"impersonate": ImpersonateTarget(),
"noplaylist": True,
"sleep_interval_requests": 3,
"extractor_retries": 1,
}
with Path("metadata.jsonl").open("a", encoding="utf-8") as records:
for index, source in enumerate(sources):
if index:
time.sleep(random.uniform(5, 10))
try:
with YoutubeDL(options) as downloader:
info = downloader.extract_info(source, download=False)
except DownloadError:
# Do not immediately replay a failing queue. Inspect the error;
# cool down the exit before restarting after a rate limit.
raise
record = {key: info.get(key) for key in (
"id", "webpage_url", "title", "channel_id", "duration"
)}
records.write(json.dumps(record, ensure_ascii=False) + "\n")
records.flush()Não detectar cada falha do YouTube procurando por uma linha de mensagens de erro e dormindo sem fim. Mantenha os itens falhados com o seu erro e tentando contar. Um cooldown compartilhado pertence à saída IP ou sessão, enquanto um vídeo não disponível é um fracasso de nível de item. Outros trabalhadores devem respeitar o mesmo cooldown.
Substituir uma saída que permanece limitada
Em uma conexão direta, isso significa um outro uso host/network egress. Com um proxy, significa uma saída diferente do proxy, não apenas uma endereço de gateway diferente. Parar os trabalhadores antigos antes de testar a substituição e manter as mesmas configurações de baixo carregamento.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--proxy "http://USER:PASSWORD@HOST:PORT" --sleep-requests 3 --extractor-retries 1 \
--skip-download --write-info-json -P diagnostics \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Para um emprego de mídia, mantenha esta saída estável da extracção através do transferência; rota entre os trabalhos ou antes de uma nova retração. Uma piscina de proxy ajuda a distribuir o trabalho em massa apenas quando as saídas da piscina são usáveis e a taxa por saída é controlada. Se a substituição imediatamente colidir 429 também, inspeccione o uso compartilhado e a cola em vez de acelerar a rotação.
Resumo sem repetição do trabalho concluído
- Retire a operação exata que falha: metadados, página de pesquisa, track de tag ou fluxo de mídia.
- Comece um trabalhador e observe vários itens. Restaura a concorrência gradualmente, com um limite por IP.
- Reutilizar os IDs descobertos e metadados existentes em vez de repetir cada pesquisa e extração.
- Mantenha as línguas solicitadas explicitamente e retire apenas as pistas perdidas.
- Use retrasas limitadas com aumentos de espera e jitter na cova compartilhada. parar de retrair imediatamente quando a mesma saída é rejeitada novamente.
Manter os meios de comunicação separados e os Estados de notícias. Se o MP4 concluído, mas as capções tiveram 429, mantenha o arquivo e agendar uma reparação de nota. O reabastecimento dos meios adiciona carga e ainda não estabelece a integridade do texto. Um arquivo de mídia sozinho não é um registro de cobertura de notas.