Solução da comunidade

Instalar o n8n no CasaOS ou no ZimaOS com estado persistente

A 2023 CasaOS tutorial walked through getting a working n8n container running on a home server.

Em resumo: o n8n precisa mais de estado persistente e de um URL público estável do que de uma instalação complexa

O antigo tutorial do CasaOS mostrava que o n8n pode ser executado como um contentor. Para uma implementação autoalojada atual, concentre-se em quatro aspetos: dados persistentes do n8n, um nome de anfitrião estável, HTTPS para webhooks e armazenamento suficiente para o histórico de execuções. Estes detalhes são muito mais importantes do que o pacote original de instalação com um clique.

Comece com uma implementação persistente num único contentor

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    volumes:
      - /path/to/n8n:/home/node/.n8n
    environment:
      - TZ=UTC

O repositório oficial do n8n é o projeto de origem. A documentação de volumes da Docker explica por que motivo o estado da aplicação não deve existir apenas na camada do contentor.

Coloque o diretório de dados do n8n num armazenamento SSD persistente

As credenciais, os fluxos de trabalho, o estado de encriptação e os metadados de execução têm de sobreviver à recriação do contentor. Se perder o diretório persistente do n8n e não tiver uma cópia de segurança com reconhecimento da aplicação, recriar o contentor não irá restaurar o seu sistema de automação.

O guia de requisitos de hardware do n8n aborda o momento em que o histórico de execuções e as bases de dados alojadas em conjunto começam a ser relevantes.

Os webhooks precisam do URL que os utilizadores realmente utilizam

Quando o n8n está atrás de um proxy inverso, o nome de anfitrião HTTPS externo tem de corresponder ao URL do webhook anunciado pelo n8n. Caso contrário, o editor pode funcionar enquanto os webhooks de entrada apontam para o anfitrião, esquema ou porta errados.

Utilize PostgreSQL quando a pilha de fluxos de trabalho crescer

As instalações pessoais pequenas podem começar de forma simples. À medida que aumentam a simultaneidade, as execuções retidas e a importância da automação, transfira a base de dados para um serviço PostgreSQL gerido de forma deliberada, em vez de tratar a base de dados local predefinida como uma arquitetura de produção ilimitada.

O diretório de hardware da App Store do ZimaOS ajuda a dimensionar a pilha de automação completa, e não apenas o n8n.

Não exponha diretamente o editor sem HTTPS e autenticação

O n8n armazena credenciais e pode executar fluxos de trabalho poderosos. Mantenha o editor protegido por autenticação de confiança e HTTPS, e restrinja a exposição pública aos endpoints que realmente precisam de receber tráfego.