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.

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
- O que é a camada NGINX do cPanel e quando ela faz sentido
- O que conferir no servidor antes de ativar o cache NGINX
- Como instalar o NGINX e desligar o cache pelo WHM
- Quais tipos de página podem ir para o cache na borda
- Quando reconstruir a configuração de uma conta nova
- Como confirmar pelo cabeçalho qual camada respondeu
- 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:
- O servidor roda Apache via EasyApache 4 e não usa LiteSpeed (as duas soluções não convivem, porque ambas querem a mesma porta e o mesmo papel).
- Os sites têm páginas públicas que mudam pouco: institucional, blog, landing page.
- Você tem acesso ao WHM como root, ou o provedor faz a ativação para você.
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:
- Confirme que não há LiteSpeed. Se o servidor usa LiteSpeed, pare aqui: ele já tem a própria camada de cache.
- 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.
- Anote os plugins de cache já ativos em cada WordPress. Dois caches empilhados funcionam, mas complicam a hora de limpar.
- Escolha uma janela de baixo movimento. A instalação reinicia serviços web.
- Tenha uma URL de teste por site, uma pública e uma logada, para validar depois.
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:
- Deixe o cache global ligado.
- Desligue o cache individualmente nas contas com carrinho ou área logada, até validar o comportamento delas.
- Use o botão de limpar cache depois de cada publicação grande ou troca de tema.
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.
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:
server: nginx: o NGINX está na frente. Se aparecerserver: Apache, o proxy não está ativo para esse domínio ou há outra camada (CDN, por exemplo) reescrevendo o cabeçalho.- Cabeçalho de status de cache: quando a configuração expõe o status do cache do NGINX, a resposta traz um cabeçalho com valores como
HIT(veio do cache) ouMISS(foi buscar no Apache). Rode o mesmocurlduas vezes: a primeira tende a serMISS, a segundaHIT. Se nenhum cabeçalho de cache aparecer, isso não prova que o cache está desligado, só que o status não está sendo exibido. Confira as opções de cache na documentação antes de concluir.
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:
- Rodar o checklist de pré-ativação.
- Instalar pelo NGINX Manager em janela de baixo movimento.
- Desligar o cache das contas com carrinho ou área logada de visitantes.
- 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 --alle testar de novo. - Validar cada site com
curl -sI, com e sem cookie de sessão, e teste com dois usuários e um visitante deslogado. - 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
- Documentação oficial (cpanel) — NGINX Manager. Consultado em 2026-11-08.