Cloudflare Tunnel: como publicar um site sem abrir portas
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

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.