blog
Infraestrutura web

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.

JR · · 8 min de leitura · 1 tabela · 1 bloco de código

Resposta curta: 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.

Neste artigo
  1. Onde fica o cache do LSCache e onde fica o do APO
  2. Como saber se a borda ou o servidor respondeu a página
  3. O que cada combinação de cabeçalhos significa
  4. Quando o APO acrescenta algo
  5. O risco real: duas versões do mesmo HTML
  6. Como desligar o APO sem quebrar o site

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

Por onde passa uma requisição com as duas camadasVisitante pede a páginaPedido sai do navegadorBorda do CloudflareAPO guarda o HTML aquiServidor com LSCacheCópia guardada no servidorPHP e banco de dadosSó rodam se nada estiver guardado
Caminho de uma requisição quando as duas camadas estão ativas. Cada camada responde antes da seguinte.

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:

Como ver os cabeçalhos no navegador, sem terminal

  1. Abra o site em uma janela anônima (logado no WordPress, as duas camadas costumam pular o cache, e o teste perde sentido).
  2. Aperte F12 e clique na aba Rede (Network).
  3. Recarregue a página com F5.
  4. Na lista, clique na primeira linha, que tem o nome do domínio ou da página (tipo "documento").
  5. 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 APO tende a acrescentar pouco quando:

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

  1. 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.
  2. 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.
  3. 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.

Ordem de limpeza: servidor antes da bordaLimpar o cache do LSCacheFeito primeiro, no servidorLimpar a borda do CloudflareDepois, para não buscar versão velhaTestar em janela anônimaConferir cf-cache-status e conteúdo novoConteúdo velho com HIT?Limpe a borda manualmente e revise o plugin
Ordem sugerida de limpeza após editar um post. A ordem é raciocínio do guia, não citação da LiteSpeed.

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:

  1. 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.
  2. Limpe o cache do Cloudflare uma vez, para a borda não continuar entregando HTML guardado.
  3. 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.

Referências

  1. Documentação oficial (litespeed) — LSCWP and Cloudflare APO. Consultado em 2026-10-07.
Leia também