Índice do artigo
Como Implantar n8n-evolution-combo em um VPS Linux
Este guia prático é focado em como você pode implantar e configurar o n8n-evolution-combo em seu próprio ambiente de servidor VPS Linux. Assumimos que você já decidiu utilizar essa ferramenta poderosa para suas necessidades de automação, e agora busca o caminho para colocá-la em funcionamento de maneira confiável e eficiente. O n8n-evolution-combo, quando rodando em seu próprio servidor, oferece controle total sobre seus dados e fluxos de trabalho, além de ser a base ideal para integrar o n8n com a Evolution API para automação de WhatsApp robusta. Para uma operação em produção estável, o requisito mínimo de servidor é de 4GB de RAM e 2 vCPUs, com espaço de armazenamento suficiente para o sistema operacional, logs, backups e o próprio container da aplicação. Este tutorial irá guiá-lo através dos passos essenciais para garantir uma implantação bem-sucedida.
Veja a infraestrutura: VPS para n8n + Evolution API para colocar este projeto no ar.
Requisitos de Sistema para Produção
Para garantir que seu n8n-evolution-combo funcione sem interrupções e com bom desempenho em um ambiente de produção, é crucial atender aos requisitos mínimos de hardware. Em minha experiência, rodar a aplicação principal do n8n, juntamente com um banco de dados e um proxy reverso em um único servidor, exige recursos consideráveis. Para uma instância que gerenciará fluxos de trabalho complexos e um volume considerável de requisições, especialmente com a Evolution API integrada para automação de WhatsApp, recomendamos:
- Memória RAM: Mínimo de 4GB. Para um desempenho otimizado e para acomodar picos de tráfego ou processos mais pesados, 8GB de RAM é o ideal. Isso garante que o n8n, o banco de dados (se incluído no combo) e o proxy reverso operem sem conflitos de memória. Ao rodar o n8n com a Evolution API e um banco de dados como PostgreSQL, o consumo de RAM pode facilmente ultrapassar 2GB em momentos de alta carga, tornando os 4GB o mínimo absoluto e 8GB uma recomendação sólida para evitar lentidão ou travamentos.
- vCPUs: Mínimo de 2 vCPUs. Para cargas de trabalho mais intensas, 4 vCPUs proporcionarão uma experiência mais fluida. Processos de larga escala, como envio de múltiplos contatos simultaneamente ou operações complexas de processamento de dados, podem saturar 2 vCPUs rapidamente.
- Armazenamento: Pelo menos 20GB de espaço em disco. Isso deve ser suficiente para o sistema operacional, Docker, os containers, logs e backups. Recomenda-se SSD para melhor performance. No entanto, considere que logs de longa duração, backups frequentes e o próprio banco de dados (se hospedado localmente) podem consumir espaço rapidamente. Para um ambiente de produção com retenção de logs e backups por um período razoável, 50GB a 100GB em um SSD pode ser mais prudente.
- Sistema Operacional: Uma distribuição Linux atualizada como Ubuntu 22.04 LTS ou superior é altamente recomendada. Certifique-se de que seu sistema esteja atualizado com os últimos pacotes de segurança e kernel.
É importante notar que estes são requisitos para a stack completa, incluindo o n8n, banco de dados e proxy. Se você planeja executar apenas o n8n, os requisitos podem ser ligeiramente menores, mas para o combo completo, é prudente superdimensionar um pouco para evitar problemas futuros. Se você ainda não tem um servidor configurado, o VPS Brasil Básico da Host You Secure, com seus 4GB de RAM e 4 vCPUs, é um excelente ponto de partida para rodar essa configuração em produção.
Passo a Passo: Implantação com Docker Compose
A maneira mais recomendada e eficiente de implantar o n8n-evolution-combo é utilizando Docker e Docker Compose. Isso encapsula a aplicação e suas dependências, facilitando a instalação, gerenciamento e atualizações. Abaixo, apresentamos um tutorial detalhado para configurar sua instância em um servidor Ubuntu.
1. Pré-requisitos: Instalar Docker e Docker Compose
Antes de iniciar a implantação do n8n-evolution-combo, certifique-se de que o Docker e o Docker Compose estejam instalados em seu servidor VPS. Se você já tem o Docker instalado, pode verificar a instalação do plugin do Docker Compose com o comando:
docker compose version
Se o comando não for encontrado, você pode instalar o Docker e o plugin do Docker Compose seguindo as instruções oficiais da Docker ou usando o script de instalação:
# Instalar Docker (se ainda não estiver instalado)
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# Adicionar usuário ao grupo docker para evitar usar sudo em comandos docker
sudo usermod -aG docker $USER
newgrp docker # Aplica as mudanças do grupo imediatamente
# Instalar o plugin do Docker Compose (recomendado)
sudo apt update
sudo apt install docker-compose-plugin -y
# Verificar a instalação
docker compose version
A adição do seu usuário ao grupo `docker` é uma etapa importante para conveniência, permitindo que você execute comandos Docker sem precisar de `sudo` o tempo todo. Após executar `newgrp docker`, você pode testar se o comando `docker ps` funciona sem `sudo`.
2. Criando o Arquivo `docker-compose.yml`
Crie um diretório para os arquivos de configuração do n8n e, dentro dele, um arquivo chamado docker-compose.yml. Este arquivo definirá os serviços necessários para rodar o n8n e a Evolution API. Abaixo, apresentamos um exemplo de arquivo docker-compose.yml. É crucial que você ajuste as variáveis de ambiente conforme suas necessidades, especialmente as credenciais e URLs.
version: '3.8'
services:
n8n:
image: n8nio/n8n:latest # Utilize a tag 'latest' ou uma versão específica
container_name: n8n
restart: always
ports:
- "5678:5678"
environment:
- N8N_HOST=n8n.seudominio.com # Substitua pelo seu domínio ou IP público
- N8N_PORT=5678
- N8N_PROTOCOL=https # Se usar HTTPS com um proxy reverso, caso contrário 'http'
- NODE_ENV=production
- WEBHOOKS_TUNNEL_URL=https://n8n.seudominio.com # Ou o URL do seu túnel se você não estiver usando um proxy reverso
- EDITOR_WIDTH=1500
- EDITOR_HEIGHT=1000
- GENERIC_TIMEZONE=America/Sao_Paulo
# Credenciais do banco de dados externo (ex: PostgreSQL)
# - DB_TYPE=postgres
# - DB_HOST=db.seu-provedor.com # Exemplo: seu-bd-externo.rds.amazonaws.com
# - DB_PORT=5432
# - DB_USER=n8n_user
# - DB_PASSWORD=senha_super_segura
# - DB_DATABASE=n8n_db
# Se o banco de dados estiver rodando no mesmo docker-compose, use o nome do serviço 'db'
# - DB_HOST=db
# - DB_USER=n8n
# - DB_PASSWORD=n8n
# - DB_DATABASE=n8n
volumes:
- n8n_data:/home/node/.n8n
networks:
- n8n_network
# Banco de dados PostgreSQL para n8n (opcional, se não usar um externo)
db:
image: postgres:15 # Use uma versão LTS do PostgreSQL
container_name: n8n_db
restart: always
environment:
POSTGRES_DB: n8n
POSTGRES_USER: n8n
POSTGRES_PASSWORD: sua_senha_segura_para_db # Mude esta senha para algo robusto!
volumes:
- n8n_db_data:/var/lib/postgresql/data
networks:
- n8n_network
healthcheck:
test: ["CMD-SHELL", "pg_isready -U n8n"]
interval: 10s
timeout: 5s
retries: 5
# Serviço para Evolution API (exemplo)
evolution_api:
image: revolut/evolution-api:latest # Verifique a imagem mais recente e recomendada
container_name: evolution_api
restart: always
ports:
- "5000:5000" # Porta padrão da Evolution API
environment:
- NODE_ENV=production
- PORT=5000
- WEBHOOK_URL=https://evolution.seudominio.com/webhook # URL público para receber webhooks
- JWT_SECRET=sua_jwt_secreta_muito_longa_aqui # Mude esta chave para algo complexo e aleatório!
# Configurações do banco de dados para Evolution API (se necessário e diferente do n8n)
# - DB_TYPE=postgres
# - DB_HOST=db_evolution # Se for um serviço de banco de dados separado para Evolution API
# - DB_PORT=5432
# - DB_USER=evo_user
# - DB_PASSWORD=senha_evo
# - DB_DATABASE=evolution_db
volumes:
- evolution_api_data:/app/data # Volume para persistir dados da Evolution API
networks:
- n8n_network
depends_on: # Garante que o banco de dados (se necessário) inicie antes
db:
condition: service_healthy
volumes:
n8n_data:
n8n_db_data:
evolution_api_data:
networks:
n8n_network:
driver: bridge
Detalhamento do `docker-compose.yml`:
- `image: n8nio/n8n:latest`: Especifica a imagem oficial do n8n a ser utilizada. É recomendado fixar uma versão específica em produção (ex: `n8nio/n8n:1.30.0`) para evitar que atualizações automáticas causem quebras inesperadas.
- `container_name: n8n`: Define um nome fixo para o container, facilitando a identificação e o gerenciamento.
- `restart: always`: Garante que o container seja reiniciado automaticamente se ele falhar ou se o servidor reiniciar.
- `ports: - "5678:5678"`: Mapeia a porta 5678 do host para a porta 5678 do container. Esta é a porta padrão do n8n.
- Variáveis de Ambiente (`environment`):
- `N8N_HOST`: O domínio ou endereço IP público que será usado para acessar o n8n. Essencial para o funcionamento correto dos webhooks e links internos.
- `N8N_PROTOCOL`: Defina como `https` se você configurar um proxy reverso (como Nginx) para servir n8n via HTTPS. Se você acessar diretamente via HTTP, use `http`.
- `WEBHOOKS_TUNNEL_URL`: O URL público que o n8n usará para se comunicar com serviços externos que precisam ser chamados de volta (como o próprio Evolution API).
- `GENERIC_TIMEZONE`: Define o fuso horário para os logs e agendamentos.
- Credenciais do Banco de Dados: Se você optar por usar um banco de dados externo (recomendado para produção), descomente e configure essas variáveis. Se estiver usando o serviço `db` definido no mesmo `docker-compose.yml`, use `DB_HOST: db`.
- `volumes`: Essenciais para persistir os dados do n8n (fluxos, configurações, credenciais) e do banco de dados. Sem volumes, os dados seriam perdidos ao recriar os containers. O volume `n8n_data` mapeia `/home/node/.n8n` dentro do container para um volume Docker nomeado.
- `networks`: Define uma rede Docker personalizada para que os containers possam se comunicar entre si usando seus nomes de serviço (ex: `db`).
- Serviço `db` (PostgreSQL):
- `image: postgres:15`: Utiliza a imagem oficial do PostgreSQL. É importante usar uma versão estável e LTS.
- `healthcheck`: Um teste de saúde para garantir que o PostgreSQL esteja pronto antes de outros serviços que dependem dele (como Evolution API) tentarem se conectar.
- Serviço `evolution_api`:
- `image: revolut/evolution-api:latest`: Imagem da Evolution API. Verifique a documentação oficial para a tag mais recente e recomendada.
- `ports: - "5000:5000"`: Mapeia a porta 5000 do host para a porta 5000 do container, que é a porta padrão da Evolution API.
- `JWT_SECRET`: Uma chave secreta para autenticação. **É crucial gerar uma chave longa e aleatória para este campo.**
- `WEBHOOK_URL`: O URL público onde a Evolution API receberá os webhooks do WhatsApp.
- `depends_on`: Garante que o serviço `db` esteja `healthy` antes de iniciar a `evolution_api`.
Nota: O arquivo acima está configurado para rodar n8n e um banco de dados PostgreSQL localmente, além de um exemplo de serviço para Evolution API. Se você pretende integrar a Evolution API, precisará descomentar e configurar o serviço correspondente, ajustando a imagem, portas e variáveis de ambiente. Para a maioria dos cenários de automação robusta de WhatsApp com n8n, a Evolution API é um componente chave. Se você já configurou a Evolution API em outro momento, pode referenciar um banco de dados compartilhado ou rodar os serviços em redes Docker separadas, dependendo da sua arquitetura. Para mais detalhes sobre a configuração específica da Evolution API, você pode consultar nosso guia sobre N8N e Evolution API: Automação WhatsApp Robusta em Seu VPS.
3. Executando o Docker Compose
Navegue até o diretório onde você salvou o arquivo docker-compose.yml e execute o seguinte comando para iniciar os containers em segundo plano:
docker compose up -d
Este comando fará o download das imagens necessárias (se ainda não existirem localmente) e iniciará os serviços definidos no arquivo docker-compose.yml. O sinalizador -d significa
Requisitos de Servidor para n8n-evolution-combo em Produção
| Componente | Requisito Mínimo (Produção) | Recomendado (Otimizado) | Observações |
|---|---|---|---|
| Memória RAM | 4GB | 8GB+ | Essencial para estabilidade e picos de tráfego, especialmente com Evolution API. |
| vCPUs | 2 | 4+ | Impacta diretamente a velocidade de processamento dos fluxos. |
| Armazenamento | 20GB SSD | 50GB+ SSD | Para SO, Docker, containers, logs e backups. SSD é crucial para performance. |
| Sistema Operacional | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS | Distribuições Linux recentes e estáveis. |
| Segurança | Configuração básica de firewall | Proxy reverso com HTTPS, Firewall configurado | Crucial para proteger dados e webhooks. |
📦 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
Quais são os requisitos mínimos de RAM para rodar o n8n-evolution-combo em produção?
Para uma operação estável em produção, recomendamos um mínimo de 4GB de RAM. No entanto, para um desempenho otimizado, especialmente ao integrar com a Evolution API e gerenciar fluxos de trabalho complexos, 8GB de RAM é o ideal. Isso garante que todos os componentes da sua stack (n8n, banco de dados, proxy) funcionem sem conflitos de memória e possam lidar com picos de tráfego.
Posso rodar o n8n-evolution-combo em um servidor com menos de 4GB de RAM?
Embora seja possível executar o n8n-evolution-combo em um ambiente de teste ou desenvolvimento com menos de 4GB de RAM, não é recomendado para produção. Servidores com menos memória podem sofrer com instabilidade, containers reiniciando devido a falta de recursos (OOM Killer) e lentidão geral, comprometendo suas automações, especialmente se envolverem a Evolution API para WhatsApp.
Como configuro o n8n para usar a Evolution API?
A integração do n8n com a Evolution API é feita configurando um nó de HTTP Request no n8n para interagir com os endpoints da Evolution API. Você precisará definir a URL base da sua instância da Evolution API, tokens de autenticação (como o JWT_SECRET) e os dados corretos para enviar em suas requisições. Consulte a documentação de ambas as ferramentas para detalhes específicos de cada endpoint e payload.
Preciso de um domínio para rodar o n8n-evolution-combo?
Não é estritamente obrigatório ter um domínio para rodar o n8n-evolution-combo, você pode usar o endereço IP público do seu VPS. No entanto, o uso de um domínio é altamente recomendado, especialmente se você planeja configurar HTTPS (essencial para segurança e para webhooks funcionarem corretamente) e integrar com serviços externos que podem exigir URLs resolvíveis. Para webhooks, um domínio é praticamente indispensável.
Como faço para acessar a interface do n8n após a instalação?
Após a instalação via Docker Compose, você pode acessar a interface do n8n abrindo seu navegador e digitando o endereço configurado no arquivo `docker-compose.yml`. Se você usou `N8N_HOST=n8n.seudominio.com` e `N8N_PORT=5678` com protocolo `http`, acesse `http://n8n.seudominio.com:5678`. Se usou o IP, acesse `http://SEU_IP_DO_VPS:5678`. Lembre-se de ajustar as portas e o host conforme sua configuração.
Qual a diferença entre rodar o n8n no meu VPS e usar a versão cloud?
Rodar o n8n no seu VPS (self-hosted) oferece controle total sobre seus dados, maior flexibilidade de customização e integração profunda com outros serviços na sua infraestrutura. É ideal para quem precisa de privacidade, segurança específica ou economizar em planos pagos. A versão cloud é mais simples de começar, pois não requer gerenciamento de infraestrutura, mas pode ter custos mais altos e limitações em customizações e volume de dados.
Como faço backup dos meus fluxos e dados do n8n?
Para fazer backup dos seus fluxos e dados do n8n, você precisa garantir que os volumes Docker estejam sendo persistidos corretamente em seu host. No nosso exemplo de `docker-compose.yml`, o volume `n8n_data` é usado para persistir os dados do n8n. Você pode copiar o conteúdo deste diretório (`/var/lib/docker/volumes/n8n_data/_data/` ou similar, dependendo da sua configuração Docker) para um local seguro. Para bancos de dados externos, utilize as ferramentas de backup do próprio banco (ex: `pg_dump` para PostgreSQL).
É seguro expor o n8n diretamente na internet?
Expor o n8n diretamente na internet sem medidas de segurança adequadas é arriscado. Recomendamos fortemente o uso de um proxy reverso (como Nginx ou Caddy) configurado com HTTPS para criptografar a comunicação. Além disso, implemente autenticação forte (senhas robustas) no n8n e, se possível, restrinja o acesso por IP ou use VPNs. A configuração de segurança é crucial, especialmente ao integrar com serviços como a Evolution API.