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.
