Pré-requisitos para instalar n8n com Docker Compose
Antes de iniciar a instalação do n8n no seu VPS usando Docker Compose, você precisa garantir alguns pontos importantes para que tudo funcione corretamente:
Um VPS rodando Linux: As distribuições mais comuns são Ubuntu, Debian ou CentOS. É importante ter um VPS com acesso root ou sudo.
Docker instalado: Docker precisa estar instalado e funcionando no servidor. Para verificar, rode o comando “docker -v”.
Docker Compose instalado: Essa ferramenta auxilia no gerenciamento de containers múltiplos. Verifique com “docker-compose -v”.
Acesso SSH ao VPS: Para fazer os comandos e transferir arquivos.
Configuração de firewall: Certifique-se de liberar as portas que serão usadas pelo n8n, geralmente a 5678.
Conhecimentos básicos de terminal: Noções simples de comandos Linux facilitam muito o processo.
Com esses pré-requisitos atendidos, você já está pronto para começar a instalar o n8n usando Docker Compose no seu VPS.
Passo a passo: Instalando n8n no VPS com Docker e Docker Compose
Agora que você tem o VPS preparado e docker e docker-compose instalados, vamos ao passo a passo para instalar o n8n:
Acessar o VPS: Logue via SSH usando:
ssh usuario@ipdoservidorCriar um diretório para o n8n:
mkdir -p ~/n8n
cd ~/n8nCriar o arquivo docker-compose.yml: Use seu editor favorito, por exemplo nano:
nano docker-compose.yml
Copie e cole o conteúdo básico:
version: ‘3’
services:
n8n:
image: n8nio/n8n
restart: always
ports:
– “5678:5678”
volumes:
– ~/.n8n:/home/node/.n8n
environment:
– N8NBASICAUTHACTIVE=true
– N8NBASICAUTHUSER=usuario
– N8NBASICAUTHPASSWORD=senhasegura
Salvar o arquivo e iniciar o container:
docker-compose up -dAcessar o n8n: Abra no navegador o endereço http://ipdoservidor:5678 e entre com o usuário e senha definidos.
Esse é o processo básico que te deixa com o n8n rodando em um container docker no seu VPS.
Como configurar n8n no VPS para produção e segurança
Depois de instalar o n8n com Docker Compose, é essencial configurar seu ambiente para produção e segurança, tratando pontos como autenticação, HTTPS, backup e monitoramento.
Ativar autenticação básica: No arquivo docker-compose.yml, habilitamos o N8NBASICAUTH para que o acesso exija usuário e senha.
Configurar HTTPS: Para proteger a comunicação, é recomendado usar um proxy reverso como Nginx com certificados SSL (Let’s Encrypt). Isso evita que dados fiquem expostos.
Backups regulares: Salvar o volume onde ficam os dados do n8n é vital para não perder fluxos e credenciais.
Atualizações periódicas: Mantenha a imagem do n8n atualizada para receber correções de bugs e segurança.
Monitoramento do container: Use ferramentas como Portainer ou comandos docker para verificar o status do container.
Limitar acesso ao VPS: Configure firewalls para liberar apenas IPs confiáveis e mantenha o sistema atualizado.
Seguindo esses passos, seu n8n estará rodando seguro e estável para projetos reais.