blog
WordPress

LiteSpeed Cache em multisite: o purge é por vhost, não por blog

A herança rede/subsite do LSCWP, o motivo técnico do purge de escopo global e as três formas corretas de invalidar só o que precisa.

JR · · 8 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: em multisite, ativação do cache, rewrite no .htaccess da raiz, object cache, crawler e Domain Key só existem em Network Admin; o subsite controla TTL, exclusões e otimização. O botão Purge All limpa o cache por virtual host, não por blog_id, e por isso derruba a rede inteira.

Neste artigo
  1. O que muda quando o plugin é ativado em rede
  2. O que só existe em Network Admin, e por que é recurso compartilhado
  3. O que o subsite ainda pode sobrescrever
  4. Por que Purge All de um subsite derruba a rede inteira
  5. O que o cabeçalho x-litespeed-cache diz sobre a requisição
  6. Ordem de instalação que evita retrabalho
  7. O que aqui é documentação e o que é inferência

O que muda quando o plugin é ativado em rede

Em instalação única, toda configuração do LiteSpeed Cache vive em um único lugar. Em multisite não. A documentação oficial do LSCWP para multisite separa dois níveis: o painel de Network Admin, que governa a rede inteira, e o painel de cada subsite, que só enxerga o subconjunto de opções que a rede deixou livre.

A decisão prática é anterior à configuração: ativar o plugin em rede (Network Activate) ou por subsite. Ativando em rede, aparece o menu LiteSpeed Cache dentro de Network Admin e passa a existir a herança descrita abaixo. Ativando apenas em alguns subsites, cada um carrega o plugin isolado, mas continua compartilhando o mesmo arquivo .htaccess da raiz e a mesma instância do LiteSpeed Web Server, que é onde moram os dois efeitos colaterais que mais confundem: a regra de rewrite e o escopo do purge.

O que só existe em Network Admin, e por que é recurso compartilhado

Estas configurações não aparecem no painel do subsite, ou aparecem travadas, porque atuam sobre recurso compartilhado (servidor, arquivo de configuração, backend de cache de objeto).

Item Onde se configura Por que não é por subsite
Ativar/desativar o cache da rede Network Admin > LiteSpeed Cache > Cache Controla se a rede inteira responde com cacheável
Regra de rewrite no .htaccess Raiz da instalação (um arquivo para toda a rede) O LiteSpeed lê um .htaccess por diretório; a raiz vale para todos os blogs
Object Cache (Redis/Memcached) Network Admin > Cache > Object Host, porta e credencial do backend são da instância, não do blog
Browser Cache Network Admin Vira diretiva de servidor no .htaccess da raiz
Crawler Network Admin Dispara varredura no servidor; habilitar por subsite exige liberação na rede
Domain Key e serviços QUIC.cloud Network Admin A chave é emitida para o domínio, não para o blog_id
Debug log Network Admin Grava em arquivo único dentro de wp-content

Há ainda a opção de forçar que todos os subsites usem as configurações do site primário. Quando ligada, o painel do subsite deixa de ser fonte de verdade: o que vale é o que está no site principal. É a configuração mais previsível para rede grande, e também a que mais confunde quem administra o subsite: a opção continua visível no painel, aceita o clique e não muda o comportamento.

A regra de rewrite fica no .htaccess da raiz

Para que o LiteSpeed Web Server (ou OpenLiteSpeed, via configuração do vhost em vez de .htaccess) saiba o que cachear, o plugin grava um bloco entre marcadores no .htaccess. Em multisite esse arquivo é o da raiz. Dois sintomas clássicos:

Verificação rápida, antes de culpar o plugin:

grep -n "LSCACHE\|CACHE_RESOURCE\|LiteSpeed" /caminho/do/site/.htaccess

O que o subsite ainda pode sobrescrever

Quando a rede não força as configurações do primário, o administrador de cada subsite controla o que é específico do conteúdo dele: TTL das páginas públicas, exclusões por URL, query string, user agent e papel de usuário, regras de otimização de CSS/JS, lazy load de imagens, ESI e as regras de purge por publicação.

O critério é simples: se a opção escreve no .htaccess da raiz ou fala com um serviço externo autenticado, é da rede; se ela apenas marca o conteúdo daquele blog, é do subsite. Use isso como teste mental antes de procurar a opção no painel errado.

Uma consequência pouco discutida: exclusões de URL feitas no subsite são relativas ao próprio blog. Em rede por subdiretório, uma regra escrita como /checkout no subsite B pode não bater com o caminho real /lojab/checkout. Escreva o caminho como ele chega ao servidor e confirme no cabeçalho.

Decidir se a opção é da rede ou do subsiteA opção escreve no .htaccess da raiz?Se sim, é da redeFala com serviço externo autenticado?Domain Key, Redis, QUIC.cloud: redeSó marca conteúdo daquele blog?TTL, exclusões, lazy load: subsiteRede força config do primário?Painel do subsite vira decorativo
Teste mental antes de procurar a opção no painel errado. Baseado na herança descrita na documentação de multisite do LSCWP.

Por que Purge All de um subsite derruba a rede inteira

A página de multisite do LSCWP descreve a herança de opções, não o modelo de armazenamento do cache. O que vem a seguir é inferência arquitetural a partir do comportamento observável do servidor e dos cabeçalhos de purge, não texto da documentação: confirme no seu ambiente antes de tratar como regra.

O cache do LiteSpeed é indexado por virtual host, não por blog_id. Quando o plugin envia o comando de purgar tudo, ele emite um cabeçalho de purge com escopo coringa para aquele vhost. Como todos os blogs da rede respondem pelo mesmo vhost (mesmo em multisite por subdomínio, se os subdomínios estiverem no mesmo vhost com alias), o servidor invalida tudo. O administrador do subsite B aperta o botão e o subsite A, C e D voltam a gerar página do zero.

Isso não é bug: é o modelo de armazenamento. O botão existe no painel do subsite porque o plugin é o mesmo código; o escopo, porém, é do servidor.

O que concilia as duas coisas é a camada de tags. Cada resposta armazenada no vhost carrega um conjunto de tags de cache, e o purge é um seletor sobre essas tags, não sobre o diretório de armazenamento. Em multisite o LSCWP prefixa as tags com o identificador do blog (algo como B2_ para o blog 2), então um purge por tag casa apenas com as entradas daquele prefixo. O purge "tudo" não usa prefixo nenhum: emite o coringa, que bate com qualquer tag do vhost e por isso varre a rede inteira. Mesmo armazenamento, seletor diferente. Para ver o seletor que saiu em cada ação, ligue o Debug log em Network Admin e observe o cabeçalho X-LiteSpeed-Purge emitido pelo PHP.

As três formas de purgar sem atingir os outros blogs

  1. Purge por tag. O LSCWP marca cada página com tags de cache (post, categoria, tag, autor, arquivo). Purgar por tag invalida só o conjunto afetado, porque o seletor emitido inclui o prefixo do blog.
  2. Purge por URL. Em Toolbox, informe a URL exata. É a opção mais cirúrgica para corrigir uma página específica que ficou com conteúdo velho.
  3. Purge do blog. No painel do subsite, use a ação que limpa apenas aquele blog em vez da que limpa tudo. Em Network Admin existe a contrapartida: a ação que esvazia o cache de toda a rede, que deve ficar reservada a mudança de tema, de plugin global ou de regra de rewrite.

Para automação, vale a mesma distinção: o escopo não vem de --url, vem do subcomando.

# lista os subcomandos disponíveis na sua versão do plugin
wp help litespeed-purge

# CUIDADO: --url apenas define qual blog da rede carrega o WordPress.
# O purge "all" continua emitindo o coringa e invalida o vhost inteiro.
wp litespeed-purge all --url=https://exemplo.com/lojab/

# escopo contido: purga uma URL específica daquele blog
# (confira o nome exato do subcomando na saída de wp help)
wp litespeed-purge url https://exemplo.com/lojab/produto/ --url=https://exemplo.com/lojab/

O exemplo de domínio acima é fictício. Confirme os subcomandos com wp help litespeed-purge antes de colocar em cron: o conjunto varia por versão do plugin e inventar flag em script de produção custa caro.

O que o cabeçalho x-litespeed-cache diz sobre a requisição

Recarregar a página e achar que ficou rápida não prova nada. O LiteSpeed responde com x-litespeed-cache, e é esse valor que diz se a requisição veio do cache.

curl -sSI https://exemplo.com/lojab/ | grep -i '^x-litespeed'
Observação Leitura
x-litespeed-cache: hit Resposta servida do cache do vhost
x-litespeed-cache: miss Elegível a cache, mas não havia cópia armazenada
Cabeçalho ausente Requisição não passou pelo módulo, ou foi excluída, ou o rewrite não está na raiz

Procedimento de teste em rede, um subsite por vez:

Estabeleça a linha de base com dois acessos seguidos

Requisite a home de cada subsite duas vezes seguidas e anote miss seguido de hit. Faça sempre deslogado, em sessão limpa, porque usuário autenticado normalmente não recebe página cacheada.

Prove o escopo do purge aquecendo dois subsites

Aqueça o cache dos subsites A e B até hit. Dispare o purge no subsite B. Requisite A de novo. Se A voltar para miss, o purge atingiu o vhost inteiro, e a correção é trocar o botão pelo purge por tag, por URL ou por blog.

Confirme o Object Cache separadamente, fora do cabeçalho

O cache de objeto não aparece em x-litespeed-cache. Verifique no painel de rede o status da conexão com o backend e, no servidor, se a instância Redis ou Memcached está respondendo. Em multisite, uma só instância atende todos os blogs: prefixo ou base de dados mal escolhidos fazem um subsite ler chave de outro.

Teste de escopo do purge entre dois subsitesAqueça A e BDois curl -I até hitPurgue no subsite BUse o botão que limpa tudoRequisite A de novocurl -I deslogado, sessão limpaLeia o cabeçalhomiss em A indica purge por vhostTroque o seletorPurge por tag, URL ou blog
Procedimento reproduzível para provar o escopo do purge. Inferência a partir do comportamento observável, não medição de laboratório.

Ordem de instalação que evita retrabalho

  1. Ative o plugin em rede e abra Network Admin > LiteSpeed Cache.
  2. Ligue o cache no nível da rede e confirme que o bloco de rewrite foi gravado no .htaccess da raiz.
  3. Decida agora se os subsites herdam as configurações do site primário. Mudar isso depois reescreve o que os administradores de subsite já ajustaram.
  4. Configure Object Cache, Browser Cache e Debug no nível da rede.
  5. Gere a Domain Key em Network Admin, antes de qualquer serviço que dependa dela.
  6. Só então entregue o painel do subsite para quem cuida do conteúdo, com a orientação explícita de não usar o botão que limpa tudo.
  7. Valide com curl -I em pelo menos dois subsites, incluindo o teste de escopo do purge.

Se algo não bater, a sequência de diagnóstico é: cabeçalho ausente aponta para rewrite ou exclusão; miss permanente aponta para cookie, query string ou usuário logado; hit com conteúdo velho aponta para regra de purge automática desligada no subsite.

O que aqui é documentação e o que é inferência

A herança de opções entre rede e subsite segue a página de multisite citada. Já o modelo de armazenamento por vhost, o prefixo de tag por blog e o coringa do purge global são inferência a partir do comportamento observável, não documentação, e nada aqui é medição executada em laboratório. Os domínios e caminhos usados são exemplos. Nomes exatos de opções e subcomandos de WP-CLI mudam entre versões do LSCWP, então confirme na sua instalação com wp help litespeed-purge e na documentação oficial antes de automatizar.

Duas coisas que este texto não resolve e convém medir no seu ambiente: o impacto de ESI em rede com muitos blocos dinâmicos por subsite, e o comportamento do crawler quando dezenas de subsites competem pela mesma janela de varredura. Ambos dependem de CPU, de número de blogs e do perfil de tráfego, e qualquer número genérico aqui seria chute.

Referências

  1. Documentação oficial (litespeed) — LSCWP Multisite. Consultado em 2026-09-16.
Leia também