A publicação original no fórum é uma introdução e uma ligação para um tutorial externo, não um registo completo da implementação. Promete uma configuração rápida do CasaOS para o Obsidian Self-hosted LiveSync, mas a própria publicação não conserva a imagem do CouchDB, os caminhos dos volumes, as credenciais, a configuração HTTPS nem a configuração dos clientes utilizadas no vídeo original.
Para uma instalação atual, utilize o projeto mantido Self-hosted LiveSync como referência técnica. A configuração a montante continua a centrar-se no CouchDB e documenta explicitamente o Docker, os dados/configuração persistentes do CouchDB, a exposição através de HTTPS e um URI de configuração para configurar os clientes Obsidian.
O Self-hosted LiveSync é uma camada de sincronização, não a própria aplicação Obsidian
O Obsidian continua instalado nos seus computadores ou dispositivos móveis. O Self-hosted LiveSync adiciona um plugin comunitário de sincronização e uma base de dados no servidor, permitindo que as alterações aos cofres sejam sincronizadas entre dispositivos sem depender do serviço pago Obsidian Sync.
O projeto a montante é software comunitário, não um serviço oficial do Obsidian.
O CouchDB é o componente central do servidor
O guia de configuração atual a montante utiliza o CouchDB como backend principal autoalojado. O exemplo Docker cria diretórios persistentes para os dados e a configuração do CouchDB antes de iniciar o contentor.
Utilize a configuração atual do servidor Self-hosted LiveSync, em vez de copiar etiquetas de imagens antigas de um vídeo.
Mantenha a base de dados do CouchDB fora do contentor descartável
A base de dados contém a representação sincronizada das suas notas e o estado relacionado. Mapeie os diretórios de dados e configuração do CouchDB para armazenamento persistente do CasaOS, para que recriar o contentor não apague o backend de sincronização.
Mantenha essas pastas separadas das camadas Docker temporárias comuns.
Utilize credenciais exclusivas do CouchDB
Não mantenha os nomes de utilizador ou palavras-passe de exemplo de um tutorial. Crie credenciais de administrador do CouchDB fortes e exclusivas e mantenha-as fora de capturas de ecrã, ficheiros Compose partilhados e publicações públicas em fóruns.
Se as credenciais forem expostas, altere-as e reveja imediatamente qualquer instância do CouchDB acessível remotamente.
A sincronização remota deve utilizar HTTPS
Se vários dispositivos precisarem de sincronizar fora da LAN, disponibilize o CouchDB através de uma ligação HTTPS segura, em vez de publicar diretamente HTTP simples na Internet. A documentação a montante inclui exemplos de proxy inverso e configuração de domínios.
Uma rede VPN/de sobreposição é outra opção quando apenas os seus próprios dispositivos precisam de acesso.
As definições de CORS e de origem têm de corresponder ao fluxo de trabalho do cliente
A configuração de segurança do CouchDB pode bloquear pedidos do navegador ou da webview mesmo quando o servidor está acessível. O procedimento de configuração do Self-hosted LiveSync configura o comportamento necessário do CouchDB, em vez de considerar um contentor de base de dados genérico concluído assim que a porta 5984 fica aberta.
Utilize o URI de configuração com cuidado
A orientação atual a montante pode gerar um URI de configuração para que outro dispositivo Obsidian importe as definições de ligação. Esse URI pode conter informações de ligação sensíveis.
Trate-o como um segredo: envie-o apenas para o seu próprio dispositivo de confiança e evite publicá-lo em capturas de ecrã ou históricos de conversas a que outras pessoas possam aceder.
A sincronização em tempo real não elimina os conflitos de edição
Dois dispositivos a editar a mesma nota quase ao mesmo tempo podem ainda criar conflitos ou exigir reconciliação. O autoalojamento dá-lhe controlo sobre o servidor; não transforma a edição distribuída num sistema de ficheiros com um único escritor.
Teste o fluxo de trabalho com um cofre descartável antes de migrar a sua única cópia de notas importantes.
A sincronização não é uma cópia de segurança
Se uma nota for eliminada e essa eliminação for sincronizada com todos os clientes, o sistema sincronizado cumpriu a sua função. Mantenha cópias de segurança versionadas e independentes do cofre Obsidian e, quando apropriado, dos dados do CouchDB.
Isto protege contra eliminações acidentais, erros de plugins, corrupção da base de dados ou uma edição em massa equivocada.
A fonte é específica do CasaOS
O tutorial histórico destinava-se ao CasaOS. Se o anfitrião for agora o ZimaOS, utilize o fluxo de trabalho atual da App Store/Compose do ZimaOS e os caminhos de armazenamento atuais, em vez de presumir a mesma estrutura de pacotes do CasaOS.
Perguntas frequentes sobre o Obsidian LiveSync
A publicação original no fórum contém a configuração Compose completa?
Não. Liga principalmente ao tutorial externo da Big Bear.
Que backend é documentado pelo Self-hosted LiveSync atual?
A configuração atual a montante utiliza o CouchDB e disponibiliza um método de implementação com Docker.
A sincronização autoalojada substitui as cópias de segurança?
Não. Mantenha uma cópia de segurança independente do cofre, porque as eliminações e as edições incorretas também podem ser sincronizadas.
