Solução da comunidade

Obsidian no ZimaOS: Corrigir montagens do cofre e problemas de HTTPS

A ZimaBlade user reverse-proxied the browser-based Obsidian app but could not see a mounted vault and later found Selkies opening without Obsidian itself.

Conclusão: se o seu objetivo é ter um cofre do Obsidian, não comece por executar a interface de ambiente de trabalho do Obsidian num contentor de navegador

A configuração de 2025 combinava o Obsidian da LinuxServer, o Selkies, um proxy inverso e um cofre montado. Pode funcionar, mas introduz quatro camadas de falhas distintas antes de sequer editar uma nota: segurança do navegador, WebSocket/HTTPS, mapeamento de volumes do contentor e o processo de ambiente de trabalho do Obsidian. Em 2026, a ZimaSpace disponibiliza agora o OZSync para Obsidian especificamente para cópias de segurança, acesso à nuvem e sincronização entre dispositivos, sendo esta uma melhor abordagem inicial quando o verdadeiro objetivo é «manter o meu cofre no ZimaOS».

O OZSync para Obsidian está listado no ecossistema de plugins do ZimaOS.

Escolha a arquitetura antes de corrigir o contentor

Existem três modelos práticos:

  • Sincronizar um cofre local normal: o Obsidian é executado nativamente no seu Mac/PC; uma camada de sincronização mantém o cofre no ZimaOS.
  • Abrir um cofre através de um sistema de ficheiros montado: a aplicação de ambiente de trabalho aponta para uma partilha montada, com as habituais limitações de latência e utilização offline.
  • Executar o próprio Obsidian num contentor de navegador: o LinuxServer/Selkies transmite a interface gráfica remotamente. Esta é a opção mais complexa.

Se escolheu o contentor de navegador apenas por pensar que era necessário para o armazenamento no ZimaOS, simplifique primeiro.

Se mantiver o contentor, verifique separadamente os caminhos do anfitrião e do contentor

Quando um cofre «nunca aparece», inspecione o mapeamento do volume Docker em vez da interface do Obsidian:

# exemplo
/media/Notes/MyVault  ->  /vaults/MyVault

O Obsidian dentro do contentor só consegue ver o caminho do lado direito. O ZimaOS Files apresenta o caminho do lado esquerdo. Os caminhos de aplicações do ZimaOS explicam este limite, enquanto os bind mounts do Docker definem o comportamento em execução.

Corrija o HTTPS antes de depurar o Selkies

Os contentores de ambientes de trabalho transmitidos pelo navegador podem depender de APIs seguras do navegador e de conectividade WebSocket. Se a aplicação recusava inicialmente o «acesso não seguro», encaminhá-la através de um proxy inverso para HTTPS foi uma solução razoável. No entanto, teste o endpoint do proxy antes de adicionar a montagem do cofre. Uma página do Selkies que apresente uma consola funcional não prova que o processo do Obsidian ou o respetivo caminho WebSocket estejam a funcionar corretamente.

O proxy HTTPS do ZimaOS apresenta o modelo de proxy inverso do ZimaOS.

Quando o Selkies abre, mas o Obsidian não

Reiniciar o contentor e ver a consola de transmissão sem a aplicação normalmente significa que o contentor está ativo, mas o processo de ambiente de trabalho falhou. Verifique os registos do contentor, a versão da imagem, o proprietário da configuração persistente e a memória disponível. Não elimine o cofre enquanto estiver a resolver problemas da interface gráfica.

docker ps -a
docker logs --tail=200 YOUR_OBSIDIAN_CONTAINER
ls -ld /media/Notes/MyVault

A LinuxServer disponibiliza atualmente o Obsidian como um contentor acessível pela Web, mas as respetivas imagens continuam a depender de permissões corretas para o /config persistente e para os volumes do anfitrião. O contentor Obsidian da LinuxServer é a fonte original.

Mantenha o cofre como ficheiros simples que possa recuperar sem o contentor

Um cofre do Obsidian é essencialmente uma pasta de ficheiros Markdown, juntamente com a configuração .obsidian. Armazene essa pasta no armazenamento de dados normal do ZimaOS e faça cópias de segurança de forma independente. Se o contentor de transmissão avariar, as suas notas devem continuar legíveis com qualquer editor de texto.

As cópias de segurança do ZimaOS e os requisitos das aplicações do ZimaOS abrangem a recuperação e o dimensionamento.

Importe um cofre existente sem o reconstruir

Pare o Obsidian, copie o cofre completo — incluindo as definições ocultas .obsidian, caso pretenda mantê-las — para o diretório do anfitrião, confirme o proprietário e, em seguida, inicie o contentor e abra o caminho do contentor mapeado. Evite copiar ficheiros enquanto dois motores de sincronização independentes estão a escrever no cofre, pois os ficheiros de conflito e as notas eliminadas são mais difíceis de resolver do que um simples problema de montagem.

Utilize a sincronização em vez de um ambiente de trabalho no navegador quando editar a partir de vários dispositivos

Para computadores portáteis e telemóveis, uma arquitetura orientada para a sincronização mantém a experiência do Obsidian local e responsiva em cada dispositivo. Isso também reduz a dependência de uma sessão de navegador remota e permite tirar notas offline. Utilize a abordagem do contentor de navegador quando o acesso centralizado à interface gráfica for especificamente o que pretende, e não apenas porque os dados estão num NAS.

Perguntas frequentes

Porque é que o meu cofre do Obsidian montado não aparece?

A causa mais comum do lado do contentor é uma incompatibilidade entre os caminhos do volume. Verifique o caminho do anfitrião, o caminho do contentor e as permissões antes de alterar as definições do Obsidian.

O Obsidian precisa de HTTPS no ZimaOS?

O Obsidian de ambiente de trabalho nativo não precisa que a interface Web do seu NAS disponibilize o editor. Um contentor Selkies transmitido pelo navegador pode exigir HTTPS ou um comportamento correto de WebSocket seguro.

Devo armazenar o cofre em SMB?

Pode funcionar, mas um cofre local com sincronização é geralmente mais fácil de utilizar offline e menos sensível a interrupções de rede.

Posso copiar diretamente um cofre Markdown existente?

Sim. Um cofre é uma pasta de ficheiros. Copie todo o diretório, incluindo o .obsidian se quiser os plugins e as definições, e depois indique esse caminho à instância do Obsidian escolhida.

Qual é agora a configuração mais simples do Obsidian no ZimaOS?

Se o objetivo for a sincronização do cofre entre dispositivos, comece por avaliar a integração atual do OZSync em vez de criar uma pilha completa de ambiente de trabalho no navegador.