El objetivo original de este hilo de noviembre de 2025 era sencillo: mantener ZimaOS y las aplicaciones en el SSD interno de 512 GB del mini PC, mientras utilizaba un disco duro USB externo Seagate de 5 TB para medios y descargas. La dificultad surgió al tratar el disco externo como un montaje genérico de servidor Linux antes de entender cómo ZimaOS ya gestiona el almacenamiento.
El usuario experimentó con el montaje manual en /var; posteriormente, el servidor se bloqueó y reinstaló ZimaOS. Después montó el disco en una ruta de datos de ZimaOS y lo asignó a SABnzbd, pero la aplicación siguió devolviendo un error de permisos. Por tanto, este hilo contiene dos lecciones independientes: primero, elige una ruta de host segura y gestionada; después, resuelve por separado los permisos del contenedor.
No uses /var como punto de montaje USB arbitrario
ZimaOS es un sistema operativo de estilo appliance con rutas del sistema gestionadas. El usuario de origen dijo que montó la unidad externa en /var al principio parecía funcionar, pero después se produjo un bloqueo completo del servidor y fue necesario reinstalarlo.
El hilo no demuestra que el montaje en sí provocara directamente el bloqueo, pero es motivo suficiente para no promover directorios del sistema como ubicaciones de almacenamiento normales para discos de medios.
Deja que ZimaOS gestione la unidad externa
La versión actual de ZimaOS ofrece una compatibilidad con el almacenamiento USB mucho más amplia que el entorno de 2025 de este hilo. Puedes añadir un disco USB desde Ajustes > Almacenamiento y usarlo como almacenamiento normal, en lugar de conectarlo manualmente a un punto de montaje de Linux inventado.
Para una implementación nueva, comienza con el flujo de trabajo actual de ZimaOS para añadir almacenamiento USB. Una vez gestionado el disco, utiliza su carpeta de almacenamiento real en la asignación de volúmenes de la aplicación.
El disco de origen finalmente apareció en las rutas gestionadas por ZimaOS
La ruta exacta que aparece en una instalación de 2025 no debe copiarse en otro servidor. Los nombres de dispositivos, como sda, sdb, y sdc puede cambiar según el orden de arranque y el hardware conectado.
Asigna una carpeta, no el dispositivo de bloques sin formato
Las aplicaciones de Docker normalmente deberían recibir un directorio, como una carpeta de descargas o multimedia, no el dispositivo sin formato /dev/sda1. ZimaOS monta el sistema de archivos; el contenedor recibe una carpeta del host de ese sistema de archivos montado.
La explicación actual de cómo el almacenamiento del host se convierte en un volumen del contenedor ayuda a evitar confundir el dispositivo de disco, el punto de montaje y la ruta del contenedor.
Un montaje correcto aún puede producir un error de permisos
El usuario de origen llegó a /DATA/HDD1 y la asignó a SABnzbd, pero la aplicación no pudo usar el directorio de descargas seleccionado. Eso significa que la visibilidad del almacenamiento ya no era el único problema.
Los procesos de Docker se ejecutan como un usuario o grupo dentro del contenedor. Si la carpeta del host pertenece a otro usuario y tiene permisos restrictivos, el contenedor puede ver la ruta, pero aun así no podrá crear archivos.
No copies PUID 999 a ciegas
Una respuesta de la comunidad indicó al usuario que cambiara PUID de 1000 a 999. Eso pudo coincidir con el modelo de cuentas de ZimaOS del autor de la respuesta, pero no es una constante universal.
Antes de cambiar PUID o PGID, identifica el propietario de la carpeta real del host y el usuario con el que se espera que se ejecute la aplicación. Un valor numérico que funciona en una instalación puede apuntar a una cuenta diferente en otra.
El chmod y chown recursivos son potentes y destructivos
Una respuesta posterior de la comunidad sugirió usar chmod 775 y chown en la ruta de descargas. Esos comandos pueden ser herramientas útiles de administración de Linux, pero modifican todos los archivos y directorios dentro del destino. El personal de IceWhale no los publicó en este hilo.
Antes de cambiar la propiedad de forma recursiva:
- confirmar la ruta de destino exacta;
- confirmar que el sistema de archivos admite la propiedad normal de Linux;
- entender qué usuarios o servicios ya dependen de la carpeta;
- haz una copia de seguridad de los metadatos o permisos importantes si varios aplicaciones comparten la carpeta.
El tipo de sistema de archivos puede cambiar el modelo de permisos
Un disco ext4 almacena directamente los identificadores UID, GID y los bits de modo de Linux. exFAT y algunas configuraciones de NTFS pueden presentar la propiedad mediante opciones de montaje. Si los cambios de PUID no surten efecto, comprueba el sistema de archivos antes de cambiar repetidamente la configuración de la aplicación.
Una distribución más limpia para las aplicaciones multimedia
Un diseño práctico es:
- SSD interno: sistema ZimaOS y tiempo de ejecución de aplicaciones pequeñas;
- disco duro externo grande: contenido multimedia, descargas, copias de seguridad y otros datos voluminosos;
- AppData persistente: ubicado en una ubicación de almacenamiento con suficiente capacidad y cobertura de copias de seguridad;
- cada aplicación: asignaciones de volúmenes explícitas únicamente a las carpetas que necesita.
Esto evita que una descarga de contenido multimedia llene la unidad del sistema y facilita hacer copias de seguridad de la configuración de la aplicación por separado de los archivos multimedia grandes.
Preguntas frecuentes sobre discos duros externos en ZimaOS
¿Debería montar manualmente un disco duro externo en /var?
No para el uso normal actual de ZimaOS. Usa la interfaz de almacenamiento y las rutas de almacenamiento administradas.
¿Debería SABnzbd asignar /dev/sda1 directamente?
No. Asigna un directorio normal del host del sistema de archivos montado a la ruta de descargas esperada por el contenedor.
¿Por qué la aplicación ve la carpeta, pero no puede escribir en ella?
Los permisos o la propiedad del sistema de archivos del host, o el PUID/PGID del contenedor, podrían no permitir la escritura.
¿Es PUID 999 un valor estándar de ZimaOS?
No. Era una sugerencia específica de la comunidad y debería verificarse en el sistema real.
