Solución de la comunidad

Configura LiveSync autoalojado de Obsidian en CasaOS: CouchDB, HTTPS y seguridad de sincronización

A March 2025 CasaOS post linking to an external Big Bear tutorial for Obsidian Self-hosted LiveSync. The forum body does not preserve the actual Compose configuration, so a durable page must keep the historical source while using current upstream LiveSync/CouchDB guidance.

La publicación original del foro es una introducción y un enlace a un tutorial externo, no un registro completo de la implementación. Promete una configuración rápida de CasaOS para Obsidian Self-hosted LiveSync, pero la publicación no conserva la imagen de CouchDB, las rutas de los volúmenes, las credenciales, la configuración de HTTPS ni la configuración de los clientes utilizadas en el video original.

Para una instalación actual, utiliza el proyecto mantenido de Self-hosted LiveSync como referencia técnica. La configuración original sigue centrándose en CouchDB y documenta explícitamente Docker, los datos y la configuración persistentes de CouchDB, la exposición mediante HTTPS y un URI de configuración para configurar los clientes de Obsidian.

Miniatura del tutorial de Big Bear para ejecutar Obsidian Self-hosted LiveSync en CasaOS
La publicación de la comunidad principalmente enlaza al tutorial externo de 2025, en lugar de almacenar la configuración de implementación en el propio foro.

Self-hosted LiveSync Es una Capa de Sincronización, No la Aplicación Obsidian

Obsidian sigue instalado en tus dispositivos de escritorio o móviles. Self-hosted LiveSync añade un complemento de sincronización de la comunidad y una base de datos en el servidor para que los cambios en las bóvedas se propaguen entre dispositivos sin depender del servicio de pago Obsidian Sync.

El proyecto original es software comunitario, no un servicio oficial de Obsidian.

CouchDB Es el Componente Principal del Servidor

La guía de configuración actual del proyecto original utiliza CouchDB como backend principal autoalojado. Su ejemplo de Docker crea directorios persistentes tanto para los datos como para la configuración de CouchDB antes de iniciar el contenedor.

Utiliza la configuración actual del servidor Self-hosted LiveSync en lugar de copiar etiquetas de imágenes antiguas de un video.

Guarda la Base de Datos de CouchDB Fuera del Contenedor Desechable

La base de datos contiene la representación sincronizada de tus notas y el estado relacionado. Asigna los directorios de datos y configuración de CouchDB a un almacenamiento persistente de CasaOS para que recrear el contenedor no borre el backend de sincronización.

Mantén esas carpetas separadas de las capas temporales normales de Docker.

Utiliza Credenciales Únicas para CouchDB

No conserves los nombres de usuario ni las contraseñas de ejemplo de un tutorial. Crea credenciales de administrador de CouchDB únicas y seguras, y no las incluyas en capturas de pantalla, archivos Compose compartidos ni publicaciones públicas en foros.

Si las credenciales quedan expuestas, cámbialas y revisa de inmediato cualquier instancia de CouchDB accesible de forma remota.

La Sincronización Remota Debe Usar HTTPS

Si varios dispositivos necesitan sincronizarse fuera de la LAN, expón CouchDB mediante una ruta HTTPS segura en lugar de publicar HTTP sin cifrar directamente en Internet. La documentación original incluye ejemplos de proxy inverso y configuración de dominios.

Una red VPN o superpuesta es otra opción cuando solo tus propios dispositivos necesitan acceso.

La Configuración de CORS y de Origen Debe Coincidir con el Flujo de Trabajo del Cliente

La configuración de seguridad de CouchDB puede bloquear solicitudes del navegador o de la vista web incluso cuando el servidor es accesible. El procedimiento de configuración de Self-hosted LiveSync configura el comportamiento requerido de CouchDB, en lugar de considerar terminada una instancia genérica de base de datos simplemente porque el puerto 5984 está abierto.

Utiliza el URI de Configuración con Cuidado

Las indicaciones actuales del proyecto original pueden generar un URI de configuración para que otro dispositivo con Obsidian importe los ajustes de conexión. Ese URI puede contener datos de conexión confidenciales.

Trátalo como un secreto: envíalo únicamente a tu propio dispositivo de confianza y evita publicarlo en capturas de pantalla o historiales de chat a los que otras personas puedan acceder.

La Sincronización en Tiempo Real No Elimina los Conflictos de Edición

Dos dispositivos que editan la misma nota casi al mismo tiempo aún pueden generar conflictos o requerir una reconciliación. El autoalojamiento te da control sobre el servidor, pero no convierte la edición distribuida en un sistema de archivos de un solo escritor.

Prueba el flujo de trabajo con una bóveda desechable antes de migrar tu única copia de notas importantes.

La Sincronización No Es una Copia de Seguridad

Si una nota se elimina y esa eliminación se sincroniza con todos los clientes, el sistema sincronizado ha cumplido su función. Conserva copias de seguridad independientes y versionadas de la bóveda de Obsidian y, cuando corresponda, de los datos de CouchDB.

Esto protege contra eliminaciones accidentales, errores del complemento, daños en la base de datos o una edición masiva equivocada.

La Fuente Es Específica de CasaOS

El tutorial histórico estaba dirigido a CasaOS. Si el equipo anfitrión ahora utiliza ZimaOS, emplea el flujo de trabajo actual de la App Store/Compose de ZimaOS y las rutas de almacenamiento actuales, en lugar de suponer que se mantiene la misma disposición de paquetes de CasaOS.

Preguntas Frecuentes sobre Obsidian LiveSync

¿La publicación original del foro contiene la configuración completa de Compose?

No. Principalmente enlaza al tutorial externo de Big Bear.

¿Qué backend documenta la versión actual de Self-hosted LiveSync?

La configuración original actual utiliza CouchDB y proporciona una ruta de implementación con Docker.

¿La sincronización autoalojada sustituye a las copias de seguridad?

No. Conserva una copia de seguridad independiente de la bóveda, porque las eliminaciones y las ediciones incorrectas también pueden sincronizarse.