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

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

João Rizzon · 2026-10-06 · WordPress

---

## 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](https://docs.litespeedtech.com/lscache/lscwp/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:

- Rede em subdiretório com regra do WordPress mal ordenada: o bloco do LiteSpeed precisa estar presente e o diretório raiz precisa permitir `AllowOverride` suficiente para as diretivas do módulo.
- Subsite com `.htaccess` próprio em pasta de upload ou plugin de segurança reescrevendo o arquivo: a regra some e o cache para de gravar sem erro visível.

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

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

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

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

```bash
# 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.

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

## Ordem de instalação que evita retrabalho

- Ative o plugin em rede e abra Network Admin > LiteSpeed Cache.
- Ligue o cache no nível da rede e confirme que o bloco de rewrite foi gravado no `.htaccess` da raiz.
- 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.
- Configure Object Cache, Browser Cache e Debug no nível da rede.
- Gere a Domain Key em Network Admin, antes de qualquer serviço que dependa dela.
- 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.
- 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.

