Soluzione della community

Configura Obsidian Self-hosted LiveSync su CasaOS: CouchDB, HTTPS e sicurezza della sincronizzazione

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.

Il post originale sul forum è un’introduzione con un link a un tutorial esterno, non un resoconto completo della distribuzione. Promette una configurazione rapida di CasaOS per Obsidian Self-hosted LiveSync, ma il post non conserva l’immagine CouchDB, i percorsi dei volumi, le credenziali, la configurazione HTTPS o la configurazione dei client utilizzate nel video originale.

Per un’installazione attuale, usa il progetto Self-hosted LiveSync mantenuto come riferimento tecnico. La configurazione upstream è ancora incentrata su CouchDB e documenta esplicitamente Docker, la persistenza dei dati e della configurazione di CouchDB, l’esposizione HTTPS e un URI di configurazione per configurare i client Obsidian.

Miniatura del tutorial di Big Bear per eseguire Obsidian Self-hosted LiveSync su CasaOS
Il post della community rimanda principalmente a questo tutorial esterno del 2025, invece di memorizzare la configurazione della distribuzione direttamente nel forum.

Self-hosted LiveSync è un livello di sincronizzazione, non l’app Obsidian

Obsidian resta installato sui tuoi dispositivi desktop o mobili. Self-hosted LiveSync aggiunge un plugin di sincronizzazione della community e un database lato server, così le modifiche ai vault possono essere trasferite tra i dispositivi senza affidarsi al servizio Sync a pagamento di Obsidian.

Il progetto upstream è un software della community, non un servizio ufficiale di Obsidian.

CouchDB è il componente principale del server

L’attuale guida di configurazione upstream usa CouchDB come backend self-hosted principale. L’esempio Docker crea directory persistenti sia per i dati sia per la configurazione di CouchDB prima di avviare il container.

Usa la configurazione attuale del server Self-hosted LiveSync invece di copiare i vecchi tag delle immagini da un video.

Conserva il database CouchDB al di fuori del container temporaneo

Il database contiene la rappresentazione sincronizzata delle tue note e dello stato correlato. Mappa le directory dei dati e della configurazione di CouchDB su uno spazio di archiviazione persistente di CasaOS, così la ricreazione del container non cancellerà il backend di sincronizzazione.

Mantieni queste cartelle separate dai normali livelli Docker temporanei.

Usa credenziali CouchDB uniche

Non mantenere i nomi utente o le password di esempio di un tutorial. Crea credenziali amministrative CouchDB robuste e uniche e non inserirle in screenshot, file Compose condivisi o post pubblici sul forum.

Se le credenziali vengono esposte, cambiale e controlla immediatamente qualsiasi istanza CouchDB raggiungibile da remoto.

La sincronizzazione remota dovrebbe usare HTTPS

Se più dispositivi devono sincronizzarsi al di fuori della LAN, esponi CouchDB tramite un percorso HTTPS sicuro invece di pubblicare direttamente su Internet il semplice HTTP. La documentazione upstream include esempi di proxy inverso e configurazione del dominio.

Una rete VPN o overlay è un’altra opzione quando devono accedere soltanto i tuoi dispositivi.

Le impostazioni CORS e Origin devono corrispondere al flusso di lavoro del client

La configurazione di sicurezza di CouchDB può bloccare le richieste del browser o della webview anche quando il server è raggiungibile. La procedura di configurazione di Self-hosted LiveSync imposta il comportamento CouchDB richiesto, invece di considerare completo un generico container del database non appena la porta 5984 è aperta.

Usa con attenzione l’URI di configurazione

Le indicazioni upstream attuali possono generare un URI di configurazione, così un altro dispositivo Obsidian può importare le impostazioni di connessione. Questo URI può contenere dettagli sensibili sulla connessione.

Trattalo come un segreto: invialo solo al tuo dispositivo fidato ed evita di pubblicarlo in screenshot o nella cronologia delle chat a cui altre persone possono accedere.

La sincronizzazione in tempo reale non elimina i conflitti di modifica

Due dispositivi che modificano la stessa nota quasi contemporaneamente possono comunque creare conflitti o richiedere una riconciliazione. Il self-hosting ti dà il controllo sul server, ma non trasforma la modifica distribuita in un filesystem a scrittura singola.

Prova il flusso di lavoro con un vault usa e getta prima di migrare l’unica copia delle note importanti.

La sincronizzazione non è un backup

Se una nota viene eliminata e l’eliminazione viene sincronizzata su ogni client, il sistema sincronizzato ha svolto il proprio compito. Conserva backup indipendenti e versionati del vault Obsidian e, quando opportuno, dei dati CouchDB.

Questo protegge da eliminazioni accidentali, bug dei plugin, corruzione del database o modifiche di massa errate.

La fonte è specifica per CasaOS

Il tutorial storico era rivolto a CasaOS. Se l’host ora è ZimaOS, usa il flusso di lavoro attuale dell’App Store/Compose di ZimaOS e i percorsi di archiviazione attuali, invece di presumere che sia ancora valido lo stesso layout dei pacchetti CasaOS.

Domande frequenti su Obsidian LiveSync

Il post originale sul forum contiene la configurazione Compose completa?

No. Rimanda principalmente al tutorial esterno di Big Bear.

Quale backend documenta l’attuale Self-hosted LiveSync?

L’attuale configurazione upstream usa CouchDB e fornisce un percorso di distribuzione Docker.

La sincronizzazione self-hosted sostituisce i backup?

No. Conserva un backup indipendente del vault, perché anche le eliminazioni e le modifiche errate possono essere sincronizzate.