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.

Resposta curta: 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.
Neste artigo
- O que o Import/Export da Toolbox realmente copia
- Como exportar o padrão do site que já está certo
- O que viaja no .data_file e o que você vai ter de refazer
- Como importar sem quebrar o próximo site
- Quando usar Purge by URL, Purge CSS/JS e Purge All
- Import sem efeito, layout quebrado e CDN herdada do site-fonte
- Três regras para padronizar configuração de cache na agência
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).
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:
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
[ ] 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).
| 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":
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_filedo 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_fileversionado com data no nome,README.mdao 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.
Referências
- Documentação oficial (litespeed) — LSCWP Toolbox. Consultado em 2026-09-29.