Cloudflare Tunnel: a VPS ligada pelo cloudflared
O Cloudflare Tunnel é o serviço que liga sua infraestrutura à rede da Cloudflare por conexões iniciadas pelo conector cloudflared. Na sua VPS, ele encaminha requisições até o aplicativo local sem exigir uma porta de entrada aberta para a Internet.
Ficha e sumário da página
- Referência técnica
- cloudflared 2026.11.0
- Revisão
- 15 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
A conexão começa dentro da VPS
O cloudflared é um processo que roda na sua infraestrutura e abre conexões de saída até a Cloudflare. Depois que essas conexões existem, requisições e respostas circulam nos dois sentidos por elas. Por isso um aplicativo local pode atender visitas recebidas pela Cloudflare mesmo sem aceitar conexões iniciadas diretamente da Internet contra a VPS.
O caminho até a aplicação muda: a rede da Cloudflare entrega o tráfego ao conector já conectado, que o encaminha ao endereço local configurado. O Tunnel dispensa um endereço IP público roteável para essa ligação. Se a VPS já possui um IP público, o túnel permite atender o aplicativo por outro caminho, mas não fecha automaticamente os serviços que continuam expostos nesse IP.
Você mantém o aplicativo rodando na VPS. O túnel transporta as requisições até ele, sem transferir seu código ou banco para a Cloudflare. Essa diferença aparece na hospedagem na borda: um Worker executa o código na rede da plataforma, enquanto o Tunnel leva o tráfego ao programa que permanece no seu servidor.
O papel do cloudflared no caminho da requisição
O conector precisa alcançar tanto a rede da Cloudflare quanto o serviço de origem. Um endereço como http://localhost:8080 representa, por exemplo, um servidor web acessível na mesma máquina do processo cloudflared. O navegador visita o domínio público, enquanto o conector usa o endereço local para entregar a requisição.
Domínio público
app.seudominio.com.brO DNS associa o nome ao túnel, sem apontar para o IP público da VPS.
Rede da Cloudflare
Cloudflare TunnelRecebe a requisição e encaminha o tráfego pelo canal conectado.
Conector na VPS
cloudflaredInicia as conexões de saída e mantém a ligação com a Cloudflare.
Aplicativo local
http://localhost:8080Recebe a requisição do conector e produz a resposta.
O localhost é relativo ao ambiente do conector. Se o cloudflared roda num container separado, esse nome aponta para o próprio container. O destino precisa representar um serviço alcançável daquele ambiente. Ter o túnel conectado confirma a ligação com a Cloudflare, mas não comprova que o aplicativo responde no endereço informado.
A conexão de saída também precisa ser permitida pelo firewall. A documentação identifica a porta 7844, com UDP para QUIC ou TCP para HTTP/2, como destino das conexões do túnel. A ausência de porta de entrada pública não significa ausência de comunicação de rede: a VPS ainda precisa sair até os destinos da Cloudflare.
Túnel nomeado e conector têm vidas separadas
O túnel nomeado é um objeto persistente, identificado por um UUID e por um nome escolhido por você. Esse nome pode representar a VPS ou o aplicativo e não precisa coincidir com um domínio. O processo cloudflared é a instância que conecta a máquina àquele objeto. Reiniciar o processo não exige criar outro túnel nem trocar seu identificador.
Um mesmo túnel pode encaminhar tráfego a vários serviços. A configuração associa cada hostname ao destino correspondente, permitindo, por exemplo, que dois subdomínios usem aplicações distintas na mesma infraestrutura. Nos túneis gerenciados localmente, essas associações ficam no arquivo de configuração. Nos gerenciados remotamente, a configuração fica na Cloudflare e pode ser administrada pelo painel ou pela API.
Essa separação também permite réplicas: instâncias adicionais do cloudflared ligadas ao mesmo túnel. Cada instância mantém quatro conexões com pelo menos dois data centers da Cloudflare. Uma réplica em outro host oferece um caminho adicional se a máquina do primeiro conector ficar indisponível. A disponibilidade do aplicativo de destino ainda precisa existir nesse caminho adicional.
O DNS associa o hostname ao túnel
Ao criar o túnel, a Cloudflare fornece um endereço no formato <UUID>.cfargotunnel.com. Um registro CNAME associa o hostname público ao endereço do túnel. Assim o nome app.seudominio.com.br identifica o acesso do aplicativo sem exigir um registro A apontado ao endereço da VPS.
Você pode associar vários nomes ao mesmo destino cfargotunnel.com, desde que cada hostname tenha seu registro e sua associação ao serviço correto. O DNS resolve a ligação com o túnel. A configuração do conector completa o encaminhamento até a aplicação. A relação entre DNS e domínios continua necessária mesmo quando o servidor de origem fica fora da Internet pública.
O registro DNS e o túnel são independentes. O CNAME pode continuar cadastrado depois que o último conector para, então a existência do registro não comprova disponibilidade. O navegador só recebe a resposta do aplicativo quando a associação DNS, o canal até a Cloudflare e o destino local funcionam juntos.
Configuração e manutenção do conector
A referência técnica usada aqui é o cloudflared 2026.11.0, publicado no repositório oficial em 12/11/2026. Esse número identifica o conector instalado na infraestrutura. O serviço Cloudflare Tunnel tem documentação própria e não usa esse número como versão de toda a plataforma.
O cloudflared aceita parâmetros de execução e variáveis para ajustar seu funcionamento. As variáveis de ambiente do cloudflared incluem opções de credenciais e de comunicação do túnel. Elas pertencem ao conector, portanto têm finalidade diferente das variáveis recebidas pelo código de um Worker.
Na VPS, o serviço precisa continuar executando para manter o caminho disponível. Os parâmetros de logs e métricas ajudam você a conferir o processo, enquanto uma requisição ao domínio confirma o percurso até a aplicação. Se o canal está ativo e o aplicativo local não responde, a investigação segue para o endereço e o protocolo configurados na origem.