Aprenda como instalar n8n no Windows com WSL2 e expor na internet usando um túnel seguro do Cloudflare, passo a passo, desde a configuração inicial até dicas de manutenção.
Se você procura uma solução prática e eficiente para rodar o n8n no seu Windows, garantindo total compatibilidade e segurança ao expor seus fluxos na internet, este guia é para você! Vamos detalhar, em linguagem simples, como instalar o n8n no Windows usando o WSL2 e Docker, e ainda aprender a expor a interface do n8n de forma segura ao mundo externo usando o Cloudflare Tunnel. Esse processo é ideal para quem busca automatizar tarefas e integrar sistemas sem abrir mão de praticidade.
Passaremos por todos os pré-requisitos, instalação do WSL2 com Docker, o passo a passo do deploy do n8n via Docker, como configurar o túnel seguro pelo Cloudflare e, por fim, dicas e soluções para quem está começando ou já se deparou com algum problema. Tudo pensado para você descomplicar o processo, mesmo se está dando os primeiros passos no universo da automação e dos agentes de IA.
Pré-requisitos e configuração do ambiente no Windows
Antes de instalar o n8n com WSL2 no Windows, é importante preparar o ambiente para garantir uma instalação tranquila e estável. Seguindo esses passos, você evita a maioria dos problemas comuns.
Sistema Operacional: Este tutorial foi pensado para Windows 10 (a partir da versão 2004) e Windows 11, ambos compatíveis com o WSL2.
Habilitar o WSL2: Vá até o painel de controle do Windows, habilite os componentes ‘Subsistema do Windows para Linux’ e ‘Plataforma de Máquina Virtual’. Você pode fazer isso via PowerShell administrado com o comando:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Atualizar o WSL: Instale o pacote de atualização do kernel WSL2 disponível no site da Microsoft. Isso garante a performance e compatibilidade ao rodar Docker e outras ferramentas essenciais.
Instalar uma distribuição Linux: Recomenda-se o Ubuntu, disponível gratuitamente na Microsoft Store. Siga as instruções do próprio instalador para configurar usuário e senha.
Instalar o Docker Desktop: Baixe o Docker Desktop para Windows, que vai funcionar integrado ao WSL2. Ao instalar, certifique-se de marcar a opção para ativar suporte ao WSL2.
Tendo tudo configurado, seu ambiente Windows estará pronto para receber o n8n de forma eficiente e segura. Com esses pré-requisitos, conseguimos unir a praticidade do Windows com a robustez do Linux e o poder do Docker para rodar automações e agentes de IA como o n8n.
🤖 Aprimore suas habilidades com a Formação Agentes de IA da Hora de Codar
Se neste processo de instalar o n8n você ficou animado para criar automações mais avançadas ou até mesmo agentes inteligentes sem precisar ser programador(a), vale a pena conhecer a Formação Agentes de IA da Hora de Codar.
Esse treinamento foi pensado para quem está começando ou quer se aprofundar no universo dos agentes de IA e automação com n8n. São mais de 20 horas de aulas, diversos projetos práticos, templates prontos e suporte vitalício. Além disso, você aprende não apenas a parte técnica, mas também como construir soluções que podem ser vendidas para empresas – uma belíssima porta de entrada para quem quer faturar com tecnologia de forma prática.
Recomendo dar uma olhada na página da formação e conferir tudo que é abordado: Conheça a Formação Agentes de IA da Hora de Codar.
Como instalar e configurar o WSL2 com Docker
Com o ambiente básico do Windows preparado, é hora de instalar o WSL2 junto com o Docker.
Instale o Ubuntu (ou outra distro) via Microsoft Store: Ao abrir pela primeira vez, ele pedirá para você criar um usuário e senha. Esta conta será usada dentro do ambiente Linux.
Verifique o status do WSL2: Abra o terminal do Ubuntu e execute:
wsl.exe –list –verbose
Verifique se a sua distribuição está usando a versão 2. Caso contrário, converta usando:
wsl.exe –set-version
Instale o Docker Desktop: Faça o download em https://www.docker.com/products/docker-desktop e siga os passo do instalador. Deixe marcada a opção de integração com WSL2.
Teste o Docker: Abra o Ubuntu dentro do WSL2 e execute:
docker –version
Se aparecer a versão do Docker, está tudo pronto!
Com WSL2 e Docker corretamente configurados, você terá uma camada Linux robusta para usar containers no seu Windows, obtendo o melhor dos dois mundos. E lembre-se: qualquer automação ou aplicação pode ser facilmente containerizada e gerida pelo Docker, aumentando a flexibilidade dos seus projetos com n8n.
Aprenda a instalar o n8n localmente (YouTube)
Que tal ver na prática como instalar o n8n no seu computador? O vídeo Como instalar o n8n localmente – Instale o n8n com o npm no seu computador traz um passo a passo visual para ajudar ainda mais no processo. Se você prefere aprender vendo, é um ótimo complemento ao tutorial escrito!
Assista agora para descomplicar ainda mais sua jornada:
Instalando o n8n via Docker no Windows passo a passo
Com Docker rodando no WSL2, instalar o n8n se torna rápido e sem complicações. Vamos ao passo a passo:
- Escolha da pasta de trabalho dentro do Ubuntu (WSL2):
Recomenda-se criar uma pasta exclusiva para os arquivos do n8n:
mkdir ~/n8n-docker && cd ~/n8n-docker
- Criando um arquivo docker-compose.yml:
O arquivodocker-compose.ymltraz toda a configuração do container do n8n. Exemplo básico para produção:
version: ‘3.8’
services:
n8n:
image: n8n
ports:
– 5678:5678
environment:
– N8NBASICAUTHACTIVE=true
– N8NBASICAUTHUSER=seuusuario
– N8NBASICAUTH_PASSWORD=suasenha
volumes:
– ~/.n8n:/home/node/.n8n
Salve este conteúdo como docker-compose.yml.
- Subindo o n8n:
No terminal, execute:
docker compose up -d
Aguarde baixar a imagem e iniciar o container. Para acessar o n8n, basta ir ao navegador em http://localhost:5678 e fazer login com o usuário e senha definidos.
- Extras:
- Modifique variáveis de ambiente conforme a necessidade (banco externo, webhook, SSL etc).
- Mantenha o container e as dependências sempre atualizados.
Seguindo este passo a passo de n8n no Docker no Windows, você terá um ambiente pronto para criar seus fluxos de automação e integrar sistemas rapidamente.
Expondo o n8n na internet com Cloudflare Tunnel
Agora que seu n8n está rodando localmente, você pode expor o acesso externo de forma segura usando o Cloudflare Tunnel. Isso dispensa abrir portas do roteador e proporciona proteção extra via Cloudflare.
Passos para ativar o Cloudflare Tunnel:
Criar uma conta no Cloudflare: Cadastre-se em cloudflare.com e adicione seu domínio.
Crie um novo Tunnel: No painel do Cloudflare, acesse a seção de “Zero Trust” e siga as instruções para criar um novo tunnel, dando um nome e selecionando a máquina (sua estação Windows/WSL2).
Instale o Cloudflare Tunnel (cloudflared) dentro do Ubuntu (WSL2):
No terminal do Ubuntu, baixe e instale o cloudflared conforme a documentação oficial.Autentique-se e vincule o tunnel ao seu domínio: O próprio cloudflared vai emitir o link de autorização e gerar o arquivo de configuração que aponta para o domínio e porta do n8n (normalmente 5678 na máquina local).
Acesse de fora:
Ao finalizar, o n8n será acessível pelo endereço seguro no seu domínio, protegido por todas as camadas do Cloudflare (incluindo SSL automático, firewall e controle de autenticação).
Benefícios:
- Não expõe diretamente sua porta para a internet.
- SSL automático sem necessidade de configuração extra.
- Controle de acesso reforçado com firewall, rate limiting e logs de acesso disponíveis no painel Cloudflare.
- Você pode pausar o tunnel a qualquer momento, mantendo plena segurança.
Esses passos cobrem como expor n8n na internet com Cloudflare Tunnel, tornando o acesso remoto fácil e altamente seguro.
💻 Leve seu n8n para o próximo nível com uma VPS Hostinger
Embora rodar o n8n no Windows com WSL2 seja ótimo para aprendizado e testes, quem busca performance, estabilidade e até projetos profissionais, vai curtir a facilidade da Hostinger. Com os planos de VPS da Hostinger, você instala o n8n sem dor de cabeça, escala recursos sob demanda e ainda aproveita infraestrutura com 99,9% de uptime garantido.
O painel é intuitivo, o VPS já vem pronto para uso, e o melhor: usando o cupom HORADECODAR ao contratar a VPS no link https://www.hostinger.com.br/horadecodar você garante desconto especial de até 60%. Legal, né? Se quiser migrar seu ambiente para algo mais profissional, a Hostinger é uma escolha super segura e fácil de gerenciar.
Dicas, soluções de problemas e manutenção do n8n
Ao rodar o n8n no Windows com WSL2 e Docker, alguns desafios podem aparecer. Confira algumas dicas para facilitar seu dia a dia e garantir que tudo funcione sem contratempos:
Atualize regularmente: Mantenha sempre o Docker, o WSL2, a distribuição Linux e o próprio n8n atualizados. Isso corrige bugs, aumenta a segurança e traz novas funcionalidades.
Gerenciamento de arquivos: Lembre-se de que, ao usar volumes Docker, os arquivos dos fluxos e credenciais do n8n ficam gravados na pasta mapeada (por exemplo, ~/.n8n). Lembre-se de fazer backup dessa pasta!
Ouça os logs: Use o comando
docker logs n8npara verificar problemas de inicialização ou conexão.Portas bloqueadas: Se não acessar o n8n via localhost, verifique firewall e se a porta 5678 está liberada no Windows.
Cloudflare Tunnel não conecta? Certifique-se de que o serviço cloudflared está rodando e as configurações de origem/porta do domínio estão corretas.
Crescimento do projeto: Rodar localmente é excelente para testes e projetos menores. Para automações estáveis, escaláveis ou profissionais, considere migrar o n8n para uma VPS dedicada. Assim, você terá mais performance, uptime e recursos. (Acompanhe as dicas sobre Hostinger em seguida!)
Se surgir algum problema mais técnico, a comunidade do n8n (https://community.n8n.io) e os grupos da Hora de Codar são excelentes fontes de ajuda.
Como instalar n8n no Windows utilizando WSL2?
Para instalar o n8n no Windows utilizando o WSL2, primeiro habilite o subsistema do Linux no Windows e instale uma distribuição Linux (como Ubuntu) via Microsoft Store. Depois, dentro do terminal Linux, atualize os pacotes do sistema, instale o Node.js, npm e o n8n com o comando ‘npm install n8n -g’. Por fim, inicie o n8n executando ‘n8n’ no terminal.
Como publicar o n8n na internet de forma segura usando túnel seguro?
Para publicar o n8n na internet com segurança, você pode utilizar o Cloudflare Tunnel. Após instalar o n8n, crie uma conta no Cloudflare, instale o ‘cloudflared’ dentro do WSL2 e configure um túnel apontando para a porta em que o n8n está rodando. O Cloudflare Tunnel irá gerar um endereço público seguro, protegendo e expondo sua aplicação.
Quais são os benefícios de usar WSL2 e túnel seguro para rodar o n8n no Windows?
Utilizar o WSL2 permite rodar aplicações Linux, como o n8n, de forma eficiente no Windows, tirando proveito de recursos nativos do sistema. Já o túnel seguro (por exemplo, Cloudflare Tunnel) protege sua aplicação contra exposições diretas à internet, oferecendo segurança extra e simplicidade na configuração de acessos externos.
Conclusão: Instale, pratique e alcance o próximo nível com n8n e túnel seguro
Você viu neste artigo como instalar n8n no Windows com WSL2 e Docker, preparando um ambiente robusto e eficiente para suas automações. Também aprendeu a expor seu n8n de forma segura na internet usando Cloudflare Tunnel, tudo explicado passo a passo e focando na segurança e praticidade.
Com esses conhecimentos, você já pode criar fluxos, conectar APIs, automatizar rotinas e até iniciar projetos usando agentes de IA. Acompanhe nosso vídeo complementar, explore as dicas de curso e VPS que apresentamos, e não hesite em expandir seus conhecimentos com as formações recomendadas.
Automação é o futuro, e com essas ferramentas e bons hábitos de manutenção, seu projeto com n8n vai correr sem dor de cabeça. Prepare-se, experimente e evolua cada vez mais!