Explorar documentación
Guías
Resuelve «Sign in to confirm you’re not a bot» con la versión nightly, Deno, una sesión válida y una IP de salida operativa.
En esta página
Comenzamos con estos cuatro controles
- Agrisa por la noche. Agrisa al trabajador fallido, luego revise una fuente.
- Check Deno. Confirmar que el tiempo de trabajo aparece en el log verboso.
- Troga una sesión válida. Las cookies del navegador pueden ayudar con un pequeño trabajo de descarga.
- Testar otro IP de salida. Si la misma fuente pública funciona allí, mover los trabajos fuera de la ruta marcada.
¿Es el correcto? - Seleccionando el correcto
| mensaje o comportamiento | ¿Dónde ir a continuación |
|---|---|
Sign in to confirm you’re not a bot / LOGIN_REQUIRED | Verificar por la noche y Deno, luego comparar los IP de salida y una sesión válida. |
The provided YouTube account cookies are no longer valid | Substituir la sesión exportada mediante el procedimiento de renovación a continuación. |
| HTTP 429 | Pausa la salida afectada y la frecuencia de solicitud inferior; use la guía separada 429. |
Could not copy Chrome cookie database / Failed to decrypt with DPAPI | Corregir el fracaso de carga de cookies locales; la solicitud autenticada prevista aún no ha ocurrido. |
| Formatos seleccionados, luego medios HTTP 403 | Siga la guía 403 para el contexto de competencia, IP y demanda de medios. |
1. actualización y prueba de una fuente
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --versionUtilice Deno 2.3+ y confirme su detección en el log verboso; es requerido por este flujo de trabajo. El [default] extra proporciona el solvente EJS que se ajusta. Para un binario oficial, use yt-dlp --update-to por la noche y sustituye el python -m yt_dlp con yt-dlp. Mantenga la misma fuente y red para ambos testes a continuación.
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 | Qué cambiar |
|---|---|
| Un trabajo; B fracaso | Removemos las opciones de cookies innecesarias de su trabajo de vídeo público.La sesión seleccionada o el camino de cliente autenticado está introducindo el fracaso.Renueva solo para trabajos que necesitan acceso a la cuenta. |
| Un fracaso; B funciona | Para un trabajador sin cabeza, exportar la sesión con el procedimiento a continuación y retestar en el trabajador. |
| B no puede copy/decrypt cookies | Resolve el error de archivo de navegador local primero. no ha probado el acceso autenticado todavía. |
| Ambos fallan en el servidor; el mismo test funciona localmente | Véase el runtime/config del trabajador, luego compare su red de salida y el volumen total de solicitud. |
| Ambos fallan por una fuente; un control público sucede | Verifique la disponibilidad exacta de la fuente y el acceso a la cuenta.Un éxito de vídeo público diferente no establece el acceso a este. |
Mantenga el viejo player_client que se desprende de esta base. Los clientes de defecto autenticados y anónimos pueden diferir. Por lo tanto, el suministro de cookies es un cambio significativo tanto en el contexto de la sesión como en la selección del cliente, no simplemente añadiendo una bandera universal de desbloqueo.
2: Substituir una IP firmemente marcada
Utilice esta rama cuando muchos videos públicos fallan en un solo trabajador pero la misma configuración sucede en otro lugar. Teste una extracción de fuente fresca y la descarga de medios a través de una salida de host o proxy diferente. Cambiar la fuente IP es la recuperación práctica cuando esa IP es la condición que YouTube sigue rechazando.
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"Verificar que el reemplazo realmente tiene un IP de salida diferente. Los servicios de proxy pueden mantener la misma salida detrás de un portado o nombre de usuario cambiado. Para grandes colecciones, mantenga un pozo de salidas probadas, limite la concorrencia por salida y mude nuevos puestos de trabajo lejos de una de las banderas. Rotar antes de una nueva extracción o después de un trabajo fallido, no entre la solicitud del jugador y su transferencia de medios.
| Comparado | Medida |
|---|---|
| Nueva salida funciona; la vieja salida todavía pide la entrada | Mantenga la ruta de trabajo y refresca down/quarantine la vieja salida.Más retrasas en la vieja salida no renuevan su reputación. |
| Las cookies funcionan para algunos videos | Utilice esa sesión para el pequeño trabajo. no escaleándolo compartiéndolo entre muchos trabajadores ocupados. |
| El navegador funciona en casa; el trabajador todavía fracaso | El hogar IP/session no es el servidor IP/session. Repita el mismo test de un vídeo en la ruta real del trabajador. |
| Un vídeo específico falló en cada ruta | Verifique la disponibilidad de la fuente y los requisitos de cuenta separadamente del control de vídeo público. |
Una cookie de navegador es útil para descargas limitadas, pero un gran conjunto de datos no puede depender de encontrar y refrescar continuamente muchas sesiones de cuenta. Para el trabajo de vídeo público en gran parte, invertir en la calidad de la salida IP, la rotación y la paquete por IP. Mantener cookies para el acceso que necesita una cuenta; un proxy no concede acceso 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 Renovación de una sesión expirada
The provided YouTube account cookies are no longer valid
playability status: LOGIN_REQUIREDPara un archivo de cookie salvado, upstream recomienda exportar una sesión privada dedicada y luego dejar esa sesión cerrada. Una tab de YouTube normal puede rotar la sesión después de exportar.
- Abra una nueva ventana private/incognito y apruebe la cuenta que puede acceder a la fuente.
- En la misma tabla, abri https://www.youtube.com/robots.txt. Mantenga como la única tabla en la sesión privada.
- Exporta cookies de youtube.com de esa sesión privada utilizando una extensión de exportación de cookies vinculada en la FAQ de arriba, con acceso a las ventanas de private/incognito activadas.
- Cerra toda la ventana privada después de exportar. no continúe utilizando esa sesión exportada en el navegador.
- Almacenar la exportación en privado y ejecutar el test de fuente única con --cookies que indica el nuevo archivo.
Combinar --cookies-from-browser con --cookies exporta el perfil de navegador ordinario; no captura esa sesión privada. Modificar las columnas de expiración del archivo también no renueva una sesión que el servidor ha invalidado.
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"Si la advertencia de cookie invalida permanece, el trabajador confirma que recibió el archivo recientemente exportado y que la exportación vino de la sesión privada prevista. Si el alerta desaparece pero LOGIN_REQUIRED permanece, vaya a la comparación network/source debajo. Si la selección de medios sucede y la transferencia ahora regresa 403, utilice los tokens GVS y los cheques de transferencia.
Linux / Docker: copiar un secreto de la cookie sólo leído
--cookies también es un camino de salida: yt-dlp salva su cookie jar cuando el caso se cierra. Indicarlo directamente a un secreto de lectura solo puede producir un error del sistema de archivos, incluso después de una transferencia. Muchos trabajadores escriben el mismo archivo exportado también pueden sobreescribir el estado de los demás.
Mantenga la exportación suministrada privada y copia en el directorio temporal de cada trabajo. El siguiente ejemplo de Python utiliza Deno para los desafíos y descarga un solo flujo de audio. Substituye el camino de archivo de cookie con su camino secreto montado; no se requiere una clave 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 un servicio de largo plazo, distribuye una nueva exportación a través de su proceso de gestión secreto existente y comience nuevos trabajos con él. No comparte ciegamente un archivo de cookie mutable entre trabajos concurrentes. Mantenga cualquier renovación de sesión separada del archivo de descarga exitosa.
El proveedor de PO-token cargado, pero todavía bloqueado
Verificar si el proveedor fue simplemente descubierto o realmente generó un token. Para un token GVS, el extractor normalmente necesita un resultado de jugador usable primero. Si ese cliente devolve LOGIN_REQUIRED antes, puede que nunca alcance la solicitud de los medios.
| Logos de evidencia | Siguiente acción |
|---|---|
PO Token Providers incluye bgutil, pero el registro no muestra que se genere un token | Un plugin cargado no es prueba de la autenticación exitosa o generación de token. |
Error reaching GET … /ping | En un contenedor de trabajadores, localhost es el trabajador; use el nombre del servicio del proveedor en una red compartida. |
Generating a gvs PO Token seguido de LOGIN_REQUIRED | Verificar la sesión y la ruta del trabajador. Reinstalar el mismo proveedor no cambia la cuenta o la red de salida. |
| Tócodos generados, formatos seleccionados, luego medios 403 | Véase el contexto de token del cliente seleccionado y la ruta extraction/transfer en la guía 403. |
El proyecto del proveedor documenta un caso de centro de datos donde se generó un token y el error de registro persistió. Por eso el control de éxito debe incluir la respuesta del jugador y una transferencia de medios reales, no sólo la línea de inicio del proveedor.
Resumen con menos solicitudes
El mensaje separado This content isn't available, try again later se documenta como un límite de la tasa de solicitud guest/account. Detener a los trabajadores de usar esa sesión, mantener sus IDs fallidos y dejar que la rechaza sea clara antes de retirar una fuente única. No hay ninguna razón útil para reproducir el manifiesto completo mientras que cada elemento recibe la misma respuesta.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txt| Control | ¿Qué cambios |
|---|---|
| -t sleep | Aplicar la prescripción de la yt-dlp en este proceso. inspeccionar la configuración verbo para los valores de sueño efectivos. |
| --sleep-requests | Requisitos de extracción.Relativos a metadata/player, incluidos los flujos de trabajo que nunca descargan medios. |
| --sleep-interval | Espera antes de que los medios descarguen. no acelera un círculo separado de metadatos-sólo solicitudes. |
| --limit-rate | Limita la ancho de banda de transferencia; no limita la frecuencia de solicitud del jugador. |
| Queja la competencia | Limita el trabajo combinado a través de sus procesos. diez trabajadores pacados todavía pueden sobrepujar a través de una sesión. |
Mantenga el presupuesto de retiro de la solicitud separado de las configuraciones de retiro de yt-dlp. Diez retrasos de trabajo, cada uno lanzando otro descargador con sus propias retrasas, puede multiplicar las solicitudes. Tratar una sesión expirada como una tarea de renovación y una fuente persistentemente inaccesible como un elemento fallido, en lugar de recoger inmediatamente ambos.
Verifique si se ha resuelto el fracaso original.
- Falta de carga de cookies: verifica copying/parsing/decryption sucede antes de interpretar la respuesta de YouTube.
- Sesión invalida: verifica que el aviso de cookie invalida desaparece y la fuente exacta produce una respuesta de jugador usable.
- Falta de proveedor: verifica la descubrimiento, la accesibilidad del servicio y un evento de generación de token cuando sea necesario.
- Descargar fallos: verificar el flujo video/audio que está previsto realmente llega al archivo de salida; la simulación solo no es la finalización.
- Falta de recopilación: reanuda un trabajador con el archivo existente y inspecta los artículos fallidos antes de restaurar la cola normal.
No utilice el cache deliminar, certificación-check desactivar o un usuario-agente arbitrario como sustitución para estos cheques. No renuevan una sesión rechazada por el servidor o descifran una base de datos del navegador. Mantenga el cambio de trabajo y las versiones de dependencia exactas con la configuración del trabajador.