Alojar o n8n no seu próprio servidor

O n8n é uma ferramenta de automatização que liga aplicações e permite criar fluxos de trabalho. Pode executá-lo no seu próprio VPS com Docker. A documentação oficial explica uma instalação com Docker Compose e recomenda o alojamento próprio a quem tem experiência técnica. Os guias de instalação não indicam valores de CPU, RAM ou disco, por isso faz sentido começar com um servidor pequeno e aumentar à medida que o observa.

Este artigo aborda a licença, os passos de instalação, as definições que importam, as cópias de segurança e as atualizações.

O que se constrói com o n8n?

Um fluxo de trabalho no n8n é um gatilho mais os passos ligados a ele. O gatilho pode ser um agendamento, um webhook ou um evento noutra aplicação. Exemplos típicos: gravar o envio de um formulário numa folha de cálculo, avisar a equipa de uma nova encomenda, ou reunir um relatório todas as manhãs e enviá-lo por e-mail. Os fluxos criam-se num editor visual no navegador. Não é preciso escrever código, mas pode acrescentar um passo de código se quiser.

Porquê executá-lo no seu próprio servidor?

• Os seus fluxos e os dados de ligação guardados ficam no seu próprio servidor.
• Os fluxos agendados continuam a correr no servidor enquanto o seu computador está desligado, e os webhooks podem acioná-los a partir do exterior.
• O seu limite de utilização é definido pela potência do servidor e, se não chegar, aumenta o servidor.
• Em troca, a manutenção é sua: atualizações, cópias de segurança e segurança.

Licença: o que permite a utilização gratuita?

O n8n não é código aberto. Pela sua própria descrição, é software «fair-code». O código-fonte está disponível, mas a Sustainable Use License restringe o uso comercial. Segundo a página oficial da licença, pode usá-lo gratuitamente nas operações internas da sua empresa e em projetos pessoais ou sem fins comerciais. Criar fluxos de trabalho para clientes como consultoria paga também é permitido, desde que os clientes não tenham acesso ao próprio n8n. Oferecer um serviço em que os clientes iniciam sessão no n8n para criar ou editar os seus próprios fluxos (alojar o n8n como serviço) exige uma licença comercial. Para casos limite, pergunte à equipa de licenciamento do n8n.

Passos de instalação

Estes passos seguem o guia oficial do Docker Compose. O guia obtém e renova o certificado HTTPS através de um proxy inverso chamado Traefik.

1. Prepare um servidor Linux com o Docker Engine e o Docker Compose instalados. Verifique com docker --version e docker compose version.
2. Adicione um registo A que aponte um subdomínio do seu domínio (por exemplo n8n.example.com) para o endereço IP do servidor. Como ligar o seu próprio domínio explica-lhe o processo.
3. Crie no servidor os ficheiros .env e compose.yaml do guia oficial.
4. Preencha DOMAIN_NAME, SUBDOMAIN, GENERIC_TIMEZONE e SSL_EMAIL em .env. Use Europe/Istanbul para o fuso horário. Se o omitir, a predefinição é Nova Iorque.
5. Inicie-o: docker compose up -d
6. Abra o seu subdomínio num navegador e crie logo a conta de proprietário. Quem preencher primeiro esse ecrã torna-se o proprietário.

Definições que deve conhecer

O nó Webhook tem dois endereços: o endereço de teste funciona enquanto edita o fluxo e o endereço de produção funciona depois de o ativar. Dê aos serviços externos o endereço de produção. O início do endereço vem do valor de N8N_WEBHOOK_URL, por isso, se esse valor estiver errado, os serviços externos não chegam ao seu fluxo.

A chave de cifragem e as cópias de segurança

No primeiro arranque, o n8n gera uma chave de cifragem aleatória e guarda-a na sua pasta de dados (/home/node/.n8n). As suas ligações guardadas são cifradas com ela. Os dados de ligação numa base de dados restaurada não podem ser decifrados sem a chave. Guarde uma cópia da chave em separado.

• O que copiar: O volume de dados (n8n_data) contém a base de dados SQLite predefinida e a chave. Pare o n8n antes de copiar. Se usar PostgreSQL, faça a cópia da base de dados em separado, com as ferramentas próprias.
• Exportação rápida: Os comandos do n8n correm dentro do contentor. docker compose exec n8n n8n export:workflow --backup --output=/home/node/.n8n/backups/workflows/ e docker compose exec n8n n8n export:credentials --backup --output=/home/node/.n8n/backups/credentials/ gravam os fluxos e as ligações no volume de dados. Os utilizadores, o histórico de execuções e as definições não estão incluídos, por isso não chega para uma recuperação completa.
• Cópia de segurança do servidor: a Seturack faz uma cópia de segurança do seu servidor todas as noites e mantém os últimos 7 dias. Isso abrange também os dados do n8n, mas convém exportar em separado os fluxos críticos.

Recursos e base de dados

Os guias de instalação oficiais não indicam valores de CPU ou memória. Como regra prática, fluxos leves e pouco frequentes correm num servidor pequeno, enquanto fluxos que tratam ficheiros grandes ou muitos dados precisam de memória. Acompanhe a utilização real do contentor com docker stats. A base de dados predefinida é SQLite. Para uso intenso, passa para PostgreSQL com DB_TYPE=postgresdb e continua a manter o volume da pasta de dados.

Se o servidor não chegar, aumente-o no painel. O seu endereço IP e os seus dados mantêm-se, e os URL dos webhooks não mudam.

Atualizar

O guia oficial descreve a atualização em três comandos: docker compose pull, docker compose down e docker compose up -d. Faça primeiro uma cópia de segurança e leia as notas de versão. As atualizações do sistema operativo e das aplicações ficam ao seu cuidado depois da configuração.

Segurança

• Abra o n8n apenas por HTTPS. O guia oficial segue a mesma abordagem.
• Crie a conta de proprietário logo a seguir à configuração e escolha uma palavra-passe forte.
• Mantenha abertas na firewall apenas as portas 22, 80 e 443. Como o Docker ignora as regras do ufw nas portas que publica, não publique a porta 5678 do n8n para o exterior.

Se preferir dispensar estes passos, escolha o servidor com o n8n pré-instalado. Se o instalar por si, comece por um servidor com o Docker instalado.