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.

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
- O que o 404 em /cpanel está dizendo sobre o servidor
- Três testes que isolam a causa em dois minutos
- Reinstalar o módulo, reconstruir o httpd.conf e reiniciar
- Confirmar /cpanel e /webmail com curl, sem abrir o navegador
- Por que mandar /cpanel por e-mail quebra na próxima manutenção
- Transformar o conserto em processo em dezenas de contas
- O texto que você manda para o cliente explicando o 404
- 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:
- 404 (ou a página de erro do WordPress), porque não existe a pasta
cpanel. - A home do site abre normalmente, porque o WordPress capturou a rota pelo
.htaccesse devolveu o conteúdo padrão.
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.
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.
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.
- Modelo de e-mail de entrega com os dois links (porta e atalho), o endereço IMAP/SMTP e a porta 993/465. Um único arquivo, reaproveitado em todas as entregas.
- Varredura periódica dos domínios que você administra, com o mesmo
curl -sIL, em um laço de shell lendo uma lista de domínios. Rodar isso depois de qualquer aviso de manutenção do provedor pega o problema antes do cliente. - Nota no runbook do cliente: qual provedor, qual porta, se o atalho funciona naquele servidor. Dado que você consulta em dez segundos em vez de testar de novo.
- Depois de toda migração ou recompilação, rode a validação dos dois caminhos antes de dizer que a migração acabou. Entra no checklist de pós-migração junto com SSL, e-mail e cron.
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:
- 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. - 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. - 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.
- Certificado dos subdomínios de proxy. Quando o redirecionamento vai para
cpanel.seudominio.com.bre 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
- Documentação oficial (cpanel) — EasyApache 4: módulo do Apache do cPanel. Consultado em 2026-10-30.