blog
WordPress

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.

JR · · 7 min de leitura · 2 tabelas · 2 blocos de código

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
  1. O que o Import/Export da Toolbox realmente copia
  2. Como exportar o padrão do site que já está certo
  3. O que viaja no .data_file e o que você vai ter de refazer
  4. Como importar sem quebrar o próximo site
  5. Quando usar Purge by URL, Purge CSS/JS e Purge All
  6. Import sem efeito, layout quebrado e CDN herdada do site-fonte
  7. 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

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
Do site-fonte ao site novo em cinco etapasExportar do site-fonteToolbox, Import/Export, ExportVersionar com READMERepositório privado, nome com dataBackup do destinoExporte o estado atual antesImportar o .data_fileConfirme a sobrescritaRevisar e purgar tudoExclusões, Domain Key, CDN, Combine
Fluxo de padronização do LiteSpeed Cache entre sites de clientes.

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

Qual purge usar em cada situaçãoEditou um postPurge by URL daquela páginaMexeu no tema ou child themePurge CSS/JS CacheMudou imagem de uma categoriaPurge por categoria ou tagImportou .data_file ou mudou regraPurge All, aqui se justifica404 em página novaPurge por URL e checar permalink
Regra de purge escrita para colocar no onboarding da equipe.

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

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:

  1. 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.
  2. 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.
  3. 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

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