Base de Conhecimento

Cloudflare Tunnel: como publicar um site sem abrir portas

  • cloudflare tunnel, cloudflared, vps, docker, access, proxy
  • Usuários acharam útil: 0

Passo a passo do Cloudflare Tunnel: requisitos, instalação do cloudflared, rota pública, config.yml, Docker com tag fixa, portas de saída, Access, limites e erros.

Por Redação Eleven Host · @robson.direitodigital · 6 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Cloudflare Tunnel: como publicar um site sem abrir portas

Capa da Redação Eleven Host para o guia: Cloudflare Tunnel: como publicar um site sem abrir portas Arte: Eleven Host

Cloudflare Tunnel publica um site que está no seu servidor sem abrir portas de entrada. Um programa no servidor, o cloudflared, liga-se à Cloudflare, e os visitantes chegam ao site por lá.

Atualizado em 06/11/2026. As telas da Cloudflare mudam: use os caminhos de menu deste texto como guia e confira o que aparece na sua tela. Os blocos marcados como exemplo são montados aqui: confira cada um no seu servidor antes de usar.

Como funciona, em palavras simples

O cloudflared é um programa que fica rodando no servidor e abre conexões de saída até a Cloudflare. Como é o servidor que chama a Cloudflare, não é preciso porta de entrada nem IP público para o site. Segundo a documentação, cada instância abre 4 conexões, só de saída, para ao menos 2 data centers da Cloudflare.

A página do produto indica disponibilidade nos planos da Cloudflare; confira as condições do seu. Se você ainda não tem servidor, o guia completo de servidor VPS explica o que é e como comparar. Para quem prefere abrir as portas 80 e 443 e usar proxy reverso no próprio servidor, há o guia de Traefik na VPS.

O que você precisa antes

  • uma conta na Cloudflare;
  • um domínio na Cloudflare, para publicar uma aplicação. Em Domains, use Onboard a domain: a Cloudflare atribui 2 nameservers, que você coloca no registrador do domínio;
  • um servidor com acesso à internet e o site já respondendo localmente.

Para testar sem conta nem domínio existe o Quick Tunnel, com endereço temporário em trycloudflare.com. A Cloudflare o indica só para testes, sem garantia de disponibilidade, com até 200 requisições em andamento e sem SSE. Com o cloudflared já instalado (veja a instalação mais abaixo), o comando é:

cloudflared tunnel --url http://localhost:8080

O servidor que vai receber o túnel já está definido? Confira na loja o que cada plano de VPS inclui. Ver as VPS

Caminho principal: túnel criado pelo painel

A Cloudflare recomenda o túnel gerenciado pelo painel (com token); o gerenciamento local fica para desenvolvimento, teste ou configuração legada. Passo a passo:

  • Criar o túnel. Em Networking > Tunnels, clique em Create Tunnel, dê um nome e confirme em Create Tunnel.
  • Escolher o sistema. Em Setup Environment, escolha o sistema e a arquitetura do servidor.
  • Instalar e conectar. Rode os comandos de Install and Run mostrados na tela e clique em Continue. Em Debian ou Ubuntu, a instalação do cloudflared a partir do repositório da Cloudflare é:

sudo mkdir -p --mode=0755 /usr/share/keyrings

curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null

echo "deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main" | sudo tee /etc/apt/sources.list.d/cloudflared.list

sudo apt-get update && sudo apt-get install cloudflared

Em seguida, no Linux, a conexão como serviço usa o token que a tela mostra no lugar de <TUNNEL_TOKEN>:

sudo cloudflared service install <TUNNEL_TOKEN>

O status esperado do túnel é Healthy. Ele mede só a ligação do servidor até a Cloudflare, não se a aplicação responde.

Agora publique o site. Abra o túnel e, em Routes, clique em Add route e escolha Published application. Preencha o Hostname (subdomínio e domínio) e a Service URL, por exemplo http://localhost:80, e clique em Add route. O servidor web precisa continuar escutando em localhost nessa porta: o túnel não substitui o servidor do site. Um exemplo de comando para conferir isso antes:

curl -I http://localhost:80

Para testar, abra o hostname no navegador. O nome público aponta, por CNAME, para <UUID>.cfargotunnel.com, e parar o túnel não remove esse registro.

Sem uma aplicação do Cloudflare Access na frente, o site publicado fica aberto a qualquer pessoa na internet. O túnel não restringe quem acessa.

Proteger o acesso e o token

O Access é a camada de autenticação entre o usuário e o servidor de origem e nega o acesso por padrão. O caminho indicado na documentação é Zero Trust > Access controls > Applications. Para painéis administrativos, como o do Node-RED na VPS, é a camada que recomendamos configurar antes de divulgar o endereço.

O token é um segredo

Quem tem o token pode rodar o túnel. Não o cole em chat, repositório ou captura de tela. Em caso de vazamento, abra Networking > Tunnels, escolha o túnel, clique em Rotate token e derrube as conexões existentes.

Caminho alternativo: túnel local com config.yml

Neste caminho você cria o túnel pela linha de comando, com o cloudflared já instalado (os comandos de instalação estão mais acima). Na ordem, o login, a criação e o registro DNS do nome:

cloudflared tunnel login

cloudflared tunnel create <NAME>

cloudflared tunnel route dns <UUID or NAME> <hostname>

O login gera o arquivo cert.pem, e o create gera o arquivo de credenciais, ambos no diretório padrão. Depois, crie o config.yml; o comando de serviço mais abaixo usa o caminho /home/<USER>/.cloudflared/config.yml. Um exemplo, com hostname fictício; a indentação pode sumir ao copiar, e o caminho das credenciais depende do usuário que rodou o create:

tunnel: <Tunnel-UUID>

credentials-file: /root/.cloudflared/<Tunnel-UUID>.json

ingress:

- hostname: app.exemplo.com

service: http://localhost:80

- service: http_status:404

A última regra, sem hostname, é obrigatória e responde 404 ao que não casar com as anteriores. Valide o arquivo e depois rode e consulte o túnel:

cloudflared tunnel ingress validate

cloudflared tunnel run <UUID or NAME>

cloudflared tunnel info <UUID or NAME>

A Cloudflare recomenda rodar como serviço: cloudflared service install. Com sudo, o $HOME vira /root, então indique o arquivo, e depois inicie:

sudo cloudflared --config /home/<USER>/.cloudflared/config.yml service install

sudo systemctl start cloudflared

Docker, com tag fixa

No Docker, o token entra pela variável TUNNEL_TOKEN, equivalente ao parâmetro --token. O exemplo da documentação usa a tag latest; recomendamos fixar a versão. Na data deste texto, a última release listada é a 2026.10.7, de 30/10/2026; confira a versão atual no GitHub do projeto e no Docker Hub, e lembre que o suporte cobre versões com até 1 ano da release mais recente. Um exemplo de Compose; a indentação pode sumir ao copiar, então confira linha a linha:

services:

cloudflared:

image: cloudflare/cloudflared:2026.10.7

restart: unless-stopped

command: tunnel --no-autoupdate run

environment:

- TUNNEL_TOKEN=${TUNNEL_TOKEN}

Antes de subir, guarde o token num arquivo .env na mesma pasta, com a linha TUNNEL_TOKEN= seguida do valor, fora de qualquer repositório. Depois, um exemplo de comando: docker compose up -d.

Dentro de um contêiner, localhost é o próprio contêiner, não o servidor. Recomendamos ajustar a Service URL ao modo de rede que você usar, por exemplo o nome de um serviço do mesmo Compose.

Portas e firewall

O túnel só precisa de saída. A Cloudflare exige a porta 7844, em TCP (protocolo http2) e UDP (quic), para region1.v2.argotunnel.com e region2.v2.argotunnel.com. A saída pela 443 é opcional (atualização e validação do Access). O parâmetro --protocol tem padrão auto, que configura quic e cai para o protocolo disponível; forçar um protocolo bloqueado derruba o túnel.

A Cloudflare recomenda bloquear a entrada e liberar apenas a saída do cloudflared. Isso não dispensa o firewall, e um DROP final pode trancar o seu acesso se a porta do SSH não estiver preservada. Se a rede restringe a saída, confira a 7844.

Limites e erros

O Tunnel atende HTTP, HTTPS, TCP, SSH e RDP, entre outros; os serviços que não são HTTP exigem o cloudflared também no cliente. Por padrão, a Cloudflare faz a terminação do TLS em seus data centers e os produtos configurados inspecionam o pedido; por isso, não trate o caminho como ponta a ponta. Cada conta pode ter 1.000 túneis, com até 25 réplicas ativas por túnel.

Nos planos Free, Pro e Business, a rota pública de túnel segue os termos da Cloudflare, que pode agir se a aplicação servir vídeo ou muitos arquivos grandes sem o serviço pago adequado. Quanto ao upload, a página do erro 413 informa o limite de 100 MB nos planos Free e Pro pelo proxy da Cloudflare (200 MB no Business e até 5 GB no Enterprise). Como a rota pública passa pelo proxy, o limite pode valer no seu caso: confira nos termos da Cloudflare.

Para diagnosticar, o status do túnel pode ser Healthy, Inactive (ainda sem conexão), Down (o processo parou) ou Degraded (ao menos uma conexão falhou). O erro 502 indica túnel conectado, mas cloudflared sem alcançar a origem: serviço parado, protocolo ou porta errados, ou certificado. Já o 1033 indica que não há cloudflared saudável. Se o túnel estiver parado, não dependa do código exibido: olhe o status em Networking > Tunnels ou rode cloudflared tunnel list.

Os logs vão para o stderr e não são gravados por padrão. Para gravar e acompanhar:

cloudflared tunnel --loglevel info --log-directory <PATH> run <UUID>

cloudflared tail <UUID>

cloudflared tunnel diag

Se a origem usa HTTPS, a opção noTLSVerify tem padrão false; com true, aceita o certificado da origem sem checar. A Cloudflare a trata como último recurso temporário, não como solução definitiva.

Resumo do caminho

A ordem é: conta e domínio na Cloudflare, túnel criado, cloudflared instalado e conectado, rota pública, serviço local escutando, teste no navegador e, por fim, o Access na frente.

A publicação do site vai partir de uma VPS? Confira na loja o que cada plano inclui. Comparar VPS

Perguntas frequentes

O Cloudflare Tunnel dispensa o firewall?

Não. Ele dispensa a porta de entrada, mas precisa de saída pela porta 7844, e a Cloudflare recomenda bloquear a entrada e liberar só a saída do cloudflared.

O site fica privado?

Não. Sem uma aplicação do Access, o site publicado fica aberto a qualquer pessoa na internet.

Preciso de domínio?

Para publicar uma aplicação, sim: a Cloudflare pede um domínio na própria Cloudflare. O Quick Tunnel dispensa conta e domínio, mas é só para testes.

Qual tag do Docker usar?

Recomendamos uma tag fixa, não a latest. Na data deste texto, a última release listada é a 2026.10.7; confira a atual antes de usar.

Esta resposta lhe foi útil?

Artigos Relacionados