# Cloudflare APO com LiteSpeed Cache: quando vale ligar

Como ler nos cabeçalhos do seu site qual camada entregou a página, em que casos a borda do Cloudflare ajuda e como impedir que servidor e borda guardem versões diferentes do mesmo HTML.

> com LiteSpeed Cache ativo, o APO acrescenta algo em três casos: visitantes longe do servidor, origem sobrecarregada em picos ou HTML hoje entregue pela borda como DYNAMIC. Fora disso, o LSCache já elimina PHP e banco.

João Rizzon · 2026-11-17 · Infraestrutura web

---

## Onde fica o cache do LSCache e onde fica o do APO

O **LiteSpeed Cache** (o plugin LSCWP) guarda o HTML pronto da página dentro do seu servidor de hospedagem. Quando um visitante pede a página, o servidor LiteSpeed entrega essa cópia sem rodar o PHP nem consultar o banco de dados.

O **APO** (Automatic Platform Optimization) do Cloudflare guarda o HTML em outro lugar: nos servidores de borda do Cloudflare, antes de o pedido chegar à sua hospedagem. Quando o APO tem a página, a requisição nem encosta no seu servidor.

As duas camadas fazem a mesma coisa (cache de página inteira), só que em pontos diferentes do caminho. Essa sobreposição é o motivo da dúvida. A LiteSpeed mantém uma página específica sobre essa combinação, [LSCWP and Cloudflare APO](https://docs.litespeedtech.com/shared/lscache/lscwp-cf-apo-tip/), e ela é a referência deste guia. Pela nossa leitura, a página trata o uso conjunto como uma configuração possível, sem desaconselhá-la; o cuidado prático é manter as duas camadas sincronizadas, e é isso que este guia detalha. Como a documentação muda com as versões do plugin, leia a página antes de ativar. Não fizemos medição própria de velocidade com as duas camadas: o que segue é leitura de documentação mais o procedimento para você verificar no seu próprio site.

## Como saber se a borda ou o servidor respondeu a página

Você não precisa adivinhar. Cada camada deixa um cabeçalho na resposta:

- `cf-cache-status`: escrito pelo Cloudflare. Diz se a borda entregou do cache dela.
- `cf-apo-via`: aparece quando o APO está ativo no domínio e indica se a página veio do cache do APO ou da origem.
- `x-litespeed-cache`: escrito pelo LiteSpeed no servidor. Diz se o LSCache entregou do cache dele.

### Como ver os cabeçalhos no navegador, sem terminal

- Abra o site em uma **janela anônima** (logado no WordPress, as duas camadas costumam pular o cache, e o teste perde sentido).
- Aperte `F12` e clique na aba **Rede** (Network).
- Recarregue a página com `F5`.
- Na lista, clique na primeira linha, que tem o nome do domínio ou da página (tipo "documento").
- Na aba **Cabeçalhos**, desça até **Cabeçalhos de resposta** e procure os três nomes acima.

Recarregue duas ou três vezes. A primeira visita pode vir sem cache; as seguintes mostram o comportamento normal.

### Como ver os mesmos cabeçalhos pelo terminal

Se preferir, este comando faz o mesmo. Troque o endereço pelo do seu site:

```
curl -sI https://www.exemplo.com.br/ | grep -i -E "cf-cache-status|cf-apo-via|x-litespeed-cache"
```

Linha a linha: `curl -sI` pede só os cabeçalhos da página, sem baixar o conteúdo e sem barra de progresso. O `|` passa o resultado adiante. O `grep -i -E` filtra e mostra apenas as linhas com um dos três nomes, sem diferenciar maiúscula de minúscula. O resultado esperado são de uma a três linhas, por exemplo `cf-cache-status: HIT`. Se nada aparecer, nem o Cloudflare nem o LSCache responderam nessa URL. Antes de concluir isso, descarte a causa mais comum de saída vazia: um redirecionamento (de http para https, ou do endereço sem www para o com www). Para conferir, rode o mesmo comando sem a parte `| grep ...`. Se a primeira linha for `HTTP/2 301` (ou `HTTP/1.1 301`), o que você viu foram só os cabeçalhos do redirecionamento, não os da página. Nesse caso há duas saídas. A primeira é usar o endereço final, que aparece na linha `location:`. A segunda é acrescentar `-L` ao curl (`curl -sIL`). Essa opção faz o curl seguir o redirecionamento até a página final e mostrar também os cabeçalhos dela.

## O que cada combinação de cabeçalhos significa

Os valores abaixo são os mais comuns. A tabela é um guia de leitura, não uma medição.

| cf-cache-status | x-litespeed-cache | Quem entregou o HTML | Leitura |
|---|---|---|---||
| HIT | qualquer valor | Borda do Cloudflare | O servidor nem foi consultado. O valor de `x-litespeed-cache` é o que estava gravado quando a borda guardou a cópia. |
| MISS ou EXPIRED | hit | Servidor, do LSCache | A borda não tinha a página; o LSCache entregou rápido e a borda deve guardar a partir daí. |
| MISS ou EXPIRED | miss | Servidor, gerando com PHP | Nenhuma camada tinha a página. É a resposta mais lenta. |
| DYNAMIC ou BYPASS | hit | Servidor, do LSCache | O Cloudflare não está guardando HTML (APO desligado ou regra de exceção). Só o LSCache trabalha. |
| DYNAMIC ou BYPASS | miss | Servidor, gerando com PHP | Ninguém está cacheando essa página. Vale investigar antes de comprar qualquer coisa. |
| ausente | hit | Servidor, do LSCache | O domínio não passa pelo proxy do Cloudflare (nuvem cinza no DNS). |

O detalhe da primeira linha é o que mais confunde. Quando a borda entrega `HIT`, ela devolve os cabeçalhos que guardou junto com a página. Então ver `x-litespeed-cache: hit` ao lado de `cf-cache-status: HIT` não prova que o servidor respondeu agora. Prova só que, quando a cópia foi feita, o LSCache tinha a página.

## Quando o APO acrescenta algo

Com o LSCache funcionando, o ganho principal do APO está na distância, não no processamento. O LSCache já elimina o custo do PHP e do banco. O que sobra é o tempo de ida e volta entre o visitante e o servidor.

O APO tende a acrescentar quando:

- O público está longe do servidor. Exemplo: site hospedado no Brasil com leitores relevantes em Portugal ou nos Estados Unidos.
- O servidor de origem está sobrecarregado em picos e você quer que parte das visitas nem chegue até ele.
- Você já usa o Cloudflare como proxy e o HTML hoje aparece como `DYNAMIC`, ou seja, a borda só guarda imagens, CSS e JS.

O APO tende a acrescentar pouco quando:

- O público e o servidor estão no mesmo país. A diferença entre entregar da borda e entregar do LSCache próximo é pequena.
- A tabela acima mostra `x-litespeed-cache: miss` com frequência. Aí o problema é o LSCache não estar guardando a página (exceções demais, cookies, parâmetros na URL). Resolver isso no plugin, sem gastar nada, rende mais que somar uma segunda camada.
- O site é muito personalizado (loja com carrinho, área de membros). As duas camadas pulam o cache para usuário logado, e o ganho fica restrito às visitas anônimas.

Se você não sabe onde está seu público, o relatório de origem dos visitantes no seu analytics responde isso antes de qualquer decisão.

## O risco real: duas versões do mesmo HTML

Com as duas camadas ligadas, existem duas cópias da página: uma no servidor, outra na borda. Quando você edita um post, o LSCache limpa a cópia dele. Se nada avisar o Cloudflare, a borda continua entregando a versão antiga. O sintoma clássico: você vê a mudança logado, o visitante não vê.

A página da LiteSpeed sobre [LSCWP e APO](https://docs.litespeedtech.com/shared/lscache/lscwp-cf-apo-tip/) existe justamente por causa dessa convivência. O ponto central é que a limpeza de cache precisa chegar às duas camadas. A ordem a seguir é raciocínio nosso, não citação da LiteSpeed: limpe primeiro o servidor, depois a borda. Se a borda for limpa antes, ela pode buscar de novo no servidor e guardar a versão velha que ainda estava no LSCache.

### Como fazer a limpeza do servidor chegar à borda

Antes de mexer, faça backup das configurações. No painel do WordPress, vá em **LiteSpeed Cache > Caixa de ferramentas (Toolbox) > Importar / Exportar** e exporte o arquivo de configuração. Para voltar atrás, basta importar esse arquivo.

- Confirme que o plugin oficial **Cloudflare** está instalado e conectado, porque é por ele que o APO é ativado no WordPress e é ele que pede limpeza da borda ao salvar conteúdo.
- No LiteSpeed Cache, abra **LiteSpeed Cache > CDN** e veja se existe uma área do **Cloudflare** configurada. Não encontramos na documentação citada a confirmação de que essa integração limpa a borda a cada post salvo, então não dependa dela para isso. Com o plugin Cloudflare do item anterior conectado e o APO ativo, é ele que pede a limpeza da borda; a integração do LSCWP não é necessária para o teste abaixo. O próximo item confirma se a limpeza está acontecendo.
- Edite um post de teste, salve, e abra em janela anônima. Rode o teste de cabeçalhos: o primeiro acesso deve vir com `cf-cache-status: MISS` (ou `EXPIRED`) e o conteúdo novo. Os seguintes, `HIT` com o conteúdo novo.

Se o conteúdo velho aparecer junto com `HIT`, a borda não foi avisada. Limpe manualmente no painel do Cloudflare (**Caching > Configuration > Purge Cache**) e revise se o plugin oficial Cloudflare está conectado e com o APO ativo em **Configurações > Cloudflare**.

## Como desligar o APO sem quebrar o site

Se depois do teste o ganho não justificar, desligar é simples e não afeta o LSCache:

- No WordPress, abra **Configurações > Cloudflare** (plugin oficial) e desative o APO. Também é possível desativar no painel do Cloudflare, na área de otimização do domínio.
- Limpe o cache do Cloudflare uma vez, para a borda não continuar entregando HTML guardado.
- Refaça o teste de cabeçalhos. O esperado é `cf-cache-status: DYNAMIC` e `x-litespeed-cache: hit` a partir da segunda visita. Esse é o cenário de uma camada só, e para muitos sites ele já é suficiente.

A decisão, no fim, sai dos cabeçalhos do seu próprio site e de onde estão seus visitantes. Se o LSCache já entrega `hit` e o público está perto do servidor, a segunda camada adiciona uma coisa a mais para manter sincronizada. Se o público está espalhado e a coordenação de limpeza está configurada, o APO tem onde agir.

