Como instalar n8n no VPS com Docker e Docker Compose

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:

  1. Um VPS rodando Linux: As distribuições mais comuns são Ubuntu, Debian ou CentOS. É importante ter um VPS com acesso root ou sudo.

  2. Docker instalado: Docker precisa estar instalado e funcionando no servidor. Para verificar, rode o comando “docker -v”.

  3. Docker Compose instalado: Essa ferramenta auxilia no gerenciamento de containers múltiplos. Verifique com “docker-compose -v”.

  4. Acesso SSH ao VPS: Para fazer os comandos e transferir arquivos.

  5. Configuração de firewall: Certifique-se de liberar as portas que serão usadas pelo n8n, geralmente a 5678.

  6. 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:

  1. Acessar o VPS: Logue via SSH usando:
    ssh usuario@ipdoservidor

  2. Criar um diretório para o n8n:
    mkdir -p ~/n8n
    cd ~/n8n

  3. Criar 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

  1. Salvar o arquivo e iniciar o container:
    docker-compose up -d

  2. Acessar 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.

  1. Ativar autenticação básica: No arquivo docker-compose.yml, habilitamos o N8NBASICAUTH para que o acesso exija usuário e senha.

  2. 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.

  3. Backups regulares: Salvar o volume onde ficam os dados do n8n é vital para não perder fluxos e credenciais.

  4. Atualizações periódicas: Mantenha a imagem do n8n atualizada para receber correções de bugs e segurança.

  5. Monitoramento do container: Use ferramentas como Portainer ou comandos docker para verificar o status do container.

  6. 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.