# 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.

> 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.

João Rizzon · 2026-09-18 · Infraestrutura web

---

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](https://docs.litespeedtech.com/lsws/cp/cpanel/cloudflare/), 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:

- **Cache Everything** ligado em uma Page Rule antiga.
- **Cache Rule** nova com `Eligible for cache` forçado para um caminho ou para o site todo.
- **APO** (Automatic Platform Optimization) ou plugin que habilita cache de HTML na borda.

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:

```bash
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:

```bash
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.

## 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.

- **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.
- **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.
- **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á.

## 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](https://docs.litespeedtech.com/lsws/cp/cpanel/cloudflare/) 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:

```apache
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:

```bash
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**

- Conferir em Rules se existe Cache Everything ou Cache Rule com cache de HTML. Anotar sim ou não na ficha do site.
- Se a edição vai durar mais de dez minutos, ligar Development Mode.
- Registrar o `age` e o `cf-cache-status` atuais da home, para comparação depois.

**Depois de publicar**

- Purgar a origem (LiteSpeed Cache), a página alterada e a home.
- Validar a origem com `curl --resolve` e confirmar o conteúdo novo.
- Purgar a borda por URL, não o site inteiro.
- Repetir o `curl` pela Cloudflare: `cf-cache-status: MISS` no primeiro acesso, `HIT` com `age` baixo no segundo.
- Abrir a página em aba privada, em rede móvel, e conferir com os próprios olhos.
- Desligar Development Mode se ligou.

**Uma vez por site, e nunca mais**

- Regras de bypass para wp-admin, login, carrinho, checkout, conta e REST API, na borda e na origem.
- Restauração do IP real do visitante configurada e validada no log.
- Firewall da origem aceitando só as faixas da Cloudflare em 80/443, **mais o IP fixo ou a VPN da agência**. Sem essa exceção, o `curl --resolve` do bloco anterior para de funcionar e você perde o teste que separa origem de borda. Onde não houver IP fixo, a alternativa é usar Development Mode para tirar a borda do caminho ou manter um host de teste liberado.
- Frase de atendimento e nome do botão de purga anotados na ficha do cliente.

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:

> **** "O site guarda uma cópia pronta da página em dois lugares para carregar mais rápido: no nosso servidor e na rede de distribuição que deixa o site perto do visitante. Quando eu publico uma alteração, limpo as duas cópias, mas a que está na rede pode levar alguns minutos para se atualizar em todas as regiões. Já limpei as duas aqui: recarregue com Ctrl+Shift+R ou abra em uma janela anônima e você verá a versão nova."

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.

