blog
Infraestrutura web

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.

JR · · 10 min de leitura · 1 tabela · 7 blocos de código

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

Neste artigo
  1. Por que cache de página num fórum entrega a página de um usuário a outro
  2. Faça backup antes e saiba desligar em um passo
  3. O que a extensão oficial resolve e o que sobra para você
  4. As rotas do XenForo que ficam de fora do cache, e por quê
  5. Cookies e parâmetros que precisam derrubar o cache
  6. Provar o efeito com curl, como visitante anônimo
  7. O que acontece com a página da thread quando alguém responde
  8. Quatro coisas que costumam pesar mais que a falta de cache

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:

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

  1. Presença de cookie de sessão (xf_session, xf_user ou o prefixo que você usa).
  2. Requisição com método POST. Toda postagem, reação e envio de formulário.
  3. 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.

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.

Quando a página pode ir para o cacheChegou a requisiçãoQualquer URL do fórumTem cookie xf_session ou xf_user?Se sim, vai para o PHPÉ POST?Postagem ou reação nunca cacheiaTem parâmetro _xf na URL?Confirme os nomes no seu fórumRota privada da lista?Conta, conversas, admin, loginNenhum dos casos: pode cachearVisitante anônimo recebe HTML guardado
Basta uma condição verdadeira para derrubar o cache e mandar a requisição ao PHP.

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:

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:

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.

Ordem de trabalho para ligar cache com segurançaBackupBanco, arquivos e plano de desligarLimpar o básicoAdd-ons antigos, índice, PHPExclusõesRotas, cookies e parâmetros foraLigar o cacheAdd-on ou regras no servidorTestarcurl anônimo e com cookie real
Exclusões antes do cache. Ligar primeiro e excluir depois é o caminho do vazamento.

Referências

  1. Documentação oficial (litespeed) — LiteSpeed Cache for XenForo. Consultado em 2026-10-07.
Leia também