Índice do artigo
Para quem busca máxima flexibilidade e controle sobre seus fluxos de automação, hospedar o n8n auto-hospedado no Brasil em um servidor VPS é a solução ideal. Este guia detalhado apresentará o passo a passo para implantar o n8n em um ambiente Linux, cobrindo desde os requisitos de sistema até a configuração final, garantindo que você possa gerenciar suas integrações sem depender de serviços de terceiros. O n8n, com sua interface visual intuitiva, permite a conexão entre centenas de aplicações, e rodá-lo em um servidor n8n brasil dedicado assegura que seus dados permaneçam sob seu controle.
Veja a infraestrutura: migração de n8n para VPS no Brasil para colocar este projeto no ar.
O Que é n8n Auto-Hospedado e Por Que Usá-lo no Brasil?
O n8n é uma poderosa ferramenta de automação de fluxo de trabalho (workflow automation) que permite conectar diferentes aplicativos e serviços para automatizar tarefas repetitivas. Ao optar pelo n8n auto-hospedado, você instala e gerencia a aplicação em sua própria infraestrutura, seja um servidor dedicado ou um VPS. Isso difere do n8n Cloud, que é uma solução SaaS oferecida pelos desenvolvedores do n8n.
As vantagens de optar pelo auto-hospedado no Brasil incluem:
- Controle Total: Você tem controle completo sobre seus dados, configurações e a infraestrutura onde o n8n roda.
- Privacidade e Segurança: Seus fluxos de trabalho e dados sensíveis não saem do seu ambiente controlado, essencial para conformidade com leis de proteção de dados como a LGPD.
- Customização Avançada: Possibilidade de ajustar configurações, integrar com sistemas internos e otimizar o desempenho conforme a necessidade específica do seu negócio.
- Custo Potencialmente Menor: Para volumes maiores de uso, hospedar o n8n em um VPS pode ser mais econômico do que as assinaturas de planos pagos do n8n Cloud.
A escolha por um servidor n8n brasil significa também a possibilidade de ter menor latência para seus fluxos de trabalho, especialmente se a maioria dos seus serviços e usuários estiverem localizados no Brasil.
n8n Self-Hosted vs n8n Cloud: Qual Escolher?
A decisão entre n8n self-hosted e n8n cloud depende das suas prioridades. O n8n Cloud é mais fácil de começar, pois não exige configuração de servidor. No entanto, ele vem com limitações de uso (como número de execuções e nós) e os dados trafegam nos servidores da plataforma. O n8n auto-hospedado, por outro lado, exige uma configuração inicial e manutenção, mas oferece liberdade irrestrita de uso e total controle sobre os dados.
Para automações críticas, com dados sensíveis, ou que exigem alta performance e escalabilidade sem custos adicionais por execução, o auto-hospedado é superior. Para quem está começando ou tem necessidades de automação mais simples, o n8n Cloud pode ser um bom ponto de partida.
| Característica | n8n Self-Hosted | n8n Cloud |
|---|---|---|
| Instalação e Configuração | Requer setup em servidor próprio (VPS, Docker) | Acesso via navegador, sem setup inicial |
| Controle de Dados e Privacidade | Totalmente sob seu controle | Dados processados nos servidores da n8n |
| Custos de Infraestrutura | Custo do servidor (VPS) + manutenção | Assinatura mensal com limites de uso |
| Limites de Uso | Limitado apenas pelos recursos do seu servidor | Planos com limites de execuções, nós, etc. |
| Customização e Integração | Alta flexibilidade e integração com sistemas internos | Limitado às funcionalidades e integrações da plataforma |
| Manutenção e Atualizações | Responsabilidade do usuário | Gerenciado pela equipe n8n |
Quanto Custa Hospedar n8n no Brasil?
O custo de hospedar n8n em um servidor VPS no Brasil varia conforme os requisitos de hardware e a qualidade do provedor. Para uma instalação de produção que execute fluxos de trabalho complexos e com um bom volume de dados, recomendamos no mínimo:
- 4 GB de RAM: Essencial para rodar o n8n e seu banco de dados (geralmente PostgreSQL ou SQLite em produção) de forma estável. Para cargas mais pesadas, 8 GB ou mais podem ser necessários.
- 2-4 vCPUs: Para garantir que os fluxos de trabalho sejam processados eficientemente sem gargalos.
- 50 GB de Armazenamento SSD: Para o sistema operacional, o n8n, logs e o banco de dados. O crescimento do banco de dados pode exigir mais espaço ao longo do tempo.
Um plano VPS Brasil Básico, como o oferecido pela Host You Secure (R$ 99/mês, 4GB RAM, 4 vCPUs), atende perfeitamente a esses requisitos mínimos para a maioria dos casos de uso de n8n auto-hospedado brasil. Para cenários de alta demanda, planos com mais RAM e CPUs seriam mais adequados. O custo inicial é o do VPS; não há taxas adicionais por volume de execuções, como ocorre em planos na nuvem.
Passo a Passo: Implantando n8n em um VPS Linux (Ubuntu) com Docker
Utilizar Docker e Docker Compose é a maneira mais recomendada para implantar o n8n, pois simplifica o gerenciamento de dependências e a execução em diferentes ambientes. Este tutorial assume que você já tem um VPS com Ubuntu instalado e acesso SSH.
1. Instale o Docker e Docker Compose
Primeiro, atualize os pacotes do sistema e instale os pré-requisitos para o Docker:
sudo apt update
sudo apt install ca-certificates curl gnupg
# Adicionar a chave GPG oficial do Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod 644 /etc/apt/keyrings/docker.gpg
# Adicionar o repositório Docker
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
# Instalar o Docker Engine, CLI, Containerd e Docker Compose Plugin
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin
# Verificar a instalação
docker --version
docker compose version
Após a instalação, adicione seu usuário ao grupo `docker` para poder executar comandos sem `sudo`:
sudo usermod -aG docker $USER
newgrp docker
Verifique se o Docker Compose está funcionando corretamente com o comando `docker compose version`.
2. Crie o Arquivo Docker Compose para o n8n
Vamos criar um arquivo `docker-compose.yml` que definirá o serviço do n8n e, opcionalmente, um banco de dados PostgreSQL, que é recomendado para produção. Crie um diretório para o n8n e navegue até ele:
mkdir n8n-docker
cd n8n-docker
Agora, crie o arquivo `docker-compose.yml` com o seguinte conteúdo:
version: '3.8'
services:
n8n:
image: n8nio/n8n
container_name: n8n
restart: always
ports:
- '5678:5678'
environment:
- N8N_HOST=your_domain.com # Substitua pelo seu domínio ou IP público
- N8N_PROTOCOL=https # Se estiver usando um proxy reverso com SSL
- WEBHOOK_URL=https://your_domain.com/webhook/ # Substitua pelo seu domínio ou IP público
- GENERIC_TIMEZONE=America/Sao_Paulo # Defina seu fuso horário
- DB_TYPE=postgres # Ou sqlite se preferir, mas PostgreSQL é recomendado
- DB_POSTGRESDB_HOST=db # Se usar PostgreSQL
- DB_POSTGRESDB_DATABASE=n8n # Se usar PostgreSQL
- DB_POSTGRESDB_USER=n8n # Se usar PostgreSQL
- DB_POSTGRESDB_PASSWORD=n8n # Se usar PostgreSQL - TROQUE ESSA SENHA!
- DB_SQLITE_DATABASE=n8n.db # Se usar SQLite
volumes:
- n8n_data:/home/node/.n8n
depends_on:
- db # Se usar PostgreSQL
db:
image: postgres:13
container_name: n8n_db
restart: always
environment:
- POSTGRES_DB=n8n
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=n8n # TROQUE ESSA SENHA!
volumes:
- n8n_db_data:/var/lib/postgresql/data
volumes:
n8n_data:
n8n_db_data:
Importante: Substitua `your_domain.com` pelo seu domínio ou IP público. Se você não tem um domínio configurado, pode usar o IP do seu VPS para testes iniciais. **Altere as senhas `POSTGRESDB_PASSWORD` e `POSTGRES_PASSWORD`** para senhas fortes e únicas. Defina o `GENERIC_TIMEZONE` para o seu fuso horário local (ex: `America/Sao_Paulo`). Se você optou por SQLite, comente ou remova as linhas `depends_on`, `DB_POSTGRESDB_*` e o serviço `db`.
3. Execute o n8n
Com o arquivo `docker-compose.yml` configurado, execute os containers:
docker compose up -d
O comando `-d` executa os containers em segundo plano. Para ver os logs e verificar se tudo está funcionando:
docker compose logs -f n8n
Pressione `Ctrl+C` para sair dos logs. Se tudo correu bem, você pode acessar o n8n pelo navegador no endereço:
http://SEU_IP_DO_VPS:5678
Na primeira vez que acessar, você será guiado para criar sua conta de administrador.
4. Configuração de Proxy Reverso (Nginx) e SSL
Para um ambiente de produção seguro e acessível por um domínio, é altamente recomendado configurar um proxy reverso com Nginx e obter um certificado SSL (Let's Encrypt). Isso permitirá acessar o n8n via `https://seu_dominio.com` em vez de `http://SEU_IP_DO_VPS:5678`.
Instale o Nginx:
sudo apt install nginx
Crie um arquivo de configuração para o n8n em `/etc/nginx/sites-available/n8n`:
server {
listen 80;
server_name your_domain.com; # Substitua pelo seu domínio
location / {
proxy_pass http://localhost:5678;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# Redirecionar HTTP para HTTPS (após configurar SSL)
# location / {
# return 301 https://$host$request_uri;
# }
}
Ative o site e reinicie o Nginx:
sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo nginx -t # Testa a configuração
sudo systemctl restart nginx
Para obter o SSL com Let's Encrypt, você pode usar o Certbot. Certifique-se de que seu domínio aponta para o IP do seu VPS.
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your_domain.com # Substitua pelo seu domínio
O Certbot irá configurar o Nginx automaticamente para usar HTTPS e renovar o certificado. Lembre-se de atualizar as variáveis `N8N_HOST`, `N8N_PROTOCOL` e `WEBHOOK_URL` no seu arquivo `docker-compose.yml` para usarem seu domínio com `https` e rodar novamente `docker compose up -d`.
Requisitos de Servidor para Produção
Para rodar o n8n auto-hospedado de forma confiável em produção, os requisitos de hardware dependem do volume de automações e da complexidade dos seus fluxos de trabalho:
- RAM: Mínimo de 4 GB. Para ambientes com muitos fluxos paralelos, mais de 8 GB são recomendados. O n8n em si consome cerca de 500MB-1GB em repouso, mas pode disparar para 2GB+ sob carga pesada, dependendo dos nós utilizados. O banco de dados PostgreSQL também consome RAM.
- CPU: Mínimo de 2 vCPUs. Para cargas intensas de processamento de dados ou muitos fluxos simultâneos, 4 vCPUs ou mais garantirão melhor performance.
- Armazenamento: Mínimo de 50 GB de espaço em disco SSD. O banco de dados pode crescer significativamente com o tempo, especialmente se você mantiver um histórico extenso de execuções. É crucial ter espaço livre para logs e atualizações.
- Rede: Uma conexão estável é fundamental, especialmente para webhooks e integrações que dependem de comunicação em tempo real.
É vital monitorar o uso de recursos do seu servidor. Se você notar que o n8n ou o banco de dados estão consumindo muita memória, pode ser hora de considerar um upgrade de plano ou otimizar seus fluxos de trabalho. Se você ainda não configurou um monitoramento eficaz para sua infraestrutura, confira este guia sobre requisitos de VPS, que aborda pontos relevantes para qualquer aplicação rodando em servidor.
Erros Comuns e Soluções
Ao hospedar o n8n, alguns problemas podem surgir:
- Container não inicia: Verifique os logs com `docker compose logs`. Erros comuns incluem conflito de porta (outra aplicação usando a 5678), senhas incorretas no `.env` ou `docker-compose.yml`, ou problemas com permissões de volume.
- Conexão com o Banco de Dados falha: Certifique-se de que o serviço `db` esteja rodando e que as credenciais (`DB_POSTGRESDB_HOST`, `_DATABASE`, `_USER`, `_PASSWORD`) no `docker-compose.yml` do n8n correspondam às configurações do serviço `db`. Se o n8n e o banco estiverem em containers separados, o `DB_POSTGRESDB_HOST` deve ser o nome do serviço do banco (ex: `db`).
- Webhooks não funcionam: Verifique se o `WEBHOOK_URL` no `docker-compose.yml` está configurado corretamente com o IP público ou domínio e o protocolo `https` (se estiver usando proxy reverso). Certifique-se de que as portas 80 e 443 estejam abertas no firewall do seu VPS e que o Nginx esteja corretamente configurado para encaminhar as requisições.
- Desempenho Lento: Pode ser devido a recursos insuficientes no VPS (RAM, CPU), fluxos de trabalho mal otimizados (muitos nós complexos rodando simultaneamente), ou um banco de dados SQLite sobrecarregado. Considere usar PostgreSQL para produção e otimizar seus fluxos.
- Problemas de Permissão nos Volumes: Ao usar volumes, especialmente com SQLite, o n8n pode reclamar de permissões. Garantir que o usuário do container (geralmente `node` ou `root`) tenha acesso de escrita ao diretório montado é crucial. No caso do Docker, os volumes geralmente lidam com isso, mas em setups mais complexos pode exigir atenção.
Perguntas Relacionadas
O n8n gratuito é auto-hospedado?
Sim, a versão comunitária do n8n é open-source e pode ser auto-hospedada gratuitamente em seu próprio servidor. O que é pago é a versão n8n Cloud, que oferece a conveniência de não precisar gerenciar a infraestrutura.
Qual o melhor banco de dados para n8n auto-hospedado?
Para ambientes de produção, o PostgreSQL é altamente recomendado devido ao seu desempenho, confiabilidade e escalabilidade. SQLite é mais simples para testes e desenvolvimento, mas pode se tornar um gargalo em ambientes com alto volume de dados e execuções.
Posso rodar o n8n em um Raspberry Pi?
Tecnicamente, sim, mas um Raspberry Pi geralmente não possui recursos de RAM e CPU suficientes para rodar o n8n e seus fluxos de trabalho em produção de maneira estável. Ele é mais adequado para desenvolvimento ou automações muito simples.
Como atualizar o n8n auto-hospedado?
Com Docker, a atualização é relativamente simples. Pare os containers com `docker compose down`, atualize a tag da imagem no `docker-compose.yml` para a nova versão (ex: `image: n8nio/n8n:latest` ou uma tag específica), e suba os containers novamente com `docker compose up -d`. O Docker baixará a nova imagem e recriará os containers.
📦 Template n8n: Agente de IA com WhatsApp + Evolution API
Baixe o arquivo JSON pronto para importar: Webhook configurado, tratamento de remetente, nó de OpenAI e disparo via Evolution API.
FAQ: perguntas frequentes
O que é n8n auto-hospedado?
n8n auto-hospedado significa instalar e rodar o n8n em sua própria infraestrutura, como um servidor VPS ou dedicado. Isso oferece controle total sobre seus dados, maior segurança e flexibilidade para customizar o ambiente, diferentemente da versão n8n Cloud oferecida como SaaS.
Quais os requisitos mínimos de um VPS para rodar n8n em produção?
Para produção, recomendamos um VPS com no mínimo 4 GB de RAM, 2 a 4 vCPUs e 50 GB de armazenamento SSD. Esses recursos garantem que o n8n e seu banco de dados (preferencialmente PostgreSQL) funcionem de forma estável, mesmo sob carga moderada. Para automações mais intensas, mais recursos podem ser necessários.
Qual o custo aproximado de hospedar n8n no Brasil?
O custo principal é o do servidor VPS. Um plano básico com 4GB de RAM e 4 vCPUs no Brasil, como o VPS Brasil Básico da Host You Secure, custa R$ 99/mês. Este valor cobre a infraestrutura para rodar o n8n de forma eficiente, sem custos adicionais por execução ou nós, como em planos de nuvem.
É possível usar o n8n self-hosted com um domínio próprio?
Sim, é altamente recomendado. Ao usar um domínio próprio com um proxy reverso (como Nginx) e certificado SSL (Let's Encrypt), você garante que o n8n seja acessível de forma segura (HTTPS) e com uma URL amigável, além de facilitar a configuração de webhooks.
Por que usar n8n auto-hospedado em vez do n8n Cloud?
Você deve optar pelo auto-hospedado se precisa de controle total sobre seus dados e fluxos, segurança reforçada para informações sensíveis, customização avançada, ou se seu volume de execuções é muito alto e o custo do n8n Cloud se torna proibitivo. É ideal para quem busca soberania de dados.
Como configurar webhooks no n8n auto-hospedado?
Webhooks no n8n auto-hospedado geralmente requerem um proxy reverso (como Nginx) configurado para encaminhar requisições da porta 80/443 para a porta 5678 do container do n8n. A URL do webhook no seu fluxo deve corresponder ao seu domínio público configurado com HTTPS e o caminho correto (ex: `https://seu-dominio.com/webhook/` seguido pelo caminho definido no n8n).
Quais os benefícios de usar Docker para instalar o n8n?
Usar Docker e Docker Compose simplifica enormemente a instalação e o gerenciamento do n8n. Ele encapsula a aplicação e suas dependências, facilitando a implantação, garantindo consistência entre ambientes (desenvolvimento e produção) e simplificando atualizações e rollback.
O n8n auto-hospedado é gratuito?
A ferramenta n8n em si, em sua versão comunitária, é open-source e gratuita. O custo associado ao n8n auto-hospedado está na infraestrutura necessária para rodá-lo, como o aluguel de um servidor VPS ou dedicado, e a manutenção dessa infraestrutura.
Comentários (4)
Artigo muito bem escrito e explicativo! Já compartilhei com toda a equipe da empresa.
Excelente conteúdo! Aprendi conceitos que não encontrava em outros lugares em português.
Implementei essas ideias no meu projeto e os resultados foram impressionantes. Obrigado pelo conhecimento compartilhado!
Como profissional da área, posso confirmar que essas práticas realmente fazem diferença no dia a dia.