Do Zero à Automação Segura: Instalando o n8n no Google Cloud com Docker e Nginx
- Michel Souza Santana
- 6 de out.
- 7 min de leitura
Manual Passo a Passo: https://github.com/michellsspy/n8n_no_GCP.git
N8N Código Json: https://github.com/michellsspy/n8n_no_GCP.git
Olá, pessoal! Michel Santana por aqui.
No universo da tecnologia, a automação de processos não é mais um luxo, mas uma necessidade estratégica. Ferramentas como o n8n se destacam por sua flexibilidade e poder, permitindo que qualquer pessoa, de desenvolvedores a analistas de negócio, crie fluxos de trabalho complexos de forma visual e intuitiva.
Mas uma dúvida comum que recebo é: "Michel, qual a melhor forma de hospedar o n8n para ter controle total, segurança e escalabilidade?". A resposta que mais recomendo para um ambiente profissional é a combinação de Google Cloud Platform (GCP), Docker e Nginx.
Neste artigo, vamos transformar um manual técnico em um guia prático e direto. O objetivo é levar você do zero absoluto a uma instância n8n robusta e pronta para produção. Vamos cobrir:
Infraestrutura na Nuvem: Como configurar um servidor virtual no GCP.
Contêineres: Como usar o Docker para instalar e gerenciar o n8n de forma limpa e isolada.
Segurança e Acesso: Como usar o Nginx como um "porteiro" seguro (Proxy Reverso) e adicionar uma camada de criptografia com um certificado SSL gratuito.
Preparado? Vamos colocar a mão na massa!
Parte 1: A Fundação Sólida no Google Cloud (GCP)
Tudo começa com uma base bem construída. Nosso primeiro passo é provisionar o servidor virtual no GCP que será o lar da nossa aplicação.
[Sugestão de Imagem: Logotipos do GCP, Docker e Nginx lado a lado]
1.1. Provisionando Nosso Servidor Virtual (VM)
Acesse o Google Cloud Console, navegue até Compute Engine > Instâncias de VM e clique em CRIAR INSTÂNCIA.
Aqui estão as configurações que recomendo:
Nome: Algo descritivo, como instance-n8n-server.
Região: Escolha uma próxima de você para menor latência (ex: southamerica-east1 para São Paulo).
Configuração da Máquina:
Série: E2 (ótimo custo-benefício).
Tipo de Máquina: e2-medium (2 vCPUs, 4 GB de memória) é um excelente ponto de partida.
Disco de Inicialização:
Clique em ALTERAR.
Sistema Operacional: Ubuntu.
Versão: Ubuntu 24.04 LTS (LTS significa Suporte de Longo Prazo, ideal para servidores).
Tamanho: Aumente para pelo menos 20 GB.
Finalize clicando em CRIAR.
1.2. Garantindo um Endereço Fixo: O IP Estático
Por padrão, o endereço de IP público da sua VM pode mudar. Para que nosso domínio sempre aponte para o lugar certo, precisamos de um IP fixo.
Clique no nome da sua VM recém-criada.
Clique em EDITAR.
Vá até a seção Interfaces de rede e clique na nic0.
No campo IP externo, mude de "Efêmero" para Criar endereço IP. Dê um nome (ex: n8n-static-ip) e reserve.
Salve as alterações.
Por que isso é crucial? Um IP estático garante que, mesmo que você reinicie a VM, o seu domínio n8n.seusite.com.br nunca se perderá no caminho.
1.3. Abrindo as Portas para o Mundo: Regras de Firewall
Nosso servidor precisa de permissão para receber tráfego da internet. Vamos criar duas regras no firewall do GCP, navegando até Rede VPC > Firewall.
Regra HTTP (Porta 80):
Nome: allow-http-ingress
Direção: Entrada
Ação: Permitir
Intervalos de IPv4 de origem: 0.0.0.0/0 (qualquer lugar da internet)
Protocolos e portas: tcp:80
Regra HTTPS (Porta 443):
Nome: allow-https-ingress
Direção: Entrada
Ação: Permitir
Intervalos de IPv4 de origem: 0.0.0.0/0
Protocolos e portas: tcp:443
1.4. Conectando seu Domínio ao Servidor (DNS)
Agora, vá ao painel do seu provedor de domínio (GoDaddy, Registro.br, etc.) e crie um Registro do Tipo A:
Tipo: A
Host/Nome: n8n (ou o subdomínio que desejar)
Valor/Aponta para: O endereço de IP Estático que você acabou de reservar.
Atenção: A propagação de DNS pode levar de alguns minutos a algumas horas. Paciência é fundamental nesta etapa!
Parte 2: Preparando o Terreno na VM
Com a infraestrutura pronta, vamos acessar nosso servidor e instalar as ferramentas que darão vida à aplicação. No console do GCP, ao lado do nome da sua VM, basta clicar no botão SSH para abrir um terminal seguro diretamente no navegador.
[Sugestão de Imagem: Captura de tela da janela do terminal SSH aberta pelo GCP]
2.1. Instalando o Nginx: Nosso Porteiro Digital
O Nginx atuará como um proxy reverso: ele receberá todas as requisições do seu domínio e as encaminhará para o serviço correto (o n8n), adicionando uma camada de segurança.
→ Explicação: Usaremos o apt-get, gerenciador de pacotes do Ubuntu, para instalar o Nginx e o systemctl para garantir que ele inicie junto com o servidor.
→ Exemplo (Comandos):
Bash
# Instala o Nginx
sudo apt-get update
sudo apt-get install nginx -y
# Verifica o status e habilita na inicialização
sudo systemctl status nginx
sudo systemctl enable nginx
→ Análise: Se o comando status mostrar uma linha verde com "active (running)", a instalação foi um sucesso.
2.2. Adotando Contêineres: A Instalação do Docker
O Docker nos permite "empacotar" o n8n em um ambiente isolado chamado contêiner. Isso simplifica a instalação, evita conflitos de dependências e torna a aplicação portátil.
→ Explicação: O processo envolve adicionar o repositório oficial do Docker para garantir que tenhamos a versão mais segura e, em seguida, instalar o Docker Engine e o plugin Compose.
→ Exemplo (Comandos):
Bash
# Instala dependências e adiciona a chave GPG do repositório Docker
sudo apt-get install ca-certificates curl -y
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
# Adiciona o repositório do Docker
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# Instala o Docker e o Compose
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
2.3. Ajustes Finais do Docker (Essencial!)
→ Explicação: Para finalizar, vamos configurar o Docker para iniciar com o sistema e, mais importante, permitir que nosso usuário execute comandos docker sem precisar digitar sudo toda vez.
→ Exemplo (Comandos):
Bash
# Habilita os serviços do Docker
sudo systemctl enable docker.service
sudo systemctl enable containerd.service
# Adiciona seu usuário ao grupo do Docker
sudo usermod -aG docker $USER
MUITO IMPORTANTE: Para que a permissão de usuário tenha efeito, feche a janela SSH atual e abra uma nova. Depois de reconectar, teste com docker --version. Se não houver erro, você está pronto para o próximo passo!
Parte 3: Dando Vida à Automação com Docker Compose
O Docker Compose é a nossa "planta baixa". Ele usa um arquivo YAML para definir todos os serviços, redes e volumes da nossa aplicação.
3.1. Criando o Cérebro da Operação: docker-compose.yml
→ Explicação: Primeiro, criamos uma pasta para organizar nosso projeto. Dentro dela, criaremos o arquivo docker-compose.yml, que dirá ao Docker como configurar e executar o n8n.
→ Exemplo (Comandos):
Bash
# Cria o diretório e entra nele
mkdir ~/n8n-server && cd ~/n8n-server
# Cria e abre o arquivo de configuração
nano docker-compose.yml
Agora, cole o seguinte conteúdo no editor. Lembre-se de substituir n8n.seu-dominio.com.br pelo seu domínio real.
YAML
version: '3.7'
services:
n8n:
image: n8nio/n8n
restart: always
ports:
# Medida de segurança: A porta do n8n só é acessível pela própria máquina (localhost).
# O Nginx será o único a falar com ela.
- "127.0.0.1:5678:5678"
environment:
# Garante que agendamentos (CRON) funcionem no fuso horário correto.
- GENERIC_TIMEZONE=America/Sao_Paulo
# Essencial para que webhooks funcionem corretamente.
- WEBHOOK_URL=https://n8n.seu-dominio.com.br/
volumes:
# O passo mais importante: Mapeia os dados do n8n para uma pasta na VM.
# Isso garante que seus workflows e credenciais NUNCA sejam perdidos.
- ./n8n_data:/home/node/.n8n
Salve o arquivo (Ctrl+X, depois Y e Enter).
3.2. Iniciando o n8n
→ Explicação: Com a nossa "planta baixa" pronta, basta um único comando para o Docker construir e iniciar nossa aplicação em segundo plano (-d).
→ Exemplo (Comando):
Bash
docker compose up -d
→ Análise: Na primeira vez, o Docker baixará a imagem do n8n. Depois, você pode verificar se tudo está rodando com docker ps. Você deve ver um contêiner com o status Up.
Parte 4: Expondo com Segurança via Nginx e SSL
Nosso n8n está rodando, mas isolado do mundo. A etapa final é configurar o Nginx para receber o tráfego do seu domínio de forma segura (HTTPS) e repassá-lo para o contêiner do n8n.
[Sugestão de Imagem: Fluxograma simples: Usuário → Domínio (HTTPS) → Nginx → Docker/n8n]
4.1. Configurando o Proxy Reverso
→ Explicação: Vamos editar o arquivo de configuração padrão do Nginx para instruí-lo a:
Redirecionar todo tráfego http:// para https://.
Para o tráfego https://, passar a requisição para o n8n que está rodando em localhost:5678.
→ Exemplo (Comando):
Bash
sudo nano /etc/nginx/sites-available/default
Apague todo o conteúdo e cole o seguinte, novamente substituindo n8n.seu-dominio.com.br pelo seu domínio:
Nginx
# Bloco para redirecionar HTTP para HTTPS
server {
listen 80;
server_name n8n.seu-dominio.com.br;
location /.well-known/acme-challenge/ {
root /var/www/html;
}
location / {
return 301 https://$host$request_uri;
}
}
# Bloco principal que lida com o tráfego seguro
server {
listen 443 ssl http2;
server_name n8n.seu-dominio.com.br;
# O Certbot preencherá as linhas do SSL aqui
location / {
proxy_pass http://localhost:5678; # A mágica acontece aqui!
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# Configurações essenciais para WebSockets, que evitam erros de conexão no n8n
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
Antes de aplicar, sempre verifique a sintaxe: sudo nginx -t.
4.2. Criptografia Gratuita e Essencial com Let's Encrypt
→ Explicação: Usaremos o Certbot, uma ferramenta fantástica que automatiza a obtenção e instalação de certificados SSL gratuitos da Let's Encrypt.
→ Exemplo (Comandos):
Bash
# Instala o Certbot e seu plugin para Nginx
sudo apt-get install certbot python3-certbot-nginx -y
# Executa o Certbot para o seu domínio
sudo certbot --nginx -d n8n.seu-dominio.com.br
→ Análise: O Certbot fará algumas perguntas (seu e-mail, termos de serviço) e, o mais importante, perguntará se você deseja redirecionar o tráfego HTTP para HTTPS. Confirme essa opção! Ele irá automaticamente editar seu arquivo de configuração do Nginx e recarregar o serviço.
Conclusão: Sua Plataforma de Automação Pronta para Decolar!
Se você chegou até aqui, parabéns! Abra seu navegador e acesse https://n8n.seu-dominio.com.br.
Você deverá ver a tela de configuração inicial do n8n, com um cadeado de segurança na barra de endereço. Você não apenas instalou uma ferramenta poderosa, mas construiu uma arquitetura resiliente, segura e escalável, seguindo as melhores práticas do mercado.
Este ambiente está configurado para reiniciar automaticamente e manter seus dados seguros, dando a você a tranquilidade necessária para focar no que realmente importa: criar automações incríveis.
Espero que este guia tenha sido útil! Se tiver alguma dúvida ou sugestão, deixe um comentário abaixo ou me encontre no LinkedIn.
Até a próxima e ótimas automações!
Comentários