n8n: Deploy em VPS para Automação Completa

O que é n8n e por que hospedá-lo em um VPS?

O n8n é uma plataforma de automação de fluxo de trabalho (workflow) de código aberto que se destaca pela sua interface visual intuitiva e pela capacidade de integrar centenas de serviços e APIs. Ao contrário de muitas ferramentas SaaS, o n8n pode ser auto-hospedado, o que significa que você pode rodá-lo em seu próprio servidor, como um VPS. A hospedagem em um VPS oferece controle total sobre seus dados, personalização ilimitada e a possibilidade de processar volumes maiores de automações sem se preocupar com limites de planos ou custos escalonados de forma imprevisível.

Na minha experiência ajudando clientes a otimizar seus processos, a decisão de migrar o n8n para um VPS geralmente vem da necessidade de maior segurança, privacidade de dados e a capacidade de criar integrações mais complexas e privadas entre sistemas internos. Uma implantação bem-sucedida em um VPS garante que seus workflows operem de forma autônoma e segura, 24 horas por dia. Para iniciar, você precisará de um servidor VPS com Linux, como Ubuntu, e o Docker instalado. Recomendo um servidor com pelo menos 2GB de RAM e 2 vCPUs para a maioria dos casos de uso iniciais, mas mais sobre requisitos adiante.

Requisitos de Servidor para n8n em Produção

Dimensionar corretamente seu servidor VPS é crucial para garantir que o n8n funcione de maneira eficiente e estável. Rodar o n8n em produção envolve não apenas o próprio aplicativo n8n, mas também seu banco de dados (geralmente PostgreSQL ou SQLite, mas PostgreSQL é recomendado para produção) e, possivelmente, um proxy reverso como Nginx ou Traefik. Cada um desses componentes consome recursos.

Recursos Mínimos Recomendados

Para um ambiente de produção básico, onde você planeja executar dezenas ou centenas de workflows, o mínimo absoluto recomendado é:

• RAM: 4GB. O n8n em si pode consumir 1-2GB em repouso, e o banco de dados e o sistema operacional adicionam outra carga. Para múltiplos workflows complexos ou grande volume de execuções, 6GB ou 8GB são mais seguros.
• vCPUs: 2. Suficiente para a maioria das operações, mas cargas de trabalho intensas podem se beneficiar de 4 vCPUs.
• Armazenamento: 50GB de SSD. Isso acomoda o sistema operacional, Docker, imagens, logs, o banco de dados e backups. O crescimento do banco de dados e dos logs de execução é o principal fator de consumo de espaço.

Otimizando o Desempenho

Se você antecipa um uso intensivo, com centenas de workflows ativos e execuções frequentes, considere aumentar os recursos para:

• RAM: 8GB ou mais.
• vCPUs: 4 ou mais.
• Armazenamento: 100GB+ de SSD com boa performance de I/O.

A escolha entre SQLite e PostgreSQL também impacta o desempenho. Para produção, o PostgreSQL é altamente recomendado por sua robustez, escalabilidade e recursos avançados de gerenciamento de dados. Ele tende a consumir mais RAM e CPU que o SQLite, mas oferece estabilidade superior.

Passo a Passo: Implantando n8n em um VPS com Docker

A forma mais prática e recomendada de implantar o n8n em um VPS é utilizando Docker e Docker Compose. Isso encapsula o n8n e suas dependências em contêineres isolados, facilitando a instalação, atualização e gerenciamento.

Pré-requisitos

Antes de começar, certifique-se de ter:

• Um servidor VPS com Ubuntu 22.04 LTS ou superior.
• Acesso SSH ao seu servidor com privilégios de root ou sudo.
• Docker e Docker Compose instalados. Se ainda não os tem, siga o guia oficial para instalação em Ubuntu. Geralmente, envolve adicionar o repositório Docker e instalar os pacotes `docker-ce`, `docker-ce-cli`, `containerd.io`, `docker-compose-plugin`.

Configuração do Docker Compose

Crie um diretório para o seu projeto n8n e navegue até ele:

mkdir n8n-deploy
cd n8n-deploy

Dentro deste diretório, crie um arquivo chamado `docker-compose.yml`. Este arquivo definirá os serviços necessários para rodar o n8n, incluindo o próprio n8n e um banco de dados PostgreSQL.

version: "3"

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=your_domain.com # Substitua pelo seu domínio ou IP
      - N8N_PORT=5678
      - WEBHOOK_URL=https://your_domain.com/ # Substitua pelo seu domínio ou IP com scheme (http/https)
      - DB_POSTGRES_HOST=db
      - DB_POSTGRES_PORT=5432
      - DB_POSTGRES_DATABASE=n8n
      - DB_POSTGRES_USER=n8n
      - DB_POSTGRES_PASSWORD=your_strong_password # Use uma senha forte e segura!
      - N8N_BASIC_AUTH_ACTIVE=true # Opcional: habilita autenticação básica
      - N8N_BASIC_AUTH_USER=admin # Opcional: usuário para autenticação básica
      - N8N_BASIC_AUTH_PASSWORD=your_admin_password # Opcional: senha para autenticação básica
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - db

  db:
    image: postgres:13
    container_name: n8n_db
    restart: always
    environment:
      - POSTGRES_PASSWORD=your_strong_password # Mesma senha usada acima
      - POSTGRES_USER=n8n # Mesma usuário usado acima
      - POSTGRES_DB=n8n # Mesma database usada acima
    volumes:
      - n8n_db_data:/var/lib/postgresql/data

volumes:
  n8n_data:
  n8n_db_data:

Observações importantes:

• Substitua your_domain.com pelo seu domínio real ou o endereço IP público do seu VPS. Se estiver usando HTTPS, certifique-se de que o `WEBHOOK_URL` inclua `https://`.
• Troque your_strong_password e your_admin_password por senhas seguras e únicas.
• A autenticação básica (N8N_BASIC_AUTH_ACTIVE) é opcional, mas altamente recomendada para proteger seu painel n8n.
• As portas 5678:5678 mapeiam a porta do contêiner para a porta do host. Se a porta 5678 já estiver em uso no seu VPS, você pode alterar o número à esquerda (ex: 8080:5678).

Iniciando os Contêineres

Execute o seguinte comando no mesmo diretório onde você salvou o `docker-compose.yml` para baixar as imagens e iniciar os contêineres:

docker compose up -d

O comando -d executa os contêineres em segundo plano (detached mode). Após a execução, você pode verificar o status dos contêineres com:

docker compose ps

Você deverá ver os contêineres `n8n` e `n8n_db` rodando.

Configurando o Proxy Reverso (Nginx)

Para acessar o n8n de forma segura e através de um domínio, é essencial configurar um proxy reverso. Usaremos o Nginx como exemplo. Primeiro, instale o Nginx em seu VPS se ainda não o tiver: sudo apt update && sudo apt install nginx.

Crie um novo arquivo de configuração para o n8n em /etc/nginx/sites-available/:

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

Cole o seguinte conteúdo, substituindo your_domain.com pelo seu domínio real:

server {
    listen 80;
    server_name your_domain.com;

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

Ative a configuração do Nginx e reinicie o serviço:

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

Se você usou um domínio, agora é o momento de configurar seu DNS para apontar para o IP do seu VPS. Para configurar HTTPS com Let's Encrypt, você pode usar o Certbot: sudo apt install certbot python3-certbot-nginx e então rodar sudo certbot --nginx -d your_domain.com. O Certbot configurará automaticamente o SSL e redirecionamentos.

Agora você pode acessar seu n8n pela URL configurada (ex: http://your_domain.com ou https://your_domain.com).

Gerenciando Workflows e Integrações

Com o n8n instalado e acessível, você pode começar a criar seus workflows. A interface web permite adicionar nós (nodes) que representam serviços, ações ou lógica de processamento. Você pode conectar esses nós para construir fluxos de dados e automações complexas.

Nodes e Conectores

O n8n possui centenas de conectores pré-construídos para serviços populares como Google Sheets, Trello, Slack, databases SQL, APIs REST e muitos outros. Cada conector é um nó que você pode adicionar ao seu workflow. Ao configurar um nó, você geralmente precisará fornecer credenciais de autenticação (API keys, tokens, etc.) para que o n8n possa interagir com o serviço externo.

Automação de Tarefas Repetitivas

O principal benefício do n8n é a automação de tarefas manuais e repetitivas. Exemplos incluem:

• Enviar e-mails automáticos com base em gatilhos de dados.
• Sincronizar dados entre diferentes aplicativos (CRM, planilhas, bancos de dados).
• Gerar relatórios e enviá-los periodicamente.
• Processar e enriquecer dados de APIs externas.
• Notificar equipes sobre eventos importantes.

Se você precisa integrar diversas ferramentas sem escrever código complexo, o n8n em um VPS é uma solução poderosa. Para uma visão mais aprofundada sobre como aproveitar ao máximo os workflows, confira nosso artigo sobre N8N em VPS: Seu Workflow Autônomo na Nuvem.

Erros Comuns e Soluções

Ao implantar e gerenciar o n8n em um VPS, alguns problemas podem surgir. Estar ciente deles pode economizar tempo e dor de cabeça.

Problemas de Acesso e Portas

Causa: Portas bloqueadas pelo firewall do servidor ou conflito de porta com outro serviço.

Solução: Certifique-se de que a porta que o n8n está usando (padrão 5678) e a porta do seu proxy reverso (80 para HTTP, 443 para HTTPS) estejam abertas no firewall do seu VPS (ex: sudo ufw allow 5678/tcp, sudo ufw allow 80/tcp, sudo ufw allow 443/tcp). Verifique também se outro serviço não está escutando na porta 5678.

Workflows Não Executam Webhooks

Causa: O WEBHOOK_URL está incorreto ou inacessível externamente, ou o proxy reverso não está configurado corretamente para encaminhar requisições para a porta 5678.

Solução: Verifique se o `WEBHOOK_URL` no seu `docker-compose.yml` corresponde exatamente à URL pública que você está usando para acessar o n8n (incluindo `http://` ou `https://`). Confirme que seu Nginx está encaminhando corretamente as requisições. Se você usa um domínio, garanta que o DNS esteja propagado corretamente.

Desempenho Lento ou Instável

Causa: Recursos insuficientes no VPS (RAM, CPU) ou uso de SQLite em produção.

Solução: Monitore o uso de recursos do seu servidor. Se a RAM ou CPU estiverem constantemente altas, considere um upgrade do seu plano VPS. Para ambientes de produção, migre do SQLite para PostgreSQL. Se você ainda não configurou um proxy reverso, saiba que ele também é crucial para o desempenho e segurança: veja como fazer isso com o Docker no VPS: Deploy Rápido e Eficiente.

Perguntas Relacionadas

O n8n consome muitos recursos?

O consumo de recursos do n8n depende muito da complexidade dos seus workflows e da frequência de execução. Em repouso, um contêiner n8n com PostgreSQL pode consumir entre 1GB a 2GB de RAM. Workflows com muitas execuções, processamento de grandes volumes de dados ou muitas integrações simultâneas exigirão mais, podendo chegar a 4GB ou mais em cenários de alta carga.

Posso usar o n8n gratuitamente?

Sim, a versão auto-hospedada do n8n é completamente gratuita e de código aberto. Você só arca com os custos da infraestrutura onde ele roda, como um VPS. A versão em nuvem do n8n oferece planos pagos com recursos adicionais e suporte, mas para controle total e sem custos recorrentes de licença, a auto-hospedagem é a escolha ideal.

Qual a diferença entre n8n e Zapier?

O Zapier é uma ferramenta SaaS com planos pagos e limites de uso. O n8n, quando auto-hospedado, oferece controle total, maior flexibilidade e sem custos de licença além da infraestrutura. Ambos oferecem interfaces visuais para criar automações, mas o n8n tende a ser mais poderoso para integrações complexas e personalizadas.

Comparativo: n8n Auto-Hospedado vs. n8n Cloud

A escolha entre hospedar seu próprio n8n ou usar a versão em nuvem oficial depende das suas necessidades específicas de segurança, controle e orçamento.

VPS Barato para N8N: Quanto Custa Rodar sua Automação?

Um VPS para rodar N8N com custo controlado começa em R$49/mês na You Secure, com 2GB de RAM e 2 vCPUs — o suficiente para quem está começando com poucos workflows ativos. Mas o preço certo depende diretamente de quantos workflows você roda ao mesmo tempo, com que frequência e se usa nós pesados como IA, scraping ou processamento de arquivos grandes.

Uso leve (1 a 5 workflows, execuções esporádicas): o plano VPS Brasil Starter, com 2GB de RAM, 2 vCPUs e 25GB NVMe por R$49/mês, cobre bem o N8N rodando com PostgreSQL via Docker Compose. É o ponto de entrada ideal para automações pessoais, integrações simples entre WhatsApp e planilhas, ou testes antes de escalar.

Uso moderado (múltiplos workflows, webhooks recebendo tráfego constante, integrações com CRM/e-commerce): o VPS Brasil Básico, com 4GB de RAM, 4 vCPUs e 100GB NVMe por R$99/mês, evita que o N8N trave quando várias execuções concorrentes competem por memória — algo comum quando você conecta Evolution API, Typebot e N8N no mesmo fluxo de atendimento.

Uso intenso (dezenas de workflows ativos, automações com IA, múltiplas instâncias ou N8N rodando junto de Chatwoot/Mautic/Metabase no mesmo servidor): o VPS Brasil Performance, com 12GB de RAM, 6 vCPUs e 150GB NVMe por R$159/mês, é o plano mais vendido para quem já depende do N8N em produção e precisa de folga real de memória para picos de execução.

Um erro comum é contratar um VPS genérico de fora do Brasil (Hetzner, Contabo) achando que é mais barato — mas depois de converter o dólar/euro, pagar imposto de importação de serviço e lidar com 150–220ms de latência até São Paulo, o "barato" some rápido. Os três planos acima já incluem NVMe, proteção anti-DDoS, backup semanal e suporte em português, com pagamento via Pix — sem letras miúdas nem cobrança em moeda estrangeira.

Na prática, para a maioria de quem está começando com N8N, o Starter a R$49/mês já resolve. Se o workflow crescer e começar a engasgar (execuções lentas, erros de memória no PostgreSQL), migrar para o Básico ou Performance é só um upgrade de plano, sem precisar reinstalar nada.

Deploy Automático do N8N em VPS: CI/CD com GitHub Actions

Deploy automático do N8N em VPS funciona assim: você conecta o servidor a um pipeline de GitHub Actions que, a cada git push, conecta via SSH e roda docker compose pull && docker compose up -d — atualizando o container sem intervenção manual. Combinado com restart: unless-stopped no docker-compose.yml (ou uma unit systemd supervisionando o Docker), o N8N volta sozinho após queda de energia, reboot do VPS ou falha do container. Isso resolve o maior ponto fraco de uma instalação manual: toda atualização de versão, hoje, depende de alguém logar via SSH e rodar os comandos na mão.

Pipeline mínimo: GitHub Actions + SSH

Não é preciso um pipeline complexo. Um workflow simples em .github/workflows/deploy.yml já cobre o caso de uso mais comum — atualizar a versão do N8N ou aplicar mudanças de configuração ao dar push na branch principal:

name: Deploy N8N
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.VPS_HOST }}
          username: ${{ secrets.VPS_USER }}
          key: ${{ secrets.VPS_SSH_KEY }}
          script: |
            cd /opt/n8n
            docker compose pull
            docker compose up -d

As credenciais (host, usuário, chave SSH) ficam em GitHub Secrets, nunca no repositório. Esse pipeline roda em segundos e garante que a versão em produção do N8N nunca fique desatualizada manualmente.

Auto-restart: systemd e restart policies do Docker

Deploy automático sem recuperação automática de falhas resolve só metade do problema. Para o N8N voltar sozinho depois de um crash ou reboot do VPS, use restart: unless-stopped (ou always) no docker-compose.yml — o Docker daemon reinicia o container automaticamente. Se o Docker em si precisar sobreviver a reboots, confirme que o serviço está habilitado com systemctl enable docker, o que garante que os containers com restart policy voltem junto na inicialização do servidor.

Auto-update controlado: watchtower ou cron

Para quem quer atualizações automáticas do N8N sem depender de push manual, uma alternativa é rodar o Watchtower monitorando o container e aplicando novas imagens automaticamente, ou um cron simples rodando docker compose pull && docker compose up -d em horário de baixo tráfego. A recomendação é reservar auto-update total para ambientes de teste — em produção, o pipeline via GitHub Actions dá controle sobre quando cada atualização entra no ar.

Conclusão e Próximos Passos

Hospedar o n8n em um VPS é uma estratégia poderosa para empresas e indivíduos que buscam automação robusta, segura e escalável. Ao seguir este guia, você está apto a implantar seu próprio ambiente n8n, desde a configuração do servidor até o deploy via Docker e o setup do proxy reverso. A capacidade de controlar seus dados e personalizar suas integrações é um diferencial imenso.

Para começar com o pé direito, recomendamos o plano VPS Brasil Starter da Host You Secure. Ele oferece a configuração ideal para iniciar com o n8n, combinando performance e custo-benefício. Subimos essa configuração em uma VPS Brasil Starter antes de publicar este guia e a experiência foi excelente para rodar o n8n e um banco de dados PostgreSQL sem gargalos.

Comece a automatizar seus processos hoje mesmo! Descubra o poder do n8n self-hosted e transforme sua infraestrutura com automações eficientes.

Quero meu VPS Brasil Starter por R$ 49/mês