Solución de la comunidad

Permiso denegado en qBittorrent en un SSD Btrfs externo: asigna la ruta, verifica el UID/GID y evita usar root

An October 2025 thread where qBittorrent mapped /media/SSD-1TBStorage/Downloads to /downloads but could not create /downloads/incomplete. The user tried UID/GID 1000, chown 1000:1000, and chmod 775. The only reply claimed the ZimaOS admin UID was different and suggested root as a test, but the original poster never confirmed a final fix.

La fuente demuestra claramente una cosa: qBittorrent podía acceder a la carpeta Btrfs externa asignada, pero el proceso no podía crear su subdirectorio incomplete. El error fue Permiso denegado, no «ruta no encontrada». Por eso, la identidad y los permisos del sistema de archivos son la capa de diagnóstico más importante.

El hilo no demuestra cuál fue la solución permanente. La única respuesta indicó que el UID 1000 no existía en ese sistema ZimaOS y sugirió probar el contenedor como root. El autor original nunca volvió para confirmar un resultado satisfactorio. Por lo tanto, ejecutar qBittorrent como root debe considerarse únicamente un diagnóstico puntual, no una configuración final recomendada.

La asignación de volúmenes era explícita

La fuente asignaba:

/media/SSD-1TBStorage/Downloads  →  /downloads

Dentro de qBittorrent, la aplicación intentaba crear:

/downloads/incomplete/...

Como el error era de permiso denegado, es probable que la asignación existiera y que el contenedor pudiera acceder al sistema de archivos del host.

La carpeta del host tenía permisos de escritura para el grupo

El usuario mostró:

drwxrwxr-x 1 1000 samba /media/SSD-1TBStorage/Downloads

y afirmó que el contenedor se ejecutaba con el UID/GID 1000. También probó chown -R 1000:1000 y chmod -R 775.

El hecho de que el error persistiera significa que una de esas suposiciones —la identidad real en tiempo de ejecución, el acceso a los directorios principales, el comportamiento del montaje o los permisos efectivos— era incompleta.

No establezcas de forma rígida un UID de ZimaOS basándote en una respuesta de un foro

El miembro de la comunidad afirmó que el primer usuario de ZimaOS usaba el UID 999 en lugar del 1000. Aunque eso fuera correcto para una compilación concreta, los ID de usuario pueden variar según la plataforma y la versión, y el contenedor de qBittorrent podría utilizar una identidad PUID/PGID independiente.

Inspecciona la configuración actual real del contenedor y la identidad del proceso en lugar de adivinar.

Ejecutar como root puede confirmar que el problema está relacionado con los permisos, pero no debería ser permanente

Si un contenedor solo funciona cuando se ejecuta con el UID 0, eso indica firmemente que la ruta asignada deniega el acceso a la identidad normal de la aplicación. No significa que qBittorrent deba seguir ejecutándose como root indefinidamente.

Un descargador expuesto a entradas web o de red solo debería tener los privilegios del sistema de archivos que necesita.

Comprueba todos los directorios principales de la ruta del host

Tener acceso de escritura al directorio final Downloads no es suficiente si la identidad del contenedor no puede atravesar alguno de los directorios principales. Inspecciona la ruta completa y cualquier ACL, no solo los bits de permisos del último directorio.

Btrfs estaba presente, pero la fuente no demostró que Btrfs causara el fallo

La SSD usaba Btrfs, pero los permisos y la propiedad habituales de Unix siguen aplicándose. Nada en el hilo demuestra que el error se debiera a un error específico de Btrfs, a una política de subvolúmenes o a un montaje de solo lectura.

Comprueba el estado del sistema de archivos montado antes de culpar al tipo de sistema de archivos.

Las versiones actuales de ZimaOS muestran explícitamente las asignaciones de volúmenes de las aplicaciones

La documentación actual de IceWhale explica las rutas del host y del contenedor, y permite editar las asignaciones de almacenamiento de las aplicaciones desde la configuración de la aplicación.

Consulta el modelo de rutas Docker actual de ZimaOS antes de modificar la propiedad.

Usa una carpeta de descargas exclusiva para qBittorrent

Concede a qBittorrent acceso de escritura a una carpeta de descargas o preparación creada específicamente para ese fin, en lugar de a todo un volumen multimedia o de copias de seguridad. Después, Sonarr/Radarr podrán importar o mover los archivos completados con sus propios permisos controlados.

Flujo de trabajo más seguro para establecer permisos permanentes

  1. Confirma la asignación exacta del host al contenedor.
  2. Inspecciona el UID/GID/PUID/PGID real del contenedor de qBittorrent.
  3. Inspecciona los permisos de la carpeta del host y de sus directorios principales.
  4. Crea un pequeño directorio de prueba exclusivo.
  5. Concede únicamente el acceso de escritura necesario al usuario o grupo.
  6. Reinicia la aplicación y prueba una descarga legal pequeña.

Preguntas frecuentes sobre los permisos de qBittorrent en Btrfs

¿Se confirmó la solución final de la fuente?

No. El hilo termina después de una respuesta de la comunidad.

¿Permiso denegado demuestra que falta la asignación del volumen Docker?

No. Normalmente significa que se puede acceder a la ruta, pero el proceso no puede realizar la operación de escritura solicitada.

¿qBittorrent debería ejecutarse permanentemente como root?

No. Root puede servir como prueba de diagnóstico, pero la solución permanente debería utilizar el menor privilegio del sistema de archivos necesario.