---
title: "Como auto-hospedar um cofre de senhas tipo BitWarden"
description: "Suas senhas são a sua propriedade digital mais crítica, e mantê-las seguras significa tê-las em suas próprias mãos."
canonical_url: "https://techvoyage.dev/pt/article/self-hosting-nodewarden-at-cloudflare"
last_updated: "2026-06-14T11:05:30.108Z"
---

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

<table>
<thead>
  <tr>
    <th>
      Funcionalidade
    </th>
    
    <th>
      BitWarden
    </th>
    
    <th>
      NodeWarden
    </th>
    
    <th>
      Notas
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Cofre Web (Web Vault)
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      <strong>
        Interface original do Web Vault
      </strong>
      
      ​
    </td>
  </tr>
  
  <tr>
    <td>
      Sincronização completa <code>
        /api/sync
      </code>
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Compatibilidade otimizada para clientes oficiais
    </td>
  </tr>
  
  <tr>
    <td>
      Upload / download de anexos
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Cloudflare R2 ou KV
    </td>
  </tr>
  
  <tr>
    <td>
      Send (Enviar)
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Suporta envio de textos e de arquivos
    </td>
  </tr>
  
  <tr>
    <td>
      Importar / Exportar
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Suporta importação do BitWarden JSON / CSV / <strong>
        ZIP com anexos
      </strong>
      
      ​
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Central de Backup em Nuvem
      </strong>
      
      ​
    </td>
    
    <td>
      ❌
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      <strong>
        Backup agendado para WebDAV / E3
      </strong>
      
      ​
    </td>
  </tr>
  
  <tr>
    <td>
      Dica de senha (web)
    </td>
    
    <td>
      ⚠️ Limitado
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      <strong>
        Não exige e-mail
      </strong>
      
      ​
    </td>
  </tr>
  
  <tr>
    <td>
      TOTP / Steam TOTP
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Inclui suporte a <code>
        steam://
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Multiusuário
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Registro baseado em convite
    </td>
  </tr>
  
  <tr>
    <td>
      Organizações / Coleções / Papéis
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ❌
    </td>
    
    <td>
      Não implementado
    </td>
  </tr>
  
  <tr>
    <td>
      Login com 2FA
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ⚠️ Parcial
    </td>
    
    <td>
      Atualmente apenas TOTP em nível de usuário
    </td>
  </tr>
  
  <tr>
    <td>
      SSO / SCIM / Diretório corporativo
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ❌
    </td>
    
    <td>
      Não implementado
    </td>
  </tr>
</tbody>
</table>

## O que precisamos:

1. **Uma conta no GitHub**
2. **Uma conta na Cloudflare**​ (Gratuita) com o Cloudflare R2 Storage ativado.
3. _Opcional:_Um nome de domínio personalizado gerenciado na Cloudflare.

### Fase 1: Preparar o Código

1. Faça um _fork_do repositório do NodeWarden acessando [https://github.com/Tech-Voyage-Dev/nodewarden](https://github.com/Tech-Voyage-Dev/nodewarden) do repositório original [https://github.com/shuaiplus/nodewarden](https://github.com/shuaiplus/nodewarden) GitHub.<br />

![Fazendo um fork do repositório NodeWarden no GitHub](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/fork-nodewarden-repo.webp)
2. Ative o Workflow "Sync Upstream".<br />

![Ativando o fluxo de trabalho Sync Upstream no GitHub Actions](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/enable-sync-upstream.webp)

### Fase 2: Fazer o Deploy na Cloudflare

1. Crie uma aplicação Worker na Cloudflare.<br />

![Criando um novo aplicativo Worker no painel do Cloudflare](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/create-cloudflare-worker.webp)
2. Selecione 'Continue with GitHub' para fazer o deploy do app.<br />

![Implantando o aplicativo NodeWarden conectando ao GitHub](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/deploy-github-repo.webp)![Progresso de compilação e implantação do Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/cloudflare-deploy-status.webp)
3. 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.<br />

![Navegando para as configurações de domínio personalizado no Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/worker-settings-custom-domain.webp)![Adicionando um domínio personalizado ao Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/add-custom-domain.webp)

### Fase 3: Proteger Seu Servidor (O Segredo JWT)

1. Vá até o seu navegador de internet e insira o nome do seu domínio personalizado ou o domínio 'worker.dev' gerado.
2. Você receberá o aviso '**JWT_SECRET is missing'**.<br />

![Mensagem de erro JWT_SECRET is missing no servidor NodeWarden](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/jwt-secret-missing-error.webp)
3. 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**'.<br />

![Seção de Variáveis e Segredos nas configurações do Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/worker-variables-secrets.webp)![Adicionando o segredo JWT gerado às variáveis do Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/add-jwt-secret.webp)
4. Insira o segredo gerado e clique no botão '**Deploy / Save**'.

### Fase 4: Criar sua Conta de Administrador

1. Volte ao navegador web e recarregue a página; você verá a seguinte tela de login.<br />

![Página de login do servidor NodeWarden](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/nodewarden-login.webp)
2. Clique em '**Create Account**' para criar a conta de administrador.<br />

![Clicando no botão Create Account na página de login do NodeWarden](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/create-account-button.webp)
3. Faça login usando a conta admin recém-criada para acessar o Dashboard.<br />

![Visão geral do painel de administração do NodeWarden](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/nodewarden-dashboard.webp)
4. 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

1. Instale a extensão do BitWarden no Chrome.
2. Abra a extensão.
3. Clique no link ao lado de 'Accessing:' na parte inferior da janelinha popup.<br />

![Selecionando a opção auto-hospedado na extensão do Bitwarden para Chrome](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/bitwarden-extension-self-hosted.webp)
4. Insira o nome de domínio do servidor NodeWarden.<br />

![Inserindo a URL do servidor na extensão do Bitwarden para Chrome](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/bitwarden-extension-domain.webp)
5. Salve as configurações e faça o login com sua conta.

#### App para iOS

1. Instale o app do BitWarden através da App Store.
2. Abra o app e clique em '' ao lado de 'Logging in on:'.<br />

![Acessando as configurações de auto-hospedado no aplicativo Bitwarden para iOS](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/bitwarden-ios-self-hosted.webp)
3. Insira o nome de domínio do servidor NodeWarden e clique no botão '✓'.<br />

![Configurando a URL do servidor no aplicativo Bitwarden para iOS](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/bitwarden-ios-domain.webp)

### 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.<br />

![Configurando gatilhos Cron para backups automáticos do cofre no Cloudflare](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/cloudflare-worker-cron.webp)

# 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](/article/how-to-secure-nodewarden-at-cloudflare)

# Referências

- Guia Oficial de Início do NodeWarden