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

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

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

---

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

- **O site precisa estar no ar, em um domínio real.** Domínio é o endereço do seu site, como `exemplo.com.br`. É a placa na porta. Um site rodando só no seu computador (`localhost`) ou em um endereço de teste interno não pode receber a visita de verificação.
- **O site precisa ser alcançável de fora.** Se ele está protegido por senha, em modo "em construção" que bloqueia tudo, ou fechado para o público, a verificação não chega.
- **O campo de IP de saída precisa estar correto.** IP é o número que identifica o seu servidor na internet, como o número da casa na rua. A tela General mostra o IP que o plugin detectou. A documentação orienta que esse campo contenha o IP de saída do servidor, não o IP de um intermediário.
- **O firewall não pode bloquear o serviço.** Firewall é o porteiro que decide quem entra e quem sai do servidor. Se ele barra os endereços do QUIC.cloud, o crachá nunca é entregue.

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.

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

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

