Restringir cPanel por IP no WHM (e por que SSH não entra)
Como restringir cPanel, WHM, webmail e e-mail por faixa de IP sem se trancar do lado de fora, e por que a regra de SSH nessa tela provavelmente não faz nada.

Resposta curta: o Host Access Control (WHM » Security Center) edita `/etc/hosts.allow` e restringe por IP os daemons que consultam libwrap: cpaneld, whostmgrd, webmaild, exim e dovecot. SSH, Apache e LiteSpeed não entram: o OpenSSH removeu o suporte a tcpwrappers na versão 6.7.
Neste artigo
- O que o Host Access Control escreve, de fato
- A rota de reversão vem antes da primeira regra
- Por que a regra de liberação tem que vir acima da negação
- Os serviços que ignoram /etc/hosts.allow em silêncio
- Testar de uma rede autorizada e de uma bloqueada
- Quando o link do escritório troca de IP
- CSF é camada complementar, não substituto
O que o Host Access Control escreve, de fato
A tela fica em WHM » Home » Security Center » Host Access Control. Ela não é um firewall: é um editor com validação para o arquivo /etc/hosts.allow, lido pela biblioteca libwrap (tcpwrappers). A documentação do cPanel descreve a interface com três campos por linha: Daemon, Access List e Action.
Três consequências práticas disso, e elas mudam o procedimento:
- Não existe reload de serviço. O arquivo é consultado no momento da conexão, por conexão. Salvou, valeu na próxima tentativa de handshake. Desfez, voltou na mesma hora. Isso é o que torna a reversão barata.
- A avaliação é por primeira correspondência. A primeira linha que casa daemon e cliente decide, e o resto do arquivo não é lido para aquela conexão.
- Só vale para daemons que consultam libwrap. Um serviço que não foi compilado contra a biblioteca ignora o arquivo inteiro, em silêncio, sem log e sem erro.
O campo Action aceita allow e deny. A sintaxe estendida do tcpd também aceita shell commands (spawn, twist), que a tela repassa para o arquivo. Em produção, use allow e deny e resolva alerta em outro lugar: comando disparado por conexão é superfície de ataque e ponto de lentidão no caminho do handshake.
A rota de reversão vem antes da primeira regra
O motivo de a busca por isso ser alta e a execução ser baixa é um só: a chance de trancar o próprio acesso. Monte a rede de segurança primeiro.
Backup do arquivo com timestamp no nome
B=/root/hosts.allow.$(date +%F-%H%M)
cp -a /etc/hosts.allow "$B"
echo "$B"
Guarde o caminho impresso: é ele que vai no job de restore do passo 3. Se preferir não depender da variável sobreviver à sessão, use um nome fixo (/root/hosts.allow.BACKUP) e mantenha a cópia com timestamp só como histórico.
A segunda sessão SSH que não pode ser fechada
Abra um terminal root por SSH e deixe parado nele, sem sair. Conexão já estabelecida não é reavaliada pelo tcpwrappers: a checagem acontece no accept, não durante a sessão. Essa sessão é sua chave reserva.
Restore agendado com at para o caso de você se trancar
echo "cp -a $B /etc/hosts.allow" | at now + 10 minutes
Aspas duplas, de propósito: a variável expande agora, na hora de criar o job, e o at guarda o caminho literal do backup que você acabou de fazer. Com aspas simples o job gravaria $B, que não existe no ambiente do atd, e o restore falharia em silêncio. Confira o que ficou agendado com at -c <id> antes de confiar.
Se em dez minutos você validou tudo, remova o job com atq e atrm <id>. Se você se trancou, não precisa fazer nada: o arquivo volta sozinho. Confira antes se o atd está ativo (systemctl is-active atd); se não estiver, use uma entrada de cron equivalente.
Onde fica o seu acesso fora de banda e como testá-lo antes
Console KVM, VNC do painel do provedor, modo rescue. Descubra onde fica e teste o login antes, não durante o incidente. Esse caminho não passa por /etc/hosts.allow.
Por que a regra de liberação tem que vir acima da negação
Como vale a primeira correspondência, a regra de liberação precisa estar acima da regra de bloqueio. Invertido, o deny casa primeiro e o allow nunca é lido.
Um conjunto mínimo, com faixas de exemplo (substitua pelas suas, estes valores são fictícios):
# /etc/hosts.allow
# 1. escape: localhost e a rede interna do servidor
ALL : 127.0.0.1 : allow
ALL : 10.0.0.0/255.255.255.0 : allow
# 2. faixas autorizadas da empresa (exemplos)
cpaneld, whostmgrd, webmaild : 203.0.113.0/255.255.255.0 : allow
cpaneld, whostmgrd, webmaild : 198.51.100.17 : allow
# 3. negação final, só para os daemons acima
cpaneld, whostmgrd, webmaild : ALL : deny
Pontos que costumam custar caro:
- O primeiro
ALL : 127.0.0.1 : allowé o escape. Vários componentes do cPanel conversam com o próprio servidor por loopback. Negar localhost quebra tarefas internas antes de quebrar o seu login. - Evite
ALL : ALL : denycomo última linha enquanto estiver aprendendo o comportamento da sua máquina. Negue por daemon nomeado. O bloqueio geral alcança serviços que você não mapeou. - Máscara explícita (
/255.255.255.0) e CIDR (/24) descrevem exatamente a mesma faixa: a diferença é de portabilidade, não de segurança. A máscara em notação completa é aceita por qualquer build do tcp_wrappers; o suporte a CIDR depende de patch da distribuição. Na dúvida, use a máscara explícita, e se usar CIDR valide comtcpdmatchantes de confiar.
Os serviços que ignoram /etc/hosts.allow em silêncio
Esta é a parte que invalida a frase "restringi o painel inteiro por IP".
| Serviço | Entrada típica | Consulta libwrap | Observação |
|---|---|---|---|
| cPanel (2082/2083) | cpaneld |
sim | serviço do cpsrvd |
| WHM (2086/2087) | whostmgrd |
sim | serviço do cpsrvd |
| Webmail (2095/2096) | webmaild |
sim | serviço do cpsrvd |
| Exim (25/465/587) | exim |
depende da build (validar com ldd) |
cuidado ao negar a porta 25 de fora |
| Dovecot (110/143/993/995) | dovecot |
depende da build (validar com ldd) |
o suporte é opção de compilação |
| Pure-FTPd / ProFTPD | pure-ftpd, proftpd |
depende da build | validar com ldd |
| OpenSSH | sshd |
não, nas versões atuais | suporte a tcpwrappers removido no OpenSSH 6.7 |
| Apache httpd (80/443) | nenhuma | não | não é linkado contra libwrap |
| LiteSpeed / OpenLiteSpeed | nenhuma | não | restrição é no vhost ou no firewall |
| MySQL / MariaDB | nenhuma | não em builds comuns | use bind-address, grants e firewall |
O caso do SSH é o que mais engana, porque a tela do WHM aceita sshd como daemon sem reclamar. O upstream do OpenSSH removeu o suporte a libwrap na versão 6.7, e as distribuições usadas hoje em servidores cPanel estão muito acima disso. Logo, uma regra sshd : ALL : deny pode não bloquear nada. Confirme na sua máquina, não no texto:
ldd $(which sshd) | grep -i libwrap
ldd $(which pure-ftpd) | grep -i libwrap
ldd /usr/sbin/exim | grep -i libwrap
ldd /usr/sbin/dovecot | grep -i libwrap
Sem saída, o daemon não lê /etc/hosts.allow, mesmo que a tela do WHM tenha aceitado a regra. Vale também para exim e dovecot: o link contra libwrap é opção de compilação do empacotador, então não assuma pelo nome do daemon. O que não aparece com libwrap precisa ser resolvido em firewall de pacotes.
O ponto de tráfego web (Apache, LiteSpeed) também não passa por ali. Se o objetivo é fechar o /wp-admin ou uma rota administrativa por IP, isso é regra de vhost ou .htaccess, não Host Access Control.
Testar de uma rede autorizada e de uma bloqueada
Teste sintaxe e teste comportamento. São checagens diferentes.
Checar a sintaxe com tcpdchk e simular com tcpdmatch
tcpdchk -v
tcpdmatch cpaneld 203.0.113.10
tcpdmatch cpaneld 192.0.2.50
O tcpdchk aponta daemons desconhecidos e regras inalcançáveis. O tcpdmatch responde access: granted ou access: denied para o par daemon/cliente, sem abrir conexão. Os binários vêm do pacote tcp_wrappers (em algumas distribuições, tcp_wrappers-tools).
Como o bloqueio aparece na conexão real, dos dois lados
De um IP autorizado:
nc -vz servidor.exemplo.com 2083
De um IP que deve estar bloqueado (4G do celular, VPS externo, VPN de outra região):
nc -vz servidor.exemplo.com 2083
O comportamento esperado com tcpwrappers é característico: o TCP conecta e a conexão é fechada em seguida, porque a decisão acontece depois do accept, na camada de aplicação. Não é timeout silencioso como no DROP do iptables. Se você vê timeout, quem bloqueou foi outra coisa, provavelmente o firewall.
Acompanhe o log durante o teste:
tail -f /var/log/messages /var/log/secure
Só depois que as duas pontas do teste baterem com o esperado, cancele o job do at.
Quando o link do escritório troca de IP
IP dinâmico é o calcanhar de aquiles desse desenho. Três caminhos, em ordem de robustez:
- IP fixo onde dói: um VPS pequeno ou uma VPN corporativa com saída estática. Você libera um endereço só, e todo mundo entra por ele. É a opção que menos quebra e a que menos exige manutenção no arquivo.
- Hostname na Access List: o tcpwrappers aceita nome e resolve por DNS reverso do cliente, com confirmação direta. Depende de o PTR da operadora existir e bater, o que raramente acontece em link residencial ou em 4G. Resolução no caminho do handshake também adiciona latência e um ponto de falha novo. Trate como recurso de exceção.
- Atualização automatizada: um script que resolve um host de DNS dinâmico e reescreve o bloco de allow. Se for por esse caminho, mantenha a geração idempotente (um bloco delimitado por marcadores, reescrito inteiro) e nunca remova a linha de loopback nem a sua faixa de administração.
E deixe escrito no runbook: quem tem o console fora de banda, onde está a credencial e qual é o comando de restore. Troca de link costuma acontecer em dia de pressa.
CSF é camada complementar, não substituto
O Host Access Control resolve bem o que está dentro do seu alcance: os serviços do cpsrvd, e-mail e FTP quando a build suporta. Ele não resolve SSH nas versões atuais do OpenSSH, não resolve porta 80/443 e não resolve banco de dados.
A divisão que funciona:
- Firewall de pacotes (CSF/iptables/nftables): fecha portas no nível de rede, inclusive SSH, MySQL e qualquer serviço que ignore libwrap. É a primeira barreira e a única que vale para tudo.
- Host Access Control: segunda barreira, por daemon, útil porque sobrevive a uma regra de firewall mal aplicada e porque é editável por quem administra o WHM sem acesso de shell.
- Camada da aplicação: restrição de rota administrativa no vhost, 2FA no WHM, chave em vez de senha no SSH.
Se você precisa escolher uma só e o objetivo é restringir SSH por IP, escolha o firewall. Restringir SSH apenas pelo /etc/hosts.allow é a falsa sensação de segurança mais comum nesse assunto, e a verificação com ldd leva cinco segundos.
Referências
- Documentação oficial (cpanel) — Host Access Control. Consultado em 2026-10-18.