Destinos dos backups: disco local e S3
O destino do Databasus é o armazenamento onde cada backup termina: o disco da própria VPS ou um serviço externo como S3, Cloudflare R2, Azure Blob Storage, NAS, FTP ou SFTP. Com a cifra ligada, o arquivo sai do container já comprimido e cifrado com AES-256-GCM, por isso o bucket guarda só cópias ilegíveis sem a chave mestra da sua instalação.
Ficha e sumário da página
- Referência técnica
- Databasus 3.70.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Sete tipos de armazenamento
O destino é cadastrado uma vez no painel e escolhido por banco. A documentação oficial lista sete tipos, do disco da própria VPS aos serviços de armazenamento de objetos e aos servidores de arquivos que você já mantém:
- Disco localOs backups ficam no servidor ou na VPS onde o Databasus roda, dentro da pasta montada no container.
- S3O Amazon S3 e os serviços de armazenamento compatíveis com a API do S3.
- Cloudflare R2O armazenamento de objetos da Cloudflare, configurado pela API compatível com S3.
- Azure Blob StorageO armazenamento de objetos da Microsoft Azure.
- NASUm dispositivo de armazenamento em rede, montado como pasta compartilhada.
- FTP e SFTPUm servidor de arquivos por FTP ou pelo SFTP, que trafega o arquivo dentro de uma conexão SSH.
Cada banco aponta para o próprio destino. O banco do seu app pode ir para um bucket R2 enquanto o banco de um sistema interno fica no NAS do escritório. A documentação oficial também prevê mais de um destino para redundância, com a mesma cópia guardada em lugares diferentes.
Por que o disco local não basta
O disco local é o destino mais simples, porque não exige cadastro em nenhum serviço externo. Os arquivos ficam na pasta databasus-data montada no container, ao lado do secret.key e do PostgreSQL interno, uma configuração que atende bem um ambiente de estudo.
O limite aparece quando a VPS falha. Um disco corrompido, um provedor fora do ar ou uma instância apagada por engano levam junto o banco e todos os backups dele, porque os dois estavam na mesma máquina. Um destino externo separa a cópia do servidor copiado. As perguntas frequentes do Databasus tratam o caso da própria instalação e registram que, com destino local, a pasta de backups também pode entrar na cópia que você leva para fora do servidor.
Como o destino S3 é configurado
A API do Amazon S3 virou o formato comum do armazenamento de objetos. Serviços como o Cloudflare R2 respondem a ela com os mesmos comandos. No painel, o destino S3 recebe o nome do bucket, a região, as duas chaves de acesso e o endereço do serviço. A documentação do Cloudflare R2 mostra esses campos preenchidos para o R2:
Destino S3 do Databasus para o Cloudflare R2
Bucket
Bucket name:- O nome do bucket criado no painel do R2.
Region:- No R2, o valor auto, como a documentação indica.
Acesso
Access Key ID:- O ID do token de API do R2, com permissão de leitura e escrita de objetos.
Secret Access Key:- O segredo do mesmo token, guardado cifrado pelo Databasus.
S3 endpoint:- O endereço https://<ACCOUNT_ID>.r2.cloudflarestorage.com, com o Account ID do painel da Cloudflare.
O mesmo formulário atende o Amazon S3 e os outros serviços compatíveis, com o endpoint e a região de cada um. O token do R2 sai do painel da Cloudflare, em R2, API, Manage API Tokens, com a permissão Object Read & Write. Um token restrito a um único bucket limita o estrago de um vazamento, porque ele não abre os outros buckets do seu cadastro na Cloudflare.
O que chega ao destino
O destino recebe dois arquivos por backup: o arquivo do backup e um .metadata em JSON, com o mesmo nome, que guarda o salt e o vetor de inicialização da cifra. O Databasus comprime a saída do backup e, com a cifra ligada, cifra o resultado com AES-256-GCM antes do envio. Na documentação de segurança, o caminho sai do pg_dump, passa pela compressão e pela criptografia e só então chega ao armazenamento na nuvem. Cada backup recebe uma chave própria, derivada da chave mestra guardada em databasus-data/secret.key, do ID do backup e de um salt aleatório.
A cifra é uma opção da configuração de backup de cada banco. No formulário da versão 3.70.0, ela vem ligada por padrão no backup lógico e desligada no físico, por isso confira esse campo quando o destino for um serviço compartilhado. Com a cifra ligada, o bucket guarda arquivos que só a sua instalação abre. Um vazamento das chaves do S3 expõe só arquivos cifrados. O algoritmo GCM também detecta qualquer alteração no arquivo durante a decifragem. O README chama esse desenho de armazenamento de confiança zero: você guarda a cópia num serviço compartilhado sem entregar o conteúdo do banco ao provedor.
As credenciais do destino recebem uma proteção própria, que não depende dessa opção. A chave de acesso do S3, a senha do FTP e a chave do Azure ficam cifradas no PostgreSQL interno do Databasus. A API e o painel não devolvem esses valores depois do cadastro. Como a chave mestra fica num arquivo separado do banco interno, uma cópia vazada do banco interno não revela os segredos.
A chave mestra decide a recuperação
A cifra protege o backup e também cria uma dependência. Sem o secret.key, nenhum arquivo cifrado do destino volta a ser legível, nem pelo Databasus nem por fora dele. As perguntas frequentes oficiais separam dois cenários. Para recuperar só os backups, sem o painel, basta o secret.key com o guia de recuperação manual. Para recriar a instalação inteira em outro servidor, com agendas, destinos e histórico, você precisa do secret.key e da pasta pgdata.
Com a cópia guardada no lugar certo, a pergunta seguinte é se o arquivo restaura. O Databasus responde com um agente que monta o banco a partir do backup, assunto da página Verificação de restauração.