Instalar o n8n com Docker Compose num VPS

O n8n instala-se num VPS com Docker Compose: um ficheiro descreve o contentor, um comando arranca-o, e a interface fica na porta 5678. Este artigo mostra o que o ficheiro leva e porquê. Os detalhes que mudam com as versões estão na documentação oficial do n8n, que deve consultar para a versão actual.

O n8n é software de terceiros. A instalação e a manutenção são suas, num VPS não gerido. Não vendemos o n8n e o nosso suporte não o instala nem o repara. Veja até onde vai o nosso suporte.

Antes de começar

1 Um VPS com acesso root por SSH e o Docker com o Docker Compose instalados. Se ainda não os tem, siga instalar o Docker e o Docker Compose num VPS.
2 Um nome de domínio, se quiser usar o n8n a sério com HTTPS (o próximo artigo da série, n8n com HTTPS no seu domínio). Para um primeiro ensaio, o endereço IP chega.
3 Uma chave de encriptação gerada por si. Uma forma comum é openssl rand -hex 32, que escreve uma sequência aleatória. Guarde-a num gestor de palavras-passe, fora do servidor.

O que o ficheiro compose leva

Numa pasta própria (por exemplo /opt/n8n) crie um ficheiro compose.yaml com um só serviço. Os pontos que interessam são estes:

Campo O que pôr Porquê
image A imagem oficial do n8n, com uma versão fixa. Uma versão fixa evita saltos de versão inesperados. O nome exacto da imagem e das versões está na documentação oficial.
ports 127.0.0.1:5678:5678 A interface fica acessível só no próprio servidor. Quem entra é o proxy com HTTPS, não a internet.
environment N8N_ENCRYPTION_KEY, WEBHOOK_URL, GENERIC_TIMEZONE A chave protege as credenciais; o endereço público diz ao n8n que URL mostrar nos webhooks; o fuso põe os agendamentos à hora certa.
volumes Um volume persistente montado na pasta de dados do n8n. Sem ele, os fluxos e as credenciais perdem-se quando o contentor é recriado.
restart Reiniciar sempre, salvo paragem manual. O n8n volta sozinho depois de um reinício do servidor.

Arrancar e verificar

1 Na pasta do ficheiro, execute docker compose up -d. O Docker descarrega a imagem e arranca o serviço em segundo plano.
2 Confirme com docker compose ps que o serviço está a correr, e com docker compose logs que não há erros no arranque.
3 Ainda sem HTTPS, entre por um túnel SSH em vez de abrir a porta ao mundo: ssh -L 5678:localhost:5678 utilizador@endereço-do-servidor e depois abra http://localhost:5678 no seu computador.
4 Na primeira visita, o n8n pede para criar a conta de dono. Escolha uma palavra-passe forte e única.
Não perca nem mude a chave de encriptação. Com uma chave diferente, o n8n já não consegue ler as credenciais guardadas. E não ligue a porta 5678 directamente à internet sem HTTPS: a conta de dono e as credenciais passariam em claro. Veja portas e firewall num VPS.
Ponha a pasta do compose em cópia desde o primeiro dia, com o volume de dados. Veja a cópia de segurança do n8n.

O VPS não responde, ou o endereço não chega à máquina? Abra um pedido e verificamos o servidor.

Abrir um pedido de suporte

VEJA TAMBÉM

Servidores VPS

O n8n com HTTPS no seu próprio domínio

Docker Compose: uma aplicação com a sua base de dados

Cópia de segurança do n8n

PRODUTO RECOMENDADO

Servidor VPS com acesso root

Recursos só seus, o sistema que escolher, reinstalação quando quiser. desde 10.800,00 Kz/mês

Ver planos
  • 0 Utilizadores acharam útil
Esta resposta foi útil?

Artigos Relacionados

Tarefas agendadas (cron): para que servem e como se criam Uma tarefa agendada, ou cron, é uma ordem que o servidor executa a horas certas, esteja você lá ou não, tenha o site vis...
Trocar o WP-Cron pelo cron do servidor O WordPress tem um agendador próprio, o WP-Cron, que trata das publicações marcadas, das verificações de actualização, d...
Tokens de API do cPanel: automatizar sem dar a palavra-passe Mais cedo ou mais tarde alguém lhe pede a palavra-passe do cPanel: o programador que vai montar uma integração, o serviç...
O que é o n8n, e o que pode automatizar com ele O n8n é um programa que liga aplicações umas às outras através de fluxos: quando acontece uma coisa numa aplicação, faz...
Precisa de um VPS para o n8n? O que um plano partilhado não consegue fazer Sim, para correr o n8n no seu próprio servidor precisa de um VPS (ou de um servidor dedicado), com acesso root. Num plan...
O n8n com HTTPS no seu próprio domínio Para usar o n8n a sério precisa de um endereço como n8n.asuaempresa.ao, com cadeado. São quatro peças: um registo DNS qu...