CDN da Cloudflare: cache entre a origem e o navegador
A CDN da Cloudflare é a rede de distribuição de conteúdo que guarda cópias de respostas HTTP nos seus data centers. Com o proxy ativo, você usa esse cache para servir arquivos sem consultar a origem a cada acesso, conforme a elegibilidade do conteúdo e o tempo de validade configurado.
Ficha e sumário da página
- Referência técnica
- Documentação de 15/11/2026
- Revisão
- 15 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O cache do proxy depende do tipo de arquivo
O proxy recebe a requisição e pode responder com uma cópia guardada na rede da Cloudflare. Na ausência de uma cópia utilizável, ele consulta a origem e avalia se a resposta pode entrar no cache. Esse caminho exige um hostname com proxy ativo nos registros de DNS. Em DNS only, a conexão segue direto ao servidor indicado pelo registro, fora desse cache HTTP.
Por padrão, a Cloudflare identifica os arquivos elegíveis pela extensão do caminho, sem usar o MIME type como base dessa seleção. A lista inclui CSS e JavaScript, imagens como JPG e PNG, fontes e documentos como PDF. O arquivo robots.txt também recebe cache por padrão. O HTML e o JSON ficam fora dessa seleção inicial, mesmo que atravessem o proxy normalmente.
Além da extensão elegível, o método da requisição e os cabeçalhos da resposta também afetam o armazenamento. No comportamento padrão, respostas com Set-Cookie não entram no cache e métodos diferentes de GET não recebem o mesmo tratamento de um download comum. Configurações adicionais podem alterar esse comportamento, por isso a nuvem laranja, isoladamente, não comprova que um conteúdo está guardado.
Navegador
GET /imagem.pngO navegador acessa um hostname com proxy ativo na Cloudflare.
Consulta ao cache
HIT ou MISSO proxy procura uma cópia utilizável para a chave daquela requisição.
Servidor de origem
Cache-ControlQuando necessário, a origem responde com o arquivo e os cabeçalhos de cache.
Resposta ao navegador
CF-Cache-StatusA resposta informa o resultado do cache, com a cópia da borda ou o conteúdo obtido da origem.
Cache-Control: validade e permissão de armazenamento
O cabeçalho Cache-Control permite à origem comunicar como uma resposta deve ser armazenada e reutilizada. A diretiva public admite cache compartilhado, enquanto private restringe o armazenamento ao cache privado, como o do navegador. A diretiva no-store orienta a não armazenar a resposta. Isso é relevante para conteúdo que muda conforme a sessão e não deve ser reutilizado entre visitantes.
O max-age define por quantos segundos a resposta permanece fresca. O s-maxage define essa validade especificamente para caches compartilhados, como o proxy, substituindo o max-age nessa avaliação. Um exemplo didático é Cache-Control: public, max-age=60, s-maxage=300: o navegador recebe uma validade de um minuto e o cache compartilhado recebe cinco minutos, respeitadas a elegibilidade e as demais configurações.
Os cabeçalhos CDN-Cache-Control e Cloudflare-CDN-Cache-Control aceitam essas diretivas para separar a política da CDN da política enviada ao navegador. Entre os cabeçalhos definidos na origem, a Cloudflare prioriza o segundo, específico da sua rede. Configurações aplicadas pela plataforma ainda podem substituir essas instruções, como o Edge Cache TTL para o prazo na borda.
A diretiva no-cache permite armazenamento, mas exige revalidação antes da reutilização. Esse comportamento depende do Origin Cache Control, ativo por padrão nos planos Free, Pro e Business. O Enterprise permite desativá-lo, o que altera o tratamento de algumas diretivas. Você precisa distinguir essa configuração do no-store, que orienta a não guardar o conteúdo.
Quando faltam instruções explícitas de validade, a Cloudflare aplica tempos padrão a determinados status HTTP de respostas elegíveis. A documentação lista duas horas para 200, 206 e 301, vinte minutos para 302 e 303 e três minutos para 404 e 410. A validade também não promete retenção: um objeto pode sair do cache antes do prazo e precisar de uma nova busca na origem.
Cache Rules para caminhos e exceções
As Cache Rules ajustam a elegibilidade e a duração do cache para requisições correspondentes a uma expressão. Você pode selecionar um hostname ou um caminho, permitir o armazenamento de conteúdo fora da seleção padrão ou dispensar o cache em uma área autenticada. O recurso aceita configuração pelo painel, pela API e pelo Terraform, com o proxy ativo como pré-requisito.
A opção de tornar uma resposta elegível permite incluir HTML, mas não autoriza ignorar a personalização da aplicação. Uma resposta que contém informações da sessão exige um tratamento compatível com esse conteúdo. Os cabeçalhos da origem continuam participando da avaliação, salvo quando uma configuração de Edge Cache TTL os substitui. Você também pode definir o Browser Cache TTL, que afeta o navegador e tem alcance diferente da validade na borda.
As configurações correspondentes são aplicadas em sequência e podem se combinar. Quando várias definem o mesmo ajuste, prevalece a última correspondência. Assim, uma exceção de cache pode ser substituída por uma configuração posterior para o mesmo caminho. A documentação lista 10 Cache Rules no Free, 25 no Pro, 50 no Business e 300 no Enterprise. Algumas opções específicas continuam dependendo do plano.
A purga remove as cópias da borda
A purga solicita a remoção de conteúdo armazenado para que novos acessos obtenham uma versão atualizada. A Cloudflare recomenda a purga por URL para arquivos individuais. Também há purga por hostname, por tag, por prefixo e de toda a zona. Esses métodos estão disponíveis nos quatro planos, com limites de uso próprios de cada plano.
Uma chave de cache personalizada pode exigir informações adicionais na purga. Quando a chave inclui cabeçalhos ou cookies, a purga individual pelo painel não consegue fornecer esses valores. A API permite enviar os elementos da chave junto da URL. A purga por hostname, prefixo ou tag remove os objetos correspondentes ao grupo selecionado, independentemente da composição dessa chave individual.
O retorno HTTP 200 da solicitação confirma o recebimento pela Cloudflare, sem comprovar que o arquivo estava guardado ou foi removido. O cabeçalho CF-Cache-Status permite examinar o acesso seguinte: HIT indica conteúdo servido do cache e MISS indica uma busca sem cópia disponível. O valor DYNAMIC aponta falta de elegibilidade na requisição, enquanto BYPASS pode resultar dos cabeçalhos recebidos da origem.
A purga da Cloudflare não apaga uma cópia já armazenada no navegador. Os tempos enviados ao cliente continuam relevantes depois da alteração na borda. O WAF da Cloudflare filtra as requisições que atravessam o proxy, enquanto a CDN administra a reutilização das respostas: a análise de uma recusa de acesso e a análise de um arquivo antigo começam por mecanismos diferentes.