# Copiar configurações do LiteSpeed Cache de um site para outro

Como transformar o site que já está bem configurado no padrão da agência, o que o .data_file deliberadamente não carrega e como purgar só o que mudou depois de publicar.

> Em LiteSpeed Cache, Toolbox, Import / Export: exporte um arquivo .data_file do site já configurado e importe nos demais. O arquivo leva cache, exclusões e otimização de CSS/JS, e sobrescreve o que existia no destino. Chave de CDN e Domain Key não viajam no arquivo e precisam ser refeitas em cada site.

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

---

## O que o Import/Export da Toolbox realmente copia

Você configurou um site com calma: escolheu o preset, ajustou TTL, excluiu o carrinho do cache, ligou a combinação de CSS e JS e testou página por página até parar de quebrar layout. Esse trabalho é reaproveitável. O LiteSpeed Cache tem, dentro da **Toolbox**, uma aba de **Import/Export** que gera um arquivo `.data_file` com as configurações do plugin e permite aplicá-lo em outra instalação ([documentação oficial do LSCWP Toolbox](https://docs.litespeedtech.com/lscache/lscwp/toolbox/)).

O ganho prático para quem mantém carteira de clientes não é o clique a menos. É ter **um padrão da agência** em vez de trinta configurações levemente diferentes, cada uma com um bug só seu. Quando o site do cliente quebra depois de uma otimização, você quer comparar com um baseline conhecido, não adivinhar o que o estagiário marcou em 2023.

O arquivo é um arquivo de configuração comum: baixe, versione num repositório privado da agência, nomeie com data e escopo (`lscwp-padrao-woo-2026-01.data_file`, por exemplo). Um arquivo por tipo de projeto costuma bastar: institucional, blog de conteúdo, loja WooCommerce, LMS.

## Como exportar o padrão do site que já está certo

### Escolha o site-fonte pelas exclusões testadas, não pelo tamanho do cliente

O site-fonte não é o maior cliente. É aquele onde você testou as exclusões, sabe que o checkout funciona e que nenhuma regra foi colocada "para ver se resolve". Configuração herdada de tentativa e erro contamina todos os próximos sites.

### Gere o .data_file e guarde fora do servidor do cliente

No painel do WordPress: **LiteSpeed Cache → Toolbox → Import / Export → Export**. O plugin entrega um `.data_file` para download. Guarde fora do servidor do cliente.

### Anote o contexto do arquivo antes de esquecer o que ele significa

O `.data_file` não documenta a si mesmo. Mantenha ao lado um `README.md` curto no repositório:

```text
lscwp-padrao-institucional-2026-01.data_file
- Origem: site institucional, WP 6.x, tema de bloco, sem Woo
- Cache: ligado, TTL público padrão do preset
- CSS/JS: minify ligado, combine DESLIGADO
- Exclusões: nenhuma (site sem área logada)
- Revisar ao importar: CDN, Object Cache, caminhos de exclusão
```

Leva dois minutos e evita que daqui a oito meses alguém importe o padrão de loja num blog.

## O que viaja no .data_file e o que você vai ter de refazer

A documentação do Toolbox é explícita em dois pontos que mudam o seu processo: o import **sobrescreve as configurações atuais** do site de destino, e **chave de CDN e Domain Key não são exportadas**. Isso existe por um bom motivo: essas credenciais pertencem a um domínio específico e a uma conta específica.

| Item | Vai no `.data_file`? | O que fazer no destino |
|---|---|---||
| Configuração geral de cache (ligado/desligado, TTL) | Sim | Conferir se o TTL faz sentido para o tipo de site |
| Regras de exclusão (URI, categoria, cookie, user agent) | Sim | **Revisar**: caminhos do site-fonte podem não existir no destino |
| Otimização de CSS e JS (minify, combine, defer) | Sim | Testar visualmente antes de entregar |
| Otimização de imagem e configurações de mídia | Sim | Revisar conforme o acervo do site |
| Chave da CDN (ex.: QUIC.cloud / Cloudflare) | Não | Configurar manualmente por site |
| Domain Key | Não | Gerar no próprio site de destino |

A linha mais perigosa da tabela é a das exclusões. Elas são strings. Uma exclusão de `/minha-conta/` exportada de uma loja em português não protege nada numa loja cuja página se chama `/account/`. O plugin importa a string sem reclamar, o cache passa a servir página de conta logada para visitante e você descobre pelo cliente.

## Como importar sem quebrar o próximo site

### Exporte o estado atual antes: é o seu rollback de um clique

O import sobrescreve. Se o site de destino já tinha ajustes manuais feitos por outra pessoa, exporte o estado atual primeiro e guarde como `antes-import-<site>-<data>.data_file`. É o seu rollback de um clique.

### Importe pela Toolbox e confirme a sobrescrita

**LiteSpeed Cache → Toolbox → Import / Export → Import**, selecione o arquivo, confirme.

### Revise exclusões, Domain Key, Object Cache e Combine nessa ordem

- **Exclusões de URI e cookie**: confira se cada caminho existe neste site. Slugs traduzidos, prefixo de idioma, checkout customizado.
- **Domain Key e CDN**: ausentes por design. Gere e configure.
- **Object Cache**: se o destino está em outro servidor, host e porta mudam.
- **Combine de CSS/JS**: é a opção que mais quebra tema. Se o padrão veio com combine ligado e o tema de destino é outro, teste home, página interna, formulário e carrinho.

### Purgue tudo uma vez e teste home, login e checkout

Depois do import, um **Purge All** é justificável: as regras mudaram inteiras e o cache antigo foi gerado com outro conjunto de otimizações. Essa é a hora certa de usar o botão grande. Em dia normal, não é.

### Checklist de nove itens antes de entregar o site

```text
[ ] Backup da config atual exportado
[ ] .data_file correto para o tipo de site
[ ] Exclusões revisadas uma a uma
[ ] Domain Key gerada neste domínio
[ ] CDN configurada ou desligada conscientemente
[ ] Object Cache apontando para o servidor certo
[ ] Purge All executado
[ ] Teste: home, interna, busca, login, checkout
[ ] Teste em aba anônima e logado
```

## Quando usar Purge by URL, Purge CSS/JS e Purge All

A Toolbox tem muito mais que o Import/Export. A aba **Purge** oferece opções específicas, e usá-las é a diferença entre republicar uma página e jogar fora a otimização de todo mundo ([documentação oficial](https://docs.litespeedtech.com/lscache/lscwp/toolbox/)).

| Situação | O que usar | Por que não Purge All |
|---|---|---||
| Publicou ou editou um post e a página não atualiza | **Purge by URL** (a URL específica) | Purge All descarta o cache de todo o site |
| Trocou o CSS do tema ou do child theme | **Purge CSS/JS Cache** | Só os arquivos gerados precisam voltar a ser criados |
| Mudou a imagem de uma categoria inteira | Purge por categoria/tag | Mantém o resto do site quente |
| Mudou regras de cache ou importou `.data_file` | **Purge All** | Aqui sim: o conjunto inteiro mudou |
| Erro 404 persistindo em página nova | Purge por URL + checar permalink | O problema costuma não ser o cache |

O ponto prático: o CSS e o JS combinados/minificados são **gerados sob demanda**. Quando você faz Purge All, o primeiro visitante de cada página paga a reconstrução. Num site com tráfego baixo, o primeiro visitante é quase sempre alguém que importa. Purgar só CSS/JS depois de mexer no tema resolve o problema real sem tocar no HTML cacheado.

### Como explicar o cache para o cliente em três frases

Quando o cliente pergunta por que a página dele "ainda está velha":

> **** "O site guarda uma cópia pronta de cada página para carregar rápido. Eu já mandei refazer a cópia só dessa página, as outras continuam rápidas. Atualize com Ctrl+F5 e me diga se ficou certo."

Na minha experiência atendendo cliente, essa frase funciona melhor do que explicar o que é cache. O cliente entende "cópia pronta".

## Import sem efeito, layout quebrado e CDN herdada do site-fonte

- **Import não faz nada aparente**: confira se o arquivo é mesmo um `.data_file` do LSCWP e se o site de destino tem o plugin ativo com permissão de escrita. Em multisite, a aba de Toolbox pode estar em escopo de rede, não do site.
- **Site quebrou visualmente depois do import**: desligue **Combine** de CSS e JS primeiro, depois **Defer/Delay** de JS. Essas três opções respondem pela maioria dos problemas de layout e de scripts que não disparam.
- **Página de conta ou carrinho sendo cacheada**: exclusão importada com caminho do site-fonte. Corrija a string e purgue a URL.
- **Imagens ou CDN com 404 após o import**: a chave da CDN não vem no arquivo, mas as opções que dependem dela vêm. Vá em **LiteSpeed Cache → CDN** e cheque três coisas: se o toggle de CDN (ou QUIC.cloud CDN) veio ligado sem credencial neste site, se há **CDN Mapping** com a URL do site-fonte em Original URLs/CDN URL, e, em **Image Optimization**, se o site está apontando para imagens otimizadas que não existem aqui. Para validar, abra a home, veja o fonte do HTML e compare o host das URLs de `<img>`, CSS e JS: se aparecer o domínio do site-fonte ou um subdomínio de CDN que você não configurou, é mapping herdado. Desligue a CDN, purgue, confirme que o site carrega limpo e só então religue com a chave correta deste domínio.

Não temos medição própria de ganho de performance desse fluxo, e não vamos fingir que temos. O ganho que dá para afirmar é de processo: configuração igual em todos os sites, revisão explícita do que não é portável e purge cirúrgico em vez de botão vermelho.

## Três regras para padronizar configuração de cache na agência

Três decisões resolvem a maior parte do caos:

- **Um repositório privado só de configurações.** Um diretório por tipo de projeto, `.data_file` versionado com data no nome, `README.md` ao lado. Nada de arquivo solto no Drive de alguém.
- **Data de validade.** Revise os padrões quando subir uma versão maior do plugin ou do WordPress. Configuração de dois anos atrás pode referenciar opção que mudou de nome.
- **Regra de purge escrita.** Purge All só em troca de regra, import de configuração ou migração. Edição de conteúdo usa Purge by URL. Mexeu no tema, Purge CSS/JS. Coloque isso no onboarding de quem entra.

E uma recomendação contra o nosso próprio interesse comercial: se o site do cliente está lento com o cache funcionando e purgado corretamente, o problema raramente é o plano de hospedagem. Olhe antes o número de plugins ativos, consultas pesadas no admin e imagens enviadas em tamanho original. Trocar de plano sem resolver isso só muda o lugar onde a lentidão acontece.

