n8n-evolution-combo: Rodando em VPS com Docker

n8n-evolution-combo: Rodando em VPS com Docker

Resposta Rápida / TL;DR

O n8n-evolution-combo é um pacote de ferramentas para automação, que inclui o n8n e a Evolution API, ideal para integrar o WhatsApp em fluxos de trabalho. Para implantá-lo em produção de forma confiável, um VPS com no mínimo 4GB de RAM e 2 vCPUs é recomendado, utilizando Docker para simplificar a gestão e a escalabilidade. Este setup garante que suas automações rodem de maneira estável e eficiente.

Pontos principais

  • Implante o n8n-evolution-combo em um VPS com Docker para controle total e escalabilidade.
  • Requisitos mínimos de produção incluem 4GB de RAM e 2 vCPUs para rodar a stack completa de forma estável.
  • Utilize o arquivo `docker-compose.yml` para definir e gerenciar os contêineres do n8n e da Evolution API.
  • Configure variáveis de ambiente como `N8N_HOST`, `WEBHOOK_URL` e `TZ` corretamente para o funcionamento adequado.
Índice do artigo

    n8n-evolution-combo: Implantação em VPS com Docker Essencial

    Para quem busca automatizar tarefas e integrar sistemas, especialmente o WhatsApp, o n8n-evolution-combo é uma solução poderosa. Este conjunto de ferramentas, que une o n8n para a orquestração de workflows e a Evolution API para a comunicação via WhatsApp, requer um ambiente de servidor estável para operar em produção. Este guia detalha como implantar o n8n-evolution-combo em um VPS Linux usando Docker, garantindo uma experiência de automação robusta e escalável. Um servidor com pelo menos 4GB de RAM e 2 vCPUs é o ponto de partida recomendado para rodar essa stack completa, incluindo banco de dados e proxy reverso, com folga para o tráfego.

    Por que usar n8n-evolution-combo em um VPS?

    Automação Personalizada e Controle Total

    Optar por hospedar o n8n-evolution-combo em um VPS (Servidor Virtual Privado) oferece controle total sobre seus dados e infraestrutura. Diferente de soluções SaaS, você não fica refém de políticas de terceiros, limites de uso arbitrários ou preocupações com a privacidade dos seus dados. Com um VPS, você define os recursos, a segurança e a escalabilidade conforme suas necessidades. Isso é crucial para quem trabalha com automação de WhatsApp, onde a confiabilidade e a capacidade de processar um volume considerável de mensagens são essenciais. Ter a liberdade de configurar o ambiente exatamente como você precisa, sem depender de terceiros, é um diferencial enorme. Você pode otimizar o sistema operacional, instalar softwares adicionais para monitoramento ou segurança, e ajustar configurações de rede para garantir a melhor performance e latência para suas automações. Essa independência permite que você adapte sua solução de automação a fluxos de trabalho únicos e complexos que muitas vezes não são suportados por plataformas prontas.

    Integração com Evolution API e WhatsApp

    A integração do n8n com a Evolution API desbloqueia o poder de automação do WhatsApp. Enquanto o n8n gerencia os fluxos lógicos e as conexões com outros serviços, a Evolution API atua como a ponte para enviar e receber mensagens, status e mídias via WhatsApp. Rodar essa combinação em um VPS permite que você tenha uma central de automação dedicada, capaz de processar interações em tempo real e escalar conforme a demanda aumenta. Para a implantação inicial, a utilização do Docker simplifica drasticamente o processo, encapsulando todas as dependências em contêineres isolados. Isso significa que você não precisa se preocupar com conflitos de bibliotecas ou dependências de sistema operacional, pois cada componente roda em seu próprio ambiente isolado. A Evolution API, especificamente, se beneficia de um ambiente estável para manter a conexão com o WhatsApp ativa e estável, minimizando interrupções e garantindo a entrega confiável de mensagens. A capacidade de gerenciar múltiplas instâncias ou aumentar a capacidade de processamento no VPS conforme o volume de mensagens aumenta é outra vantagem significativa, garantindo que sua automação possa crescer junto com seu negócio sem gargalos.

    Requisitos de Servidor para Produção

    Configuração Mínima para Testes e Desenvolvimento

    Para experimentação e desenvolvimento local, um ambiente com 2GB de RAM e 1 vCPU pode ser suficiente para rodar o n8n e a Evolution API em contêineres Docker. No entanto, essa configuração não é recomendada para produção, pois o consumo de recursos pode facilmente exceder os limites, levando a instabilidade e falhas. O n8n, em particular, pode consumir uma quantidade significativa de RAM e CPU dependendo da complexidade dos seus workflows e do volume de dados processados. Por exemplo, um workflow que processa centenas de registros por minuto, ou que realiza requisições HTTP para múltiplos endpoints externos, pode rapidamente saturar um CPU de núcleo único ou consumir toda a RAM disponível. Um erro comum em ambientes subdimensionados é o contêiner do n8n entrar em loop de reinicialização devido à falta de memória (OOM Killer do Linux atuando) ou alta utilização de CPU que o torna irresponsivo.

    Requisitos Recomendados para Produção com Docker

    Para rodar o n8n-evolution-combo em um ambiente de produção robusto e confiável, especialmente com o uso do Docker e o gerenciamento de workflows complexos e interações com o WhatsApp, a Host You Secure recomenda um plano com no mínimo 4GB de RAM e 2 vCPUs. Esta configuração, como o nosso plano VPS Brasil Básico, oferece um equilíbrio ideal entre custo e performance para a maioria dos casos de uso. É importante considerar que, além do n8n e da Evolution API, o ambiente Docker também consome recursos, e um banco de dados (como PostgreSQL) e um proxy reverso (como Nginx) podem ser necessários, aumentando a demanda por RAM e CPU. Um disco de armazenamento SSD de pelo menos 30GB é também recomendado para garantir tempos de leitura/escrita rápidos, essenciais para o bom desempenho do banco de dados e do próprio sistema operacional.

    O consumo típico de memória para o contêiner do n8n em repouso é de aproximadamente 300-500MB, mas pode facilmente saltar para 1GB ou mais durante a execução de workflows pesados ou com muitas execuções simultâneas. Por exemplo, um workflow que envolve a leitura de um grande arquivo CSV e o processamento individual de cada linha pode alocar temporariamente vários gigabytes de RAM. A Evolution API, por outro lado, tende a ser mais leve, consumindo cerca de 100-200MB em repouso. Somando esses consumos, mais o overhead do Docker e do sistema operacional, 4GB de RAM proporcionam uma margem de segurança adequada. Um banco de dados PostgreSQL, se utilizado, pode consumir adicionalmente 100-300MB em repouso, mas essa demanda aumenta significativamente com o número de conexões e a quantidade de dados armazenados. Um proxy reverso como o Nginx é extremamente leve, consumindo apenas alguns megabytes de RAM, mas é crucial para o gerenciamento de SSL e roteamento de tráfego.

    Considerações Adicionais de Armazenamento e Rede

    Além de RAM e CPU, o armazenamento é um fator importante. Para a persistência dos dados do n8n (workflows, credenciais, logs) e do banco de dados da Evolution API, recomenda-se o uso de volumes Docker mapeados para o host. Isso garante que os dados não sejam perdidos caso o contêiner seja recriado. Um disco de pelo menos 30GB em um VPS com SSD é ideal para a maioria dos cenários de produção. Para a rede, a configuração de um proxy reverso (como Nginx) é fundamental para expor o n8n e a Evolution API de forma segura via HTTPS. Isso envolve a configuração de certificados SSL (Let's Encrypt é uma opção gratuita e popular), o que pode exigir a abertura das portas 80 e 443 no firewall do seu VPS. A escolha de um VPS com boa conectividade de rede e baixa latência é crucial para garantir que as requisições e respostas do WhatsApp sejam processadas rapidamente, evitando timeouts e melhorando a experiência do usuário final.

    Passo a Passo: Implantação do n8n-evolution-combo com Docker Compose

    Este tutorial abrange a implantação do n8n-evolution-combo utilizando Docker Compose em um servidor Ubuntu. Assumimos que você já possui um VPS com Docker e Docker Compose instalados. Se não, você pode seguir nosso guia sobre Docker: Resolvendo Erros em Container Reiniciando para a instalação base.

    1. Preparando o Ambiente

    Primeiro, crie um diretório para o projeto e navegue até ele:

    
    mkdir n8n-evolution-combo
    cd n8n-evolution-combo
    

    Em seguida, é uma boa prática criar subdiretórios para os volumes persistentes. Isso ajuda a organizar seus dados e facilita backups futuros. Por exemplo:

    
    mkdir n8n_data
    # Se for usar o banco de dados PostgreSQL:
    # mkdir postgres_data
    

    2. Criando o Arquivo docker-compose.yml

    Crie um arquivo chamado docker-compose.yml neste diretório. Este arquivo definirá os serviços, redes e volumes necessários para rodar o n8n e a Evolution API. Abaixo está um exemplo de configuração. Note que a porta padrão do n8n é 5678 e da Evolution API é 3000.

    
    version: "3.8"
    
    services:
      n8n:
        image: n8nio/n8n
        container_name: n8n
        restart: always
        ports:
          - "5678:5678"
        environment:
          - N8N_HOST=n8n.seusite.com # Substitua pelo seu domínio ou IP público
          - N8N_PORT=5678
          - N8N_PROTOCOL=https # Use http se não tiver SSL configurado no proxy reverso
          - WEBHOOK_URL=https://n8n.seusite.com/ # Substitua pelo seu domínio ou IP com o caminho do webhook
          - GENERIC_TIMEZONE=America/Sao_Paulo # Ajuste para seu fuso horário
          # Para produção, é altamente recomendado configurar um banco de dados externo para o n8n também.
          # Exemplo com PostgreSQL:
          # - DB_FROM_ENV=true
          # - DB_TYPE=postgres
          # - DB_HOST=db_n8n
          # - DB_PORT=5432
          # - DB_DATABASE=n8n_db
          # - DB_USER=n8n_user
          # - DB_PASSWORD=n8n_password
        volumes:
          - ./n8n_data:/home/node/.n8n
        networks:
          - app-network
    
      evolutionapi:
        image: revoltt/evolution-api
        container_name: evolutionapi
        restart: always
        ports:
          - "3000:3000"
        environment:
          - TZ=America/Sao_Paulo # Ajuste para seu fuso horário
          - N8N_URL=http://n8n:5678 # Conecta com o serviço n8n pela rede interna do Docker
          - N8N_WEBHOOK_URL=http://n8n:5678/webhook # URL interna para o webhook do n8n
          # Se você usa banco de dados para Evolution API, descomente e configure aqui:
          - DB_HOST=db_evolution # Nome do serviço do banco de dados
          - DB_PORT=5432
          - DB_USER=evolution_user
          - DB_PASSWORD=evolution_password
          - DB_DATABASE=evolution
        networks:
          - app-network
    
      # Opcional, mas recomendado para produção: Banco de Dados PostgreSQL para Evolution API
      db_evolution:
        image: postgres:14
        container_name: evolutionapi_db
        restart: always
        environment:
          - POSTGRES_USER=evolution_user
          - POSTGRES_PASSWORD=evolution_password
          - POSTGRES_DB=evolution
        volumes:
          - ./postgres_data:/var/lib/postgresql/data
        networks:
          - app-network
    
      # Opcional: Banco de Dados PostgreSQL para n8n (recomendado em produção)
      # db_n8n:
      #   image: postgres:14
      #   container_name: n8n_db
      #   restart: always
      #   environment:
      #     - POSTGRES_USER=n8n_user
      #     - POSTGRES_PASSWORD=n8n_password
      #     - POSTGRES_DB=n8n_db
      #   volumes:
      #     - ./postgres_n8n_data:/var/lib/postgresql/data
      #   networks:
      #     - app-network
    
    networks:
      app-network:
        driver: bridge
    
    volumes:
      n8n_data:
      postgres_data:
      # postgres_n8n_data: # Descomente se usar o banco de dados para n8n
    

    3. Configurando Variáveis de Ambiente (Opcional, mas Recomendado)

    Para uma melhor organização e segurança, você pode criar um arquivo .env na raiz do seu projeto para armazenar variáveis sensíveis e específicas do ambiente. Por exemplo:

    
    # Arquivo .env
    N8N_HOST=n8n.seusite.com
    N8N_PORT=5678
    N8N_PROTOCOL=https
    WEBHOOK_URL=https://n8n.seusite.com/
    GENERIC_TIMEZONE=America/Sao_Paulo
    
    EVOLUTIONAPI_TZ=America/Sao_Paulo
    EVOLUTIONAPI_N8N_URL=http://n8n:5678
    EVOLUTIONAPI_N8N_WEBHOOK_URL=http://n8n:5678/webhook
    
    DB_EVOLUTION_HOST=db_evolution
    DB_EVOLUTION_PORT=5432
    DB_EVOLUTION_USER=evolution_user
    DB_EVOLUTION_PASSWORD=evolution_password
    DB_EVOLUTION_DATABASE=evolution
    
    # Para n8n com DB:
    # DB_N8N_HOST=db_n8n
    # DB_N8N_PORT=5432
    # DB_N8N_USER=n8n_user
    # DB_N8N_PASSWORD=n8n_password
    # DB_N8N_DATABASE=n8n_db
    

    Se você usar o arquivo .env, precisará referenciá-lo no docker-compose.yml usando a diretiva env_file. Por exemplo, para o serviço n8n:

    
      n8n:
        image: n8nio/n8n
        container_name: n8n
        restart: always
        ports:
          - "5678:5678"
        env_file:
          - .env
        # Outras configurações do n8n...
    

    É crucial que o N8N_HOST e WEBHOOK_URL sejam configurados corretamente com seu domínio público ou IP, para que o n8n possa receber webhooks externos e se comunicar corretamente com a Evolution API. Se você não configurar o SSL no proxy reverso, altere N8N_PROTOCOL para http e o WEBHOOK_URL para corresponder.

    4. Executando os Contêineres

    Com o arquivo docker-compose.yml (e opcionalmente o .env) configurado, você pode iniciar os serviços. Navegue até o diretório onde você salvou o arquivo e execute:

    
    docker-compose up -d
    

    O comando -d executa os contêineres em modo detached (em segundo plano). Para verificar o status dos contêineres, você pode usar:

    
    docker-compose ps
    

    Para visualizar os logs de um serviço específico (útil para depuração), use:

    
    docker-compose logs -f n8n
    # ou
    docker-compose logs -f evolutionapi
    

    Se você encontrar erros como "port is already allocated" ao tentar iniciar os contêineres, significa que outra aplicação está usando a porta 5678 ou 3000 no seu servidor. Você precisará parar o processo que está usando a porta ou alterar as portas mapeadas no seu docker-compose.yml (por exemplo, "5679:5678" para o n8n, para usar a porta 5679 no host).

    5. Configurando o Proxy Reverso (Nginx)

    Para acessar o n8n e a Evolution API de forma segura e conveniente, é altamente recomendado configurar um proxy reverso, como o Nginx. Isso permite usar um único domínio, gerenciar certificados SSL e rotear o tráfego corretamente.

    Crie um arquivo de configuração para o Nginx, por exemplo, /etc/nginx/sites-available/n8n-evolution:

    
    server {
        listen 80;
        server_name n8n.seusite.com; # Substitua pelo seu domínio
    
        # Redirecionar HTTP para HTTPS
        location / {
            return 301 https://$host$request_uri;
        }
    }
    
    server {
        listen 443 ssl http2;
        server_name n8n.seusite.com; # Substitua pelo seu domínio
    
        ssl_certificate /etc/letsencrypt/live/n8n.seusite.com/fullchain.pem; # Caminho para seu certificado
        ssl_certificate_key /etc/letsencrypt/live/n8n.seusite.com/privkey.pem; # Caminho para sua chave
    
        location / {
            proxy_pass http://localhost:5678; # Mapeia para a porta do n8n no host
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    
        # Para a Evolution API, se você desejar expô-la diretamente ou via subdomínio
        # location /api/evolution {
        #     alias /var/www/evolutionapi/html; # Exemplo, não é um caminho real
        #     proxy_pass http://localhost:3000; # Mapeia para a porta da Evolution API no host
        #     proxy_set_header Host $host;
        #     proxy_set_header X-Real-IP $remote_addr;
        #     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        #     proxy_set_header X-Forwarded-Proto $scheme;
        # }
    }
    

    Lembre-se de substituir n8n.seusite.com pelo seu domínio real e ajustar os caminhos dos certificados SSL. Após criar o arquivo, habilite o site e reinicie o Nginx:

    
    sudo ln -s /etc/nginx/sites-available/n8n-evolution /etc/nginx/sites-enabled/
    sudo systemctl restart nginx
    

    Se você encontrar erros de configuração do Nginx, use sudo nginx -t para testar a sintaxe e sudo systemctl status nginx para verificar o status do serviço.

    6. Configurando a Evolution API com o n8n

    Dentro da interface do n8n, você precisará configurar a conexão com a Evolution API. Geralmente, isso envolve adicionar um novo nó HTTP Request e configurar o URL base para http://localhost:3000 (ou o IP do seu servidor na porta 3000 se não estiver usando o mesmo host para Docker e Nginx) e definir os headers necessários para autenticação, se houver.

    Para que o n8n receba webhooks da Evolution API, certifique-se de que a URL configurada em WEBHOOK_URL no seu docker-compose.yml esteja correta e que seu proxy reverso esteja encaminhando o tráfego para o contêiner do n8n. A Evolution API usará essa URL para enviar notificações sobre novas mensagens recebidas, status de envio, etc.

    Um erro comum é esquecer de configurar corretamente a comunicação entre o n8n e a Evolution API. Verifique se no arquivo docker-compose.yml as URLs N8N_URL e N8N_WEBHOOK_URL dentro do serviço `evolutionapi` apontam para o nome do serviço `n8n` (http://n8n:5678), pois eles se comunicam pela rede interna do Docker. Se você expôs o n8n externamente, mas a Evolution API está no mesmo Docker Compose, essa comunicação interna é a forma correta.

    Ao configurar os webhooks na Evolution API, use o URL público configurado no seu Nginx (https://n8n.seusite.com/webhook) para garantir que as notificações cheguem ao n8n corretamente.

    Com esta configuração, você terá uma poderosa plataforma de automação do WhatsApp rodando em seu próprio VPS, com controle total sobre seus dados e escalabilidade garantida. Lembre-se de monitorar o consumo de recursos do seu servidor para garantir que ele continue atendendo às demandas da sua automação.

    Para uma experiência ainda mais robusta e para garantir a alta disponibilidade, recomendamos o plano VPS Brasil PRO da Host You Secure, que oferece 8GB de RAM e 4 vCPUs. Este plano é ideal para aplicações de automação que exigem processamento intensivo e grande volume de requisições, garantindo que seus fluxos de trabalho permaneçam eficientes e sem interrupções. Visite nosso site para mais detalhes.

    Comparativo de Requisitos: n8n-evolution-combo

    Componente Ambiente de Teste (Mínimo) Ambiente de Produção (Recomendado)
    RAM 2 GB 4 GB+
    vCPU 1 2+
    Armazenamento 20 GB 40 GB+ (incluindo volumes e logs)
    Banco de Dados SQLite (via volume n8n) PostgreSQL (via contêiner Docker)
    Proxy Reverso Não obrigatório Nginx/Traefik (com HTTPS)
    Complexidade de Workflow Baixa Média a Alta
    Volume de Mensagens WhatsApp Baixo Alto
    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 produção, recomendamos um mínimo de 4GB de RAM. Essa quantidade é necessária para acomodar o n8n, a Evolution API, o Docker, o sistema operacional e um proxy reverso, além de oferecer uma margem para o processamento de workflows e mensagens. Embora 2GB possam ser suficientes para testes, instabilidade e falhas são comuns em produção com essa configuração.

    É possível rodar o n8n-evolution-combo em um servidor com menos de 4GB de RAM?

    É tecnicamente possível rodar o n8n-evolution-combo em um servidor com menos de 4GB de RAM para fins de desenvolvimento ou testes. No entanto, essa configuração é altamente desaconselhada para ambientes de produção. A falta de memória pode levar a contêineres sendo reiniciados inesperadamente (OOM - Out of Memory) e à instabilidade geral do sistema de automação.

    Como configurar o N8N para usar um domínio personalizado?

    Para usar um domínio personalizado, como 'n8n.seusite.com', você precisa configurar as variáveis de ambiente `N8N_HOST` e `WEBHOOK_URL` no seu arquivo `docker-compose.yml`. Certifique-se de que o DNS do seu domínio aponte para o IP do seu VPS e que um proxy reverso (como Nginx) esteja configurado para direcionar o tráfego para a porta do contêiner do N8N (geralmente 5678) e gerenciar o certificado SSL.

    Qual a diferença entre o n8n e a Evolution API neste combo?

    O n8n é a plataforma principal de automação, responsável por construir e orquestrar os fluxos de trabalho (workflows). Ele se conecta a diversos serviços e APIs. A Evolution API, por outro lado, é focada especificamente na comunicação via WhatsApp, atuando como uma interface para enviar, receber e gerenciar mensagens, mídias e status através do WhatsApp Business API ou de uma conta conectada.

    Como conectar o N8N à Evolution API?

    A conexão é estabelecida através da configuração de variáveis de ambiente no `docker-compose.yml`. Para o contêiner do n8n, você pode definir `N8N_URL` e `N8N_WEBHOOK_URL` apontando para o serviço da Evolution API dentro da mesma rede Docker (ex: `http://evolutionapi:3000`). Na Evolution API, você configura os webhooks para apontar de volta para o N8N (ex: `N8N_URL=http://n8n:5678`).

    É necessário um banco de dados para o n8n-evolution-combo?

    O n8n utiliza um banco de dados interno (baseado em SQLite por padrão, que é armazenado em volume) para persistir workflows e dados. Para produção, é altamente recomendado usar um banco de dados externo como PostgreSQL, que pode ser configurado como um serviço Docker separado no seu `docker-compose.yml`. A Evolution API também pode se beneficiar de um banco de dados externo para maior robustez.

    Como garantir a segurança da minha instância n8n-evolution-combo?

    A segurança envolve várias camadas: use um VPS com firewall configurado, evite expor portas desnecessariamente, utilize HTTPS com um certificado SSL válido (gerenciado pelo Nginx ou outro proxy), mantenha o Docker e o sistema operacional atualizados, e configure senhas fortes. Para o n8n, defina usuários e permissões adequadas e considere limites de acesso baseados em IP.

    O que fazer se o container do n8n ou Evolution API reiniciar sozinho?

    Se um container reinicia sozinho, o primeiro passo é verificar os logs. Use o comando `docker logs nome-do-container` (ex: `docker logs n8n`). Erros comuns incluem falta de memória (OOM), problemas de configuração nas variáveis de ambiente, falhas de conexão com o banco de dados ou conflitos de porta. Certifique-se de que o `restart: always` está configurado no `docker-compose.yml` para reinícios automáticos em caso de falhas.

    ← Voltar para o blog