In sintesi: se il tuo obiettivo è un vault di Obsidian, non iniziare eseguendo l’interfaccia desktop di Obsidian in un container accessibile dal browser
La configurazione del 2025 combinava LinuxServer Obsidian, Selkies, un proxy inverso e un vault montato. Può funzionare, ma introduce quattro livelli distinti di possibili guasti prima ancora di modificare una nota: sicurezza del browser, WebSocket/HTTPS, mappatura dei volumi del container e processo desktop di Obsidian. Nel 2026, ZimaSpace propone OZSync per Obsidian specificamente per backup, accesso al cloud e sincronizzazione tra dispositivi: è un percorso iniziale migliore quando l’obiettivo reale è “mantenere il mio vault su ZimaOS”.
OZSync per Obsidian è elencato nell’ecosistema dei plugin di ZimaOS.
Scegli l’architettura prima di correggere il container
Esistono tre modelli pratici:
- Sincronizzare un vault locale normale: Obsidian viene eseguito nativamente sul tuo Mac/PC; un livello di sincronizzazione mantiene il vault su ZimaOS.
- Aprire un vault tramite un filesystem montato: l’app desktop utilizza una condivisione montata, con i consueti limiti di latenza e di accesso offline.
- Eseguire Obsidian stesso in un container accessibile dal browser: LinuxServer/Selkies trasmette l’interfaccia grafica da remoto. È l’opzione più complessa.
Se hai scelto il container accessibile dal browser solo perché pensavi fosse necessario per lo spazio di archiviazione di ZimaOS, semplifica prima la configurazione.
Se mantieni il container, verifica separatamente i percorsi dell’host e del container
Quando un vault “non compare mai”, controlla la mappatura del volume Docker invece dell’interfaccia di Obsidian:
# esempio
/media/Notes/MyVault -> /vaults/MyVaultObsidian all’interno del container può vedere solo il percorso a destra. ZimaOS Files mostra il percorso a sinistra. La pagina dei percorsi delle app di ZimaOS spiega questo confine, mentre i bind mount di Docker definiscono il comportamento in fase di esecuzione.
Risolvi HTTPS prima di eseguire il debug di Selkies
I container desktop trasmessi tramite browser possono dipendere da API sicure del browser e dalla connettività WebSocket. Se l’app inizialmente rifiutava l’“accesso non sicuro”, il proxy inverso su HTTPS era una soluzione ragionevole. Tuttavia, verifica l’endpoint del proxy prima di aggiungere il mount del vault. Una pagina Selkies funzionante non dimostra che il processo di Obsidian o il relativo percorso WebSocket siano operativi.
Il proxy HTTPS di ZimaOS illustra il modello di proxy inverso di ZimaOS.
Quando Selkies si apre ma Obsidian no
Se riavvii il container e visualizzi l’ambiente di streaming senza l’applicazione, di solito significa che il container è attivo ma il processo desktop non è riuscito ad avviarsi. Controlla i log del container, la versione dell’immagine, i permessi di proprietà della configurazione persistente e la memoria disponibile. Non eliminare il vault durante la risoluzione dei problemi dell’interfaccia grafica.
docker ps -a
docker logs --tail=200 YOUR_OBSIDIAN_CONTAINER
ls -ld /media/Notes/MyVaultLinuxServer distribuisce attualmente Obsidian come container accessibile via web, ma le sue immagini dipendono ancora dalla corretta configurazione dei permessi per /config persistente e per i volumi dell’host. Il container Obsidian di LinuxServer è la fonte upstream.
Mantieni il vault come file normali, recuperabili anche senza il container
Un vault di Obsidian è fondamentalmente una cartella di file Markdown più la configurazione .obsidian. Archivia quella cartella nello spazio dati normale di ZimaOS ed esegui il backup in modo indipendente. Se il container di streaming si rompe, le tue note dovrebbero rimanere leggibili con qualsiasi editor di testo.
Il backup di ZimaOS e i requisiti delle app di ZimaOS illustrano il recupero e il dimensionamento.
Importa un vault esistente senza ricrearlo
Arresta Obsidian, copia il vault completo, incluse le impostazioni nascoste di .obsidian se desideri conservarle, nella directory dell’host, verifica la proprietà, quindi avvia il container e apri il percorso del container mappato. Evita di copiare file mentre due motori di sincronizzazione indipendenti stanno scrivendo nel vault, perché i file in conflitto e le note eliminate sono più difficili da districare rispetto a un semplice problema di mount.
Usa la sincronizzazione invece di un desktop nel browser quando modifichi i contenuti da più dispositivi
Per laptop e telefoni, un’architettura orientata alla sincronizzazione mantiene l’esperienza di Obsidian locale e reattiva su ogni dispositivo. Riduce inoltre la dipendenza da una sessione del browser remota e consente di prendere note offline. Usa l’approccio con container nel browser quando desideri specificamente un accesso centralizzato all’interfaccia grafica, non semplicemente perché i dati risiedono su un NAS.
Domande frequenti
Perché il mio vault di Obsidian montato non compare?
La causa più comune sul lato container è una mancata corrispondenza nei percorsi del volume. Verifica il percorso dell’host, quello del container e i permessi prima di modificare le impostazioni di Obsidian.
Obsidian richiede HTTPS su ZimaOS?
Obsidian desktop nativo non ha bisogno che l’interfaccia web del NAS esponga l’editor. Un container Selkies trasmesso tramite browser può richiedere HTTPS o una corretta gestione dei WebSocket sicuri.
Devo archiviare il vault su SMB?
Può funzionare, ma un vault locale con sincronizzazione è generalmente più semplice da usare offline e meno sensibile alle interruzioni di rete.
Posso copiare direttamente un vault Markdown esistente?
Sì. Un vault è una cartella di file. Copia l’intera directory, inclusa .obsidian se desideri conservare plugin e impostazioni, quindi indica quel percorso all’istanza di Obsidian scelta.
Qual è ora la configurazione più semplice di Obsidian su ZimaOS?
Se l’obiettivo è sincronizzare il vault tra dispositivi, inizia valutando l’integrazione OZSync attuale invece di creare un’intera infrastruttura desktop nel browser.
