blog
Infraestrutura web

Como ativar o NGINX com cache no cPanel sem LiteSpeed

Procedimento baseado na documentação do cPanel para ligar, desligar e validar o proxy reverso com cache do ea-nginx, sem trocar servidor web nem plano.

JR · · 8 min de leitura · 1 tabela · 4 blocos de código

Resposta curta: no WHM, abra Software » NGINX Manager, instale o NGINX e mantenha o cache ligado só nas contas sem carrinho ou área logada de visitantes (o wp-admin, que todo WordPress tem, não entra nesse critério).

Neste artigo
  1. O que é a camada NGINX do cPanel e quando ela faz sentido
  2. O que conferir no servidor antes de ativar o cache NGINX
  3. Como instalar o NGINX e desligar o cache pelo WHM
  4. Quais tipos de página podem ir para o cache na borda
  5. Quando reconstruir a configuração de uma conta nova
  6. Como confirmar pelo cabeçalho qual camada respondeu
  7. Roteiro de ativação para vários servidores e o que dizer ao cliente

O que é a camada NGINX do cPanel e quando ela faz sentido

O NGINX Manager é a tela do WHM que instala o pacote ea-nginx e o coloca como proxy reverso na frente do Apache. O Apache continua lá, processando PHP, .htaccess e tudo o que os sites já usam. O NGINX passa a receber a conexão do visitante e pode guardar respostas em cache, entregando a página sem tocar o Apache na próxima requisição.

O procedimento descrito aqui segue a documentação oficial do NGINX Manager (consultada em 08/11/2026). Não fizemos medição própria para este artigo, então não há número de ganho de velocidade aqui. O ganho depende do site, do tipo de página e de quanto dela pode ficar em cache.

Faz sentido quando:

Não exige trocar de servidor web nem de plano. Se o seu problema é uma consulta lenta no banco, o cache de borda só esconde o sintoma para visitantes anônimos. Olhar o log de consulta lenta antes pode resolver sem mexer em nada disso.

O que conferir no servidor antes de ativar o cache NGINX

Vale rodar isso uma vez por servidor e guardar como modelo:

  1. Confirme que não há LiteSpeed. Se o servidor usa LiteSpeed, pare aqui: ele já tem a própria camada de cache.
  2. Liste as contas com área logada de visitantes ou carrinho. WooCommerce, área de membros, LMS, fórum. O wp-admin não conta: todo WordPress tem. São as candidatas a ficar fora do cache.
  3. Anote os plugins de cache já ativos em cada WordPress. Dois caches empilhados funcionam, mas complicam a hora de limpar.
  4. Escolha uma janela de baixo movimento. A instalação reinicia serviços web.
  5. Tenha uma URL de teste por site, uma pública e uma logada, para validar depois.
Quem atende a requisiçãoVisitanteNGINX (proxy e cache)Apache (PHP e .htaccess)
NGINX recebe a conexão e responde do cache quando pode, sem acionar o Apache.

Como instalar o NGINX e desligar o cache pelo WHM

Onde encontrar o NGINX Manager no WHM

No WHM, vá em Software » NGINX Manager. Se o NGINX ainda não estiver instalado, a tela mostra a opção de instalação.

O que acontece durante a instalação do ea-nginx

Clique para instalar e aguarde o processo terminar. O cPanel instala o ea-nginx, gera a configuração de cada conta e reinicia os serviços. Ao final, a tela passa a exibir os controles de cache e a lista de usuários.

Quais controles de cache ligar globalmente e por conta

A documentação descreve um controle de cache para o servidor inteiro e controles individuais por usuário. O caminho prático para agência:

Como desligar o cache de uma conta ou remover o NGINX

Se algo quebrar, há dois níveis de recuo. O mais leve é desligar o cache da conta afetada: o NGINX continua como proxy, mas repassa tudo ao Apache. O mais drástico é desinstalar o NGINX pela mesma tela, o que devolve o Apache ao atendimento direto. Comece sempre pelo mais leve: a maioria dos problemas de página desatualizada se resolve sem desinstalar.

Quais tipos de página podem ir para o cache na borda

A regra geral: só vai para cache o que é igual para todo visitante anônimo. Qualquer página que mude conforme cookie de sessão, login ou carrinho não deveria ser servida de cache compartilhado.

Um limite importante: a tela do NGINX Manager só oferece controle por conta, ligando ou desligando o cache de todos os domínios dela. A documentação consultada não detalha quais rotas, cookies ou cabeçalhos no-cache o ea-nginx exclui por padrão, então não presuma que wp-admin, admin-ajax.php ou o carrinho já ficam de fora. Use a tabela abaixo para decidir se a conta inteira pode ter cache ligado, e confirme o comportamento real com o teste de cookie descrito na seção de cabeçalhos. Por área logada entenda login de visitantes (cliente da loja, aluno, membro), não o wp-admin do administrador.

Tipo de conteúdo Cache na borda Motivo
Páginas institucionais e posts Sim Iguais para todos os visitantes anônimos
Imagens, CSS, JS Sim Arquivos estáticos, mudam por versão
wp-admin e wp-login.php Não Conteúdo por usuário e sessão
Carrinho, checkout, minha conta Não Depende de sessão e cookie
Área de membros, cursos Não, até validar Risco de mostrar conteúdo de um usuário para outro
Formulários com token Testar Token em cache pode expirar e o envio falhar
API e admin-ajax.php Não Respostas dinâmicas

Como a configuração do ea-nginx é gerada pelo cPanel, evite editar à mão os arquivos que ele regenera: a próxima reconstrução sobrescreve. Se uma conta tem muitas exceções, é mais seguro desligar o cache dela na tela do WHM e deixar o plugin de cache do WordPress cuidar das regras.

Roteiro de ativação por contaConfirmar que não há LiteSpeedListar contas com área logadaDesligar cache dessas contas no WHMValidar com curl e dois usuários
Ordem de ativação em cada servidor cPanel sem LiteSpeed.

Quando reconstruir a configuração de uma conta nova

Quando você cria uma conta pelo WHM, o cPanel normalmente gera a configuração do NGINX dela sozinho. Se uma conta nova responder com erro, cair no site padrão do servidor ou um domínio adicionado não aparecer, reconstrua a configuração pela linha de comando como root:

# reconstrói a configuração de todas as contas
/usr/local/cpanel/scripts/ea-nginx config --all

# testa a sintaxe antes de confiar no resultado
nginx -t

Se o nginx -t retornar que a sintaxe está ok e o teste foi bem-sucedido, a configuração gerada é válida. Se apontar erro, o arquivo e a linha aparecem na mensagem: normalmente é um domínio com configuração incompleta na conta. Corrija a conta no WHM e rode a reconstrução de novo.

Para padronizar entre vários servidores, coloque no onboarding de cliente, logo depois da criação da conta e da emissão do SSL, só a verificação: nginx -t e o curl -sI da seção seguinte. Como o cPanel já gera a configuração da conta nova sozinho, a reconstrução com config --all fica reservada para quando um desses testes falhar.

Como confirmar pelo cabeçalho qual camada respondeu

O jeito mais rápido de saber quem respondeu é olhar os cabeçalhos da resposta:

curl -sI https://exemplo.com.br/

O domínio acima é fictício, troque pelo do cliente. O que observar:

Se houver Cloudflare ou outra CDN na frente, o cabeçalho server mostra a CDN. Teste direto no IP do servidor:

curl -sI --resolve exemplo.com.br:443:IP_DO_SERVIDOR https://exemplo.com.br/

Faça também o teste com sessão, que um único login não cobre. Use dois usuários diferentes em navegadores ou perfis separados, mais um terceiro navegador deslogado. Navegue nas mesmas páginas (minha conta, carrinho, conteúdo restrito) e confira se nenhum deles vê nome, itens de carrinho ou conteúdo do outro, e se o deslogado não vê nada restrito.

Depois repita o curl levando o cookie de sessão. No WordPress, o cookie de login se chama wordpress_logged_in_ seguido de um hash; copie nome e valor das ferramentas de desenvolvedor do navegador:

curl -sI -H "Cookie: NOME_DO_COOKIE=VALOR" https://exemplo.com.br/minha-conta/

Rode duas vezes. Se a resposta com cookie de sessão vier marcada como HIT, o cache está servindo página personalizada: desligue o cache dessa conta no WHM. Esse é o teste que pega erro grave de cache em loja e área de membros.

Roteiro de ativação para vários servidores e o que dizer ao cliente

Um roteiro curto que cabe em qualquer servidor cPanel sem LiteSpeed:

  1. Rodar o checklist de pré-ativação.
  2. Instalar pelo NGINX Manager em janela de baixo movimento.
  3. Desligar o cache das contas com carrinho ou área logada de visitantes.
  4. Rodar nginx -t. Só se ele apontar erro, ou se algum domínio cair no site padrão do servidor, rodar /usr/local/cpanel/scripts/ea-nginx config --all e testar de novo.
  5. Validar cada site com curl -sI, com e sem cookie de sessão, e teste com dois usuários e um visitante deslogado.
  6. Registrar no documento do cliente: data, contas com cache desligado, como limpar.

Para o cliente final, uma frase que costuma bastar: "Colocamos uma camada na frente do servidor que guarda as páginas públicas prontas, então elas carregam sem processar tudo de novo a cada visita. Áreas com login e carrinho continuam sempre atualizadas."

E quando ele reclamar que a alteração não apareceu: "A página estava guardada pronta. Limpei o cache e a versão nova já está no ar." Deixe o botão de limpar cache documentado, porque essa vai ser a dúvida mais comum depois da ativação.

Referências

  1. Documentação oficial (cpanel) — NGINX Manager. Consultado em 2026-11-08.
Leia também