# Acelerar o XenForo com cache sem vazar a sessão do usuário

Quais rotas do XenForo precisam ficar fora do cache de página, por que cada uma precisa ficar, e como confirmar o efeito no seu próprio fórum com uma bateria de testes curl: tempo de resposta, cabeçalho de cache, cookie de sessão, rota privada e invalidação depois de responder.

> o cache em camada de servidor só pode servir páginas a visitantes anônimos. Fica de fora tudo que muda por usuário: /account/, /conversations/, login e registro, /whats-new/, marcação de leitura, e qualquer requisição com cookie xf_session, xf_user ou parâmetro _xfToken.

João Rizzon · 2026-10-08 · Infraestrutura web

---

## Por que cache de página num fórum entrega a página de um usuário a outro

Cache em camada de servidor guarda o HTML pronto de uma URL e devolve esse mesmo HTML para o próximo visitante, sem passar pelo PHP nem pelo banco. Num site institucional isso é quase inofensivo. Num XenForo não é, porque quase toda página tem um pedaço que depende de quem está olhando: a barra superior com o nome do usuário, o contador de mensagens privadas, o selo de "não lido" em cada thread, o botão de reagir.

Se o servidor armazenar a resposta gerada para um usuário logado e entregar essa cópia ao próximo visitante, o próximo visitante vê o nome e os contadores do primeiro. O conteúdo das conversas privadas não costuma vazar junto (ele está atrás de outra URL), mas o nome de usuário, o avatar e o token de formulário vazam. Token de formulário vazado é pior do que parece: é o `_xfToken`, usado pelo XenForo para validar envios.

A regra que evita isso é simples de enunciar e trabalhosa de aplicar: **só visitante anônimo recebe página de cache**. Qualquer indício de sessão derruba o cache e manda a requisição para o PHP.

## Faça backup antes e saiba desligar em um passo

Antes de mexer:

- Backup do banco e dos arquivos. No XenForo, exporte o banco pelo painel da hospedagem (phpMyAdmin, aba Exportar, formato SQL) e guarde uma cópia da pasta do fórum.
- Anote como desligar. Se usar a extensão, o desligamento é em **Admin CP → Add-ons**, desativando o add-on. Se as regras estiverem no `.htaccess`, guarde uma cópia do arquivo original com outro nome antes de editar.
- Teste fora do horário de pico do seu fórum. Problema de cache aparece como "usuário X diz que está logado como usuário Y", e você quer poder reverter em menos de um minuto.

Risco concreto de errar a mão: usuários reclamando que não conseguem postar (token inválido), que aparecem logados como outra pessoa, ou que o fórum "não atualiza" quando alguém responde. Todos os três se resolvem desligando o cache e revisando as exclusões.

## O que a extensão oficial resolve e o que sobra para você

A LiteSpeed mantém uma extensão de cache para XenForo, documentada em [docs.litespeedtech.com/lscache/lscxf](https://docs.litespeedtech.com/lscache/lscxf/). Ela é um add-on instalado dentro do próprio XenForo e depende de o servidor web ser LiteSpeed ou OpenLiteSpeed com o módulo de cache habilitado e um cache root definido. Sem esse lado do servidor, o add-on manda os cabeçalhos e ninguém os lê.

O que um add-on desse tipo faz, e que regra de `.htaccess` não faz bem: ele decide *de dentro da aplicação* se a resposta pode ser guardada, porque sabe se há usuário autenticado naquela requisição. É mais confiável do que adivinhar pela URL.

O que ele não decide por você: a lista de rotas que você adicionou com outros add-ons, páginas customizadas, integrações com loja ou área de membros. Essas continuam sendo sua responsabilidade.

Se o seu servidor não for LiteSpeed, o raciocínio das seções seguintes vale igual para cache de página em Nginx (`proxy_cache` com `proxy_cache_bypass`) ou Varnish. Muda a sintaxe, não a lista.

## As rotas do XenForo que ficam de fora do cache, e por quê

Cada linha abaixo é uma rota padrão do XenForo 2. O motivo importa mais que a lista, porque o seu fórum tem rotas que não estão aqui.

| Rota | Por que não pode ser cacheada |
|---|---||
| `/account/` e tudo abaixo | Preferências, alertas, avatar: conteúdo exclusivo de um usuário |
| `/conversations/` | Mensagens privadas. Cachear aqui é vazamento direto |
| `/login/`, `/logout`, `/register/` | Formulários com token de sessão; cache serve token de outro |
| `/admin.php` | Painel administrativo. Nunca |
| `/install/` e `/upgrade/` | Rotina de manutenção, resposta muda a cada passo |
| `/whats-new/` e `/find-new/` | Depende de quando *aquele* usuário leu pela última vez |
| `/forums/mark-read` e `/conversations/mark-read` | Ação de marcação de leitura: muda estado, não devolve página |
| `/misc/` (estilo, idioma, cookies) | Ações que gravam preferência na sessão |
| `/members/` com área privada | Perfil público pode ser cacheado; abas restritas, não |
| Qualquer rota de add-on com área logada | Mesma lógica: se muda por usuário, fica de fora |

O critério único: **se duas pessoas diferentes, no mesmo segundo, veriam HTML diferente naquela URL, ela não entra no cache**.

## Cookies e parâmetros que precisam derrubar o cache

URL não é o suficiente. A mesma `/threads/assunto.123/` é pública para um visitante e personalizada para um membro logado. O que distingue os dois é o cookie.

O XenForo usa, por padrão, cookies com o prefixo `xf_`. Os dois que indicam sessão são `xf_session` e `xf_user` (o segundo é o "continuar conectado"). O prefixo é configurável no `src/config.php`, então confirme o seu antes de escrever regra. Em caso de dúvida, abra o fórum logado, pressione F12, aba Application (Chrome) ou Armazenamento (Firefox), e leia os nomes reais em Cookies.

Três condições que devem forçar bypass:

- Presença de cookie de sessão (`xf_session`, `xf_user` ou o prefixo que você usa).
- Requisição com método POST. Toda postagem, reação e envio de formulário.
- URL com parâmetro de sessão ou de resposta parcial. Os nomes que costumam aparecer são `_xfToken`, `_xfRequestUri`, `_xfResponseType` e `_xfWithData`, e em instalações antigas vindas do XenForo 1 também o `s=` na querystring. Não tome essa lista como oficial: ela vem de observação de instalações e o conjunto muda com a versão e com os add-ons. Confirme no seu fórum antes de escrever regra: logado, pressione F12, abra a aba Rede (Network), clique em algo que carregue conteúdo sem recarregar a página (curtir um post, abrir o menu de alertas) e leia a querystring das requisições que aparecerem. Os parâmetros que o seu fórum realmente usa estão ali. A lista de exclusões que a LiteSpeed mantém para o add-on está na [documentação oficial da extensão](https://docs.litespeedtech.com/lscache/lscxf/).

O parâmetro `_xfResponseType=json` merece atenção especial: é o que o fórum usa para carregar pedaços da página via JavaScript. Cachear JSON de um usuário e devolver a outro produz os bugs mais difíceis de reproduzir, porque a página "parece" certa e só o comportamento está trocado.

## Provar o efeito com curl, como visitante anônimo

O teste só vale se for feito sem cookie nenhum. Navegador logado nunca serve para medir cache de visitante. Use `curl`, que por padrão não envia cookie algum.

Escolha uma thread pública, de preferência longa, e rode:

```
curl -s -o /dev/null -w "%{time_total}\n" https://seuforum.com.br/threads/assunto.123/
```

O que cada parte faz: `-s` silencia a barra de progresso, `-o /dev/null` descarta o HTML (você quer o tempo, não o conteúdo), `-w "%{time_total}"` imprime o tempo total da requisição em segundos.

Rode duas vezes seguidas. Exemplo fictício de saída, apenas para você saber o formato:

```
0.842
0.061
```

A primeira requisição gerou a página (cache miss). A segunda foi servida do cache (cache hit). Os números do **seu** fórum serão outros: dependem do servidor, do tamanho da thread e da distância até ele. O que importa é a diferença entre a primeira e a segunda, e ela precisa se repetir quando você roda mais vezes.

### Confirmar pelo cabeçalho, não só pelo relógio

Tempo baixo pode ser coincidência. Cabeçalho não é. Peça só os cabeçalhos:

```
curl -sI https://seuforum.com.br/threads/assunto.123/ | grep -i litespeed
```

O que entra de novo aqui: `-I` pede só os cabeçalhos da resposta, sem baixar o HTML, e `| grep -i litespeed` filtra a saída deixando apenas as linhas que contêm a palavra litespeed, ignorando maiúsculas e minúsculas. O `grep` existe em Linux e macOS. No Prompt de Comando do Windows ele não existe: troque por `| findstr /i litespeed`. No PowerShell, use `| Select-String litespeed`. Se nada disso funcionar, rode só `curl -sI https://seuforum.com.br/threads/assunto.123/` e leia a lista de cabeçalhos com os olhos, procurando a linha de cache.

Com a extensão ativa em servidor LiteSpeed, você deve ver uma linha indicando o estado do cache (`miss` na primeira chamada, `hit` na segunda). Se nenhuma linha aparecer, o add-on está instalado mas o servidor não tem o módulo de cache habilitado, e aí não há cache nenhum acontecendo.

### Confirmar que a área logada não está sendo cacheada

Este é o teste que protege seus usuários, e ele tem duas etapas, porque um cookie inventado não prova grande coisa. Comece pelo cookie falso:

```
curl -sI -H "Cookie: xf_session=teste" https://seuforum.com.br/threads/assunto.123/ | grep -i litespeed
```

Esse comando só testa uma coisa: se existe regra de bypass por *presença* do cookie, no estilo `.htaccess`, Nginx ou Varnish. Nesse arranjo, qualquer `xf_session` já derruba o cache e você não deve ver `hit` em nenhuma chamada.

Se você usa o add-on do XenForo, `hit` aqui não é falha. O valor `teste` não corresponde a sessão nenhuma, então o XenForo trata a requisição como visitante anônimo e o add-on pode marcar a resposta como cacheável, corretamente. Concluir "está vazando" a partir desse `hit` é diagnóstico errado.

A etapa que vale é com cookie real. Entre no fórum logado, pressione F12, vá em Application (Chrome) ou Armazenamento (Firefox), abra Cookies, copie o nome e o valor do `xf_session` e cole no comando:

```
curl -sI -H "Cookie: xf_session=VALOR_COPIADO_AQUI" https://seuforum.com.br/threads/assunto.123/ | grep -i litespeed
```

Trate esse valor como senha: ele dá acesso à sua conta enquanto a sessão existir. Não cole em chat, ticket nem captura de tela, e saia e entre de novo no fórum depois do teste para invalidar a sessão usada.

Agora sim: se aparecer `hit` com cookie de sessão válido, a resposta de um usuário autenticado está sendo guardada. Desligue o cache e revise as exclusões antes de continuar.

E teste uma rota privada direto:

```
curl -sI https://seuforum.com.br/conversations/ | grep -i litespeed
```

Sem cookie, essa URL redireciona para login. O que você não quer ver é `hit`.

## O que acontece com a página da thread quando alguém responde

Fórum muda o tempo todo. Se a página de uma thread fica 10 minutos em cache, quem responder vai recarregar e não ver a própria mensagem, e vai responder de novo. Dois posts iguais, e a culpa parece ser do fórum.

Dois caminhos:

- **Purge dirigido**: o add-on avisa o servidor para descartar as URLs afetadas quando um post é criado ou editado. É o comportamento desejável e o motivo de usar uma extensão em vez de só regras de servidor.
- **TTL curto**: definir um tempo de vida baixo para páginas de thread e maior para a home e para páginas de nó. Resolve pior, mas resolve.

Como testar: abra a thread logado em um navegador, poste uma resposta, e rode o `curl` anônimo na mesma URL. O texto novo precisa aparecer. Para checar o conteúdo em vez do tempo:

```
curl -s https://seuforum.com.br/threads/assunto.123/ | grep -c "trecho da sua resposta"
```

Resultado `0` significa que o cache antigo ainda está sendo servido. Resultado `1` ou mais significa que a invalidação funcionou.

## Quatro coisas que costumam pesar mais que a falta de cache

Cache de página só acelera quem não está logado. Num fórum em que a maior parte do tráfego é de membros autenticados, o ganho fica no visitante vindo de busca, que é justamente o que traz gente nova. Vale, mas não substitui o resto.

Quatro coisas que costumam pesar mais e que não exigem mexer em cache:

- **Add-ons antigos.** Desative um por vez em Admin CP → Add-ons e meça com o mesmo comando `curl` acima. Um add-on que roda consulta em todo page load custa caro.
- **Tabela de busca inchada.** Reconstruir o índice em Admin CP → Tools → Rebuild caches costuma ajudar mais que qualquer plugin.
- **Imagens de anexo sem otimização.** O HTML pode voltar rápido e a página continuar lenta para o usuário.
- **Versão de PHP.** Atualizar a versão no painel da hospedagem é a mudança de maior efeito por menor esforço, desde que todos os add-ons sejam compatíveis.

Se depois disso o tempo da primeira requisição anônima continuar alto, aí sim o cache de página é o passo certo. E a ordem correta é: exclusões primeiro, cache depois.

Referência de instalação e configuração da extensão: [LiteSpeed Cache for XenForo](https://docs.litespeedtech.com/lscache/lscxf/).

