Solución de la comunidad

Permitir que las aplicaciones de ZimaOS accedan a unidades externas: rutas del host, rutas del contenedor y asignación de almacenamiento actual

A November 2025 beginner tutorial showing how to identify a storage mount point and map it into an app with separate host and container paths. Community replies corrected the raw-mount approach, IceWhale clarified external media lives under /media by default, and the author later noted newer ZimaOS releases make the process easier.

Este tutorial para principiantes resolvió una fuente real de confusión: el nombre y la ruta que se muestran en Archivos de ZimaOS no son automáticamente la ruta que una aplicación ve dentro de su contenedor Docker. El autor original utilizó el terminal web para inspeccionar los puntos de montaje de los discos y después asignó la carpeta de almacenamiento del host a Immich o Syncthing con una ruta de contenedor más sencilla, como /SYNC.

Más adelante, el hilo recibió una corrección importante: las rutas de montaje sin formato no deben tratarse como la interfaz preferida a largo plazo para el almacenamiento de aplicaciones cuando ZimaOS puede proporcionar una ruta de almacenamiento gestionada. El ZimaOS actual lo hace mucho más fácil que el flujo de trabajo de 2025.

El tutorial original comenzó en el modo de desarrollador

Pantalla de configuración de ZimaOS con el modo de desarrollador y el terminal web visibles
El tutorial original utilizó el terminal web integrado para identificar dónde estaban montados los dispositivos de almacenamiento.

El usuario utilizó lsblk para inspeccionar los puntos de montaje

Terminal de ZimaOS mostrando la salida de lsblk con los puntos de montaje del almacenamiento resaltados
El campo importante era el punto de montaje, pero las respuestas posteriores advirtieron contra tratar cada ruta de montaje sin formato como un destino estable para el almacenamiento de aplicaciones.

Abre la configuración de la aplicación y añade un volumen

Menú de aplicaciones de ZimaOS con Configuración seleccionada
El panel de configuración de la aplicación es donde el almacenamiento del host se expone al contenedor.

Las columnas Host y Contenedor significan cosas diferentes

Configuración de volúmenes de la aplicación Syncthing, que muestra una ruta de almacenamiento del host de ZimaOS asignada a /SYNC dentro del contenedor
El lado izquierdo es la ruta real del host de ZimaOS; el lado derecho es la ruta que la aplicación ve dentro de su contenedor.

Si la ruta del contenedor es /SYNC, la aplicación debe usar /SYNC o una subcarpeta como /SYNC/Photos. No debe apuntar de nuevo a la ruta de montaje del host.

la configuración de carpetas de Syncthing usando /SYNC como ruta de carpeta interna
Una vez asignado el volumen, la aplicación funciona únicamente con la ruta del lado del contenedor.

Una respuesta de la comunidad advirtió contra las rutas /mnt sin formato

Otro participante señaló que las rutas de montaje sin formato pueden cambiar después de actualizar un disco, reconstruir un grupo u realizar otras operaciones de almacenamiento, y pueden eludir las suposiciones de la capa de almacenamiento de ZimaOS.

El usuario recomendó asignar almacenamiento estable gestionado por ZimaOS, como /DATA/Media o la ubicación de AppData prevista, en lugar de crear una aplicación alrededor de un identificador de montaje sin formato arbitrario.

IceWhale aclaró que los medios externos están en /media de forma predeterminada

Zima-Giorgio añadió que las rutas de los medios de almacenamiento externos se colocan en /media de forma predeterminada. Esa nota oficial ayuda a distinguir el almacenamiento externo de los ejemplos de datos internos de la aplicación en /DATA.

Las versiones actuales de ZimaOS hacen más explícito el modelo de rutas

En agosto de 2026, el autor original del tutorial explicó a un usuario posterior que las versiones más recientes de ZimaOS habían simplificado mucho este proceso.

La guía actual de IceWhale explica cómo se asignan el almacenamiento del host de ZimaOS y las rutas de los contenedores en la configuración de las aplicaciones. Empieza por ahí antes de crear manualmente rutas a partir de la información de montaje de bajo nivel.

Usa el selector de archivos o el almacenamiento administrado cuando esté disponible

Para las aplicaciones normales, el flujo de trabajo actual más seguro consiste en seleccionar una carpeta real en el espacio de almacenamiento de ZimaOS previsto desde la configuración de volúmenes de la aplicación, elegir o conservar la ruta del contenedor que espera la aplicación, guardar y, después, utilizar esa ruta del contenedor dentro de la aplicación.

No uses un nodo de dispositivo sin formato como carpeta de una aplicación

La captura de pantalla original incluye una ruta que comienza por /dev/... en una asignación de volúmenes experimental. Un nodo de dispositivo de bloques no es lo mismo que un directorio de sistema de archivos montado. Las aplicaciones normales, como Syncthing e Immich, deben recibir una carpeta montada, no un dispositivo de disco sin montar.

/DATA Es una ubicación de datos de ZimaOS, no un marcador de posición para todos los discos

Más tarde, un principiante preguntó si /DATA simplemente significa «iniciar todas las rutas aquí». No es así. /DATA es una ubicación de datos administrada por ZimaOS que se utiliza para las aplicaciones y los datos de usuario administrados por el sistema. El almacenamiento externo independiente puede aparecer en /media u otra ruta de almacenamiento administrada, según cómo la haya registrado ZimaOS.

La regla importante es seleccionar la carpeta real del host en el espacio de almacenamiento previsto y, después, asignarla a una ruta estable del contenedor.

Más tarde, el autor del tutorial dijo que las versiones más recientes de ZimaOS lo hacen más fácil

En agosto de 2026, el autor original regresó y explicó a otro principiante que las versiones más recientes de ZimaOS simplifican el proceso. Ese comentario posterior refuerza el límite histórico: utiliza las capturas de terminal de 2025 para comprender las rutas del host y del contenedor, no como requisito para descubrir manualmente cada punto de montaje actual.

Preguntas frecuentes sobre el acceso a unidades externas

¿Qué lado de un volumen de Docker corresponde a la ruta real del disco?

La del host.

¿Qué ruta debería usar internamente Immich, Syncthing u otra aplicación?

La ruta del contenedor configurada en la asignación de volúmenes.

¿Debería apuntarse cada aplicación directamente a /mnt o a un nodo de dispositivo?

No. Prefiere rutas de almacenamiento administradas y estables cuando ZimaOS las proporcione.

¿Dónde dijo IceWhale que se montan los medios externos de forma predeterminada?

Zima-Giorgio dijo que los medios de almacenamiento externos se encuentran en /media de forma predeterminada.