blog
WordPress

Não consigo gerar a Domain Key do LiteSpeed Cache

A tela General separa duas coisas: o cache que já roda no seu servidor e a oficina externa que precisa de crachá. Entender a diferença resolve o pedido travado.

JR · · 7 min de leitura · 1 tabela

Resposta curta: a Domain Key do LiteSpeed Cache só autoriza os serviços online (otimização de imagem, WebP e CSS crítico). O cache de página, a purga e a minificação funcionam no servidor sem chave nenhuma, então o site não está quebrado enquanto o pedido espera aprovação.

Neste artigo
  1. O que a Domain Key autoriza e o que ela não tem a ver com o cache
  2. Tabela do que funciona sem a chave e do que depende dela
  3. Os quatro pré-requisitos para conferir antes de clicar em Request Domain Key
  4. Pedindo a chave na tela General do plugin
  5. Erros comuns e o que fazer em cada um
  6. Desligando só os recursos que dependem da nuvem e mantendo o cache local
  7. Em que ordem verificar se a chave ainda não chegou

O que a Domain Key autoriza e o que ela não tem a ver com o cache

O LiteSpeed Cache é um plugin do WordPress que faz duas coisas bem diferentes, e quase todo mundo confunde as duas no primeiro dia.

A primeira é o cache local. Cache é uma cópia pronta da sua página, guardada no próprio servidor onde o site mora. Em vez de montar a página do zero a cada visita, o servidor entrega a cópia. Isso acontece dentro de casa. Não depende de ninguém de fora.

A segunda são os serviços online do fornecedor do plugin, chamados QUIC.cloud. São tarefas pesadas que o plugin manda para computadores de fora processarem: comprimir imagens, gerar imagens em formato WebP (um formato de imagem mais leve que JPG e PNG), e montar o CSS crítico (o pedacinho do código de estilo que precisa carregar primeiro para a página não aparecer "crua").

Para usar essa oficina de fora, o seu site precisa de um crachá. Esse crachá é a Domain Key, ou chave de domínio. Segundo a documentação oficial do LiteSpeed Cache, a chave de domínio é o que autentica o seu site junto aos serviços online. Sem o crachá, o segurança não deixa entrar.

E aqui está o detalhe que faz o iniciante achar que o plugin quebrou: ele não mostra um erro vermelho gritando "sem chave". A fila de imagens simplesmente não anda.

Tabela do que funciona sem a chave e do que depende dela

Esta tabela resolve metade das dúvidas da tela General.

Recurso Precisa da chave de domínio O que faz
Cache de páginas Não Guarda a cópia pronta da página no servidor
Purgar o cache Não Apaga as cópias antigas quando você edita o site
Minificar e combinar arquivos de estilo (CSS) e de comportamento (JS) Não Encolhe e junta os arquivos que dão o visual e os efeitos da página
Cache de objeto Não Guarda no servidor o resultado das consultas ao banco de dados, o arquivo onde ficam os textos e as configurações do site
Cache de navegador Não Guarda imagens e arquivos no computador do próprio visitante, para a segunda visita abrir mais rápido
Otimização de imagem Sim Comprime suas imagens fora do servidor
Geração de WebP Sim Cria a versão leve das imagens
CSS crítico Sim Monta só o pedaço do estilo que precisa carregar primeiro, e também pode descartar as regras de estilo que a página não usa
Low Quality Image Placeholder Sim Cria a miniatura borrada que aparece antes da imagem
CDN do QUIC.cloud Sim Distribui o site por servidores pelo mundo

CDN é a sigla em inglês para rede de distribuição de conteúdo: cópias do seu site guardadas em servidores de vários países, para o visitante baixar a página do ponto mais perto dele.

Leia a tabela com calma. Se o seu objetivo hoje é só "deixar o site mais rápido", a coluna do "Não" já entrega muita coisa. A chave é um bônus, não um pré-requisito para o site funcionar.

Os quatro pré-requisitos para conferir antes de clicar em Request Domain Key

O pedido da chave é um diálogo entre três partes: o seu site, o servidor onde ele mora e o serviço online. Se qualquer uma das três não se encontrar, o pedido fica parado sem explicação.

Confira esta lista antes de clicar:

Se você não sabe qual é o IP de saída do seu servidor, essa é a hora de perguntar ao suporte da sua hospedagem. Não é pergunta boba. É exatamente o tipo de informação que só quem administra o servidor tem.

Checklist antes de pedir a chave de domínioDomínio real no arNada de localhost ou testeSite aberto ao públicoSem senha nem modo construçãoIP de saída corretoConfirme com sua hospedagemFirewall liberadoPorteiro não pode barrar o serviço
Os quatro itens que o pedido da chave exige. Falhou um, o pedido fica parado sem mensagem de erro.

Pedindo a chave na tela General do plugin

Onde fica o bloco Domain Key no painel do WordPress

No painel do WordPress, no menu da esquerda, clique em LiteSpeed Cache e depois em General. O resultado esperado é uma tela com o título "General Settings" e, no topo, um bloco chamado Domain Key.

Comparar o IP detectado pelo plugin com o IP de saída do servidor

No bloco Domain Key existe um campo para o IP de saída do servidor. Compare com o IP que a sua hospedagem informou. Se estiver diferente, corrija ali mesmo e, antes de sair da tela, role até o fim da página e clique no botão de salvar da tela General (Save Changes, ou "salvar alterações"). O resultado esperado é a página recarregar com um aviso de que as opções foram salvas e o campo de IP já exibindo o número novo. Só peça a chave depois disso: sem salvar, o pedido sai com o valor antigo.

Salvar antes de enviar o pedido, senão ele sai com o valor antigo

Clique em Request Domain Key. O resultado esperado é a tela mudar para um estado de espera: o plugin registra que o pedido foi enviado e passa a aguardar a resposta.

Quanto esperar e por que recarregar a tela em vez de clicar de novo

A aprovação não é instantânea. O plugin consulta o serviço periodicamente. Recarregue a página do navegador depois de alguns minutos. Se nada mudou, espere mais um pouco antes de clicar de novo.

Como saber que a chave foi aprovada

Quando aprovado, o campo deixa de mostrar o estado de espera e passa a exibir a chave. A partir daí, aparece a opção de vincular o site ao painel do QUIC.cloud, e a fila de otimização de imagem começa a andar.

Caminho até a chave na tela GeneralAbrir GeneralMenu LiteSpeed Cache, aba GeneralConferir o IPCompare com o IP da hospedagemSalvar a telaClique em Save Changes antesPedir a chaveBotão Request Domain KeyEsperar e recarregarNão clique de novo seguidas vezes
Ordem dos cliques na tela General. Salvar antes de pedir evita enviar o IP antigo.

Erros comuns e o que fazer em cada um

Pedido parado em espera: o que checar antes de suspeitar do plugin

Primeiro: não clique vinte vezes. Clicar de novo não acelera a aprovação. Espere, recarregue a tela e confira os quatro pré-requisitos da seção anterior. Na imensa maioria das vezes o problema é um deles, não um defeito do plugin.

IP errado porque o site passa por proxy ou CDN de terceiros

Acontece quando o site passa por um intermediário, como um serviço de proxy ou CDN de terceiros. Proxy é um mensageiro no meio do caminho: quem fala com o mundo é ele, não o seu servidor. O plugin acaba vendo o IP do mensageiro. Corrija o campo com o IP de saída real do servidor e peça a chave de novo.

Site em localhost ou domínio de teste não recebe a verificação

Não insista. Termine o site, coloque no domínio definitivo e peça a chave depois. Enquanto isso, use só o cache local, que funciona normalmente.

Firewall barrando o QUIC.cloud e o que pedir ao suporte

Peça ao suporte da hospedagem para liberar o acesso dos endereços do QUIC.cloud. Explique que é a verificação de domínio do plugin LiteSpeed Cache. Essa frase costuma ser suficiente para a equipe entender o pedido.

Desligando só os recursos que dependem da nuvem e mantendo o cache local

Se a chave não sai e você precisa do site no ar hoje, dá para viver bem sem ela.

Desligue, nas telas de imagem e de página do plugin, as opções que dependem do serviço online: otimização automática de imagem, geração de WebP, CSS crítico e o placeholder borrado. Mantenha ligado o cache de página, a purga automática e a minificação.

O resultado esperado: o site continua servindo páginas em cache, as imagens continuam sendo exibidas no formato original, e nenhuma fila fica rodando em vazio.

Depois, se quiser reduzir o peso das imagens sem depender de serviço externo, comprima os arquivos antes de subir para a Biblioteca de Mídia. Uma foto de 4000 pixels de largura em um blog que exibe 800 pixels é desperdício puro, e isso nenhum serviço de nuvem conserta melhor do que você redimensionando antes.

Em que ordem verificar se a chave ainda não chegou

Se você chegou até aqui sem a chave, faça nesta ordem: confirme que o site abre de fora em um domínio real, confirme o IP de saída com a sua hospedagem, peça a chave uma vez e espere. Enquanto espera, configure o cache local, que é o que mais muda a percepção de velocidade no começo.

A chave vai chegar, ou você vai descobrir qual dos quatro pré-requisitos faltava. Nenhuma das duas situações exige trocar de plugin nem de hospedagem.

Referências

  1. Documentação oficial (litespeed) — LSCache for WordPress: General Settings. Consultado em 2026-10-04.
Leia também