Solución de la comunidad

Descarga torrents de qBittorrent directamente en una unidad USB externa en ZimaOS: corrige el volumen y la ruta de guardado

A March 2026 thread where qBittorrent on a 128 GB ZimaOS mini PC errored when the user tried to save torrents to a 14 TB external USB drive. A community reply correctly focused on adding the external folder as a Docker volume. The user posted volume and qBittorrent settings, but the thread ends before a confirmed final fix.

qBittorrent no puede escribir en una unidad externa de ZimaOS solo porque la unidad aparezca en Archivos. El contenedor de qBittorrent debe recibir primero esa carpeta del host como volumen Docker, y después qBittorrent debe usar la ruta del contenedor, no la ruta física del host de ZimaOS, como ubicación de guardado.

El hilo original apunta en la dirección correcta, pero no muestra una solución final confirmada por el usuario. Las capturas son útiles porque revelan la arquitectura prevista: carpetas externas del host asignadas a rutas sencillas, como /Torrents y /Active Torrents.

Configuración de volúmenes Docker de ZimaOS que muestra la carpeta Downloads de una unidad externa asignada a un contenedor de descarga
El patrón clave es: la ruta del host a la izquierda y una ruta sencilla del contenedor a la derecha.

Una asignación de volumen Docker tiene dos lados

Por ejemplo:

/media/Expansion/Torrents  →  /Torrents

ZimaOS utiliza la ruta de la izquierda. qBittorrent utiliza la ruta de la derecha. Por tanto, dentro de qBittorrent, la ruta de guardado predeterminada debe ser /Torrents, no /media/Expansion/Torrents.

El usuario de origen asignó carpetas de torrents a qBittorrent

Configuración de descargas de qBittorrent que muestra la ruta de guardado predeterminada /Torrents y la ruta de torrents incompletos /Active Torrents
La configuración de qBittorrent utiliza rutas del contenedor, que deben coincidir exactamente con las rutas creadas por las asignaciones de volúmenes de ZimaOS.
Configuración de descargas de qBittorrent con rutas de contenedor para torrents completos e incompletos
Las rutas para descargas completas e incompletas pueden ser diferentes, pero ambas necesitan almacenamiento asignado con permisos de escritura.

La asignación de volúmenes de ZimaOS debe coincidir con esas rutas del contenedor

La configuración de la ruta de descarga de qBittorrent requiere asignaciones de volumen Docker correspondientes en ZimaOS
Si falta el volumen o está asignado a una ruta de contenedor diferente, qBittorrent puede mostrar el torrent como «Error».

La documentación actual de ZimaOS utiliza el mismo modelo de host frente a contenedor

La documentación actual de Docker de IceWhale explica explícitamente que una aplicación debe usar la ruta montada dentro de su contenedor, mientras que el lado de ZimaOS apunta a la carpeta de almacenamiento real.

Usa el modelo actual de volúmenes Docker de ZimaOS.

Si la ruta existe, pero los torrents siguen mostrando errores, comprueba los permisos de escritura

Desde el contenedor o terminal de qBittorrent, verifica que el directorio asignado exista y pueda crear un archivo temporal. Una ruta válida sin permisos de escritura produce un error diferente al de un volumen inexistente.

Evita resolver todos los problemas de permisos con una configuración permanente 0777 o root. Cuando sea posible, haz coincidir la identidad/grupo del contenedor con la carpeta de destino.

Comprueba el sistema de archivos de la unidad externa

La versión actual de ZimaOS es compatible con sistemas de archivos USB comunes, incluidos NTFS, exFAT, ext4 y Btrfs. La semántica del sistema de archivos puede afectar a la propiedad y los permisos, especialmente en NTFS/exFAT.

Los torrents incompletos y completados pueden usar la misma unidad externa

Si activas «Mantener los torrents incompletos en», asigna también esa ruta. De lo contrario, qBittorrent podría intentar escribir los datos incompletos en una ruta interna no asignada, aunque la ruta de descargas completadas sea correcta.

Mantén las cargas grandes de torrents fuera de la unidad del sistema de 128 GB

El caso de uso de la fuente es precisamente donde el almacenamiento externo tiene sentido. Mantén pequeña y persistente la configuración/AppData de qBittorrent, y coloca las cargas de varios terabytes en el dispositivo de almacenamiento externo.

Prueba la ruta desde dentro del contenedor de qBittorrent

Una forma rápida de separar los problemas de rutas de los de permisos es abrir el terminal de la aplicación e inspeccionar la carpeta dentro del contenedor. Si /Torrents no existe, la asignación del volumen de Docker es incorrecta. Si existe, pero no se puede crear un archivo de prueba pequeño, la asignación funciona y el siguiente nivel que se debe revisar son los permisos y el comportamiento del sistema de archivos.

Asegúrate de que la unidad externa esté montada antes de que qBittorrent empiece a escribir

Si un disco USB externo está desconectado o no se monta, una ruta del host obsoleta puede hacer que la aplicación escriba en un directorio local no previsto. Después de reiniciar o volver a conectar la unidad, verifica que esté presente en Almacenamiento/Archivos de ZimaOS antes de iniciar descargas grandes.

Las rutas de las categorías también deben permanecer dentro del almacenamiento asignado al contenedor

Las categorías de qBittorrent pueden sustituir la ruta de guardado predeterminada. Por lo tanto, un torrent puede dar error incluso cuando /Torrents es correcto si su categoría apunta a otra ruta no asignada. Revisa las ubicaciones de guardado específicas de cada categoría cuando solo fallen algunos torrents.

Los torrents existentes pueden conservar su ruta de guardado anterior

Cambiar la ruta de guardado predeterminada global no siempre reescribe la ubicación de cada torrent existente. En el caso de los torrents ya añadidos, comprueba su ruta de guardado actual y utiliza el comportamiento administrado de qBittorrent para «establecer la ubicación» o reubicar, en lugar de mover los archivos parciales a sus espaldas.

Preguntas frecuentes sobre unidades externas de qBittorrent

¿Debería qBittorrent usar la ruta completa del host de ZimaOS como ruta de guardado?

Normalmente, no. Debe usar la ruta del contenedor creada por la asignación del volumen de Docker.

¿La fuente contiene una solución final confirmada?

No. El hilo termina después de que el usuario publica su configuración.

¿Qué se debe comprobar después de la ruta del volumen?

Verifica que el directorio asignado exista dentro del contenedor y que la identidad de ejecución de qBittorrent pueda escribir en él.