Como integrar o n8n com um VPS da Hostinger e evitar erros comuns de conexão

Integrar o n8n, a plataforma de automação de fluxos de trabalho, a um VPS da Hostinger pode transformar a maneira como você gerencia tarefas repetitivas, oferecendo flexibilidade e desempenho sob demanda. Neste artigo, vamos guiá‑lo passo a passo na configuração do ambiente, desde a preparação do servidor até a resolução dos erros de conexão mais frequentes, garantindo uma integração estável e segura.

Preparando o VPS na Hostinger

Antes de tocar no n8n, é essencial que o seu VPS esteja pronto para receber aplicações modernas. Comece escolhendo um plano que ofereça recursos suficientes para o volume de automações que você pretende executar – CPU, RAM e espaço em disco são os principais indicadores. Após a criação do servidor, acesse‑o via SSH usando as credenciais fornecidas no painel da Hostinger.

Uma vez conectado, siga estas etapas básicas:

• Atualize o sistema: sudo apt update && sudo apt upgrade -y
• Instale o Node.js (versão 18 ou superior) e o gerenciador npm:
  curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt install -y nodejs
• Opcionalmente, instale o Docker para isolamento de contêineres:
  sudo apt install -y docker.io && sudo systemctl enable --now docker
• Configure o firewall (UFW) permitindo apenas as portas necessárias:
  sudo ufw allow OpenSSH && sudo ufw allow 5678/tcp && sudo ufw enable

Essas ações criam uma base segura e atualizada, reduzindo a probabilidade de erros de permissão ou incompatibilidade de versões ao instalar o n8n.

Configurando o n8n e resolvendo problemas de conexão

Com o VPS preparado, é hora de instalar o n8n. Existem duas abordagens populares: instalação direta via npm ou uso de Docker. Abaixo, explicamos a instalação com Docker, que costuma ser a mais simples para evitar conflitos de dependências.

1. Crie um diretório dedicado e defina variáveis de ambiente essenciais:

mkdir -p ~/n8n && cd ~/n8n
cat > .env <<EOF
# URL pública do seu servidor (substitua pelo IP ou domínio)
N8N_HOST=seu-dominio.com
# Porta interna do n8n
N8N_PORT=5678
# Token de segurança para a API
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=senhaSegura123
EOF

2. Inicie o contêiner:

docker run -d \
  --name n8n \
  -p 5678:5678 \
  --restart unless-stopped \
  -v $PWD:/home/node/.n8n \
  --env-file .env \
  n8nio/n8n

3. Verifique se o serviço está ativo navegando até http://seu-dominio.com:5678. Caso apareça um erro de “conexão recusada”, siga estas verificações:

• Porta bloqueada: confirme que a regra de firewall permite a porta 5678 e que o provedor de hospedagem não impõe restrições adicionais.
• Endereço incorreto: o N8N_HOST deve coincidir exatamente com o domínio ou IP público usado no navegador.
• SSL/TLS: se você habilitar HTTPS via proxy (Nginx ou Cloudflare), assegure‑se de que o proxy_set_header X-Forwarded-Proto $scheme esteja configurado; caso contrário, o n8n pode rejeitar requisições por “insecure connection”.
• Variáveis de autenticação: um basic auth errado impede acesso; verifique N8N_BASIC_AUTH_USER e N8N_BASIC_AUTH_PASSWORD no arquivo .env.

Se ainda houver falhas, examine os logs do contêiner: docker logs n8n. Mensagens como “EADDRINUSE” indicam que outra aplicação está usando a mesma porta