# Como configurar o LiteSpeed Cache: de 1.786 ms para 116 ms

Instalação pelo painel, as poucas caixas que realmente precisam ser marcadas, as páginas que nunca podem entrar em cache e a checagem no navegador que mostra o cabeçalho mudando de miss para hit.

> com o cache de página ativo, o TTFB mediano da mesma página WordPress foi de 116 ms contra 1.786 ms sem cache, 15× mais rápido. Instale o LiteSpeed Cache, ligue a aba Cache, exclua carrinho, checkout, minha-conta e login, e confirme no navegador o cabeçalho x-litespeed-cache: hit.

João Rizzon · 2026-09-04 · WordPress

---

## O que o cache de página resolve, em uma frase

Sem cache, cada visita faz o WordPress montar a página do zero: PHP roda, o banco responde dezenas de consultas, o tema e os plugins entram na fila. Com cache de página, o servidor guarda o HTML pronto e devolve o arquivo já montado para a próxima pessoa que pedir a mesma URL.

A diferença aparece no TTFB, o tempo entre o navegador pedir a página e o primeiro byte da resposta chegar. Na mesma página WordPress, com e sem cache de página, o TTFB mediano foi de **116 ms** contra **1.786 ms**, cerca de 15 vezes mais rápido.

Como esse número saiu: a URL medida foi um post do WordPress, sempre a mesma, com o mesmo tema e os mesmos plugins ativos. As requisições foram feitas de uma máquina fora do servidor, sequencialmente, com `curl` medindo `time_starttransfer` (o tempo até o primeiro byte). Foram 100 requisições em cada rodada, em setembro de 2026, e o valor citado é a mediana de cada uma. Entre a primeira e a segunda rodada mudou uma coisa só: a opção **Ativar cache** do plugin passou de desligada para ligada. Nada de conteúdo, tema, plugin ou plano de hospedagem foi alterado no meio.

O que você vai conferir com os próprios olhos até o fim deste guia é o cabeçalho `x-litespeed-cache` mudando de `miss` para `hit`. É a prova de que o servidor parou de montar a página a cada visita. Se quiser também medir o TTFB do seu site, tem um passo opcional com `curl` no fim da seção de teste.

Duas coisas que o cache de página **não** faz, para você não esperar o que não vem:

- Não acelera quem está logado no painel. Administrador e editor continuam recebendo a página gerada na hora, de propósito.
- Não conserta consulta lenta de banco em página que nunca pode ser cacheada, como o carrinho de uma loja. Se o seu problema está lá, cache não é o remédio.

**15×** diferença de TTFB mediano da mesma página WordPress com e sem cache de página (116 ms contra 1.786 ms) (n=100, setembro de 2026)

## Cheque o servidor e faça o backup antes de instalar

O plugin LiteSpeed Cache só faz cache de página de verdade quando o servidor web é LiteSpeed ou OpenLiteSpeed. Em Apache ou Nginx puro, ele instala, abre o menu, mostra as opções, e o cache de página simplesmente não entra em ação.

### Como saber em dez segundos se o seu servidor é LiteSpeed

A checagem leva dez segundos. Abra o site em uma aba anônima, aperte `F12`, vá na aba **Network** (Rede), recarregue com `F5`, clique na primeira linha da lista (a que tem o nome do domínio ou o nome do documento) e olhe **Response Headers**. Procure a linha `server`.

Se você prefere terminal, o mesmo teste em uma linha:

```
curl -sI https://seusite.com.br | grep -i -E "server|litespeed"
```

O que cada pedaço faz: `curl -sI` pede só os cabeçalhos da resposta, sem baixar a página; `-s` esconde a barra de progresso; o `grep -i -E` filtra as linhas que interessam, ignorando maiúsculas.

Resposta esperada em servidor LiteSpeed, antes de instalar qualquer coisa:

```
server: LiteSpeed
```

Se aparecer `nginx` ou `Apache`, pare aqui e pergunte à sua hospedagem qual servidor web ela usa. Instalar o plugin nesse cenário só vai gerar frustração e a sensação de que "cache não funciona".

### O backup a fazer antes de ligar o cache

Cache mal configurado não apaga arquivo, mas quebra layout, mistura página e, no pior caso, entrega a tela de um visitante para outro. Vale ter o caminho de volta pronto.

Gere um backup completo (arquivos e banco) pelo painel da sua hospedagem ou por um plugin de backup, e confirme que o arquivo terminou de ser criado antes de continuar. Backup que está "em andamento" não é backup.

### Como desfazer se algo quebrar

- Painel do WordPress, menu **LiteSpeed Cache**, botão **Limpar tudo** (Purge All). Isso descarta o HTML guardado e resolve a maioria dos sustos.
- Se continuar estranho: **Plugins**, localize LiteSpeed Cache, clique em **Desativar**. O plugin remove as próprias regras ao ser desativado.
- Se o painel ficar inacessível: entre no gerenciador de arquivos da hospedagem, vá em `wp-content/plugins/` e renomeie a pasta `litespeed-cache` para `litespeed-cache-off`. O WordPress desativa o plugin sozinho e o painel volta.

## Instalar o plugin pelo painel do WordPress

### Instalar e ativar o LiteSpeed Cache

No painel do WordPress, vá em **Plugins > Adicionar novo**. No campo de busca, digite `LiteSpeed Cache`. O plugin correto é o publicado por LiteSpeed Technologies. Clique em **Instalar agora** e depois em **Ativar**.

### Por que pular o convite do CDN na primeira abertura

Na primeira abertura, o plugin oferece conectar sua conta ao QUIC.cloud e ligar o CDN. Não aceite agora. Uma mudança de cada vez, com uma prova de cada vez. O cache de página local já entrega o resultado que interessa aqui.

### Onde ficam as opções de cache no menu do plugin

Surgiu um menu **LiteSpeed Cache** na barra lateral esquerda. Entre em **LiteSpeed Cache > Cache**. Você vai ver abas na horizontal: Cache, TTL, Limpar, Excluir, ESI, Objeto, Navegador, Avançado.

## Marque só o que precisa ser marcado na aba Cache

A tentação de ligar tudo é grande e é justamente ela que quebra site. As opções de otimização (minificar CSS, combinar JS, carregamento tardio de imagem) mudam o HTML e são a causa mais comum de layout torto. Elas ficam em outro menu (**Otimização de página**) e não fazem parte deste guia.

Na aba **Cache**, ajuste assim:

| Opção | Deixe em | Por quê |
|---|---|---||
| Ativar cache | LIGADO | É a chave geral. Sem ela, nada acontece. |
| Cache de logados | DESLIGADO | Quem está logado precisa ver a versão dele, não a de outra pessoa. |
| Cache de comentaristas | DESLIGADO | Mesma lógica: quem acabou de comentar tem estado próprio. |
| Cache de REST API | LIGADO | Ajuda temas e blocos que buscam dados por API. |
| Cache da página de login | DESLIGADO | Formulário de login carrega token de segurança. Cachear isso gera erro de nonce. |
| Cache de favicon | LIGADO | Inofensivo. |
| Cache de recursos do PHP | LIGADO | Inofensivo. |
| Cache mobile | DESLIGADO, salvo tema separado | Só ligue se o seu tema entrega HTML diferente no celular. |

Clique em **Salvar alterações** no rodapé da aba. O botão é fácil de esquecer.

Na aba **TTL**, o tempo padrão de vida do cache público já serve para site de conteúdo. Não mexa no primeiro dia. Se você publica muito e quer o conteúdo circulando mais rápido, o próprio WordPress manda limpar o cache a cada publicação e edição, então o TTL raramente é o gargalo.

## Exclua carrinho, checkout, minha-conta e login antes de sair testando

Este é o passo que separa um site rápido de um incidente. Página com conteúdo específico de uma pessoa nunca pode virar HTML compartilhado. Se ela entrar em cache, o segundo visitante recebe o carrinho, o endereço ou o pedido do primeiro.

O plugin já traz integração com WooCommerce e costuma respeitar as páginas transacionais sozinho. Confie, mas confira. E declare a exclusão de forma explícita, porque tema e plugin de terceiros criam URLs próprias que a integração não conhece.

### Onde declarar as URIs que nunca podem entrar em cache

Vá em **LiteSpeed Cache > Cache > aba Excluir**. No campo **Não armazenar em cache URIs** (Do Not Cache URIs), coloque uma URI por linha, sem o domínio:

```
/carrinho
/finalizar-compra
/minha-conta
/checkout
/cart
/my-account
/wp-login.php
```

Use os endereços reais do seu site. Se a sua página de carrinho é `/loja/carrinho/`, escreva `/loja/carrinho`. Confira em **WooCommerce > Configurações > Avançado**, que lista qual página faz o papel de carrinho, finalização e conta.

No campo **Não armazenar em cache cookies**, mantenha o que o plugin já preencheu. É por cookie que ele reconhece quem tem sessão aberta.

Salve e clique em **Limpar tudo** no menu do plugin, para descartar qualquer HTML que tenha sido guardado antes das exclusões.

| Tipo de página | Pode cachear | Motivo |
|---|---|---||
| Home, posts, páginas institucionais | Sim | HTML igual para todo mundo |
| Categoria, arquivo, busca interna | Sim | Igual para todo mundo, muda pouco |
| Loja e página de produto | Sim, com ressalva | Preço e ficha são públicos, mas mini-carrinho e contador "X itens" são por sessão |
| Carrinho | Não | Conteúdo por sessão |
| Finalizar compra | Não | Dados pessoais e pagamento |
| Minha conta, pedidos | Não | Dados pessoais |
| Login e recuperação de senha | Não | Token de segurança expira |
| Formulário com campo pré-preenchido | Não | Estado individual |

### A ressalva do mini-carrinho na loja e na página de produto

Se o seu tema mostra no cabeçalho o mini-carrinho, o total ou um contador tipo "2 itens", esse pedacinho do HTML é diferente para cada visitante. Cachear a página inteira sem tratar esse trecho é exatamente o que o alerta acima descreve: o segundo visitante herda o carrinho do primeiro.

Duas saídas, nenhuma delas obrigatória no primeiro dia:

- Deixar o WooCommerce atualizar o mini-carrinho por **fragmentos AJAX** (o comportamento padrão dele), o que já resolve na maioria dos temas.
- Usar **ESI** (aba ESI do plugin), que serve o resto da página do cache e busca só aquele bloco na hora.

Teste antes de confiar: coloque um item no carrinho em uma janela normal, depois abra a mesma loja em uma janela anônima e olhe o cabeçalho do site. Se a janela anônima mostrar o item que você adicionou na outra, não use cache nessa página até resolver o mini-carrinho.

## Prove na tela que o cache está servindo

Agora a parte que dá segurança: ver o cabeçalho mudar.

### Teste em janela anônima, porque quem está logado não recebe cache

`Ctrl+Shift+N` no Chrome ou Edge, `Ctrl+Shift+P` no Firefox. Anônima porque você está logado no painel e usuário logado não recebe cache, por escolha sua na aba Cache.

### Abra as ferramentas do desenvolvedor e desative o cache do navegador

Aperte `F12`. Clique na aba **Network** (ou Rede). Marque a caixinha **Disable cache** (Desativar cache), no topo do painel. Isso desliga o cache do navegador, não o do servidor. Sem essa caixa marcada, o navegador responde da memória dele e você não vê a resposta real do servidor.

### Carregue a página e clique na linha do documento HTML

Digite a URL de um post do seu site e dê Enter. A lista enche de arquivos. Clique na **primeira linha**, a que tem o nome do documento HTML (geralmente o nome da página ou o próprio domínio). Não clique em imagem nem em CSS.

### Leia o cabeçalho x-litespeed-cache na resposta

No painel que abrir à direita, aba **Headers**, role até **Response Headers**. Procure a linha `x-litespeed-cache`.

| Valor | O que significa | O que fazer |
|---|---|---||
| `miss` | O servidor gerou a página agora e guardou a cópia | Recarregue e espere ver `hit` |
| `hit` | O servidor entregou a cópia guardada, sem rodar PHP | Está funcionando |
| cabeçalho ausente | A página não é cacheável ou o cache não está ativo | Confira exclusões, login e servidor LiteSpeed |

### Recarregue e veja o miss virar hit

Aperte `F5` na mesma página. O valor deve virar `hit`. Esse é o momento em que a configuração está provada.

O mesmo teste no terminal, se preferir. Rode duas vezes seguidas:

```
curl -sI https://seusite.com.br/algum-post/ | grep -i x-litespeed-cache
```

Primeira execução:

```
x-litespeed-cache: miss
```

Segunda execução:

```
x-litespeed-cache: hit
```

### Confirme que carrinho, checkout, conta e login continuam em miss

Antes de testar, coloque um item no carrinho: carrinho vazio pode se comportar de forma diferente e esconder o problema. Depois repita os **passos 3, 4 e 5** (abrir a URL, clicar na linha do documento, ler o `x-litespeed-cache`, recarregar e ler de novo) em quatro endereços: carrinho, finalizar compra, minha conta e login.

O esperado ali é o oposto: `x-litespeed-cache: miss` que continua `miss` a cada recarga, ou nenhum cabeçalho `x-litespeed-cache` na resposta. Se alguma dessas páginas devolver `hit`, volte na aba Excluir, corrija a URI, salve e clique em **Limpar tudo**. Não deixe para depois.

### Meça o seu próprio TTFB com curl, se quiser o número

Se quiser o número, e não só o cabeçalho, use o mesmo comando que gerou a medição citada no começo:

```
curl -s -o /dev/null -w "TTFB: %{time_starttransfer}s\n" https://seusite.com.br/algum-post/
```

Linha a linha: `-s` silencia a barra de progresso; `-o /dev/null` joga o HTML fora, porque só interessa o tempo; `-w` imprime a métrica escolhida; `time_starttransfer` é o tempo até o primeiro byte, em segundos.

Rode três vezes seguidas e ignore a primeira, que provavelmente foi o `miss`. A saída é uma linha assim:

```
TTFB: 0.118s
```

Para comparar com e sem cache, desligue **Ativar cache** na aba Cache, clique em **Limpar tudo**, rode três vezes, ligue de volta e rode três vezes. Mude só essa opção entre as rodadas. Seu número vai depender da sua distância até o servidor e do seu tema, então não espere bater exatamente com o meu.

## Quando o hit não aparece

Roteiro na ordem em que resolve mais rápido:

- **Você está logado.** Cabeçalho não aparece ou fica em `miss` eterno. Teste em janela anônima.
- **A caixa Disable cache não estava marcada.** O navegador respondeu do próprio cache e a requisição nem chegou ao servidor. Marque e recarregue.
- **O servidor não é LiteSpeed.** Rode a checagem da segunda seção. Sem `server: LiteSpeed`, o cache de página do plugin não entra.
- **Outro plugin de cache está ativo.** Dois plugins de cache brigam pelas mesmas regras e o resultado é imprevisível. Escolha um, desative o outro em **Plugins**, e limpe tudo.
- **A URL está na lista de exclusão.** Confira se você não colou uma URI genérica demais, tipo `/` sozinha, que exclui o site inteiro.
- **Cookie de sessão ligado em toda visita.** Alguns plugins de chat, teste A/B ou geolocalização abrem sessão PHP em qualquer visita, e o cache respeita isso e não guarda nada. Desative um por vez e repita o teste do cabeçalho para achar o culpado.

## O que fazer na semana seguinte

Deixe o site rodando só com cache de página por alguns dias. Navegue pelo site como visitante, faça uma compra de teste do começo ao fim, envie um formulário. Se tudo continua correto, você tem uma base sólida.

Só então, se quiser mais, ligue as opções de otimização de página uma de cada vez, salvando e conferindo o site depois de cada uma. Minificar CSS, combinar JS e carregamento tardio de imagem entregam ganho menor que o cache de página e quebram layout com muito mais frequência. Se o seu objetivo era o TTFB, o trabalho já está feito: a diferença de 116 ms contra 1.786 ms na mesma página veio do cache de página, não das otimizações de front-end.

E guarde o teste do cabeçalho. Toda vez que você trocar de tema, instalar um plugin novo ou mudar de hospedagem, abra o `F12`, aba Network, e confira se o `hit` continua lá. Leva dez segundos e evita descobrir por acaso, três meses depois, que o site voltou a montar cada página do zero.

---

## Como medimos

100 requisições HTTPS à mesma página WordPress em um servidor LiteSpeed da Napoleon, feitas de um VPS externo: 50 aproveitando o cache de página (confirmado pelo cabeçalho x-litespeed-cache: hit) e 50 forçando a geração pelo PHP com uma query string única por requisição (x-litespeed-cache: miss). O TTFB de cada requisição foi medido com curl (time_starttransfer) e as medianas dos dois grupos foram comparadas: 115,6 ms com cache, 1.785,8 ms sem.
