Solución de problemas
Resuelva los fallos más frecuentes de VidArch.
El puerto 2499 ya está en uso
Detenga el proceso anterior o modifique el puerto publicado por Docker. En el desarrollo local, verifique también que la API 2498 esté libre.
yt-dlp no se encuentra
Revise la página de sistema, el PATH y YT_DLP_PATH. Con Docker, vuelva a crear la imagen o el contenedor en lugar de instalar manualmente un binario no persistente.
YouTube devuelve 403
Actualice yt-dlp, reintente más tarde y agregue cookies solo si es necesario. Verifique que el archivo corresponda al formato Netscape y no haya expirado.
La descarga permanece en espera
Verifique las tareas en curso, la concurrencia configurada, los registros y el espacio en disco. Reinicie el servicio de manera limpia si la cola no se reanuda.
Un video local no se reproduce
Confirme que el archivo existe en DOWNLOADS_DIR, que el contenedor puede leerlo y que el proxy transmite las solicitudes con rango de bytes. Intente directamente a través de 127.0.0.1 para aislar el proxy.
El escáner no encuentra nada
Está suspendido en modo local. Verifique también su activación, la frecuencia, las suscripciones y los registros del último análisis.
Conexión rechazada tras la restauración
Restaure también .session_secret, o vuelva a conectarse después de generar una nueva clave secreta. Si AUTH_PASSWORD proviene del entorno, su valor debe coincidir con la configuración actual.