Rode o n8n com Docker Compose e Traefik no seu computador

Esta stack é para estudos e testes no seu computador. Ela coloca o n8n atrás do Traefik, o mesmo proxy reverso usado nas stacks de servidor deste hotsite. As configurações ficam em um arquivo .env. Assim você pratica com a mesma estrutura que vai encontrar depois em uma VPS de estudos.

Crie a pasta e o arquivo .env

Crie uma pasta chamada n8n-estudo e abra o terminal dentro dela. Grave este conteúdo em .env:

1
# Versão do n8n usada nos estudos
2
N8N_VERSION=2.45.5
3

4
# Endereço local do editor
5
N8N_HOST=n8n.localhost
6

7
# Fuso dos agendamentos e do container
8
GENERIC_TIMEZONE=America/Sao_Paulo

Navegadores atuais resolvem nomes terminados em .localhost para o seu próprio computador. Por isso n8n.localhost funciona sem editar arquivos do sistema.

Crie o compose.yaml

Na mesma pasta, grave compose.yaml:

1
services:
2
  traefik:
3
    image: traefik:v3
4
    restart: unless-stopped
5
    command:
6
      - "--providers.docker=true"
7
      - "--providers.docker.exposedbydefault=false"
8
      - "--entrypoints.web.address=:80"
9
    ports:
10
      - "80:80"
11
    volumes:
12
      - /var/run/docker.sock:/var/run/docker.sock:ro
13

14
  n8n:
15
    image: n8nio/n8n:${N8N_VERSION}
16
    container_name: n8n-estudo
17
    restart: unless-stopped
18
    labels:
19
      - traefik.enable=true
20
      - traefik.http.routers.n8n.rule=Host(`${N8N_HOST}`)
21
      - traefik.http.routers.n8n.entrypoints=web
22
      - traefik.http.services.n8n.loadbalancer.server.port=5678
23
    environment:
24
      - N8N_HOST=${N8N_HOST}
25
      - N8N_PROTOCOL=http
26
      - N8N_WEBHOOK_URL=http://${N8N_HOST}/
27
      - N8N_PROXY_HOPS=1
28
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
29
      - TZ=${GENERIC_TIMEZONE}
30
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
31
    volumes:
32
      - n8n_data:/home/node/.n8n
33

34
volumes:
35
  n8n_data:

O Compose lê o .env da mesma pasta e troca cada ${...} pelo valor do arquivo. O Traefik só publica serviços com traefik.enable=true e encaminha o endereço n8n.localhost para a porta 5678 do n8n. N8N_WEBHOOK_URL e N8N_PROXY_HOPS fazem o n8n mostrar a URL certa nos webhooks.

O volume n8n_data guarda o SQLite e a chave que cifra as credenciais. Para estudar, o SQLite atende.

Suba e abra o editor

1
docker compose up -d
2
docker compose ps

Abra http://n8n.localhost e cadastre o usuário owner. Se a página não abrir, leia os logs com docker compose logs n8n e docker compose logs traefik antes de mudar a configuração.

Confira a persistência

Crie um workflow de estudo e execute:

1
docker compose down
2
docker compose up -d

O workflow continua lá. O down remove os containers e preserva o volume. Acrescentar -v apaga o volume e tudo o que a instância guardou.

Para trocar de versão, mude N8N_VERSION no .env e siga o guia de atualização da instância de estudo.

Para montar ou revisar essa stack com orientação ao vivo, o Desenvolvimento Colaborativo da Dev Side Studio acompanha o trabalho no terminal, com você no controle dos comandos.