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

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

João Rizzon · 2026-10-31 · Painéis

---

## 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 `.htaccess` e 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:

```bash
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?

```bash
rpm -q ea-apache24-mod_cpanel
```

A [documentação do EasyApache 4](https://docs.cpanel.net/ea4/apache/apache-modules/apache-module-cpanel/) 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.

```bash
# 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:

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

```bash
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:

> **** O endereço seudominio.com.br/cpanel é um atalho criado pelo servidor e ele deixou de responder depois de uma atualização do servidor web. Sua conta, seu site e seus e-mails não foram afetados. Acesse por https://seudominio.com.br:2083 (painel) e https://seudominio.com.br:2096 (webmail). Guarde esses dois links: eles funcionam mesmo quando o atalho não funciona.

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

