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.

Resposta curta: 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.
Neste artigo
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 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, 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 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:
[email protected], 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.
Referências
- Documentação oficial (cpanel) — cPHulk Brute Force Protection. Consultado em 2026-11-15.