# Cliente bloqueado no cPanel mesmo em outra rede: o cPHulk por usuário

O cPHulk conta falhas por conta e por endereço de forma independente. Veja como identificar qual travou, liberar o usuário, calibrar os limites e receber aviso antes do cliente ligar.

> o cPHulk mantém 2 contadores separados: um por IP e outro por nome de usuário. Quando a proteção por usuário vale para qualquer origem, a conta que estoura o limite fica bloqueada para qualquer endereço, então trocar de rede não ajuda.

João Rizzon · 2026-11-16 · Painéis

---

## Dois contadores, duas chaves diferentes

O cPHulk, a proteção contra força bruta do cPanel & WHM, não tem um bloqueio só. A [documentação oficial](https://docs.cpanel.net/whm/security-center/cphulk-brute-force-protection/) separa a configuração em blocos distintos na aba **Configuration Settings**: **Username-based Protection** (proteção por nome de usuário) e **IP Address-based Protection** (proteção por endereço IP). Cada bloco tem a própria janela de tempo e o próprio limite de falhas.

Na prática, isso significa que o servidor conta falhas de login de duas formas ao mesmo tempo:

| Contador | O que ele acompanha | O que acontece ao estourar o limite | Trocar de rede resolve |
|---|---|---|---||
| Por nome de usuário | Falhas de login de uma conta, venham de onde vierem | A conta fica bloqueada durante o período configurado | Não |
| Por IP | Falhas de login vindas de um mesmo endereço | O endereço fica bloqueado durante o período configurado | Sim, enquanto o novo IP não acumular falhas |

Quem já resolveu um bloqueio de IP pedindo para o cliente desligar o Wi-Fi e usar o 4G costuma assumir que o problema é sempre esse. Não é. Quando o contador estourado é o de usuário, a chave do bloqueio é o nome da conta, e o endereço de origem deixa de importar.

## Por que trocar de rede não libera a conta

O contador por nome de usuário existe justamente para o ataque distribuído: um atacante que tenta a mesma conta a partir de centenas de IPs nunca estouraria o limite por IP, mas estoura o limite da conta. Para isso funcionar, o bloqueio precisa valer para a conta inteira, independentemente da origem.

Esse comportamento depende de uma opção do bloco **Username-based Protection**: **Apply protection to local addresses only**. Segundo a [documentação](https://docs.cpanel.net/whm/security-center/cphulk-brute-force-protection/), ela restringe a proteção por usuário a tentativas vindas de endereços locais. Se estiver ativa no seu servidor, o cenário descrito a seguir não se aplica da mesma forma. Confira o estado dela antes de concluir que o bloqueio é por conta.

O efeito colateral aparece com o cliente legítimo. Ele erra a senha algumas vezes no escritório, o celular com senha antiga tenta autenticar o e-mail em segundo plano, o contador da conta sobe, e o bloqueio entra. A partir daí:

- trocar de Wi-Fi para dados móveis não muda nada;
- tentar de outro computador não muda nada;
- continuar tentando pode estender o problema, porque cada tentativa conta como nova falha.

A saída é esperar o período configurado expirar ou um administrador do servidor liberar a conta manualmente.

Um detalhe que poupa tempo: o cPHulk é configurado no WHM, com acesso root. Se o site do cliente está em hospedagem compartilhada ou revenda, você não tem esse acesso. O caminho é abrir chamado no provedor informando o **nome de usuário** bloqueado, e não só o IP. Informar só o IP leva o suporte a liberar o endereço, e o cliente continua travado.

## Diagnóstico rápido: qual contador travou

Antes de liberar qualquer coisa, descubra qual dos dois bloqueios está ativo. A documentação descreve a aba **History Reports** do cPHulk, onde o administrador escolhe o tipo de relatório: falhas de login por usuário, usuários bloqueados, IPs bloqueados e IPs bloqueados por um dia, entre outros.

Roteiro que funciona bem em atendimento:

- Pergunte ao cliente se o erro persiste em outra rede (dados móveis, por exemplo). Se persiste, a suspeita principal é o bloqueio por usuário. Confirme em **Configuration Settings** se a opção **Apply protection to local addresses only** está desativada, condição em que o bloqueio por usuário vale para qualquer origem.
- No WHM, abra **Security Center » cPHulk Brute Force Protection » History Reports** e consulte o relatório de usuários bloqueados.
- Procure o nome da conta. Lembre que o usuário pode ser o do cPanel ou um endereço de e-mail completo, conforme o serviço em que o login falhou.
- Consulte também o relatório de IPs bloqueados. Os dois bloqueios podem estar ativos juntos.
- Veja o relatório de falhas de login para identificar o serviço e o horário. Uma sequência regular de falhas, em intervalos parecidos, costuma ser um dispositivo com senha antiga, não uma pessoa.

O último item (relatório de falhas de login) é o que mais evita retrabalho. Se a origem é um celular ou um cliente de e-mail configurado com a senha antiga, liberar a conta sem corrigir o dispositivo só reinicia a contagem, e o bloqueio volta.

## Como liberar a conta bloqueada

### Corrija a origem das falhas antes de liberar

Antes de liberar, peça ao cliente para atualizar a senha em todos os dispositivos que acessam aquela conta (celular, notebook, Outlook, aplicativo de e-mail) ou desligar temporariamente os que não consegue atualizar. Se a senha foi trocada recentemente, esse é quase sempre o culpado.

### Remova o bloqueio no History Reports

Na aba **History Reports**, selecione o relatório de usuários bloqueados e remova a entrada da conta. Faça o mesmo no relatório de IPs bloqueados se o endereço do cliente também aparecer lá. Os nomes exatos dos botões variam entre versões do WHM, então confira a [página oficial](https://docs.cpanel.net/whm/security-center/cphulk-brute-force-protection/) da versão do seu servidor.

### Valide o acesso com um único login

Peça ao cliente para fazer um único login, com a senha correta digitada manualmente. Se falhar de novo, volte ao relatório antes de qualquer nova tentativa e veja se a conta reapareceu.

### Avalie a lista de permissões com cuidado

O cPHulk tem listas de permissão e de bloqueio (**Whitelist Management** e **Blacklist Management**). Incluir o IP fixo do escritório do cliente na lista de permissões evita que aquele endereço seja bloqueado, mas não substitui o passo 1. E não faça isso com IP dinâmico de operadora: amanhã o endereço pode ser de outra pessoa.

## Ajustar as tentativas de cada contador

Na aba **Configuration Settings**, cada bloco tem seus parâmetros. Os principais, segundo a documentação:

| Bloco | Parâmetro | Efeito |
|---|---|---||
| Username-based Protection | Brute Force Protection Period (minutos) | Janela em que as falhas da conta são somadas e duração do bloqueio |
| Username-based Protection | Maximum Failures by Account | Falhas permitidas por conta dentro da janela |
| IP Address-based Protection | IP Address-based Brute Force Protection Period (minutos) | Período de proteção por IP: janela e duração do bloqueio do endereço |
| IP Address-based Protection | Maximum Failures per IP Address | Falhas permitidas por IP dentro da janela |
| IP Address-based Protection | Maximum Failures per IP Address before the IP Address is Blocked for One Day | Máximo de falhas antes do bloqueio de um dia: limite que leva o IP ao bloqueio de 24 horas |

Os valores padrão mudam entre versões, então leia os do seu servidor antes de alterar. Algumas orientações para decidir:

- **Não desligue a proteção por usuário** para resolver reclamação de cliente. Ela é a proteção do cPHulk contra ataque distribuído em contas de e-mail.
- Se os bloqueios por usuário são frequentes e sempre legítimos, aumentar um pouco o limite de falhas por conta costuma ser melhor do que encurtar a janela.
- Se o problema é escritório com muitas pessoas atrás do mesmo IP, o ajuste está no contador por IP (ou na lista de permissões, se o IP for fixo), não no de usuário.
- Mude um parâmetro por vez e anote a data. Sem isso, não dá para saber o que resolveu.

Exemplo ilustrativo, não parâmetro documentado: uma agência que gerencia um servidor só de sites institucionais pode decidir dobrar o limite de falhas por conta e manter a janela, observando o relatório de bloqueios por duas semanas antes de mexer de novo.

## Cadastrar o aviso de bloqueio

Descobrir o bloqueio pela ligação do cliente é o pior cenário. O cPHulk pode notificar quando detecta um usuário em força bruta. A documentação lista as opções de notificação na própria aba **Configuration Settings**, e o destino dos avisos é definido no WHM em **Server Contacts » Contact Manager**, na categoria do cPHulk.

Procedimento:

- Em **Configuration Settings**, ative a notificação para quando o sistema detectar um usuário em força bruta.
- Em **Contact Manager**, confirme que o e-mail de contato do servidor é uma caixa que alguém lê, de preferência fora do próprio servidor.
- Ajuste o nível de importância para que o aviso do cPHulk seja de fato enviado.
- Provoque um teste controlado com uma conta de teste (exemplo: `teste-hulk@seudominio.com.br`, criada só para isso) e confirme que o aviso chega. Faça as tentativas a partir de uma origem que não seja a do seu acesso administrativo (um celular em dados móveis, por exemplo) ou com o IP do administrador na **Whitelist**. Errar a senha várias vezes do mesmo IP que você usa no WHM também alimenta o contador por IP e pode bloquear o seu próprio acesso.
- Depois do teste, abra **History Reports**, confirme que a conta de teste e o IP usado aparecem nos relatórios de bloqueio, remova as duas entradas e apague a conta de teste.

Com o aviso ativo, você costuma saber do bloqueio antes do cliente e pode ligar para ele já com a causa provável.

## Padronizar em vários servidores e explicar ao cliente

Para quem administra mais de um servidor, vale manter uma ficha por servidor com: valores atuais dos dois contadores, IPs fixos na lista de permissões (com o nome do cliente dono de cada um), destino das notificações e data da última revisão. Revisar a lista de permissões a cada trimestre evita IP de cliente antigo liberado para sempre.

A explicação ao cliente precisa ser curta e tirar a ideia de que "a internet dele" é o problema. Uma versão pronta:

```
O servidor bloqueou temporariamente a sua conta, não a sua internet,
porque registrou várias tentativas de login com senha errada. Por isso
trocar de rede não resolveu. Já liberamos a conta. Para não acontecer
de novo, atualize a senha em todos os aparelhos que acessam esse e-mail,
principalmente o celular.
```

E no chamado ao provedor, quando você não tem WHM:

```
Conta bloqueada pelo cPHulk por nome de usuário (persiste em outras redes).
Usuário: [conta ou e-mail completo]
IP de origem, se souber: [IP]
Já corrigimos o dispositivo com senha antiga. Favor remover o bloqueio
da conta e, se houver, do IP.
```

O ponto central para guardar: bloqueio que sobrevive à troca de rede é bloqueio de conta. Liberar só o IP não resolve, e liberar a conta sem corrigir o aparelho com senha antiga só adia o próximo chamado.

