Zeladu
Kit digital · compatível com n8n · VPS + Docker
Kit Self-Host Seguro
Suas automações no seu servidor, com HTTPS configurado, backup testável e restauração com rollback testado. Arquivos de configuração e scripts, com guia em português, para instalar o n8n (imagens oficiais) na sua VPS com as proteções básicas que muitos tutoriais deixam de fora.
Checkout em breve: os links de compra pela Kiwify ainda estão sendo configurados.
O problema
Subir o n8n com Docker é rápido. Os problemas costumam aparecer depois:
- a tela de cadastro do administrador fica aberta para qualquer um;
- o backup nunca foi testado;
- a chave de criptografia se perde;
- uma atualização quebra a instância e não existe caminho de volta.
Como funciona
O que o kit inclui
- HTTPS configurado com Caddy para Let's Encrypt (emissão e renovação pelo Caddy). A emissão pública com Let's Encrypt não foi validada nos nossos testes; testamos com certificado local.
- Senha extra (basic auth) na frente do editor e da tela de cadastro. Webhooks e formulários continuam públicos.
- Banco e aplicação só na rede interna do Docker. Apenas as portas 80/443 do proxy ficam expostas.
- Código dos nós “Code” em container separado (task runners externos).
- Imagens fixadas por versão e digest: o servidor baixa exatamente as imagens testadas.
- Segredos gerados com
openssl, sem senhas padrão. - Script de backup com checksum, validação e rotação. Há interrupção da aplicação durante o backup; a duração varia conforme os dados. Você agenda a execução diária no
cron(o README mostra como). - Cópia externa criptografada opcional (
age+rclone), com conferência do envio e alerta se falhar. Testada só com destino local; destinos em nuvem não foram testados. - Teste de restauração não destrutivo (
testar-backup.sh). - Restauração que valida antes de trocar, com rollback compensatório na troca. Interrupções que matam o próprio script (queda de energia,
kill -9) exigem o procedimento manual do README. - Atualização com backup prévio e tentativa de reversão: se a verificação de saúde falhar, volta a versão e restaura banco e dados.
- Trava entre operações: backup, restauração e atualização nunca rodam ao mesmo tempo.
- Pré-voo e testes rápidos pós-instalação, além de um checklist de segurança (com orientação de firewall de saída e de monitoramento).
O que vem no kit
| Item | Descrição |
|---|---|
docker-compose.yml | Postgres 17 + aplicação + task runners + Caddy, versões fixas, limites de recursos e rede interna |
Caddyfile | HTTPS, cabeçalhos de segurança, limite de requisição e basic auth no editor |
.env.example + gerar-env.sh | Configuração sem segredos embutidos; gera chaves com openssl |
verificar.sh / testar-instalacao.sh | Pré-voo e testes rápidos após subir |
backup.sh / testar-backup.sh / restaurar.sh | Backup consistente, teste de restauração e restauração com validação prévia |
atualizar.sh | Atualização com backup prévio e tentativa de reversão |
trocar-senha-editor.sh | Troca a senha do basic auth |
CHECKLIST-SEGURANCA.md | O que conferir antes e depois de colocar no ar |
README.md | Guia passo a passo em português |
LICENSE.md | Licença de uso do kit |
O que NÃO inclui
- O software n8n: as imagens oficiais são baixadas por você das fontes oficiais.
- Servidor, domínio ou qualquer custo de provedor.
- Instalação feita por nós, migração de uma instalação existente, alta disponibilidade, cluster ou modo fila.
- Recuperação de desastres garantida.
Para quem é
- Pequenos negócios e freelancers que querem automações internas no próprio servidor.
- Quem já instalou por conta própria e quer revisar a instalação com HTTPS, backup e atualização.
- Quem tem noção básica de terminal e SSH.
Para quem NÃO é
- Quem não quer usar terminal: um serviço gerenciado (como a nuvem oficial) tende a ser melhor.
- Quem precisa de alta disponibilidade, cluster ou modo fila. O kit é para uma instância.
- Quem quer oferecer o n8n como serviço para clientes criarem os próprios workflows: a licença do n8n não permite isso.
Requisitos (não incluídos)
- Um servidor Linux com Docker Engine e Compose v2, portas 80/443 liberadas.
- Um domínio ou subdomínio apontado para o servidor.
- O kit vem configurado para 2 GB de RAM (perfil testado com os containers limitados a 2 GB num servidor de testes, e não numa VPS de 2 GB real) e traz um perfil para 4 GB ou mais, recomendado para cargas maiores. Workflows pesados podem exigir mais memória.
- Saber usar terminal e SSH. O tempo de instalação varia com a sua experiência e com a propagação do DNS.
Limites que você precisa conhecer
- Não é recuperação de desastres. O kit ajuda a fazer e testar backups, mas não garante recuperar o serviço se o servidor for perdido. Teste a restauração periodicamente em um servidor separado.
- Backups locais não são criptografados. Só a cópia externa opcional é. Guarde a chave de criptografia do n8n fora do servidor.
- Checksums detectam corrupção acidental, não adulteração maliciosa.
- A reversão automática da atualização cobre falhas em que a aplicação não sobe; não detecta workflow que passou a se comportar diferente, e dados gravados depois do backup prévio se perdem na reversão.
- Webhooks recebidos durante o backup falham. Agende para um horário de pouco movimento.
- A proteção contra SSRF do n8n cobre requisições HTTP, não nós de banco de dados e outros protocolos. Só dê acesso de edição a pessoas de confiança.
- O kit reduz riscos comuns, mas não torna o servidor invulnerável. A operação do servidor e dos dados (inclusive LGPD) é de quem instala.
O que foi testado (e o que não foi)
Servidor de testes Debian 13 com Docker 26.1.5; n8n 2.45.3 e 2.45.4; Postgres 16 e 17; Caddy 2.11.7. Cobertura: instalação limpa, senha do editor (sem vazar na lista de processos), webhooks, backup e cópia criptografada (destino local), restauração com arquivos corrompidos e falhas provocadas em cada etapa da troca, atualização com falha simulada e reversão do banco, operações simultâneas (a segunda é recusada) e carga com 2 GB de RAM sem swap.
Como não havia domínio público, o HTTPS foi testado com certificado local.
Não foram testados: certificado Let's Encrypt real, VPS de provedores comerciais, Ubuntu e outras distribuições, destinos de nuvem do rclone (S3, B2, Drive etc.), 2FA, atualizações entre versões maiores, encerramento por falta de memória (OOM) e uso prolongado.
Pagamento único
R$ 29
Arquivos para download · licença para 1 empresa · 12 meses de atualizações · suporte por e-mail por 90 dias
Checkout em breve: os links de compra pela Kiwify ainda estão sendo configurados.
Pagamento e entrega pela Kiwify. 7 dias para desistir, com reembolso integral (art. 49 do CDC).
Como comprar
- Clique em “Comprar” e você vai para o checkout da Kiwify.
- Pague com um dos meios de pagamento exibidos pela Kiwify.
- Receba o acesso aos arquivos no e-mail da compra.
- Siga o README, começando pelo pré-voo (
verificar.sh).
Perguntas frequentes
O kit inclui o software n8n?
Não. O kit traz arquivos de configuração e scripts. As imagens oficiais são baixadas por você das fontes oficiais. O uso do n8n segue a licença do próprio n8n (Sustainable Use License), que não é uma licença open source irrestrita.
Vocês são da equipe do n8n?
Não. Somos independentes, sem afiliação, patrocínio ou endosso da n8n GmbH. Citamos o nome apenas para indicar compatibilidade.
Funciona em qual provedor?
O guia foi escrito para Ubuntu/Debian com Docker e portas 80/443 liberadas. Testamos apenas em Debian 13. Outros provedores e distribuições devem funcionar se tiverem Docker Engine e Compose v2, mas não foram testados.
Já tenho uma instalação rodando. Serve para mim?
Serve como referência para revisar sua configuração. Migrar uma instalação existente exige cuidado (especialmente com a chave de criptografia), e o README não cobre migração.
Preciso de domínio?
Sim. O HTTPS do kit depende de um domínio apontado para o servidor (a emissão pública não foi validada nos nossos testes).
Posso usar para instalar para meus clientes?
O kit é vendido para uso no seu próprio servidor. Dependendo do caso, instalar para terceiros pode ser considerado hospedagem do n8n como serviço, o que a Sustainable Use License restringe. Antes de usar o kit para terceiros, confirme o seu caso diretamente com a n8n (license@n8n.io).
Tem suporte?
Sim, pelo e-mail contato@zeladu.com, com resposta em até 2 dias úteis, durante 90 dias após a compra, para dúvidas sobre os arquivos e o guia do kit.
Recebo atualizações do kit?
Sim, por 12 meses após a compra, com aviso por e-mail.
E se não gostar?
Você pode desistir em até 7 dias e receber o valor integral de volta, sem precisar justificar (art. 49 do CDC). Esse prazo não limita outros direitos do CDC. Escreva para contato@zeladu.com ou use a própria Kiwify; a devolução é feita em até 7 dias após a confirmação, pelo mesmo meio de pagamento.
Sem afiliação: produto independente, não afiliado, patrocinado ou endossado pela n8n GmbH. “n8n” é marca de seus titulares, usada apenas de forma descritiva (“compatível com n8n”).
Conteúdo produzido com assistência de IA: este kit e esta página foram produzidos com assistência de inteligência artificial e revisados antes da publicação.
Sem garantia de segurança absoluta: o kit reduz riscos comuns; a operação do servidor e dos dados é de responsabilidade de quem instala. Seus direitos de consumidor (CDC) não são afetados.