blog
Painéis

cPanel pelo domínio dando erro 404: o módulo sumiu

O atalho pelo domínio depende de um módulo do Apache que some em recompilação do EasyApache. Veja como confirmar, corrigir e entregar ao cliente um link que não quebra na próxima manutenção.

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

Resposta curta: o erro 404 em seudominio.com.br/cpanel quase sempre significa que o módulo do cPanel do Apache saiu do perfil do EasyApache 4 numa recompilação. Confirme com `httpd -M | grep -i cpanel`, reinstale o módulo, rode `build_apache_conf` e reinicie o Apache.

Neste artigo
  1. O que o 404 em /cpanel está dizendo sobre o servidor
  2. Três testes que isolam a causa em dois minutos
  3. Reinstalar o módulo, reconstruir o httpd.conf e reiniciar
  4. Confirmar /cpanel e /webmail com curl, sem abrir o navegador
  5. Por que mandar /cpanel por e-mail quebra na próxima manutenção
  6. Transformar o conserto em processo em dezenas de contas
  7. O texto que você manda para o cliente explicando o 404
  8. Módulo carregado e o atalho ainda falha: o que olhar depois

O que o 404 em /cpanel está dizendo sobre o servidor

O endereço seudominio.com.br/cpanel não é uma pasta no seu site. Nada é servido do public_html quando ele funciona. É um redirecionamento que o próprio Apache faz, via módulo do cPanel, mandando o navegador para a porta 2083 (ou para o proxy de subdomínio, dependendo de como o servidor está configurado).

Quando esse módulo não está carregado, o Apache trata /cpanel como qualquer outro caminho dentro do DocumentRoot. Aí só existem dois desfechos, e você já viu os dois:

Os dois sintomas têm a mesma causa. E a causa aparece quase sempre depois de uma recompilação do EasyApache 4, de uma troca de perfil do EA4 ou de uma migração de servidor: o perfil aplicado não incluiu o módulo do cPanel, e a configuração do Apache foi reconstruída sem ele.

Isso é diferente de porta 2083 bloqueada na rede, que é o outro caso clássico. Se a porta estivesse bloqueada, https://seudominio.com.br:2083 daria timeout. No cenário deste artigo, 2083 responde normalmente e só o atalho pelo domínio quebrou. O primeiro teste de triagem é esse.

Três testes que isolam a causa em dois minutos

Faça nesta ordem, do navegador para o terminal.

A porta 2083 responde? (se não, o caso é outro)

Abra https://seudominio.com.br:2083. Se a tela de login do cPanel aparece, o serviço está de pé e o problema é só o atalho. Se dá timeout, pare: o caso é de firewall ou rede, e o conserto é outro.

O módulo do cPanel está carregado no Apache?

Com root no servidor:

httpd -M | grep -i cpanel

Se a saída vem vazia, o módulo do cPanel não está carregado no Apache. É esse o conserto. Se aparece algo como cpanel_module (shared), o módulo está lá e o problema é outro (veja a última seção).

O pacote ea-apache24-mod_cpanel está instalado?

rpm -q ea-apache24-mod_cpanel

A documentação do EasyApache 4 identifica esse módulo como o responsável pelos redirecionamentos dos subdomínios de proxy do cPanel. Se o pacote não está instalado, a recompilação removeu ele junto com o resto do perfil.

Triagem do 404 em /cpanelPorta 2083 responde?Se dá timeout, é firewallhttpd -M | grep cpanelSaída vazia indica módulo ausenterpm -q ea-apache24-mod_cpanelConfirma se o pacote sumiuCausa isoladaMódulo fora do perfil EA4
Ordem de triagem: do navegador para o terminal, parando no primeiro teste que falha.

Reinstalar o módulo, reconstruir o httpd.conf e reiniciar

Três comandos, nesta ordem, com root. Faça fora do horário de pico do cliente, porque o Apache reinicia no final.

# 1. instala o módulo (use dnf em AlmaLinux/Rocky 8+)
yum install ea-apache24-mod_cpanel

# 2. reconstrói o httpd.conf a partir dos dados do cPanel
/usr/local/cpanel/bin/build_apache_conf

# 3. reinicia o Apache
/scripts/restartsrv_httpd

Depois confirme que o módulo subiu:

httpd -M | grep -i cpanel

Se você prefere a interface, o caminho é WHM > Software > EasyApache 4 > Customize > Apache Modules, marcar o módulo do cPanel e aplicar o perfil. É mais lento e reinicia o Apache do mesmo jeito, mas deixa o módulo salvo no perfil, o que evita que ele suma de novo na próxima recompilação. Se o servidor é seu, salve o perfil customizado depois de ajustar. Esse é o passo que a maioria das equipes esquece e por isso o problema volta.

Vale checar também se os subdomínios de proxy estão habilitados no servidor, em WHM > Server Configuration > Tweak Settings, na seção de domínios. Com o módulo presente e a opção desligada, o atalho continua sem funcionar.

Conserto e validação do módulo do cPanelInstalar móduloyum ou dnf installReconstruir httpd.confbuild_apache_confReiniciar Apacherestartsrv_httpd, fora do picoSalvar perfil EA4Evita sumir na próxima recompilaçãoValidar com curl/cpanel e /webmail
Sequência do conserto. O quarto passo é o que impede o problema de voltar.

Confirmar /cpanel e /webmail com curl, sem abrir o navegador

O teste que fecha o chamado é um curl de cabeçalho. Você quer ver um redirecionamento, não um 200 com HTML do site.

curl -sIL https://seudominio.com.br/cpanel | grep -i -E 'HTTP/|^location'
curl -sIL https://seudominio.com.br/webmail | grep -i -E 'HTTP/|^location'

Como interpretar. Use -L e olhe o último Location: da sequência, porque o primeiro salto costuma ser só o redirecionamento de HTTP para HTTPS.

O que volta Leitura Ação
301 ou 302 com o último Location: apontando para 2083/2096 ou para cpanel.dominio Corrigido Avisar o cliente
301 para https://seudominio.com.br/cpanel, mesmo host e mesmo caminho Só o redirecionamento de SSL; não é correção Olhar o que vem depois desse salto
404 Módulo ausente ou proxy desabilitado Refazer a seção anterior
200 com HTML do site WordPress capturou a rota Módulo ausente; o .htaccess só mascarou o 404
503 ou sem resposta Apache não subiu depois do restart /scripts/restartsrv_httpd --status e olhar o error_log

Teste sempre os dois caminhos. É comum /cpanel voltar e /webmail continuar quebrado quando a correção foi feita só no perfil sem reconstruir a configuração.

Por que mandar /cpanel por e-mail quebra na próxima manutenção

O atalho é conveniente e frágil. Ele depende de um módulo do Apache do servidor, que depende do perfil do EasyApache, que muda em recompilação, migração e troca de provedor. O link que você mandou para o cliente em janeiro pode morrer em uma madrugada de manutenção sem que ninguém tenha mexido no site dele.

Para entrega ao cliente, use o endereço de porta, que não depende de módulo nenhum do Apache:

Serviço Link que você manda Link que você evita
cPanel https://seudominio.com.br:2083 seudominio.com.br/cpanel
Webmail https://seudominio.com.br:2096 seudominio.com.br/webmail
WHM (revenda) https://seudominio.com.br:2087 seudominio.com.br/whm

Uma ressalva honesta: a porta 2083 é bloqueada em algumas redes corporativas e em parte das redes móveis. O atalho pelo domínio só ajuda nesses casos quando os subdomínios de proxy estão habilitados e o redirecionamento vai para cpanel.seudominio.com.br em 80/443. Se o Location: final do curl -sIL apontar para :2083, o atalho quebra na mesma rede que bloqueia a porta direta, porque o destino final é o mesmo. Confira para qual dos dois destinos o seu servidor redireciona antes de prometer algo ao cliente. Se for o subdomínio de proxy, mande os dois links no mesmo e-mail e explique qual usar quando um falhar. Dois links em uma linha custam nada e resolvem os dois cenários.

Para webmail, existe uma terceira opção que é a mais estável de todas: configurar a conta no Outlook, no Thunderbird ou no app do celular por IMAP. Cliente com a conta configurada no aplicativo reduz o uso do webmail e tira o atalho do caminho crítico: senha expirada, quota cheia e erro de IMAP continuam gerando chamado, mas nenhum deles depende de um módulo do Apache.

Transformar o conserto em processo em dezenas de contas

Se você mantém dezenas de contas, transforme o conserto em processo.

O texto que você manda para o cliente explicando o 404

Use esta, adaptando o domínio. Ela explica sem culpar ninguém e já entrega a solução:

Se o cliente perguntar por que isso aconteceu, a versão curta é: o atalho depende de um módulo do Apache que precisa estar presente no perfil de compilação do servidor, e ele saiu do perfil na última reconstrução.

Módulo carregado e o atalho ainda falha: o que olhar depois

A correção acima cobre o caso mais comum. Se httpd -M mostra o módulo e o /cpanel ainda não redireciona, verifique nesta ordem:

  1. Cache do navegador e do DNS. Teste em aba anônima e com curl, não só no navegador. Redirecionamento 301 fica em cache do lado do cliente.
  2. Regra no .htaccess. Plugins de segurança e de firewall do WordPress às vezes bloqueiam caminhos que parecem administrativos. Comente as regras do plugin e teste de novo.
  3. O domínio aponta para outro servidor. Se o DNS está em Cloudflare com proxy ligado, a requisição não chega no Apache do servidor da mesma forma. Teste com o IP real ou desligue o proxy temporariamente.
  4. Certificado dos subdomínios de proxy. Quando o redirecionamento vai para cpanel.seudominio.com.br e esse nome não tem certificado válido, o navegador mostra aviso de segurança em vez de erro 404. Nesse caso o conserto é AutoSSL, não módulo.

Se nada disso resolve, abra chamado com o provedor informando exatamente três coisas: a saída de httpd -M | grep -i cpanel, a saída do curl -sIL nos dois caminhos e a confirmação de que a porta 2083 responde. Com esses três dados o suporte pula a triagem inteira e vai direto ao ponto.

Referências

  1. Documentação oficial (cpanel) — EasyApache 4: módulo do Apache do cPanel. Consultado em 2026-10-30.
Leia também