Tutoriales de VPS
Obsidian LiveSync en VPS: CouchDB, cifrado y backups (2026)
Configura LiveSync con CouchDB, CORS, HTTPS, cifrado, varios dispositivos, conflictos y backups. Corrige la estimación original de $120/año para dos bibliotecas con las condiciones reales del plan.

Self-hosted LiveSync conecta dispositivos Obsidian mediante CouchDB y permite elegir dónde alojar notas y servidor. También te responsabiliza de credenciales, certificados, actualizaciones, conflictos y recuperación. Elige esta opción por control y necesidades concretas, sin asumir ahorro automático.
El original trataba Sync oficial como cobro universal por biblioteca y prometía historial ilimitado. La documentación oficial, consultada el 2026-11-16, indica Standard: 1 biblioteca, 1 GB, archivos de 5 MB e historial de 1 mes; Plus: 10 bibliotecas, 10–100 GB según almacenamiento comprado, archivos de 200 MB e historial de 12 meses. La cuota se comparte en la cuenta. Comprueba precio y derechos actuales en lugar de multiplicar una tarifa por cada biblioteca.
| Método | Coste | Sincronización | Cifrado/historial | Móvil y mantenimiento |
|---|---|---|---|---|
| Sync oficial | Suscripción | Servicio gestionado | E2EE y retención del plan | Móvil nativo; servidor gestionado |
| LiveSync | Plugin, VPS y tiempo | Incremental casi en tiempo real | E2EE opcional; retención del plugin/base | Escritorio/móvil; mantienes CouchDB |
| Remotely Save | Plugin y almacenamiento | Programada/manual | Revisa cifrado y versiones configurados | Compatibilidad según backend |
| Syncthing | Software e infraestructura | Sincronización de archivos | Cifra transporte; contenido remoto requiere medidas propias; versiones opcionales | Sin cliente oficial iOS |
| Plugin Git | Repositorio y herramientas | Commit/pull/push | Historial Git; cifrado aparte | Conflictos y flujo móvil requieren atención |
Remotely Save no replica continuamente como LiveSync; pueden aparecer conflictos entre ejecuciones. Revisa cifrado y retención del plugin, sin atribuirlos solo al almacenamiento. Syncthing sirve para dispositivos compatibles, con una decisión separada sobre iOS. Todos necesitan backups.
LiveSync puede interesar si:
- Tienes varias bibliotecas o colecciones grandes.
- Los adjuntos superan la cuota práctica de un plan.
- Quieres elegir ubicación y administración.
- Ya mantienes un VPS con recursos libres.
Para una biblioteca pequeña de texto, el servicio gestionado puede compensar por su menor mantenimiento.
| Configuración inicial | Evaluación |
|---|---|
| 1 vCPU/512 MB | Ajustada; sincronización simultánea puede agotar RAM |
| 1 vCPU/1 GB | Posible para uso personal pequeño; mide |
| 1 vCPU/2 GB | Mayor margen inicial |
| 2 vCPU/2 GB+ | Más dispositivos, adjuntos o servicios compartidos |
Los 200–300 MB en reposo del original son una estimación. Reserva inicialmente unas 3–5 veces el tamaño de la biblioteca y vigila revisiones, fragmentos, logs y espacio de compactación. Una biblioteca de 200 MB que llega a 1 GB es un ejemplo, no una tasa garantizada. Considera 20 GB de disco o más según carga.
Mide latencia desde tus dispositivos; idioma no determina ubicación. Opciones económicas usan $3/mes como umbral comparativo, sin garantizar inventario o rendimiento. Considera jurisdicción y acceso incluso con E2EE: metadatos y patrones de tráfico pueden seguir visibles.
mkdir -p ~/obsidian-sync/{data,local.d}
cd ~/obsidian-sync
Crea docker-compose.yml, reemplazando contraseña por una aleatoria privada y seleccionando una imagen mantenida y revisada:
services:
couchdb:
image: couchdb:3.4
container_name: obsidian-couchdb
restart: unless-stopped
user: "5984:5984"
environment:
- COUCHDB_USER=admin
- COUCHDB_PASSWORD=换成一个长随机密码
volumes:
- ./data:/opt/couchdb/data
- ./local.d:/opt/couchdb/etc/local.d
ports:
- "127.0.0.1:5984:5984"
user: "5984:5984" alinea usuario con archivos. Comprueba UID 5984 en la imagen elegida y propietario de data y configuración:
sudo chown -R 5984:5984 data local.d
Restringe permisos de archivos con secretos. Enlaza a 127.0.0.1 y publica mediante proxy, sin exponer directamente 5984. Comprueba red y puertos Docker, sin confiar únicamente en UFW.
Usa local.d/livesync.ini dentro de local.d/, evitando cambios efímeros en local.ini:
[couchdb]
single_node = true
max_document_size = 50000000
[chttpd]
require_valid_user = true
max_http_request_size = 4294967296
enable_cors = true
[chttpd_auth]
require_valid_user = true
authentication_redirect = /_utils/session.html
[httpd]
WWW-Authenticate = Basic realm="couchdb"
bind_address = 0.0.0.0
enable_cors = true
[cors]
origins = app://obsidian.md, capacitor://localhost, http://localhost
credentials = true
headers = accept, authorization, content-type, origin, referer
methods = GET,PUT,POST,HEAD,DELETE
max_age = 3600
single_node = trueselecciona nodo único.enable_cors = truey[cors]permiten solicitudes desde el origen web necesario.originsincluyeapp://obsidian.mdycapacitor://localhost; limita a los clientes realmente usados.max_http_request_sizepermite peticiones HTTP de hasta 4 GB en el ejemplo. No es requisito universal ni límite de documentos de 4 GB: max_document_size está separado en 50,000,000 bytes. Ajusta a fragmentación del plugin, memoria y límites del proxy.require_valid_user = trueexige autenticación. Configura además miembros/seguridad de cada base para limitar privilegios.
docker compose up -d
docker compose logs -f
Revisa logs y entra en Fauxton mediante túnel SSH en http://127.0.0.1:5984/_utils/. Usa administrador para instalación y evalúa usuario exclusivo de la base para uso diario tras las comprobaciones del plugin.
Usa certificado válido y confiable en escritorio y móvil; evita certificados no confiables y desactivar validación. Con DNS correcto y desafíos accesibles, Caddy proporciona HTTPS:
couchdb.example.com {
encode gzip
reverse_proxy 127.0.0.1:5984
}
Comprueba Host y X-Forwarded-*, especialmente tras otro proxy. Deja CORS a CouchDB, sin duplicarlo. En Nginx configura proxy_pass y desactiva proxy_buffering cuando la replicación continua necesita streaming; revisa timeouts y tamaños. Consulta Caddy.
Instala Self-hosted LiveSync del catálogo comunitario, revisando confianza y versión compatible. Sigue el asistente, cuya redacción puede variar:
| Campo | Valor |
|---|---|
| URI | https://couchdb.example.com, sin puerto público 5984 |
| Usuario/contraseña | Cuenta CouchDB autorizada |
| Base | Nombre separado para la biblioteca, como obsidian-vault |
Ejecuta Test database connection y Check and fix si el plugin necesita permisos de instalación. Revisa seguridad después.
Copia la biblioteca completa a un backup independiente antes de decidir dirección.
- Servidor nuevo realmente vacío: cárgalo desde la copia local completa prevista.
- Servidor existente y autoritativo: llena un dispositivo nuevo vacío desde él.
No sobrescribas dispositivos con cambios pendientes. Lee cada advertencia y prueba con notas desechables: una dirección incorrecta puede propagar datos vacíos o antiguos.
Con E2EE correctamente configurado, el cliente cifra los datos compatibles antes de subirlos. Path Obfuscation reduce exposición de nombres. No protege un cliente comprometido ni elimina todos los metadatos.
Guarda la passphrase: perderla puede inutilizar el contenido cifrado del servidor. La frase del cifrado de datos y la del Setup URI protegen elementos distintos. Conserva ambas con un gestor de contraseñas y un proceso de recuperación adecuado.
El Setup URI que comienza por obsidian://setuplivesync?settings= contiene configuración sensible. En el dispositivo preparado:
Self-hosted LiveSync: Copy settings as a new Setup URI
Usa una passphrase de protección separada. En el nuevo dispositivo selecciona I am adding a device to an existing synchronisation setup e importa URI/frase en privado. Trátalos como credenciales: no los publiques ni envíes juntos por un canal expuesto.
Una biblioteca nueva vacía puede descargar del servidor. Si existe copia local, respáldala y reconcilia cambios antes de aprobar sobrescrituras.
Dos ediciones sin conexión de la misma nota pueden chocar. El plugin puede combinar cambios compatibles; revisa las alternativas pendientes en su interfaz. Prueba recuperación en tu versión, sin asumir revisiones recuperables para siempre.
Las revisiones CouchDB sirven para replicación y concurrencia, no garantizan un archivo histórico ilimitado. Compactación y política del plugin pueden eliminar cuerpos antiguos. La sincronización también propaga borrados; el historial no sustituye una copia independiente.
Mantén exportaciones independientes de la biblioteca y sigue backup. En un nodo pequeño, detener y archivar evita copiar una base cambiante:
cd ~/obsidian-sync
docker compose stop couchdb
sudo tar czf ~/couchdb-backup-$(date +%F).tar.gz data local.d
docker compose start couchdb
Guarda Compose y secretos en privado además de data/local.d, envía el archivo fuera del VPS y prueba restauración aislada. Comprueba éxito de tar y asegúrate de reiniciar el servicio aunque falle el backup. Replicación hacia otro CouchDB puede mantenerse en línea, pero también copia borrados indeseados; conserva snapshots históricos independientes.
Failed to fetch/CORS: revisa [cors], origins y app://obsidian.md, credenciales y TLS. Evita CORS duplicado en proxy.
Conecta sin avanzar: comprueba proxy_buffering off en Nginx, timeouts de solicitudes continuas y límites proxy/CDN. Cloudflare puede cortar peticiones largas según el plan.
Escritorio funciona, móvil no: comprueba cadena/confianza, caducidad y DNS mediante curl -v https://couchdb.example.com; restricciones móviles pueden diferir.
Base crece: vigila disco y espacio temporal antes de compactar:
curl -u admin:密码 -X POST https://couchdb.example.com/obsidian-vault/_compact \
-H "Content-Type: application/json"
Auto Compaction del plugin, si existe, necesita retención deliberada. Puede eliminar cuerpos de revisiones; no implica historial permanente. Limpia adjuntos mediante procedimientos compatibles.
Cambio de dominio/certificado: actualiza URI y prueba después de reiniciar cliente.
Passphrase perdida: recupera una copia legible de otro dispositivo o backup y crea una configuración nueva. El servidor no puede descifrarla por ti.
El original usaba $5/mes para VPS, $30–50/año para 1 vCPU/2 GB, $5–10/mes para Sync y $48–96/año con pago anual. Su cálculo de $120–240/año para dos bibliotecas suponía cobro por biblioteca y no compara correctamente con Plus documentado. Son ejemplos históricos, no ofertas vigentes.
Incluye alojamiento, backup, tráfico y mantenimiento. Recursos VPS libres reducen coste adicional, pero comprar uno solo para una biblioteca puede ahorrar poco. Ubicación y control operativo son razones más sólidas.