O que este guia cobre
O PassZit é um gerenciador de senhas gratuito e de código aberto (AGPLv3) que roda no seu próprio servidor. Cada usuário tem um cofre com criptografia de ponta a ponta para logins, códigos de uso único, notas seguras, cartões, chaves SSH e arquivos; as equipes compartilham cofres com permissões por pessoa. O servidor guarda apenas texto cifrado. Se você está comparando ferramentas porque pesquisou uma alternativa auto-hospedada ao Bitwarden, este guia mostra como são, na prática, a instalação e a implantação do PassZit.
- O que você precisa
- Instalar o servidor
- Primeiro acesso e primeiro administrador
- Um certificado em que os navegadores confiem
- Convidar a sua equipe
- Senha mestra e chave de recuperação
- Instalar a extensão do navegador
- Importar senhas de outro programa
- Como funciona a criptografia
- Backup do servidor
- Atualizações
- Limites que convém conhecer
- Próximos passos
O que você precisa
- Uma máquina virtual no VMware, VirtualBox, Proxmox VE/KVM ou Hyper-V, ou um servidor físico, com 2 vCPU, 2 GB de RAM e um disco de 16 GB — ou um servidor de 64 bits existente com Debian 12+, Ubuntu 22.04+, AlmaLinux ou Rocky Linux 9+ (x86-64 ou ARM64).
- Os navegadores acessam o servidor pela porta TCP 8443. O PostgreSQL é configurado pelo script de instalação e pelas imagens.
- Para as extensões do navegador: um nome DNS para o servidor e um certificado em que os navegadores confiem (veja abaixo).
- Opcionalmente, um servidor SMTP, para que o PassZit envie convites e avisos por e-mail.
Instalar o servidor
Há quatro formas; todas estão na página de download, e cada versão é assinada.
| Forma | Ideal para |
|---|---|
| Imagem de VM: OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V geração 1) | Importar, iniciar, entrar — Debian, PostgreSQL e PassZit prontos |
| ISO do appliance | Uma VM nova ou um servidor físico; a instalação automática apaga o primeiro disco |
| Script de instalação | Um servidor Debian, Ubuntu, AlmaLinux ou Rocky Linux existente |
| Pacotes (deb, rpm; amd64, arm64) | Seu próprio PostgreSQL e gerenciamento de configuração |
Imagem de VM ou ISO: inicie a VM. A tela dela mostra o endereço do console e o token de configuração. No console da VM você pode entrar como pzadmin (primeira senha passzit, trocada no primeiro acesso): um menu configura a rede, o nome do servidor e o fuso horário, mostra o token de novo e restaura backups. Só as portas 22 (SSH) e 8443 ficam abertas.
Script de instalação: como root no servidor:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
O script instala o PostgreSQL, baixa a versão mais recente, verifica a assinatura dela, cria um banco de dados com senha aleatória, inicia o serviço e mostra o endereço e o token de configuração. Opções como --version, --db (um banco PostgreSQL existente) ou --no-auto-updates são passadas com sh -s --.
Pacotes: instale o deb ou o rpm, defina PASSZIT_DB em /etc/passzit/server.env e execute systemctl start passzit-server. O token de configuração fica em /var/lib/passzit/setup-token.txt.
Primeiro acesso e primeiro administrador
- Abra
https://<servidor>:8443. Um servidor novo usa um certificado autoassinado; o navegador avisa uma vez — aceite. - Digite o Token de configuração, seu endereço de e-mail e uma senha mestra. O navegador cria agora as suas chaves; leva um segundo. Esta primeira conta é o administrador.
- Escaneie o QR code com um aplicativo autenticador (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). O login em dois fatores é obrigatório para todas as contas. Guarde os dez códigos de recuperação; cada um substitui o aplicativo uma vez.
- Crie uma chave de recuperação (veja abaixo) e adicione o primeiro login com Novo item.
Mais tarde, em A minha conta, você pode adicionar chaves de segurança (YubiKey e outras) ou uma passkey do seu dispositivo como segundo fator.
Um certificado em que os navegadores confiem
As extensões do navegador recusam certificados autoassinados, então dê ao servidor um certificado de verdade antes de distribuir a extensão. Em Definições → Certificado, envie um certificado (da CA da sua empresa ou comprado; PEM com os certificados intermediários e a chave privada) ou escolha Let's Encrypt. O Let’s Encrypt precisa de um nome DNS público e o verifica pela porta 80 do servidor ou por um registro DNS na Cloudflare — a segunda opção também funciona para um servidor acessível só dentro da sua rede. O certificado passa a valer na hora, sem reiniciar; o DNS da sua rede precisa apontar o nome para o servidor.
Convidar a sua equipe
Contas só são criadas por convite. Em Utilizadores → Convidar um utilizador, informe o endereço de e-mail e a função (Utilizador ou Administrador). O PassZit mostra o link do convite uma única vez; envie-o à pessoa. O link funciona uma vez e por 7 dias por padrão. Se você configurou um servidor SMTP em Definições → E-mail, marque Enviar também o convite por e-mail e o PassZit envia por você.
A pessoa convidada escolhe uma senha mestra e configura o login em dois fatores, como você. Administradores podem desativar usuários, redefinir um segundo fator perdido e retirar convites abertos. Para compartilhar senhas, crie um cofre compartilhado e dê acesso a pessoas ou grupos.
As contas da empresa são conectadas em Definições → Início de sessão da empresa: login único com OpenID Connect ou SAML 2.0, e Active Directory / LDAP. A senha mestra continua sempre, porque é a chave do cofre.
Senha mestra e chave de recuperação
A senha mestra nunca sai do navegador do usuário. Esse é o sentido da criptografia de ponta a ponta, e tem uma consequência: ninguém — nem o administrador, nem a MaxZit — consegue abrir um cofre sem a senha mestra ou a chave de recuperação. Administradores não podem ver nem redefinir senhas mestras.
- Uma frase-senha de quatro a seis palavras aleatórias é fácil de lembrar e difícil de adivinhar. A política do cofre define um comprimento mínimo (12 caracteres por padrão).
- Em A minha conta, Criar uma chave de recuperação mostra uma chave de 32 letras e dígitos, uma única vez. Imprima ou anote e guarde offline — não no cofre e não ao lado do celular.
- Com a chave de recuperação e um código do aplicativo autenticador, um usuário que esqueceu a senha mestra define uma nova na página de login. Sem chave de recuperação o cofre está perdido; o administrador só pode excluir a conta e convidar a pessoa de novo, com um cofre vazio. A lista de usuários mostra quem já criou uma chave de recuperação.
Peça a todos que criem a chave de recuperação no primeiro dia.
Instalar a extensão do navegador
A extensão preenche logins e códigos de uso único só no site a que pertencem, oferece salvar logins novos e alterados, preenche cartões e endereços em formulários de pagamento e entrega e gera senhas. Instale-a pela loja do seu navegador, que a mantém atualizada:
- Chrome Web Store — Chrome, Brave, Opera e Vivaldi
- Firefox Add-ons — Firefox 128 ou mais recente
- Microsoft Edge Add-ons — Microsoft Edge
Os links estão na página de download. O servidor PassZit oferece o mesmo: Extensões do navegador no menu do cofre web mostra Instalar com um clique com a loja do navegador que você usa, além dos pacotes da versão dele para instalação manual.
- Clique no ícone do PassZit, digite só o endereço do seu servidor (por exemplo
https://vault.example.com) e clique em Ligar com o cofre web. Permita que o navegador deixe o PassZit se comunicar com esse servidor. Uma porta no endereço, como:8443, funciona em todos os navegadores, inclusive no Firefox. - O cofre web abre; entre nele se ainda não tiver entrado.
- O cofre pergunta se deve conectar a extensão neste navegador — clique em Ligar. Nenhuma senha ou código é digitado na extensão.
O cofre web e a extensão compartilham um único desbloqueio: desbloqueie um e o outro abre também; bloqueie um e os dois bloqueiam.
Importar senhas de outro programa
Cada usuário importa para o próprio cofre. Exporte primeiro do programa antigo e depois escolha Ferramentas → Importar no cofre e o arquivo. O PassZit reconhece o formato, mostra quantos itens e pastas encontrou e quantos já estão no cofre, e permite manter as pastas do arquivo e pular duplicados.
| De | Exportar lá |
|---|---|
| Chrome, Edge, Brave, Opera, Vivaldi | Password manager → Settings → Export passwords (CSV) |
| Firefox | about:logins → … → Export passwords (CSV) |
| Safari | File → Export → Passwords (CSV) |
| Bitwarden | Tools → Export vault → .json ou .csv, não a variante criptografada |
| KeePass 2 / KeePassXC | KeePass XML (2.x) / CSV ou XML |
| 1Password | File → Export → CSV |
| LastPass | Advanced options → Export (CSV) |
O arquivo é lido no navegador; o servidor recebe os itens apenas criptografados. São transferidos logins, notas, sites, campos próprios, pastas, favoritos e segredos TOTP (do Bitwarden também cartões, identidades e chaves SSH). Arquivos anexados não fazem parte dessas exportações. Exclua o arquivo exportado depois — ele contém as senhas sem criptografia.
Como funciona a criptografia
O navegador deriva uma chave mestra da senha mestra com Argon2id (64 MiB, 3 passagens). Dela saem duas chaves: uma chave de autenticação enviada no login — o servidor guarda só um hash argon2id dela — e uma chave de envelope que desbloqueia a chave de conta aleatória do usuário. Cada item, inclusive nome, usuário, sites e notas, é criptografado com AES-256-GCM sob a chave do seu cofre; cofres compartilhados têm chave própria, selada para a chave X25519 de cada membro. O servidor vê texto cifrado, identificadores, tamanhos e horários, nunca a senha mestra nem uma chave que pudesse usar. Os detalhes estão na página de segurança e em docs/ARCHITECTURE.md do repositório.
Backup do servidor
Definições → Backup da consola grava todos os dias (e sob demanda com Fazer backup agora) um backup em /var/lib/passzit/backups: o banco de dados com todos os cofres, a chave secreta do servidor e o certificado do console — tudo de que um servidor novo precisa. Um backup é sempre criptografado com uma frase-senha que você define; guarde-a em outro lugar. Cada backup também pode ser copiado para uma pasta SFTP em outro servidor. Para restaurar, use o menu do appliance, ou pare o serviço e execute passzit-server -restore como descreve o guia integrado ao console.
Atualizações
Definições → Atualizações e servidor mostra a versão em execução e a mais recente. A instalação verifica a assinatura de novo, faz backup do banco de dados e do programa, instala a atualização e confere se o servidor volta — se não voltar, ela mesma restaura a versão anterior e o banco. Ali também se ativa a instalação automática em um horário escolhido. O canal Estável recebe as versões; Testing oferece também versões candidatas, para um servidor de teste. Em uma instalação por script, executar o instalador de novo também atualiza o PassZit e mantém todos os dados.
Limites que convém conhecer
- O PassZit está em desenvolvimento ativo: a primeira versão pública foi a 0.9.0, em novembro de 2026, e novas versões saem com frequência.
- Não há aplicativo móvel nativo. No celular, o cofre web pode ser adicionado à tela inicial e abre na própria janela, mas nada é guardado para uso offline — sem o servidor você vê uma página “offline”.
- Uma senha mestra esquecida sem chave de recuperação não pode ser recuperada por ninguém.
- As extensões do navegador precisam de um certificado confiável e entram com a senha mestra e o código do autenticador — não com login único.
- Como em todo cofre web, o JavaScript dele vem do servidor; um servidor totalmente comprometido poderia entregar código alterado. A extensão traz o próprio código.
- Não há imagem Docker; instale com uma imagem, o script ou os pacotes. O guia integrado ao console está em inglês e sérvio.
Próximos passos
Baixe o PassZit, veja todos os recursos — cofres compartilhados, links secretos, acesso de emergência, conexões remotas, a linha de comando — ou leia o guia integrado ao console (documentação). Como configurar cofres compartilhados para uma equipe está no guia Compartilhar senhas com a equipe. Perguntas são bem-vindas no GitHub Discussions. Empresas podem contratar suporte comercial da MaxZit (somente em inglês).