O que é a Cloudflare e para que ela serve
A Cloudflare é uma rede global de data centers que responde pelo DNS do seu domínio e fica entre o visitante e o seu site como proxy reverso. Quando o registro está com o proxy ligado, o visitante recebe um IP anycast da Cloudflare, por isso cada requisição chega primeiro ao data center mais próximo, que serve a página da própria rede ou repassa a requisição ao seu servidor.
Ficha e sumário da página
- Referência técnica
- Wrangler 4.162.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Uma rede que fica na frente do seu domínio
A Cloudflare opera uma rede com milhares de máquinas espalhadas por centenas de locais. Quando você cadastra um domínio na Cloudflare, ela vira o provedor de DNS autoritativo desse domínio: é a Cloudflare que responde quando um navegador pergunta qual endereço IP corresponde a seudominio.com.br. Você mantém os registros no painel ou na API dela.
Essa resposta varia com o status de proxy de cada registro. Com o proxy ligado, a nuvem laranja do painel, a Cloudflare responde com um IP anycast, um endereço compartilhado por vários data centers. A internet leva o visitante ao data center mais próximo que anuncia esse endereço. Com o proxy desligado, o registro fica como DNS only e a resposta traz o IP real do seu servidor, visível para qualquer consulta.
O tráfego HTTP e HTTPS de um registro com proxy passa pela rede da Cloudflare a caminho do servidor de origem. No meio do caminho, a Cloudflare termina o TLS, aplica a configuração de cache e de firewall do painel e decide se a resposta sai do próprio data center ou se a requisição segue até a origem, papel que a documentação chama de proxy reverso.
Hospedagem, segurança e rede no mesmo painel
Além do DNS e do proxy, a plataforma reúne serviços que usam a mesma rede de data centers. Alguns ficam na frente de um servidor que você já tem, com cache e filtro de tráfego. Outros dispensam o servidor para o site, para funções curtas e para arquivos, porque o código e os arquivos ficam na própria rede da Cloudflare. A árvore abaixo agrupa os serviços que aparecem neste portal pela camada onde cada um atua:
seudominio.com.brA zona DNS que a Cloudflare administra depois da troca dos nameservers.DNS e proxyRespondem pelo domínio e decidem se o tráfego passa pela rede.Developer PlatformHospedam o site, o código e os arquivos na própria rede.PagesSite estático publicado a partir do repositório.WorkersCódigo que roda a cada requisição, também com assets estáticos.R2Armazenamento de objetos compatível com a API do S3.cloudflaredConector aberto do Cloudflare Tunnel, instalado no seu servidor.
O DNS e o proxy aparecem na página DNS e domínios, enquanto o Pages, os Workers e o R2 ganham uma página própria cada um. A página Hospedagem na borda mostra como os três se combinam num site completo.
Para que a Cloudflare serve no seu projeto
O primeiro uso é colocar um domínio atrás do proxy para ganhar HTTPS, cache e proteção contra ataques de negação de serviço sem mexer no servidor. Nesse desenho, o site continua na sua VPS e a Cloudflare só fica no caminho, com o IP da origem escondido atrás dos endereços anycast.
O segundo uso é hospedar o próprio site na rede da Cloudflare. Um site estático gerado pelo Astro, pelo Hugo ou pelo Vite vira um conjunto de arquivos que o Pages ou um Worker servem a partir de cada data center. O código que precisa rodar por requisição, como um redirecionamento, uma API pequena ou um formulário, roda num Worker. Os arquivos grandes, como vídeos, imagens enviadas pelos usuários e cópias de backup, vão para um bucket do R2.
O website da Promovaweb está hospedado desse segundo jeito: o build do Astro gera a pasta dist, publicada como assets estáticos de um Worker. Um middleware em JavaScript, no mesmo Worker, aplica os redirecionamentos permanentes antes de servir cada página. Cada push na branch main do GitHub dispara o build e a publicação, como explica a página Builds e deploy pelo GitHub.
Site na VPS com a Cloudflare na frente
- O servidor guarda os arquivos e roda o código de cada página.
- A Cloudflare faz cache e repassa à origem o que não está em cache.
- Uma queda da VPS derruba as páginas que não estavam em cache.
- Você mantém sistema operacional, servidor web e certificados da origem.
Site hospedado na rede da Cloudflare
- Os arquivos do build ficam na rede e saem do data center mais próximo.
- O código roda num Worker, no data center que recebeu a requisição.
- Nenhum servidor seu participa das requisições ao site.
- O banco e os processos contínuos seguem numa VPS ou num serviço gerenciado.
A empresa, a marca e o que é aberto
A Cloudflare, Inc. mantém a plataforma, que é proprietária. Ela não publica o código dos serviços nem um número de versão para o DNS, o proxy, o Pages, os Workers ou o R2, por isso as páginas deste portal registram a data da consulta à documentação e a versão do Wrangler, a ferramenta de linha de comando que publica Workers e projetos do Pages e administra os buckets do R2. A referência atual das páginas é o Wrangler 4.162.0, publicado em novembro de 2026.
Dois componentes da Cloudflare publicam o código no GitHub. O Wrangler fica no repositório workers-sdk, onde cada versão sai como release. O cloudflared, conector do Cloudflare Tunnel, usa a licença Apache 2.0 e publica cada versão nas releases do repositório no GitHub. As variáveis de ambiente desse conector estão em Variáveis de ambiente.
A política de marcas da Cloudflare permite citar o nome dos produtos em texto e exige permissão escrita para usar o logo. Por isso este portal escreve Cloudflare, Pages, Workers e R2 por extenso e não reproduz o logo. O mesmo cuidado vale para o cloudflared, porque a licença Apache 2.0 cobre o código e não cede a marca.
O que continua com você
Um Worker não mantém um processo seu ligado o tempo todo nem grava num disco próprio. O código roda dentro de um isolate do V8, que a plataforma pode descartar entre uma requisição e outra quando falta recurso na máquina ou quando o Worker passa dos limites. O banco relacional do seu app, uma fila com processamento contínuo e uma ferramenta como o n8n continuam numa VPS ou num serviço gerenciado, com a Cloudflare na frente pelo proxy. A página Hospedagem na borda mostra onde passa essa divisão.