n8n-evolution-combo: Servidor Essencial para Automação

n8n-evolution-combo: Servidor Essencial para Automação

Resposta Rápida / TL;DR

O n8n-evolution-combo é uma poderosa ferramenta de automação que requer um servidor VPS para ser implantada e utilizada em produção, especialmente quando integrada com a Evolution API para WhatsApp. Para uma operação estável e eficiente, recomendamos um VPS com no mínimo 4GB de RAM e 4 vCPUs, como o nosso plano VPS Brasil Básico.

Pontos principais

  • O n8n-evolution-combo é uma solução de automação poderosa para WhatsApp quando auto-hospedada em um VPS.
  • Requisitos mínimos de produção incluem 4GB RAM, 4 vCPUs e 50GB SSD para estabilidade e performance.
  • Docker Compose simplifica a implantação, gerenciando n8n, Evolution API e bancos de dados em um único ambiente.
  • Um proxy reverso (Nginx) é essencial para acesso seguro e gerenciamento de domínio/SSL.
Índice do artigo

    O n8n-evolution-combo em seu VPS: O Que É e Por Que Hospedar?

    O n8n-evolution-combo, quando implantado em seu próprio servidor VPS, oferece uma solução de automação de fluxo de trabalho poderosa e flexível, ideal para integrar o n8n com a Evolution API e automatizar tarefas em larga escala, como o envio e recebimento de mensagens via WhatsApp. A decisão de hospedar essa stack em um ambiente auto-hospedado permite controle total sobre os dados, maior segurança, personalização avançada e a capacidade de escalar conforme a demanda. Este guia foca na implantação prática, assumindo que você já decidiu usar essa combinação e agora precisa da infraestrutura correta para rodá-la em produção, garantindo que sua automação de WhatsApp com n8n seja confiável e performática.

    Para ter o n8n-evolution-combo rodando de forma otimizada, especialmente com a Evolution API, é crucial ter um servidor VPS com recursos adequados. Nossa experiência indica que um servidor com pelo menos 4GB de RAM e 4 vCPUs é o ponto de partida ideal para um ambiente de produção estável, que inclui o n8n, o banco de dados, a Evolution API e o proxy reverso. Um armazenamento de 50GB SSD é geralmente suficiente para os logs e dados iniciais, podendo ser expandido conforme o volume de processamento.

    Por Que Auto-Hospedar o n8n-evolution-combo?

    A auto-hospedagem do n8n-evolution-combo em um VPS oferece uma série de vantagens significativas:

    • Controle Total: Você detém seus dados e a infraestrutura, sem depender de terceiros para disponibilidade ou políticas de uso.
    • Segurança Aprimorada: Implemente suas próprias políticas de segurança, firewalls e monitoramento, protegendo suas automações e dados sensíveis.
    • Custo-Benefício: Em larga escala, hospedar sua própria solução pode ser mais econômico do que depender de planos pagos de serviços gerenciados, especialmente com alto volume de automações.
    • Flexibilidade e Customização: Adapte o ambiente exatamente às suas necessidades, instale plugins adicionais, ajuste configurações de rede e otimize a performance.
    • Integração Robusta com WhatsApp: A combinação com a Evolution API em seu próprio servidor garante conexões estáveis e controle sobre o uso do WhatsApp Business API.

    Requisitos de Servidor para Produção

    Para garantir que seu n8n-evolution-combo funcione sem gargalos, especialmente com a Evolution API e automação de WhatsApp, considere os seguintes requisitos mínimos para um ambiente de produção:

    • Memória RAM: Mínimo de 4GB. Para fluxos de trabalho complexos ou múltiplos workers, 8GB ou mais são recomendados.
    • vCPUs: Mínimo de 4 vCPUs. Isso garante que o n8n e seus nós possam processar tarefas de forma eficiente.
    • Armazenamento: Mínimo de 50GB em SSD. O SSD é crucial para a velocidade de I/O, impactando diretamente a performance do banco de dados e do n8n. Espaço adicional pode ser necessário dependendo do volume de logs e dados gerados.
    • Sistema Operacional: Ubuntu LTS (como 22.04 ou 24.04) é uma escolha robusta e amplamente suportada.
    • Conectividade: Um IP dedicado e portas abertas (80, 443 para o proxy reverso; a porta do n8n, se não estiver atrás de proxy; e a porta da Evolution API, se rodando separadamente) são essenciais.

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

    A maneira mais eficiente e recomendada de implantar o n8n-evolution-combo é utilizando Docker e Docker Compose. Isso encapsula as dependências e simplifica o gerenciamento. Vamos detalhar o processo para um servidor Ubuntu.

    Pré-requisitos: Docker e Docker Compose

    Antes de tudo, certifique-se de que o Docker e o Docker Compose estejam instalados em seu servidor. Se não estiverem, siga estes passos:

    # Atualizar lista de pacotes
    sudo apt update
    
    # Instalar dependências
    sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
    
    # Baixar chave GPG do Docker
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
    
    # Adicionar repositório Docker
    echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    
    # Instalar Docker Engine
    sudo apt update
    sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
    
    # Verificar instalação
    docker --version
    docker compose version
    

    Configurando o Docker Compose para n8n e Evolution API

    Agora, vamos criar o arquivo docker-compose.yml que definirá nossos serviços. Para este guia, assumimos que você deseja rodar o n8n e a Evolution API no mesmo ambiente Docker. É importante notar que, em produção, pode ser vantajoso rodar a Evolution API em um servidor separado ou com recursos dedicados, dependendo do volume de tráfego.

    Crie um diretório para o seu projeto e dentro dele o arquivo docker-compose.yml:

    mkdir n8n-evolution-combo
    cd n8n-evolution-combo
    nano docker-compose.yml
    

    Cole o seguinte conteúdo no arquivo docker-compose.yml. Este exemplo configura o n8n com um banco de dados PostgreSQL e a Evolution API. Lembre-se de substituir as variáveis de ambiente (como senhas e tokens) por valores seguros e únicos.

    
    version: '3.8'
    
    services:
      n8n:
        image: n8nio/n8n
        container_name: n8n
        restart: always
        ports:
          - '5678:5678'
        environment:
          - N8N_HOST=n8n.seudominio.com # Opcional: se estiver usando um domínio
          - N8N_PORT=5678
          - WEBHOOK_URL=https://n8n.seudominio.com/webhook/ # Opcional: para webhooks externos
          - NODE_ENV=production
          - GENERIC_TIMEZONE=America/Sao_Paulo
          - DB_TYPE=postgres
          - DB_HOST=db
          - DB_PORT=5432
          - DB_DATABASE=n8n
          - DB_USER=n8n
          - DB_PASSWORD=n8n_db_password # TROQUE POR UMA SENHA FORTE!
          - N8N_BASIC_AUTH=true # Opcional: Ativa autenticação básica
          - N8N_USER=admin # Opcional: Usuário para autenticação básica
          - N8N_PASSWORD=admin_password # TROQUE POR UMA SENHA FORTE!
        volumes:
          - n8n_data:/home/node/.n8n
        depends_on:
          - db
    
      evolution-api:
        image: evolution-api/evolution-api
        container_name: evolution-api
        restart: always
        ports:
          - '5000:5000'
        environment:
          - NODE_ENV=production
          - PORT=5000
          - DB_TYPE=postgres
          - DB_HOST=db
          - DB_PORT=5432
          - DB_DATABASE=evolutionapi
          - DB_USER=evolutionapi
          - DB_PASSWORD=evolutionapi_db_password # TROQUE POR UMA SENHA FORTE!
          - JWT_SECRET=your_super_secret_jwt_key # TROQUE POR UMA CHAVE SECRETA FORTE!
          - INSTANCE_NAME=MyEvolutionAPI
          - INSTANCE_TOKEN=your_instance_token # Gere um token único para sua instância
          - SESSION_TOKEN=your_session_token # Gere um token único para sua sessão
        volumes:
          - evolutionapi_data:/usr/src/app/files
        depends_on:
          - db
    
      db:
        image: postgres:14
        container_name: postgres_db
        restart: always
        environment:
          - POSTGRES_DB=n8n
          - POSTGRES_USER=n8n
          - POSTGRES_PASSWORD=n8n_db_password # TROQUE POR UMA SENHA FORTE!
        volumes:
          - n8n_db_data:/var/lib/postgresql/data
        networks:
          default:
            aliases:
              - db
    
      db_evolution:
        image: postgres:14
        container_name: postgres_db_evolution
        restart: always
        environment:
          - POSTGRES_DB=evolutionapi
          - POSTGRES_USER=evolutionapi
          - POSTGRES_PASSWORD=evolutionapi_db_password # TROQUE POR UMA SENHA FORTE!
        volumes:
          - evolutionapi_db_data:/var/lib/postgresql/data
        networks:
          default:
            aliases:
              - db_evolution
    
    volumes:
      n8n_data:
      n8n_db_data:
      evolutionapi_data:
      evolutionapi_db_data:
    
    networks:
      default:
        driver: bridge
    

    Importante: Substitua n8n.seudominio.com e https://n8n.seudominio.com/webhook/ pelos seus domínios ou IPs. As senhas (n8n_db_password, evolutionapi_db_password, JWT_SECRET, INSTANCE_TOKEN, SESSION_TOKEN) devem ser alteradas para valores únicos e seguros. Você pode gerar tokens e segredos usando ferramentas online ou comandos do Linux.

    Iniciando os Containers

    Com o arquivo docker-compose.yml configurado, você pode iniciar os serviços:

    docker compose up -d
    

    O comando -d executa os containers em modo detached (em segundo plano). Para verificar se tudo está funcionando, você pode listar os containers:

    docker ps
    

    Você deverá ver os containers n8n, evolution-api, postgres_db e postgres_db_evolution em execução.

    Configurando o Proxy Reverso (Nginx)

    Para acessar o n8n e a Evolution API de forma segura e através de um domínio, é altamente recomendado configurar um proxy reverso, como o Nginx. Se você ainda não tem o Nginx instalado, pode fazê-lo com sudo apt install nginx.

    Crie um novo arquivo de configuração para seu domínio (substitua n8n.seudominio.com e evolution.seudominio.com):

    sudo nano /etc/nginx/sites-available/n8n-evolution
    

    Adicione a seguinte configuração, adaptando os nomes de domínio e caminhos:

    
    server {
        listen 80;
        server_name n8n.seudominio.com evolution.seudominio.com;
    
        location / {
            proxy_pass http://localhost:5678;
            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;
        }
    
        location /api/v1/ {
            proxy_pass http://localhost:5000/;
            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;
        }
    
        # Opcional: Configuração para HTTPS com Let's Encrypt (recomenda-se)
        # listen 443 ssl;
        # ssl_certificate /etc/letsencrypt/live/n8n.seudominio.com/fullchain.pem;
        # ssl_certificate_key /etc/letsencrypt/live/n8n.seudominio.com/privkey.pem;
        # include /etc/letsencrypt/options-ssl-nginx.conf;
        # ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
    }
    

    Ative a configuração e reinicie o Nginx:

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

    Após configurar o DNS para apontar seus subdomínios para o IP do seu VPS, você poderá acessar o n8n em http://n8n.seudominio.com (ou https:// se configurou SSL) e a Evolution API em http://evolution.seudominio.com.

    Otimizando a Performance do n8n e Evolution API

    Para garantir que sua automação de WhatsApp com n8n e Evolution API rode de forma eficiente, algumas otimizações podem ser aplicadas. A performance do n8n, especialmente, pode ser um ponto de atenção em fluxos complexos. A escolha de um servidor com recursos adequados, como o recomendado de 4GB de RAM e 4 vCPUs, é o primeiro passo. Se você precisar de mais detalhes sobre como otimizar a performance do N8N em seu ambiente auto-hospedado, este guia pode oferecer insights valiosos sobre ajustes de configuração e monitoramento.

    Ajustes no N8N

    • Workers: Se você tem múltiplos fluxos de trabalho complexos rodando simultaneamente, considere aumentar o número de workers no n8n. Isso pode ser feito através da variável de ambiente N8N_WORKER_COUNT.
    • Banco de Dados: Utilize um banco de dados robusto como PostgreSQL (como no exemplo) e certifique-se de que ele esteja bem configurado. Para volumes muito grandes, considere um servidor de banco de dados dedicado.
    • Cache: O n8n utiliza cache internamente. Para cenários de alta carga, o uso de um cache externo como Redis pode ser explorado, embora muitas vezes a configuração padrão já seja suficiente.

    Ajustes na Evolution API

    • Recursos Dedicados: Se o volume de mensagens via WhatsApp for muito alto, alocar recursos de CPU e RAM dedicados para o container da Evolution API pode ser necessário. Isso pode envolver rodar a Evolution API em um Docker Compose separado ou em um servidor diferente.
    • Conexão: Garanta que sua conexão de rede seja estável e com baixa latência para o servidor da Evolution API, especialmente se ele estiver hospedado em um VPS diferente.

    Erros Comuns e Soluções

    Ao implantar o n8n-evolution-combo, alguns problemas podem surgir. Conhecer as causas comuns e suas soluções pode economizar muito tempo.

    • Containers não iniciam ou reiniciam: Verifique os logs dos containers com docker compose logs [nome_do_container]. Erros de configuração, senhas incorretas ou falta de recursos (RAM) são as causas mais frequentes. Se um container reinicia constantemente, o problema pode ser falta de memória ou um bug na aplicação. Para mais detalhes, consulte este artigo sobre erros em containers.
    • Acesso negado ao n8n/Evolution API: Verifique a configuração do proxy reverso (Nginx) e as regras de firewall. Certifique-se de que as portas corretas estejam abertas e que o Nginx esteja corretamente configurado para repassar as requisições para os containers Docker.
    • Problemas de conexão com o banco de dados: Revise as variáveis de ambiente no docker-compose.yml, especialmente os nomes de usuário, senhas e nomes do banco de dados. Verifique se os containers do PostgreSQL estão rodando e acessíveis pela rede Docker.
    • Webhooks não funcionam: Para webhooks do n8n, certifique-se de que o WEBHOOK_URL esteja corretamente configurado e que a porta 443 (ou outra porta configurada para SSL) esteja acessível externamente e sendo repassada corretamente pelo proxy reverso. Para webhooks da Evolution API, garanta que o URL configurado no painel da Meta esteja correto e que o servidor esteja acessível.

    Perguntas Relacionadas

    O que é o n8n-evolution-combo?

    O n8n-evolution-combo refere-se à combinação do n8n, uma plataforma de automação de fluxo de trabalho visual, com a Evolution API, uma solução para integrar o WhatsApp ao seu sistema. Ao hospedar essa combinação em um VPS, você obtém uma infraestrutura poderosa e personalizável para suas necessidades de automação.

    Quais os requisitos mínimos para rodar o n8n e Evolution API em um VPS?

    Para produção, recomendamos um VPS com no mínimo 4GB de RAM e 4 vCPUs, além de 50GB de armazenamento SSD. Isso garante que ambos os serviços, junto com seus bancos de dados e proxy reverso, funcionem de maneira estável e performática.

    É possível rodar n8n e Evolution API no mesmo VPS?

    Sim, é totalmente possível e comum rodar ambos no mesmo VPS utilizando Docker Compose, como demonstrado neste guia. Para volumes de tráfego muito altos, considere alocar recursos dedicados ou até mesmo servidores separados para cada componente.

    Como faço para acessar o n8n após a instalação?

    Após a instalação via Docker Compose e a configuração de um proxy reverso (como Nginx), você acessará o n8n através do domínio ou IP configurado para ele (ex: http://n8n.seudominio.com). Se não usar proxy reverso, acesse diretamente pela porta configurada (http://SEU_IP:5678).

    Comparativo: n8n Auto-Hospedado vs. Serviços Gerenciados

    A escolha entre auto-hospedar o n8n-evolution-combo e utilizar um serviço gerenciado envolve um trade-off entre controle e conveniência. Para quem busca máxima flexibilidade e controle sobre os dados e a infraestrutura, a auto-hospedagem é o caminho ideal. Serviços gerenciados podem ser mais fáceis de começar, mas limitam a customização e podem se tornar caros em escala.

    Recurso n8n Auto-Hospedado (VPS) n8n Serviço Gerenciado (Ex: n8n Cloud)
    Custo Variável (custo do VPS + tempo de gestão) Mensal/Anual baseado em uso (execuções, n° de workflows)
    Controle e Flexibilidade Total. Customização completa de ambiente e integrações. Limitado. Depende das opções oferecidas pelo provedor.
    Segurança dos Dados Responsabilidade sua. Alto controle sobre dados sensíveis. Depende das políticas do provedor. Compartilhamento de infraestrutura.
    Manutenção Requer conhecimento técnico para atualizações e resolução de problemas. Gerenciada pelo provedor. Plug-and-play.
    Escalabilidade Escala com o seu VPS. Possibilidade de otimização customizada. Escala automaticamente até os limites do plano contratado.
    Integração com Evolution API Totalmente possível e recomendada para controle máximo. Depende das políticas de conexão externa e uso de portas. Pode ser mais restrito.

    Conclusão e Próximos Passos

    Implantar o n8n-evolution-combo em seu próprio VPS, como detalhado neste guia, capacita você a construir soluções de automação robustas e seguras, com foco especial na integração de WhatsApp via Evolution API. A infraestrutura auto-hospedada oferece o controle e a flexibilidade necessários para otimizar sua operação, garantindo que suas automações funcionem de maneira confiável.

    Para colocar sua estratégia de automação em prática com a infraestrutura ideal desde o início, recomendamos o plano VPS Brasil Básico. Com 4GB de RAM e 4 vCPUs, ele oferece os recursos essenciais para rodar o n8n-evolution-combo e outras aplicações de forma estável e performática. Nossos clientes rodam essa mesma stack em uma VPS Brasil Básico, garantindo confiabilidade e custo-benefício.

    Comece hoje mesmo a construir suas automações sem limites. Conheça o plano VPS Brasil Básico e garanta sua infraestrutura de automação!

    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

    O que é o n8n-evolution-combo e para que serve?

    O n8n-evolution-combo é a junção do n8n, uma ferramenta de automação de fluxo de trabalho visual, com a Evolution API, que permite integrar o WhatsApp ao seu sistema. Juntos, eles criam uma poderosa plataforma para automatizar tarefas, como envio de mensagens, notificações e interações com clientes via WhatsApp, diretamente do seu servidor.

    Quais são os requisitos de hardware para rodar o n8n e a Evolution API em produção?

    Para um ambiente de produção estável, recomendamos um VPS com no mínimo 4GB de RAM e 4 vCPUs. Além disso, um armazenamento SSD de pelo menos 50GB é crucial para o desempenho. Recursos adicionais podem ser necessários dependendo da complexidade dos seus fluxos de trabalho e do volume de mensagens processadas.

    Posso usar um único VPS para n8n e Evolution API? Como configurar?

    Sim, é possível e prático rodar ambos no mesmo VPS utilizando Docker Compose. O arquivo de configuração gerencia os containers do n8n, Evolution API e seus bancos de dados. Recomendamos o uso de um proxy reverso como Nginx para gerenciar o acesso e garantir a segurança através de domínios.

    Qual a importância do Docker e Docker Compose para esta implantação?

    Docker e Docker Compose simplificam drasticamente a implantação e o gerenciamento do n8n-evolution-combo. Eles encapsulam as dependências, garantem a consistência entre ambientes e facilitam a configuração e o escalonamento dos serviços, tornando o processo de setup muito mais rápido e livre de conflitos.

    Como configurar o acesso externo ao n8n e Evolution API após a instalação?

    É altamente recomendado configurar um proxy reverso, como o Nginx. Ele permite expor seus serviços de forma segura através de um domínio (ex: n8n.seudominio.com), gerenciar certificados SSL (HTTPS) e direcionar o tráfego corretamente para os containers Docker, protegendo seu servidor.

    Quais são os benefícios de hospedar o n8n e Evolution API em um VPS em vez de usar soluções em nuvem?

    Hospedar em um VPS oferece controle total sobre seus dados e infraestrutura, maior flexibilidade para customizações, segurança aprimorada com políticas próprias e, em muitos casos, um custo-benefício superior para volumes maiores de automação. Você não fica preso às limitações de um serviço gerenciado.

    Como lidar com problemas de performance ou containers reiniciando?

    Verifique os logs dos containers com `docker compose logs [nome_do_container]`. Falta de RAM, configurações incorretas de ambiente ou erros de código são causas comuns. Para performance, otimize os fluxos no n8n, ajuste o número de workers e garanta que o banco de dados e o VPS tenham recursos adequados.

    Qual plano de VPS você recomenda para rodar o n8n-evolution-combo?

    Para uma experiência de produção confiável e sem gargalos, o plano VPS Brasil Básico, com 4GB de RAM e 4 vCPUs, é ideal. Ele fornece os recursos necessários para o n8n, Evolution API, bancos de dados e proxy reverso funcionarem de forma estável e performática. Nossos clientes utilizam essa configuração com sucesso.

    Comentários (2)

    Ana Alves

    Excelente conteúdo! Aprendi conceitos que não encontrava em outros lugares em português.

    Julia Ferreira

    Artigo muito bem escrito e explicativo! Já compartilhei com toda a equipe da empresa.

    ← Voltar para o blog