Solución de la comunidad

Obsidian en ZimaOS: Soluciona los problemas de montaje de bóvedas y HTTPS

A ZimaBlade user reverse-proxied the browser-based Obsidian app but could not see a mounted vault and later found Selkies opening without Obsidian itself.

Conclusión: si tu objetivo es un vault de Obsidian, no empieces ejecutando la interfaz de escritorio de Obsidian en un contenedor de navegador

La configuración de 2025 combinaba LinuxServer Obsidian, Selkies, un proxy inverso y un vault montado. Puede funcionar, pero introduce cuatro capas de posibles fallos antes de que siquiera edites una nota: seguridad del navegador, WebSocket/HTTPS, asignación de volúmenes del contenedor y el proceso de escritorio de Obsidian. En 2026, ZimaSpace ofrece OZSync para Obsidian específicamente para copias de seguridad, acceso desde la nube y sincronización entre dispositivos, una mejor opción inicial cuando el objetivo real es «mantener mi vault en ZimaOS».

OZSync para Obsidian aparece en el ecosistema de complementos de ZimaOS.

Elige la arquitectura antes de solucionar el contenedor

Hay tres modelos prácticos:

  • Sincronizar un vault local normal: Obsidian se ejecuta de forma nativa en tu Mac/PC; una capa de sincronización mantiene el vault en ZimaOS.
  • Abrir un vault mediante un sistema de archivos montado: la aplicación de escritorio apunta a un recurso compartido montado, con las habituales limitaciones de latencia y acceso sin conexión.
  • Ejecutar el propio Obsidian en un contenedor de navegador: LinuxServer/Selkies transmite la interfaz gráfica de forma remota. Es la opción más compleja.

Si elegiste el contenedor de navegador únicamente porque pensabas que era necesario para el almacenamiento de ZimaOS, simplifica primero.

Si mantienes el contenedor, verifica por separado las rutas del host y del contenedor

Cuando un vault «nunca aparece», inspecciona la asignación de volúmenes de Docker en lugar de la interfaz de Obsidian:

# ejemplo
/media/Notes/MyVault  ->  /vaults/MyVault

Obsidian dentro del contenedor solo puede ver la ruta de la derecha. ZimaOS Files muestra la ruta de la izquierda. Rutas de aplicaciones de ZimaOS explica este límite, mientras que montajes bind de Docker define el comportamiento en tiempo de ejecución.

Soluciona HTTPS antes de depurar Selkies

Los contenedores de escritorio transmitidos al navegador pueden depender de API seguras del navegador y de la conectividad WebSocket. Si la aplicación rechazaba originalmente el «acceso no seguro», usar un proxy inverso con HTTPS era una solución razonable. Sin embargo, prueba el endpoint del proxy antes de añadir el montaje del vault. Que la estructura básica de la página de Selkies funcione no demuestra que el proceso de Obsidian ni su ruta WebSocket estén funcionando correctamente.

Proxy HTTPS de ZimaOS explica el modelo de proxy inverso de ZimaOS.

Cuando Selkies se abre pero Obsidian no

Reiniciar el contenedor y ver la interfaz de transmisión sin la aplicación normalmente significa que el contenedor está activo, pero el proceso de escritorio falló. Comprueba los registros del contenedor, la versión de la imagen, los permisos de propietario de la configuración persistente y la memoria disponible. No elimines el vault mientras solucionas los problemas de la interfaz gráfica.

docker ps -a
docker logs --tail=200 YOUR_OBSIDIAN_CONTAINER
ls -ld /media/Notes/MyVault

LinuxServer publica actualmente Obsidian como un contenedor accesible desde la web, pero sus imágenes siguen dependiendo de una configuración persistente /config correcta y de los permisos adecuados para los volúmenes del host. Contenedor de Obsidian de LinuxServer es la fuente original.

Mantén el vault como archivos simples que puedas recuperar sin el contenedor

Un vault de Obsidian es, fundamentalmente, una carpeta de archivos Markdown junto con la configuración de .obsidian. Guarda esa carpeta en el almacenamiento de datos normal de ZimaOS y haz copias de seguridad independientes. Si el contenedor de transmisión falla, tus notas deberían seguir siendo legibles con cualquier editor de texto.

Copias de seguridad de ZimaOS y Requisitos de aplicaciones de ZimaOS abarcan la recuperación y la planificación de recursos.

Importa un vault existente sin reconstruirlo

Detén Obsidian, copia el vault completo —incluida la configuración oculta de .obsidian si quieres conservarla— en el directorio del host, confirma el propietario y, después, inicia el contenedor y abre la ruta asignada del contenedor. Evita copiar archivos mientras dos motores de sincronización independientes escriben en el vault, porque los archivos en conflicto y las notas eliminadas son más difíciles de desenredar que un simple problema de montaje.

Usa sincronización en lugar de un escritorio en el navegador cuando edites desde varios dispositivos

Para portátiles y teléfonos, un diseño orientado a la sincronización mantiene la experiencia de Obsidian local y fluida en cada dispositivo. También reduce la dependencia de una sesión de navegador remota y permite tomar notas sin conexión. Usa el enfoque del contenedor de navegador cuando quieras específicamente un acceso centralizado a la interfaz gráfica, no simplemente porque los datos estén en un NAS.

Preguntas frecuentes

¿Por qué no aparece mi vault de Obsidian montado?

La causa más común en el contenedor es una discrepancia entre las rutas del volumen. Verifica la ruta del host, la ruta del contenedor y los permisos antes de cambiar la configuración de Obsidian.

¿Obsidian necesita HTTPS en ZimaOS?

El Obsidian de escritorio nativo no necesita que la interfaz web de tu NAS sirva el editor. Un contenedor Selkies transmitido al navegador puede requerir HTTPS o un funcionamiento correcto de WebSocket seguro.

¿Debería guardar el vault en SMB?

Puede funcionar, pero un vault local junto con la sincronización suele ser más fácil de usar sin conexión y menos sensible a las interrupciones de red.

¿Puedo copiar directamente un vault Markdown existente?

Sí. Un vault es una carpeta de archivos. Copia el directorio completo, incluido .obsidian si quieres conservar los complementos y la configuración, y después indica esa ruta a la instancia de Obsidian elegida.

¿Cuál es ahora la configuración más sencilla de Obsidian en ZimaOS?

Si el objetivo es sincronizar el vault entre dispositivos, empieza evaluando la integración actual de OZSync en lugar de crear toda una infraestructura de escritorio en el navegador.