Tutoriais de VPS
Obsidian LiveSync no VPS: CouchDB, criptografia e backups (2026)
Configure LiveSync com CouchDB, CORS, HTTPS, criptografia, vários dispositivos, conflitos e backups. Corrija a estimativa original de $120/ano para dois cofres com os limites reais do plano.

Self-hosted LiveSync conecta dispositivos Obsidian pelo CouchDB e permite escolher onde ficam servidor e notas. Também transfere para você a responsabilidade por credenciais, certificados, atualizações, conflitos e recuperação. A escolha deve considerar controle e necessidades reais, sem presumir economia automática.
O original tratava Sync oficial como cobrança universal por cofre e prometia histórico ilimitado. A documentação oficial, consultada em 2026-11-16, informa Standard: 1 cofre, 1 GB, arquivos de 5 MB e histórico de 1 mês; Plus: 10 cofres, 10–100 GB conforme armazenamento comprado, arquivos de 200 MB e histórico de 12 meses. A cota é compartilhada pela conta. Confira preço e condições atuais, sem multiplicar uma mensalidade por cada cofre.
| Método | Custo | Sincronização | Criptografia/histórico | Celular e manutenção |
|---|---|---|---|---|
| Sync oficial | Assinatura | Serviço gerenciado | E2EE e retenção do plano | Celular nativo; servidor gerenciado |
| LiveSync | Plugin, VPS e tempo | Incremental quase em tempo real | E2EE opcional; retenção depende do plugin/banco | Desktop/celular; você mantém CouchDB |
| Remotely Save | Plugin e armazenamento | Agendada/manual | Confira criptografia e versões configuradas | Depende do backend |
| Syncthing | Software e infraestrutura | Sincronização de arquivos | Transporte criptografado; conteúdo remoto exige proteção própria; versões opcionais | Sem cliente oficial iOS |
| Plugin Git | Repositório e ferramentas | Commit/pull/push | Histórico Git; criptografia separada | Conflitos e fluxo móvel exigem atenção |
Remotely Save não replica continuamente como LiveSync; edições entre execuções podem conflitar. Confira criptografia e retenção do plugin, sem atribuí-las só à nuvem. Syncthing funciona em dispositivos compatíveis, com decisão separada para iOS. Todas as opções precisam de backups.
LiveSync pode interessar quando:
- Você tem vários cofres ou coleções maiores.
- Anexos excedem a cota prática de um plano gerenciado.
- Quer escolher localização e administração.
- Já mantém um VPS com recursos disponíveis.
Para um cofre pequeno de texto, o serviço gerenciado pode valer pela menor manutenção.
| Configuração inicial | Avaliação |
|---|---|
| 1 vCPU/512 MB | Apertada; sincronização simultânea pode esgotar RAM |
| 1 vCPU/1 GB | Possível para uso pessoal pequeno; meça |
| 1 vCPU/2 GB | Mais margem inicial |
| 2 vCPU/2 GB+ | Mais dispositivos, anexos ou serviços compartilhados |
Os 200–300 MB em repouso do original são estimativas. Reserve inicialmente 3–5 vezes o tamanho do cofre e acompanhe revisões, chunks, logs e espaço para compactar. Um cofre de 200 MB chegando a 1 GB é exemplo de planejamento, sem taxa garantida. Considere 20 GB de disco ou mais conforme a carga.
Teste latência dos seus dispositivos; idioma não define localização. Opções econômicas usam $3/mês como comparação, sem garantir estoque ou desempenho. Considere jurisdição e acesso mesmo com E2EE: metadados e padrões de tráfego podem continuar visíveis.
mkdir -p ~/obsidian-sync/{data,local.d}
cd ~/obsidian-sync
Crie docker-compose.yml, trocando a senha por uma aleatória privada e escolhendo imagem mantida e 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" alinha usuário com arquivos. Confira UID 5984 na imagem escolhida e proprietário de data e configuração:
sudo chown -R 5984:5984 data local.d
Restrinja arquivos com segredos. Vincule a 127.0.0.1 e publique pelo proxy, sem expor 5984 diretamente. Confira portas/rede Docker, sem depender apenas do UFW.
Use local.d/livesync.ini em local.d/, evitando alterações descartáveis em 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 = trueseleciona o nó único demonstrado.enable_cors = truee[cors]permitem as origens web necessárias.originsincluiapp://obsidian.mdecapacitor://localhost; restrinja aos clientes usados.max_http_request_sizepermite requisições HTTP de até 4 GB no exemplo. Não é requisito universal nem limite de documento de 4 GB: max_document_size é separado, em 50,000,000 bytes. Ajuste aos chunks do plugin, RAM e limites do proxy.require_valid_user = trueexige autenticação. Configure também membros/segurança do banco para limitar privilégios.
docker compose up -d
docker compose logs -f
Confira logs e acesse Fauxton por túnel SSH em http://127.0.0.1:5984/_utils/. Use administrador na instalação e avalie usuário exclusivo do banco para rotina após as verificações do plugin.
Use certificado válido e confiável no desktop e celular; evite certificados não confiáveis e desativar validação. Com DNS e desafios acessíveis, Caddy fornece HTTPS:
couchdb.example.com {
encode gzip
reverse_proxy 127.0.0.1:5984
}
Confira Host e X-Forwarded-*, especialmente atrás de outro proxy. Deixe CORS com CouchDB, sem duplicar cabeçalhos. No Nginx, configure proxy_pass e desative proxy_buffering quando a replicação contínua precisar de streaming; revise timeouts e tamanhos. Veja Caddy.
Instale Self-hosted LiveSync pelo catálogo comunitário, conferindo confiança e versão compatível. Siga o assistente, cuja redação pode mudar:
| Campo | Valor |
|---|---|
| URI | https://couchdb.example.com, sem porta pública 5984 |
| Usuário/senha | Conta CouchDB autorizada |
| Banco | Nome separado por cofre, como obsidian-vault |
Execute Test database connection e Check and fix quando o plugin exigir permissões de instalação. Confira segurança depois.
Copie o cofre completo para um backup independente antes de escolher a direção.
- Servidor realmente novo e vazio: preencha com a cópia local completa escolhida.
- Servidor existente e autoritativo: preencha um dispositivo novo vazio a partir dele.
Não sobrescreva dispositivos com mudanças pendentes. Leia o aviso e teste com notas descartáveis: direção errada pode propagar dados vazios ou antigos.
Com E2EE corretamente configurada, o cliente criptografa dados compatíveis antes do upload. Path Obfuscation reduz exposição de nomes. Isso não protege clientes comprometidos nem elimina todos os metadados.
Guarde a passphrase: perdê-la pode tornar os dados cifrados do servidor inutilizáveis. A frase dos dados e a frase do Setup URI protegem itens diferentes. Preserve ambas num gerenciador de senhas e num processo adequado de recuperação.
O Setup URI iniciado por obsidian://setuplivesync?settings= contém configurações sensíveis. No dispositivo preparado:
Self-hosted LiveSync: Copy settings as a new Setup URI
Escolha outra passphrase para protegê-lo. No novo dispositivo selecione I am adding a device to an existing synchronisation setup e importe URI/frase em privado. Trate ambos como credenciais; não publique nem envie juntos por um canal exposto.
Um cofre novo vazio pode baixar do servidor. Se já existe cópia local, faça backup e concilie mudanças antes de aprovar sobrescrita.
Duas edições offline na mesma nota podem conflitar. O plugin pode juntar mudanças compatíveis; revise alternativas pendentes na interface. Teste recuperação na versão instalada, sem presumir revisão recuperável para sempre.
Revisões CouchDB servem para replicação e concorrência, sem garantir arquivo histórico ilimitado. Compactação e retenção do plugin podem remover corpos antigos. Sincronização também propaga exclusão: histórico não substitui cópia independente.
Guarde exportações independentes do cofre e siga backups. Num nó pequeno, parar e arquivar evita copiar banco em mudança:
cd ~/obsidian-sync
docker compose stop couchdb
sudo tar czf ~/couchdb-backup-$(date +%F).tar.gz data local.d
docker compose start couchdb
Guarde Compose e segredos em privado além de data/local.d, transfira o arquivo para fora do VPS e teste restauração isolada. Confira sucesso do tar e garanta reinício do serviço mesmo se o backup falhar. Replicação para outro CouchDB pode ficar online, mas também copia exclusões indesejadas; mantenha snapshots históricos independentes.
Failed to fetch/CORS: confira [cors], origins e app://obsidian.md, credenciais e TLS. Evite CORS duplicado no proxy.
Conecta sem avançar: confira proxy_buffering off no Nginx, timeouts contínuos e limites proxy/CDN. Cloudflare pode encerrar requisições longas conforme o plano.
Desktop funciona, celular não: confira cadeia/confiança, validade e DNS com curl -v https://couchdb.example.com; restrições móveis podem diferir.
Banco crescendo: monitore disco e espaço temporário antes de compactar:
curl -u admin:密码 -X POST https://couchdb.example.com/obsidian-vault/_compact \
-H "Content-Type: application/json"
Auto Compaction, quando disponível, exige retenção deliberada. Pode remover corpos antigos; não significa histórico permanente. Limpe anexos por procedimentos suportados pelo plugin.
Domínio/certificado mudou: atualize URI e teste após reiniciar cliente.
Passphrase perdida: recupere cópia legível de outro dispositivo ou backup e estabeleça nova configuração. O servidor não consegue descriptografar por você.
O original usava $5/mês para VPS, $30–50/ano para 1 vCPU/2 GB, $5–10/mês para Sync e $48–96/ano no pagamento anual. Seu cálculo de $120–240/ano para dois cofres presumiu cobrança por cofre e não compara corretamente com Plus documentado. São exemplos históricos, sem oferta vigente.
Inclua hospedagem, backup, tráfego e manutenção. Recursos VPS livres reduzem custo adicional, mas comprar um só para um cofre pode economizar pouco. Localização e controle operacional são razões mais fortes.