n8n Evolution Combo: Implante seu Automação Agora

Implante o n8n Evolution Combo em seu VPS: O Início da Automação Robusta

Este guia detalha o processo de instalação do n8n Evolution Combo em um servidor VPS Linux, com foco em quem busca controle total sobre suas automações. A implantação via Docker e Docker Compose é a abordagem recomendada para garantir eficiência, isolamento e facilidade de gerenciamento. Para um ambiente de produção estável, um VPS com no mínimo 4GB de RAM e 2 vCPUs é recomendado, garantindo que o n8n e seus complementos, como a Evolution API para automação de WhatsApp, operem sem gargalos. A seguir, apresentaremos um passo a passo completo para colocar sua infraestrutura de automação para funcionar em tempo recorde.

Veja a infraestrutura: VPS para n8n + Evolution API para colocar este projeto no ar.

Requisitos Essenciais para Produção

Antes de iniciar a implantação, é crucial entender os requisitos de hardware para uma operação robusta. Para o n8n Evolution Combo rodando com a Evolution API e outros serviços essenciais em um ambiente de produção, recomendamos:

• Memória RAM: Mínimo de 4GB. Para cargas de trabalho mais intensas e múltiplos fluxos de automação, 8GB ou mais são ideais.
• CPU: Mínimo de 2 vCPUs. Mais núcleos podem ser benéficos para processamento paralelo e maior throughput.
• Armazenamento: Pelo menos 20GB de espaço em disco SSD para o sistema operacional, Docker, imagens de contêineres, logs e backups. A necessidade de espaço pode crescer significativamente dependendo do volume de dados processados.
• Sistema Operacional: Uma distribuição Linux atualizada, como Ubuntu 22.04 LTS ou superior, é preferível.
• Conectividade: Acesso à internet para download de imagens Docker e comunicação externa das automações.

Estes requisitos são baseados na experiência prática na Host You Secure, onde mantemos stacks similares em produção. Um plano como o VPS Brasil Básico (R$ 99/mês, 4GB RAM, 4 vCPUs) atende perfeitamente a essas necessidades, oferecendo um ótimo custo-benefício para iniciar suas automações.

Passo a Passo: Implantação do n8n Evolution Combo com Docker Compose

A forma mais eficiente de implantar o n8n Evolution Combo, que inclui o n8n e a Evolution API, é utilizando Docker e Docker Compose. Este método garante que todas as dependências sejam gerenciadas em contêineres isolados, simplificando a instalação e a manutenção.

Pré-requisitos: Instalando Docker e Docker Compose

Certifique-se de que seu VPS possui o Docker e o Docker Compose instalados. Se ainda não os tem, siga estes passos:

1. Atualize o índice de pacotes:

sudo apt update
sudo apt upgrade -y

2. Instale o Docker:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

sudo usermod -aG docker $USER
newgrp docker

3. Instale o Docker Compose Plugin (versão v2):

sudo apt install docker-compose-plugin -y

Verifique as instalações:

docker --version
docker compose version

Configurando o Arquivo Docker Compose

Agora, vamos criar o arquivo docker-compose.yml que definirá nossos serviços. Crie um diretório para o seu projeto e dentro dele, o arquivo docker-compose.yml:

1. Crie o diretório do projeto:

mkdir n8n-combo
cd n8n-combo

2. Crie o arquivo docker-compose.yml:

version: "3.8"

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=n8n.seudominio.com # Altere para seu subdomínio ou IP
      - N8N_PORT=5678
      - WEBHOOK_URL=https://n8n.seudominio.com # Altere para seu subdomínio ou IP
      - NODE_ENV=production
      - TZ=America/Sao_Paulo # Defina seu fuso horário
      # Para segurança, use variáveis de ambiente para credenciais sensitiveis
      # - N8N_BASIC_AUTH_ACTIVE=true
      # - N8N_BASIC_AUTH_USER=seu_usuario
      # - N8N_BASIC_AUTH_PASSWORD=sua_senha_forte
    volumes:
      - n8n_data:/home/node/.n8n

  evolutionapi:
    image: ghcr.io/evolutionapi/evolutionapi:latest
    container_name: evolutionapi
    restart: always
    ports:
      - "8080:8080"
    environment:
      - TZ=America/Sao_Paulo # Defina seu fuso horário
      - SERVER_PORT=8080
      - N8N_URL=http://n8n:5678 # Conecta com o serviço n8n
      - N8N_TOKEN=SEU_TOKEN_N8N # Gere um token em Configurações do n8n
      - DATABASE_URL=postgres://user:password@db:5432/evolutionapi # Configure seu banco de dados
      - REDIS_URL=redis://redis:6379
      - LOG_LEVEL=info
      # Configurações de segurança para WhatsApp (obrigatório para produção)
      - SECRET_KEY=SUA_CHAVE_SECRETA_FORTE # Mantenha em segredo!
      - INSTANCE_NAME=api_whatsapp_hostyousecure # Nome da sua instância
      - PUBLIC_URL=https://api.seudominio.com # Altere para seu subdomínio/IP da API
    volumes:
      - evolutionapi_data:/app/data

  db:
    image: postgres:15
    container_name: postgres_evolutionapi
    restart: always
    environment:
      - POSTGRES_DB=evolutionapi
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password # Use uma senha forte!
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    container_name: redis_evolutionapi
    restart: always
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data

volumes:
  n8n_data:
  evolutionapi_data:
  postgres_data:
  redis_data:

Atenção: Altere n8n.seudominio.com e api.seudominio.com para o seu subdomínio ou IP público. Substitua SEU_TOKEN_N8N por um token gerado nas configurações do n8n. Troque user, password e SUA_CHAVE_SECRETA_FORTE por credenciais seguras. Se você precisar de um banco de dados mais robusto, pode considerar um serviço externo ou um plano de VPS com mais recursos. Para ter uma ideia de como configurar um banco de dados PostgreSQL em produção, confira nosso artigo sobre n8n com PostgreSQL e Redis: Arquitetura em VPS no Brasil.

Iniciando os Contêineres

Com o arquivo docker-compose.yml configurado, inicie os serviços:

docker compose up -d

Este comando irá baixar as imagens necessárias e iniciar os contêineres em segundo plano (-d).

Verificando a Instalação

Após alguns minutos, verifique se os contêineres estão rodando:

docker compose ps

Você deverá ver os contêineres n8n, evolutionapi, postgres_evolutionapi e redis_evolutionapi com o status Up.

Acesse o n8n em seu navegador em http://seu_vps_ip:5678 ou https://n8n.seudominio.com (se configurou um subdomínio e proxy reverso).

Para a Evolution API, acesse http://seu_vps_ip:8080 ou https://api.seudominio.com.

Configurando o Proxy Reverso com Nginx

Para acessar o n8n e a Evolution API de forma segura e amigável (usando HTTPS e subdomínios), é altamente recomendado configurar um proxy reverso com Nginx. Isso também permite que a Evolution API se comunique corretamente com o n8n através do seu nome de serviço interno.

Instalando Nginx

Se o Nginx não estiver instalado:

sudo apt install nginx -y

Configurando o Virtual Host

Crie um arquivo de configuração para seu domínio, por exemplo, /etc/nginx/sites-available/n8n-combo:

server {
    listen 80;
    server_name n8n.seudominio.com api.seudominio.com;

    location / {
        proxy_pass http://127.0.0.1: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-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /webhook/ {
        proxy_pass http://127.0.0.1:8080;
        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-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # Opcional: configurar um servidor separado para a API se necessário
    # server {
    #    listen 80;
    #    server_name api.seudominio.com;
    #    location / {
    #        proxy_pass http://127.0.0.1:8080;
    #        ... (outras configurações de proxy)
    #    }
    # }
}

Importante: Para usar https, você precisará obter um certificado SSL (por exemplo, via Let's Encrypt) e configurar o Nginx para ouvir na porta 443, redirecionando também as requisições da porta 80 para 443. Se você ainda não tem familiaridade com a configuração de proxy reverso e SSL, nosso artigo sobre Nginx como proxy reverso para Docker: configuração segura pode ajudar.

Habilitando o Site e Testando

Crie um link simbólico para habilitar a configuração e teste-a:

sudo ln -s /etc/nginx/sites-available/n8n-combo /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Agora você deve ser capaz de acessar o n8n e a Evolution API através do seu subdomínio.

Automação WhatsApp com n8n e Evolution API

Com o n8n Evolution Combo rodando em seu VPS, você está pronto para integrar a automação do WhatsApp. A Evolution API atua como uma ponte, permitindo que o n8n envie e receba mensagens via WhatsApp.

Conectando Evolution API ao n8n

No n8n, crie um novo nó (por exemplo, um HTTP Request node) para enviar mensagens. Configure-o para fazer uma requisição POST para o endpoint da Evolution API. O endpoint para enviar mensagens é geralmente https://api.seudominio.com/messages.

Você precisará incluir:

• Headers: Authorization: Bearer SEU_TOKEN_N8N e Content-Type: application/json.
• Body: Um JSON com os detalhes da mensagem, como from (seu número de telefone com código do país), to (número do destinatário com código do país), e message (o texto ou mídia).

Para receber mensagens, você configurará um webhook na Evolution API (definido no seu docker-compose.yml com PUBLIC_URL) que aponta para um endpoint do n8n. O n8n, por sua vez, precisa ser configurado para escutar nesse URL específico, que você definirá nas configurações de webhook da Evolution API. O n8n irá receber os dados via POST e você poderá processá-los usando seus fluxos de trabalho.

Uma configuração robusta de automação WhatsApp em VPS pode exigir atenção a detalhes como filas de processamento e alta disponibilidade. Se você busca uma abordagem mais detalhada sobre como tornar essas automações mais resilientes, recomendamos a leitura sobre N8N e Evolution API: Automação WhatsApp Robusta em Seu VPS.

Otimizando o Desempenho e Segurança

Para garantir que seu n8n Evolution Combo funcione de maneira otimizada e segura, considere as seguintes práticas:

Otimização de Recursos

• Monitoramento: Utilize ferramentas como docker stats para monitorar o consumo de CPU e RAM dos contêineres. Ajuste os recursos do seu VPS conforme necessário.
• Limites de Automação: Configure limites no n8n (como o número máximo de execuções simultâneas) para evitar sobrecarga.
• Banco de Dados: Para grandes volumes de dados históricos ou logs, considere otimizar as consultas ao PostgreSQL ou utilizar um serviço de banco de dados gerenciado.

Segurança

• Credenciais Fortes: Utilize senhas fortes e únicas para o banco de dados, para o token do n8n e para a chave secreta da Evolution API.
• HTTPS: Sempre utilize HTTPS com um certificado SSL válido. Isso criptografa a comunicação entre o cliente e o servidor.
• Firewall: Configure um firewall (como ufw no Ubuntu) para permitir apenas as portas necessárias (80, 443, e a porta específica da Evolution API se não estiver atrás do proxy).
• Atualizações: Mantenha o sistema operacional, Docker e as imagens dos contêineres sempre atualizados para corrigir vulnerabilidades de segurança.

Erros Comuns e Soluções

Ao implantar e gerenciar o n8n Evolution Combo, alguns problemas podem surgir:

• Contêineres não iniciam: Verifique os logs com docker compose logs para identificar erros de configuração ou falta de recursos. Geralmente, problemas de permissão em volumes ou portas já em uso podem causar falhas.
• Evolução API não conecta com n8n: Certifique-se de que o N8N_URL no arquivo docker-compose.yml da Evolution API está correto e aponta para o serviço n8n (http://n8n:5678). Verifique também se o token do n8n está correto.
• Webhooks não funcionam: Confirme se o PUBLIC_URL da Evolution API está corretamente configurado e acessível publicamente. Verifique as configurações de firewall e DNS. Se estiver usando Nginx como proxy reverso, garanta que ele esteja encaminhando as requisições corretamente para a porta 8080.
• Falta de Memória (OOM): Se os contêineres (especialmente o n8n ou a Evolution API) estão sendo encerrados inesperadamente, pode ser falta de RAM. Considere aumentar a memória do seu VPS ou otimizar o uso dos recursos. Para produção, 4GB de RAM é o mínimo recomendado.

Comparativo de Recursos: N8n Evolution Combo em VPS vs. Alternativas Cloud Genéricas

Perguntas Relacionadas

O que é o n8n Evolution Combo?

O n8n Evolution Combo é uma suíte de ferramentas para automação de fluxos de trabalho. Ele combina o poder do n8n, uma plataforma de automação open-source, com a Evolution API, permitindo a integração robusta com o WhatsApp e outros serviços. Essencialmente, é uma solução completa para quem deseja automatizar tarefas e comunicação em um ambiente controlado.

Qual a diferença entre n8n e Evolution API?

O n8n é o orquestrador de fluxos de trabalho, permitindo criar lógicas complexas conectando diferentes APIs e serviços. A Evolution API é um módulo especializado que funciona como um servidor de WhatsApp para seu número, facilitando a comunicação bidirecional (envio e recebimento de mensagens) com o n8n e outras aplicações via API.

Posso rodar o n8n Evolution Combo em um servidor gratuito?

Embora seja possível rodar o n8n Evolution Combo em ambientes de teste com poucos recursos, para produção, especialmente com a Evolution API e WhatsApp, um servidor com recursos mínimos garantidos (como 4GB de RAM e 2 vCPUs) é altamente recomendado. Servidores gratuitos ou de baixo desempenho podem causar instabilidade e falhas nas automações.

Quais os requisitos mínimos de hardware para o n8n Evolution Combo em produção?

Para um ambiente de produção estável, recomendamos no mínimo 4GB de RAM e 2 vCPUs. Isso garante que o n8n, a Evolution API, o banco de dados PostgreSQL e o Redis possam operar eficientemente, mesmo sob carga moderada. Um disco SSD também é importante para o desempenho.

Conclusão: Sua Plataforma de Automação Personalizada

Implantar o n8n Evolution Combo em seu próprio VPS oferece controle, flexibilidade e escalabilidade incomparáveis para suas necessidades de automação. Ao seguir este guia, você estará bem equipado para configurar um ambiente robusto, especialmente para automatizar o WhatsApp com a Evolution API. Lembre-se de que a segurança e o monitoramento contínuos são fundamentais para o sucesso a longo prazo.

Se você busca uma solução pronta e otimizada para rodar o n8n Evolution Combo, com a infraestrutura necessária para garantir performance e estabilidade, a Host You Secure oferece planos ideais. Temos esse mesmo stack em produção em uma VPS Brasil Básico, que oferece 4GB de RAM e 4 vCPUs por apenas R$ 99/mês. Comece suas automações de forma confiável e escalável:

Contrate agora sua VPS Brasil Básico e potencialize suas automações! por R$ 99/mês