Solución de problemas
Resuelva los fallos más frecuentes de VidArch.
El puerto 2508 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.
SQLite es de solo lectura o no se pueden escribir descargas
El contenedor publicado se ejecuta con UID/GID 1000:1000. Concede a esta identidad acceso de lectura y escritura a los dos directorios del host montados en /app/data y /app/downloads, y vuelve a crear el contenedor. SQLite necesita escribir en el directorio además de acceder al archivo de base de datos, ya que crea archivos -wal y -shm. Sigue los comandos de propietario o ACL de Almacenamiento; no uses chmod 777.
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.