Explorar documentación
Guías
Actualiza la versión nightly, reduce la concurrencia, verifica Deno y después prueba las cookies y una IP de salida operativa.
En esta página
Intentamos esto primero
- Agresor por la noche. Agresor el entorno de Python utilizado por el trabajador fallido.
- Reduce la carga. Pase las tareas paralelas en este IP; prueba un vídeo y un fragmento a la vez.
- Check Deno. Confirmar que el log verboso detecta el tiempo de trabajo.
- Trí cookies válidas. Para un pequeño trabajo, utilice una sesión de navegador que puede jugar la fuente.
- Remplaza un IP rechazado. Comienza una extracción fresca a través de una salida de host o proxy saludable.
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 el trabajador fallido. Véase la verboza Proxy map para su ruta real. --ignore-config elimina las opciones salvadas pero mantiene instalados los plugins y los proxies del entorno.
Succes significa un archivo salvado. Una vez que el audio funciona, prueba el vídeo con -f bv, luego restablece sus configuraciones de salida completas. --simulate y -F no pruebe una transferencia de medios. La cap 2M es un punto de partida para el diagnóstico.
1 Actualizar por la noche
Un comando que trabajaba anteriormente se detiene de repente: actualiza primero. cambios en el jugador de YouTube pueden romper los extractores más antiguos; los últimos nocturnos ya pueden contener la ficha.
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 y reiniciar un contenedor si su imagen contiene un paquete más antiguo; la actualización de Python en el alojador no actualiza ese contenedor. Mantenga la revisión exacta en el log de trabajo y rellenar la misma fuente de nuevo antes de cambiar otras configuraciones.
Eliminar los antiguos player_client, player_js_version y los formatos=missing_pot sobreridas para la base. Un trabajador de un antiguo incidente puede ahora seleccionar un cliente inadecuado o exponer un flujo cuyo token todavía está ausente. El tema #14680 es un ejemplo de un cambio de jugador en el flujo de alta fijo; copiar su sobrerido temporal indefinidamente no es la ficha.
2 Reducir las solicitudes concurrentes
Download funciona, luego fallan como el volumen aumenta: reduce la carga total en la IP de salida.En la experiencia de FlashData, las transferencias paralelas rápidas pueden desencadenar la rechazo.
| Fuente de carga | Primera configuración de diagnóstico |
|---|---|
| Video Concurrentes de Empleo | Un vídeo activo para este IP de salida; detener temporalmente el resto de la cola. |
| Peticiones de fragmento nativo | --concurrent-fragments 1. |
| aria2 o otro descargador externo | Vuelve a --downloader native. Si más adelante vuelves a usar aria2, empieza con -x 1 -s 1 -j 1. |
| El bandwidth de los medios | Probar --limit-rate 2M como un test conservador, luego aumentar gradualmente. |
| Extracción y nuevas descargas | Usar --sleep-requests 2 y --sleep-interval 5 --max-sleep-interval 10. |
| Retrato de Nested | Mantenga los cuentos de retiro tanto a nivel de trabajo como a nivel de descarga limitados; no los multiplique entre los trabajadores. |
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"Si la transferencia de baja carga funciona, mantenga esa base y aumenta una dimensión a la vez mientras observa fallos. Si todavía fallan inmediatamente después de nightly/runtime verificaciones, no continúan reduciendo la ancho de banda indefinidamente: prueba un IP de salida diferente. Una ruta ya marcada por YouTube puede permanecer rechazada después de que el tráfico que la ha desencadenado haya parado.
3 – El control de la
Verifique ambas dependencias sobre el trabajador: Deno corre los desafíos; yt-dlp-ejs suministra los escritos de solución. El [default] extra instala los escritos. Instalar Deno por separado.
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"Lea la línea de rutas JS para Deno, y cualquier mensaje [jsc:deno] que se resuelva. Un tiempo de lanzamiento ausente o signature/n-challenge alerta necesita fijarse antes de otro gran lanzamiento. Deno 2.3+ es el mínimo actual en la documentación EJS de upstream; use una versión actualizada y soportada.
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"El curl-cffi extra permite --impersonate="". Ofrece impresiones de la solicitud similar al navegador; no sustituye a Deno. Si el objetivo del navegador no está disponible, instale el extra en el mismo entorno de Python. Si la impersonización introduce un fracaso en una ruta de trabajo, comparar la solicitud idéntica sin la bandera.
Después del control de dependencia, se retira la transferencia de medios reales. Si el actual nocturno todavía informa de un fracaso de resolución de firma para el mismo jugador, guardar el ID del jugador y el mensaje de solución para el problema de corriente superior. Si la solución sucede y los medios reciben 403, continúe a session/IP los cheques.
5. reemplazar una salida rechazada IP
El mismo video público, las mismas configuraciones, diferentes resultados por IP: sustituye la salida fallida. FlashData ve muchos persistentes 403s causados por males o flagrados IPs de proxy. Reinstalar yt-dlp no repara esa ruta.
- Mantenga la fuente, revisión nocturna, Deno, cookies si es necesario, y el selector de formato el mismo.
- Testar una salida de IP de sustitución con una extracción fresca y una transferencia de medios reales.
- Confirmar que el proxy realmente cambió su IP de salida. un nuevo nombre de host o credencial de la puerta puede seguir llevando a la misma salida.
- Mantenga una sesión de proxy estricta durante la extracción, la generación de token y la transferencia de medios.
- Removir o enfriar la salida fallida en su piscina.Rota hacia otra salida sana para un nuevo trabajo o una retrea 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 | Siguiente acción |
|---|---|
| La misma fuente sucede en un nuevo IP de salida | Mantenga esa ruta y su base de baja carga. cuarentine la salida fallida en lugar de retirarla para cada vídeo. |
| Cambiar las credenciales de proxy no tiene efecto | Verifique la política de IP y sesión de progreso real; el proxy puede seguir utilizando la misma salida. |
| El jugador funciona, los medios fallan sólo a través del proxy | Verifique el acceso a googlevideo.com y que los medios usan el mismo exit/session. |
| Una fuente fracasará en cada ruta probada; el control funciona | Investiga esa fuente, formato y estado en vivo. No etiquete todo el pool de proxy roto de un solo video. |
Avanzado: mantener la extracción y la transferencia en un IP
Un error de aplicación común es extraer info['url'] en una máquina, almacenándolo en una cueva, y descargarlo más tarde en otro lugar. Las URL de los medios firmados expiran y pueden depender del IP original y los header de solicitud. Un proxy de rotación puede crear la misma división incluso dentro de una aplicación.
Revisa el ID de vídeo de YouTube y las configuraciones de salida deseadas. Que el trabajador realice una extracción fresca y descargue juntos. Si el trabajador utiliza un proxy, mantenga el mismo progreso a través de la extracción del jugador, la generación de token y las solicitudes de medios. Pregúntale al proveedor de proxy para una sesión de contacto en lugar de rotar cada solicitud 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"])Si esto sucede mientras requests.get(saved_media_url) o un proceso separado FFmpeg fracaso, inspeccione que fallece: edad de URL, headeres proporcionados por extractor, cookies y actual progreso. Mantener las URL de los medios fuera de los registros de trabajo duraderos. Cuando retraer los resultados de extracción expirados, solicitar URLs frescos del ID de vídeo original.
Avanzado: identificar la solicitud fallida
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F lista los formatos extraídos; --simulate se detiene antes de salvar medios. Tampoco se demuestra que el flujo seleccionado devolverá bajos. Si el log alcanza Downloading 1 format(s) y luego fracasará con un dato de medios 403, cambiar el nombre de archivo de salida o instalar FFmpeg no reparará esa solicitud HTTP.
Los perfiles de los clientes de YouTube como mweb y web_safari cambian las solicitudes de respuesta del jugador yt-dlp. Algunas respuestas requieren una firma o transformación de n-parámetro; algunas solicitudes de medios también necesitan un token de prueba de origen GVS. Un token PO para la solicitud del jugador no es intercambiable con uno para entrega de medios o subtitulos.
| Log ubicación | Interpretación |
|---|---|
Unable to download API page / Unable to download webpage | Identificar ese alojamiento antes de tratarlo como un fracaso de servidor de medios. |
unable to download video data: HTTP Error 403: Forbidden | La solicitud de los medios seleccionados fue rechazada.Seguen las ramas solver/token/route a continuación. |
| Fragmentos de mensajes retrospectivos | Mantener el error de fragmento y el protocolo; comparar otro formato disponible en lugar de retrear el mismo fragmento indefinidamente. |
| FFmpeg dice HTTP 403 mientras lee un enfoque | FFmpeg es la captura de los medios remotos, por ejemplo para un clip. Véase la URL y la red pasada a FFmpeg; esto no es un error de codec local. |
El almacenamiento de carga devuelve AccessDenied | El archivo llegó a su etapa de upload. Fix bucket access y retry que upload, no la descarga de YouTube. |
Avanzado: instalar un proveedor de PO-token
Utilice esta rama cuando se desplazan los formatos necesarios para un token GVS que no existe o su token configurado se rechaza. Los tokens están vinculados a un contexto client/request y pueden estar vinculados al ID de vídeo. Un token copiado para un vídeo no es una credencia reutilizable para una cola entera. Utilice un proveedor para generar el token para la solicitud actual.
El siguiente modo de configuración utiliza bgutil 2.0.2. Tiene dos partes: un plugin Python cargado por yt-dlp y un servicio de JavaScript que genera tokens. Mantener sus versiones alineadas al actualizar. Los ejemplos a continuación utilizan un servicio que se puede acceder en el mismo alojamiento en el puerto 4416.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"Para yt-dlp que se ejecuta en el alojamiento de Docker. Publica sólo el puerto de retroceso.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2Requiere Git, Node 22+ y npm. Ejecutar el último comando en un terminal separado y dejar que se ejece. Si la pasta ya existe, utilice su actual checkout de la liberación de ajuste.
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 | Qué hacer |
|---|---|
PO Token Providers: none | El plugin no está cargado. instalarlo con el mismo intérprete Python; eliminar --no-plugin-dirs. Para binarias individuales, use la instalación de ZIP del plugin documentado del proveedor en lugar de pip en un entorno no relacionado. |
Error reaching GET … /ping | Comienza el proveedor o corregir base_url. comproba desde el proceso de descarga, no sólo su navegador de ordenador portátil. |
| Proveedor listado, pero no ocurre ninguna generación | Leer los errores de jugador anteriores. LOGIN_REQUIRED puede detener la solicitud antes de la etapa de token. Un plugin cargado no demuestra que se ha utilizado. |
| Se genera un token, luego bot/sign-in se rechaza | Move to session/network diagnóstico. generando un token no autentica la cuenta del navegador. |
| mweb el token funciona, el viejo cliente forzado todavía fracaso | No reutilizes el token de mweb para ese otro cliente. Deja que el proveedor maneje el contexto seleccionado, o vuelva a la configuración del cliente que trabaja. |
Para dos contenedores, 127.0.0.1 en el interior del trabajador se pone el punto al mismo trabajador. Póngase ambos servicios en la misma red de Docker y utilice el nombre de servicio del proveedor, por ejemplo http://bgutil-provider:4416. No expone públicamente el puerto del proveedor.
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"El problema #17681 registra un fracaso de token manual resuelto al cambiar a un proveedor. También contiene una repetición posterior: trata el correcto de trabajo como prueba de que el token falló, no prueba de que cada 403 más tarde tiene la misma causa.
Avanzado: un formato, clip o streaming en vivo fallan
Formatos de lista con las mismas cookies, proveedores y opciones de red como la descarga fallida. Descarga el formato fallido directamente. Si funciona un formato diferente disponible, ha estrecho el fracaso a un camino delivery/client; no ha establecido que cada resolución o codec se rompa.
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"Los avisos de SABR se refieren a los formatos ofrecidos por un cliente. No es lo mismo que un fracaso de n-challenge. Si un viejo web sobrerido produce sólo unavailable/unsupported formatos, quita el sobrerido o utilice el camino documentado mweb/provider. No añade formats=missing_pot como una ficha: exponerá formatos sin suministrar su token perdido.
Los videos en vivo, recientemente terminados y habituales que se cargan pueden exponer diferentes manifiestos. Incluye ese estado al buscar upstream. Si un flujo recientemente terminado todavía está siendo procesado, un formato alternativo actualmente disponible o una extracción posterior puede ser el siguiente test útil; agregar un codec global sobrerido a cada trabajador no es.
Resumen de un trabajador
Repita primero la fuente fallida con la salida requerida video/audio original. Luego, reanuda un trabajador utilizando la política de manifiesto, archivo y salida existente. Si todos los trabajos comparten la misma sesión o ruta fallida, descansar que quieba en lugar de multiplicar sus fallos.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txtUn 403 que regresa en cada intento necesita un cambio de condición antes de retirarse. No establezca retrasos de fragmentos infinitos o mide los IDs fallidos en el archivo de éxito. Si los medios terminan y sólo la entrega de almacenamiento no ha sido posible, reenvíe el cargamento del archivo salvado.
¿Está fallando? prepara un informe de error útil
- Capturar la transferencia real fallida con --verbose, no sólo un éxito --simulate.
- Mantenga la revisión yt-dlp, runtime/EJS versiones, proveedor cargado y el seleccionado format/protocol.
- Incluye la advertencia antes del error, si se solicitó un token y si el fracaso ocurrió antes o después de la selección de medios.
- Recordar los resultados de la misma fuente sobre IPv4/direct/proxy sólo para las comparaciones que realmente se realizaron.
- Remove contenidos de cookies, credenciales de proxy, URLs firmados y tokens antes de compartir el log.
Buscar upstream utilizando el aviso previo específico y su liberación. Si una regresión de coincidencia todavía está abierta, conservar el elemento fallado y utilizar un camino de trabajo confirmado mientras rastreando que se corregirá. Un log limpio que dice sólo '403' es menos útil que un breve registro que muestra el cambio de solicitud y controlado falleció.