Teste suas habilidades em todos os nossos serviços de hospedagem e ganhe 15% de desconto!

Utilizar o código no ato da compra:

Skills
24.09.2025

Como implementar o n8n em um VPS Debian 12

Executar o n8n em seu próprio VPS é a melhor maneira de construir fluxos de trabalho de automação seguros, escaláveis e sempre ativos. Ao contrário dos serviços de automação baseados em nuvem, hospedar o n8n em um VPS da AlexHost oferece privacidade total dos dados, execuções ilimitadas, tempo de atividade 24/7 e custos previsíveis. Com o Debian 12 como sistema operativo de base, beneficiará de estabilidade a longo prazo e suporte de software moderno.

Este guia irá guiá-lo através da instalação do Docker, configurando o n8n com criptografia, lançando o serviço e acessando-o no navegador.

Por que executar o n8n em um VPS em vez de apenas no navegador?

Embora o n8n ofereça um serviço de nuvem acessível diretamente a partir do browser, executar a sua própria instância do n8n num VPS proporciona vantagens críticas para profissionais, empresas e programadores:

  • Privacidade total dos dados – Todos os seus fluxos de trabalho, chaves API e dados de clientes permanecem inteiramente sob o seu controlo. Nenhum fornecedor terceiro pode aceder às suas informações.
  • Integrações ilimitadas – Num VPS, é você que define os limites, não o fornecedor de SaaS. Pode executar tantos fluxos de trabalho, accionadores e execuções quantos forem necessários.
  • disponibilidade 24/7 – Um VPS mantém as suas automatizações sempre online, mesmo quando o seu computador pessoal está desligado.
  • Melhor segurança – Proteja o seu sistema com firewalls, certificados SSL e acesso VPN. Todas as credenciais são encriptadas com a sua própria chave.
  • Escalabilidade e desempenho – Com o VPS da AlexHost, você pode atualizar os recursos de CPU, RAM e armazenamento sempre que seus projetos de automação crescerem.
  • Custo-benefício – Em vez de pagar por execução, você paga uma taxa mensal fixa de VPS e executa fluxos de trabalho ilimitados.

resumindo: a execução do n8n no seu VPS transforma-o num poderoso centro de automação auto-hospedado, onde controla os dados, o desempenho e os custos.

Atualizar o servidor

Comece sempre por atualizar os pacotes Debian 12:

sudo apt update && sudo apt upgrade -y

Explicação da saída: Verá pacotes a serem descarregados e actualizados. No final, o sistema confirma com 0 upgraded, 0 newly installed se tudo já estiver atualizado.

Instalar o Docker e o Docker Compose

Instale as dependências e adicione o repositório oficial do Docker:

sudo apt install -y curl gnupg2 ca-certificates lsb-release apt-transport-https
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
#

Atualizar os repositórios e instalar o Docker + Compose:

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Verificar versões:

docker --version
docker compose version

exemplo de saída:

Docker version 25.0.3, build abc123
Docker Compose version v2.24.6

Isso confirma que o Docker está instalado e pronto.

Preparar o diretório do projeto

Crie um diretório dedicado para o n8n:

mkdir ~/n8n && cd ~/n8n

Gerar uma chave de encriptação

Esta chave é utilizada para encriptar credenciais dentro do n8n:

###ATP_NOTR_8_CODE_TAG_NOTR_ATP##cat ~/n8n/encryption.key

Criar o docker-compose.yml

Abrir o ficheiro:

nano docker-compose.yml

Cole a configuração (substitua YOUR_SERVER_IP pelo IP do seu VPS AlexHost):

version: '3.7'

services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=supersecretpassword
      - GENERIC_TIMEZONE=Europe/Chisinau
      - N8N_ENCRYPTION_KEY_FILE=/files/encryption.key
      - N8N_EDITOR_BASE_URL=http://YOUR_SERVER_IP:5678
      - N8N_SECURE_COOKIE=false
    volumes:
      - ./n8n_data:/home/node/.n8n
      - ./encryption.key:/files/encryption.key:ro

Salve(CTRL + O, Enter) e saia(CTRL + X)

Ajustar permissões

Dê ao utilizador do contentor os direitos adequados:

mkdir -p ./n8n_data
sudo chown -R 1000:1000 ./n8n_data
#

Iniciar o n8n

Executar o contentor em modo separado:

docker compose up -d#

O exemplo de saída será como:

[+] Running 2/2
✔ Network n8n_default Created
✔ Container n8n-n8n-1 Started

Verificar os contentores em execução:

docker ps

A saída será como a seguinte:

Verificar registos

Certifique-se de que não existem erros:

docker logs -f n8n-n8n-1
#

o que esperar:

  • Nenhum erro de “chaves de encriptação incompatíveis”.
  • Serviço confirmando a inicialização e escutando na porta 5678.

A saída será como a seguinte

Aceder ao n8n no navegador

Agora abra o IP do seu VPS num browser:

http://YOUR_SERVER_IP:5678#
* no meu caso é http://176.123.2.191:5678
Se quiser enviar para o seu servidor, ou se não houver forma de verificar no seu browser, pode introduzir isto utilizando curl
curl http://176.123.2.191:5678
Esta saída vem da execução do curl contra a sua instância n8n na porta 5678. Em vez de renderizar o editor visual, ele mostra a fonte HTML bruta da página de login do n8n, incluindo tags <script> e um aviso de que a UI requer JavaScript. Resumindo, isso confirma que o n8n está funcionando corretamente, mas como o curl não pode executar JavaScript, você deve abrir a mesma URL em um navegador real para usar o Editor n8n. E no próprio browser poderás ver esta janela.

Este é o ecrã de Configuração da Conta de Proprietário da n8n, que aparece quando acede à sua instância n8n pela primeira vez num browser. Permite-lhe registar o administrador inicial, introduzindo um e-mail, nome próprio, apelido e uma palavra-passe segura. Uma vez concluída, esta conta torna-se o principal proprietário da sua implementação n8n, dando-lhe acesso total ao editor e à gestão do fluxo de trabalho. Depois de preencher o formulário e clicar em Seguinte, pode começar a criar e gerir fluxos de trabalho de automatização diretamente na interface visual do n8n.

Conclusão

Este guia mostra claramente como implantar o n8n em um VPS AlexHost com Debian 12 e destaca por que ele é uma escolha superior ao uso baseado em navegador. Executar o n8n em seu próprio VPS garante controle total dos dados, fluxos de trabalho ilimitados e tempo de atividade contínuo 24 horas por dia, 7 dias por semana, o que é essencial para a automação profissional. O processo de instalação com Docker e Docker Compose é simples, facilitando a configuração de um hub de automação seguro e escalável. O uso de recursos VPS da AlexHost permite uma escalabilidade suave de CPU, RAM e armazenamento à medida que os projetos crescem. A segurança é reforçada com chaves de encriptação, opções SSL e autenticação privada. Em conclusão, a implantação do n8n em um VPS da AlexHost combina estabilidade, privacidade e custo-benefício, transformando seu servidor em uma poderosa plataforma de automação auto-hospedada.

Teste suas habilidades em todos os nossos serviços de hospedagem e ganhe 15% de desconto!

Utilizar o código no ato da compra:

Skills