n8n Evolution Combo: Implante em VPS Linux

n8n Evolution Combo: Implante em VPS Linux

Resposta Rápida / TL;DR

O n8n-evolution-combo é uma poderosa ferramenta de automação que pode ser implantada em um servidor VPS Linux. Para rodá-lo em produção de forma estável, recomendamos um servidor com no mínimo 4GB de RAM e 2 vCPUs, além de espaço em disco para logs e backups. Seguindo este guia, você terá sua instância configurada em minutos.

Pontos principais

  • O n8n-evolution-combo requer no mínimo 4GB de RAM e 2 vCPUs para produção, com 8GB de RAM e 4 vCPUs sendo o ideal para desempenho otimizado.
  • A implantação via Docker Compose é a abordagem recomendada, simplificando a instalação, gerenciamento e atualizações de todos os componentes.
  • Um proxy reverso com HTTPS é essencial para a segurança e o funcionamento correto dos webhooks, especialmente ao integrar com a Evolution API para automação de WhatsApp.
  • O uso de volumes Docker garante a persistência dos dados do n8n, permitindo backups e recuperação de dados de forma confiável.
Í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.

    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.
    Download Gratuito Template Pronto para n8n & Evolution API

    📦 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.

    ← Voltar para o blog