blog
Servidores

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.

JR · · 7 min de leitura · 1 tabela · 8 blocos de código

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
  1. O que o Host Access Control escreve, de fato
  2. A rota de reversão vem antes da primeira regra
  3. Por que a regra de liberação tem que vir acima da negação
  4. Os serviços que ignoram /etc/hosts.allow em silêncio
  5. Testar de uma rede autorizada e de uma bloqueada
  6. Quando o link do escritório troca de IP
  7. 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:

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.

Rede de seguranca antes de editar hosts.allowBackupCopia /etc/hosts.allow com timestampSessao reservaSSH root aberta e paradaRestore agendadoJob at restaura em 10 minutosAcesso fora de bandaConsole KVM testado antesEntao editeSo agora escreva a regra
Ordem da rede de seguranca antes da primeira regra de bloqueio.

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:

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.

Onde cada servico deve ser restringidoRode ldd no binarioldd $(which sshd) | grep libwrapSaiu libwrap?Decide onde a regra valeSim: Host Access ControlRegra por daemon em hosts.allowNao: firewall de pacotesCSF, iptables ou nftablesValide com tcpdmatchgranted ou denied sem conectarTeste conexao realnc -vz de rede bloqueada
SSH, Apache, LiteSpeed e MySQL caem no ramo do firewall.

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.

IP dinâmico é o calcanhar de aquiles desse desenho. Três caminhos, em ordem de robustez:

  1. 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.
  2. 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.
  3. 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:

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

  1. Documentação oficial (cpanel) — Host Access Control. Consultado em 2026-10-18.
Leia também