blog
Infraestrutura web

Cloudflare mostra página velha: purgue origem, depois borda

Como decidir o que a borda guarda, em que ordem purgar quando publica e como ler nos cabeçalhos quem entregou a página. Com checklist para padronizar em todos os sites do portfólio.

JR · · 11 min de leitura · 3 tabelas · 5 blocos de código

Resposta curta: são duas camadas de cache de HTML, não uma: o LiteSpeed no servidor guarda o HTML da origem e o Cloudflare guarda na borda. Purgue sempre na ordem origem primeiro, borda depois, e leia cf-cache-status e age para saber qual das duas entregou a página velha.

Neste artigo
  1. As duas camadas e quem guarda o quê
  2. O que a borda guarda por padrão, e quando o HTML entra
  3. Ler os cabeçalhos e descobrir quem entregou a página
  4. Ordem de purga na publicação
  5. Regras de bypass: wp-admin, carrinho e login
  6. Devolver o IP real do visitante ao log
  7. Checklist de publicação reutilizável
  8. A frase para o cliente

Quem já resolveu cache no servidor, com LiteSpeed Cache no WordPress e purga configurada, coloca Cloudflare na frente e o problema reaparece: o cliente edita o preço, vê o site no celular e continua a versão antiga. A causa quase nunca é o plugin. É que agora existem duas camadas guardando HTML, com botões de purga diferentes, cabeçalhos diferentes e uma ordem certa de limpar.

Este guia é documental: os cabeçalhos abaixo aparecem como exemplos de leitura, não como medição nossa. O que é parâmetro de configuração vem da documentação oficial do LiteSpeed sobre Cloudflare no cPanel, e o que varia por conta ou por plano está marcado como "valide no painel".

As duas camadas e quem guarda o quê

Com Cloudflare em modo proxy (nuvem laranja no DNS), a requisição passa por dois caches de HTML antes de chegar ao PHP. Há um terceiro cache no caminho, o da aplicação, que entra na tabela como camada complementar porque não guarda HTML pronto:

Camada Onde roda Guarda o quê Quem purga Cabeçalho que delata
1. Borda Data center da Cloudflare Estático por padrão; HTML só se alguém pediu Painel da Cloudflare, API, Development Mode cf-cache-status, age, cf-ray
2. Origem Seu servidor (LiteSpeed/LSCache) HTML da página, por URL e por vary Plugin LiteSpeed Cache, purga do painel, hook do WordPress x-litespeed-cache
Complementar: aplicação PHP + MySQL Object cache, transients WP-CLI, plugin nenhum

A camada complementar não serve página velha para visitante anônimo, porque ela não armazena HTML: guarda resultado de consulta, opção e transient. Ela pode, sim, fazer com que o HTML recém-gerado saia com um número desatualizado dentro. Diagnóstico diferente, botão diferente. Para o caso clássico de "publiquei e o cliente vê o antigo", o jogo é entre borda e origem.

A consequência prática: purgar a origem não tira nada da borda, e purgar a borda não tira nada da origem. Se você só conhece um dos dois botões, metade dos casos de "página velha" vai continuar aparecendo.

O que a borda guarda por padrão, e quando o HTML entra

No comportamento padrão do proxy, a Cloudflare guarda arquivo estático (imagem, CSS, JS, fonte) e trata HTML como conteúdo dinâmico: passa para a origem toda vez. Nesse cenário, HTML velho não vem da borda. Se o cliente vê página antiga, o suspeito é o cache da origem ou o navegador dele.

O HTML entra na borda em três situações, todas causadas por configuração explícita:

Quando o HTML está na borda, um Edge TTL de algumas horas significa que o cliente pode ver a versão antiga por horas depois da edição, mesmo com a origem limpa. Antes de qualquer diagnóstico, abra a aba de Rules da zona e escreva numa anotação do projeto: HTML na borda, sim ou não. Sem essa resposta você está chutando.

A lista exata de extensões que a Cloudflare considera estática pode mudar e varia por configuração da zona. Confirme pelos cabeçalhos, não pela memória.

Ler os cabeçalhos e descobrir quem entregou a página

Use GET, não HEAD. Vários caches respondem de forma diferente a HEAD e você acaba diagnosticando o cache errado. Com curl, o jeito de pegar só os cabeçalhos de um GET real:

curl -sS -o /dev/null -D - https://exemplo.com.br/ \
  | grep -iE 'HTTP/|cf-cache-status|^age|cache-control|x-litespeed-cache|cf-ray|vary'

Uma resposta típica de página com HTML na borda, servida da borda:

HTTP/2 200
cache-control: public, max-age=0, must-revalidate
cf-cache-status: HIT
age: 842
cf-ray: 8b2f1c9a7e4f0d21-GRU

O age: 842 diz que aquela cópia está na borda há 842 segundos (valor de exemplo). Se você publicou a alteração há dois minutos e o age é maior que isso, a borda está servindo cópia anterior à sua edição. Fim do mistério.

Tabela de leitura do cf-cache-status

Valor Significado O que fazer
HIT A borda respondeu da cópia dela Purgar a borda; confira o age
MISS Passou na borda, foi buscar na origem e guardou Agora o próximo visitante pega HIT
EXPIRED Tinha cópia, venceu, revalidou na origem Se o conteúdo veio velho, o problema é a origem
DYNAMIC A borda decidiu não guardar HTML não está em cache na borda
BYPASS Regra ou cabeçalho mandou não usar cache Esperado em wp-admin, carrinho, checkout
REVALIDATED Cópia confirmada com a origem Conteúdo atual

O cabeçalho da origem

Com LiteSpeed, o x-litespeed-cache: hit mostra que o HTML saiu do cache do servidor sem executar PHP. x-litespeed-cache: miss mostra que o PHP rodou. Para ver a origem sem a borda no caminho, resolva o host direto no IP do servidor:

curl -sS -o /dev/null -D - https://exemplo.com.br/ \
  --resolve exemplo.com.br:443:203.0.113.10 \
  | grep -iE 'HTTP/|x-litespeed-cache|cache-control'

203.0.113.10 é endereço de exemplo (faixa reservada para documentação): troque pelo IP real do servidor. Esse teste responde a pergunta que importa no atendimento: a origem já tem a versão nova. Se tem, o resto é borda ou navegador.

Se o firewall da origem já estiver fechado para aceitar só as faixas da Cloudflare (recomendação do checklist), esse curl vai falhar com conexão recusada ou tempo esgotado. É comportamento esperado, não defeito: o teste direto na origem só funciona a partir de um IP liberado na regra, normalmente o IP fixo ou a VPN da agência.

Como descobrir quem entregou a página velhaHTML na borda?Confira Rules da zonacf-cache-status e ageGET pela CloudflareHIT com age altoBorda serve cópia anteriorcurl --resolve na origemVeja x-litespeed-cacheOrigem já atualizadaResta borda ou navegador
Sequência de leitura de cabeçalhos para separar borda, origem e navegador.

Ordem de purga na publicação

A ordem não é preferência, é dependência. A borda, quando você a purga, vai buscar o HTML na origem no próximo acesso. Se a origem ainda tem o HTML antigo em cache, a borda guarda o antigo de novo e você repõe o problema com aparência de resolvido.

  1. Origem primeiro. Purga do LiteSpeed Cache (Purge All ou purga da URL alterada). Confirme com o curl --resolve acima: x-litespeed-cache: miss no primeiro acesso e o conteúdo novo no corpo.
  2. Borda depois. Purgar por URL é melhor que Purge Everything: tira só o que mudou e não derruba o hit rate do site inteiro. Purgue a URL alterada, a home e qualquer arquivo com nome fixo que você substituiu.
  3. Navegador do cliente por último, se ele insistir. Ctrl+Shift+R ou aba privada.

O plugin LiteSpeed Cache tem uma seção de integração com a API da Cloudflare, o que permite disparar a purga da borda a partir do WordPress. A existência e o nome das opções variam por versão do plugin: confira na aba de CDN antes de prometer o automatismo ao cliente. Onde não houver integração, o token de API da Cloudflare com permissão de purga na zona resolve por script ou por Deploy hook.

Para janela de edição longa, o Development Mode da Cloudflare é mais eficiente que purgar de dez em dez minutos: ele desliga o cache da borda temporariamente. Ligue quando começar a mexer, e não confie na memória para desligar; ele expira sozinho, mas o site fica sem borda até lá.

Ordem de purga na publicaçãoOrigem primeiroPurga do LiteSpeed CacheValidar origemcurl --resolve, conteúdo novoBorda depoisPurgar por URL, não tudoNavegador por últimoCtrl+Shift+R ou aba privada
Purgar a borda antes da origem repõe o HTML antigo na borda.

Regras de bypass: wp-admin, carrinho e login

Se você ligou Cache Everything, o HTML de área logada também é elegível para cache. O resultado varia de irritante (dashboard estranho) a grave (página de carrinho de um visitante servida para outro). Bypass explícito não é opcional nesse cenário.

Alvo Critério da regra Motivo
/wp-admin/* Caminho começa com Painel é sempre único por usuário
/wp-login.php Caminho igual a Nonce e redirect de login
/cart, /checkout, /my-account Caminho começa com Conteúdo por sessão no WooCommerce
/wp-json/* Caminho começa com REST API usada por blocos e integrações
Cookie wordpress_logged_in_* Cookie presente Usuário autenticado
Cookie woocommerce_items_in_cart Cookie presente Carrinho com itens
Cookie wp-postpass_* Cookie presente Post protegido por senha
Query de preview Query string contém preview=true Pré-visualização de rascunho

Duas ressalvas honestas. A disponibilidade do campo de cookie em Cache Rules depende do plano da zona: valide no painel antes de desenhar a arquitetura em cima disso. E o cache da origem precisa das mesmas exclusões, porque bypass na borda não impede o LiteSpeed de guardar aquele HTML. Configure os dois lados com a mesma lista, ou você troca um bug por outro.

Se o site tem área logada, carrinho ou formulário com estado, a recomendação que contraria o instinto de performance é a certa: não ligue cache de HTML na borda. O LSCache na origem já entrega HTML sem executar PHP, e o ganho restante raramente paga o risco de servir sessão trocada.

Devolver o IP real do visitante ao log

Com o proxy ativo, a conexão TCP chega dos servidores da Cloudflare. Sem configuração, o access_log registra IP da Cloudflare em toda linha, e aí quebram coisas concretas: plugin de limite de tentativas de login bloqueia todo mundo ou ninguém, antispam perde referência, relatório de acesso fica inútil, e o firewall da origem não consegue distinguir atacante de visitante.

O IP do visitante vem no cabeçalho CF-Connecting-IP. A documentação do LiteSpeed para Cloudflare no cPanel trata exatamente da restauração do IP original do visitante nesse ambiente: siga o procedimento indicado lá para a sua versão do LiteSpeed, porque o caminho no painel muda entre versões.

Três caminhos, em ordem de preferência para quem administra sites de cliente:

1. Plugin da Cloudflare no cPanel

Se a conta tem o plugin da Cloudflare no cPanel, a opção de restaurar os IPs originais dos visitantes resolve sem editar configuração de Apache. É o caminho que dá menos manutenção em portfólio grande, porque não precisa acompanhar mudança de faixa de IP.

2. mod_remoteip no Apache

Vale só onde quem atende a requisição é o Apache. O LiteSpeed Web Server não processa RemoteIPHeader nem RemoteIPTrustedProxy: nele, o equivalente é a opção nativa de IP de cliente em cabeçalho, descrita no item 3 abaixo. Em cPanel com Apache, o lugar de colocar isso é o Include Editor do WHM, não o httpd.conf (que é reescrito). Esqueleto da diretiva:

RemoteIPHeader CF-Connecting-IP
# Cole aqui as faixas IPv4 e IPv6 publicadas pela Cloudflare,
# uma por linha, como RemoteIPTrustedProxy.
# RemoteIPTrustedProxy 0.0.0.0/0 NAO: qualquer cliente poderia forjar o IP.

Não copie faixa de IP de memória nem de post antigo: pegue a lista publicada pela Cloudflare no momento da configuração e agende revisão. Sem a lista de proxies confiáveis, o cabeçalho passa a ser forjável por qualquer requisição que chegue direto ao servidor.

3. Configuração do LiteSpeed

O LiteSpeed tem, na configuração de servidor, a opção de usar o IP de cliente vindo em cabeçalho, com variante restrita a IPs confiáveis. Prefira sempre a variante restrita. A documentação oficial citada acima é a referência para o nome e o local exatos da opção na sua versão.

Validar em 30 segundos

Acesse o site pelo Cloudflare, depois procure seu IP no log:

tail -n 20 ~/access-logs/exemplo.com.br

Se as linhas do seu acesso trazem seu IP residencial, está correto. Se trazem IP da Cloudflare, a configuração não pegou. Bloquear a origem para aceitar conexão só das faixas da Cloudflare, por firewall, fecha o furo de alguém acessar o IP direto e forjar o cabeçalho.

Checklist de publicação reutilizável

Salve como snippet no seu gerenciador de projetos e rode em toda entrega. Vale para qualquer site do portfólio que tenha Cloudflare na frente.

Antes de mexer

Depois de publicar

Uma vez por site, e nunca mais

Os quatro itens de "Uma vez por site" são o que transforma isso em processo: uma vez configurados, a publicação cai para o bloco "Depois de publicar" e leva menos de cinco minutos.

A frase para o cliente

O cliente não quer saber de camada, TTL nem cabeçalho. Ele quer saber se o site está quebrado e se vai acontecer de novo. Frase pronta, para copiar no WhatsApp:

Duas observações que economizam a segunda mensagem: peça o print com a hora visível, porque na maioria das vezes o cliente olhou antes da purga terminar, e se ele estiver em rede corporativa, lembre que pode existir um proxy da empresa dele no meio, fora do seu alcance e do da Cloudflare. Nesse caso, testar pelo 4G do celular separa o que é seu problema do que não é.

Se você chegou aqui vindo dos artigos de cache no cPanel e de configuração do LiteSpeed Cache, o encaixe é este: aqueles resolvem a origem, este resolve o que mudou quando a borda entrou na frente. A ordem de purga é a peça que costuma faltar.

Referências

  1. Documentação oficial (litespeed) — LiteSpeed com Cloudflare no cPanel. Consultado em 2026-09-16.
Leia também