Como auto-hospedar um cofre de senhas tipo BitWarden
Suas senhas são a sua propriedade digital mais crítica, e mantê-las seguras significa tê-las em suas próprias mãos.
Suas senhas são a sua propriedade digital mais crítica, e mantê-las seguras significa tê-las em suas próprias mãos. Ao fazer o self-hosting do seu gerenciador de senhas, você assume o controle da sua própria segurança.
O BitWarden é amplamente considerado um dos mais confiáveis no domínio de gerenciamento de senhas e seu código-fonte é disponibilizado sob a licença AGPL-3.0. O NodeWarden é um servidor não oficial compatível com o BitWarden, escrito em BitWarden, que pode ser feito deploy gratuitamente na Cloudflare.
Comparação de Funcionalidades com o Servidor Oficial do BitWarden
| Funcionalidade | BitWarden | NodeWarden | Notas |
|---|---|---|---|
| Cofre Web (Web Vault) | ✅ | ✅ | Interface original do Web Vault |
Sincronização completa /api/sync | ✅ | ✅ | Compatibilidade otimizada para clientes oficiais |
| Upload / download de anexos | ✅ | ✅ | Cloudflare R2 ou KV |
| Send (Enviar) | ✅ | ✅ | Suporta envio de textos e de arquivos |
| Importar / Exportar | ✅ | ✅ | Suporta importação do BitWarden JSON / CSV / ZIP com anexos |
| Central de Backup em Nuvem | ❌ | ✅ | Backup agendado para WebDAV / E3 |
| Dica de senha (web) | ⚠️ Limitado | ✅ | Não exige e-mail |
| TOTP / Steam TOTP | ✅ | ✅ | Inclui suporte a steam:// |
| Multiusuário | ✅ | ✅ | Registro baseado em convite |
| Organizações / Coleções / Papéis | ✅ | ❌ | Não implementado |
| Login com 2FA | ✅ | ⚠️ Parcial | Atualmente apenas TOTP em nível de usuário |
| SSO / SCIM / Diretório corporativo | ✅ | ❌ | Não implementado |
O que precisamos:
- Uma conta no GitHub
- Uma conta na Cloudflare (Gratuita) com o Cloudflare R2 Storage ativado.
- _Opcional:_Um nome de domínio personalizado gerenciado na Cloudflare.
Fase 1: Preparar o Código
- Faça um _fork_do repositório do NodeWarden acessando https://github.com/Tech-Voyage-Dev/nodewarden do repositório original https://github.com/shuaiplus/nodewarden GitHub.
- Ative o Workflow "Sync Upstream".
Fase 2: Fazer o Deploy na Cloudflare
- Crie uma aplicação Worker na Cloudflare.
- Selecione 'Continue with GitHub' para fazer o deploy do app.
- Aguarde alguns instantes até a Cloudflare fazer a build e o deploy do seu app. Ele fornecerá uma URL padrão terminada em
worker.dev.
(Opcional) Adicionar um Domínio Personalizado:
- Nas configurações do seu Cloudflare Worker, vá para a aba Settings.
- Clique em Triggers -> Custom Domains -> + Add Custom Domain.
- Digite seu domínio de preferência e siga as instruções.
Fase 3: Proteger Seu Servidor (O Segredo JWT)
- Vá até o seu navegador de internet e insira o nome do seu domínio personalizado ou o domínio 'worker.dev' gerado.
- Você receberá o aviso 'JWT_SECRET is missing'.
- Copie a chave secreta (secret key) gerada, volte para a aba de Settings no seu NodeWarden Worker e clique no botão '+ Add' na seção 'Variables and Secrets'.
- Insira o segredo gerado e clique no botão 'Deploy / Save'.
Fase 4: Criar sua Conta de Administrador
- Volte ao navegador web e recarregue a página; você verá a seguinte tela de login.
- Clique em 'Create Account' para criar a conta de administrador.
- Faça login usando a conta admin recém-criada para acessar o Dashboard.
- Agora temos o servidor rodando e operante. Vamos começar a configurar os clientes do BitWarden.
Fase 5: Conectar Seus Dispositivos
Você pode usar os aplicativos oficiais do BitWarden em todos os seus dispositivos.
Extensão do Chrome
- Instale a extensão do BitWarden no Chrome.
- Abra a extensão.
- Clique no link ao lado de 'Accessing:' na parte inferior da janelinha popup.
- Insira o nome de domínio do servidor NodeWarden.
- Salve as configurações e faça o login com sua conta.
App para iOS
- Instale o app do BitWarden através da App Store.
- Abra o app e clique em '' ao lado de 'Logging in on:'.
- Insira o nome de domínio do servidor NodeWarden e clique no botão '✓'.
Outros Clientes
O NodeWarden foi testado e confirmou-se compatível com estes clientes oficiais do BitWarden:
- ✅ Windows (desktop)
- ✅ Apps mobile Android/iOS
- ✅ Extensões de navegador
- ✅ Linux (desktop)
- ⚠️ macOS desktop (não verificado totalmente)
Backup do Cofre (Vault)
O NodeWarden permite fazer backup do seu cofre no seu computador local ou em um armazenamento remoto (armazenamento compatível com S3 ou WebDAV).
Para automatizar backups remotos:
- Configure os detalhes do armazenamento remoto dentro do painel do NodeWarden.
- Certifique-se de que a tarefa Cron esteja configurada nas configurações do seu Cloudflare Worker para o backup remoto automático.
Recomendações Finais de Segurança
- Proteja o acesso da sua conta na Cloudflare, caso contrário, os dados podem ser comprometidos. Ative a Autenticação de Dois Fatores (2FA) ou o Passkey em sua conta da Cloudflare imediatamente.
- Hospede o NodeWarden em uma conta da Cloudflare dedicada. Não compartilhe os recursos com outras aplicações web para minimizar os riscos de segurança.
- Proteger o NodeWarden com a Cloudflare
Referências
- Guia Oficial de Início do NodeWarden