blog
Painéis

Liberar FTP só para o IP da agência: o que dá e o que não dá

O painel só sabe negar IP, e o IP Blocker nem alcança o FTP. Como inverter a lógica no ProFTPD, o que muda em compartilhada, e o plano de saída para quando o seu IP mudar.

JR · · 9 min de leitura · 2 tabelas · 8 blocos de código

Resposta curta: em hospedagem compartilhada, não dá sozinho: lista de permissão de FTP é configuração de servidor. Em VPS com WHM, confirme que o daemon é o ProFTPD, crie um include com <Limit LOGIN>, Allow from e DenyAll, reinicie e valide. SFTP fica fora dessa regra: firewall ou Match Address no sshd.

Neste artigo
  1. O IP Blocker do cPanel não bloqueia FTP
  2. Em hospedagem compartilhada, o que realmente está na sua mão
  3. Em VPS com WHM: a lista de permissão no ProFTPD
  4. SFTP não passa pelo ProFTPD
  5. O plano de saída, escrito antes de aplicar a regra
  6. Checklist reutilizável por cliente
  7. A frase que você manda para o dono do site

O IP Blocker do cPanel não bloqueia FTP

A primeira coisa que trava a agência é uma confusão de escopo. O recurso IP Blocker do cPanel existe para negar acesso, um IP ou faixa por vez, e o que ele nega é o acesso ao site. Ele não é uma lista de permissão e não governa quem consegue autenticar no servidor de FTP.

Dá para listar o que cada peça cobre antes de prometer qualquer coisa ao cliente:

Recurso Lógica O que alcança O que não alcança
IP Blocker (cPanel) negar um, liberar o resto acesso HTTP ao site login de FTP, login do painel, SSH/SFTP
.htaccess com Require ip permitir poucos, negar o resto um diretório web, tipo /wp-admin qualquer coisa fora do Apache/LiteSpeed
Regra de host no ProFTPD permitir poucos, negar o resto login de FTP e FTPS SFTP, que é SSH na porta 22
Firewall do servidor permitir poucos, negar o resto qualquer porta, inclusive 21, 22 e painel nada, e esse é justamente o risco

Ou seja: restringir FTP por IP é configuração de serviço, no servidor. Não é um botão na conta cPanel do cliente. Quem prometer isso em um plano compartilhado sem falar com o provedor vai acabar entregando outra coisa.

Em hospedagem compartilhada, o que realmente está na sua mão

Sem root, você não edita a configuração do servidor de FTP. Sobram caminhos que resolvem o mesmo medo ("alguém com a senha de FTP publica arquivo no site do meu cliente") por outra via:

É contraintuitivo, mas em compartilhada a resposta honesta muitas vezes é "remova o FTP" em vez de "restrinja o FTP".

Onde a restrição de FTP realmente cabeTem root no servidorSem root, nada de ProFTPDNão: hospedagem compartilhadaChamado no provedor ou desligue FTPSim: qual daemon rodaProFTPD ou Pure-FTPdPure-FTPdTrocar daemon ou usar firewallProFTPDInclude com bloco Limit LOGINSFTP sempre à parteFirewall na 22 ou sshd
Caminho de decisão antes de prometer restrição de FTP ao cliente. O ramo de SFTP é independente: regra de ProFTPD não alcança a porta 22.

Em VPS com WHM: a lista de permissão no ProFTPD

O ProFTPD aceita controle de acesso por host, e a documentação oficial da cPanel trata exatamente desse ajuste. A ideia é inverter a lógica dentro de um bloco <Limit LOGIN>: permitir as origens conhecidas e negar todo o resto no momento do login.

Confirmar se o daemon em uso é ProFTPD ou Pure-FTPd

O cPanel suporta dois servidores de FTP, e o padrão de uma instalação nova pode ser o Pure-FTPd. No Pure-FTPd não existe <Limit LOGIN>, não existe Allow from e não existe /etc/proftpd.conf em uso. Seguir os passos abaixo em um servidor com Pure-FTPd produz um arquivo que ninguém lê e a falsa sensação de que a restrição está ativa.

Confira em WHM » Service Configuration » FTP Server Selection, ou no terminal:

/usr/local/cpanel/scripts/restartsrv_ftpserver --status
ps aux | grep -E 'proftpd|pure-ftpd' | grep -v grep

Se a resposta for Pure-FTPd, você tem duas saídas: trocar o servidor de FTP para ProFTPD na mesma tela do WHM (a troca reinicia o serviço e derruba transferências em andamento, faça em janela combinada) ou resolver a restrição no firewall, liberando a porta 21 e a faixa passiva só para os seus IPs. A segunda opção vale para o servidor inteiro, sem distinção de conta.

Onde colocar o arquivo de include sem perdê-lo na próxima atualização

O /etc/proftpd.conf de um servidor cPanel é gerado pelo painel e pode ser reescrito em atualização. Por isso a configuração vai em um arquivo incluído, não dentro do arquivo principal. Confirme no próprio servidor qual diretório de include está declarado:

grep -i include /etc/proftpd.conf

A saída mostra o caminho que o ProFTPD lê de fato naquela versão. Crie o seu arquivo lá, com extensão .conf, em vez de assumir um caminho de blog. Se a saída não trouxer nada, siga o que a documentação da cPanel indica para a sua versão antes de improvisar.

O bloco Limit LOGIN linha por linha

Exemplo (os IPs abaixo são faixas de documentação, troque pelos seus):

<Limit LOGIN>
  Order allow,deny
  Allow from 203.0.113.10
  Allow from 198.51.100.0/24
  Allow from 2001:db8:abcd::/48
  DenyAll
</Limit>

Três observações que economizam uma hora de depuração:

A regra vale para todas as contas do servidor, não para um cliente

Esse bloco, escrito solto no include, vale para todas as contas de FTP do servidor. Se o VPS hospeda dez sites de clientes diferentes, os dez passam a só aceitar login de FTP dos IPs listados. Em VPS de agência, onde todos os sites são mantidos pela mesma equipe, isso costuma ser exatamente o que você quer: assuma a regra como política do servidor e documente assim. Em VPS com contas de terceiros que publicam por conta própria, não faça isso sem avisar.

Para limitar o escopo a usuários específicos, o caminho é o mod_ifsession, que habilita <IfUser> e <IfGroup>. Antes, confirme que o módulo está disponível na build do seu servidor:

proftpd -l | grep -i ifsession

Atenção a uma pegadinha: proftpd -l lista apenas os módulos compilados de forma estática. Em builds com suporte a DSO (módulos carregados dinamicamente, comuns em pacotes de distribuição), o mod_ifsession pode estar presente e simplesmente não aparecer nessa lista. Antes de concluir que <IfUser> é inviável, verifique também:

proftpd -vv
grep -ri loadmodule /etc/proftpd.conf /etc/proftpd.d/ 2>/dev/null
ls /usr/lib64/proftpd/ /usr/lib/proftpd/ 2>/dev/null | grep -i ifsession

O proftpd -vv mostra a versão e as opções de compilação, inclusive se o suporte a DSO está ativo. Se o arquivo mod_ifsession.so existir no diretório de módulos, basta garantir que ele seja carregado com LoadModule mod_ifsession.c no ponto que a sua configuração prevê. Só depois de os três testes falharem é que vale descartar o escopo por usuário e ficar com a regra global.

Com o módulo disponível, o bloco fica assim:

<IfModule mod_ifsession.c>
  <IfUser cliente1>
    <Limit LOGIN>
      Order allow,deny
      Allow from 203.0.113.10
      DenyAll
    </Limit>
  </IfUser>
</IfModule>

Duas armadilhas aqui. As subcontas de FTP do cPanel se autenticam como [email protected], e o casamento em <IfUser> precisa considerar esse formato, não só o nome da conta principal. E o resultado depende de versão e de como o painel monta a configuração, então teste com uma conta descartável antes de aplicar em cliente que publica todo dia.

Reiniciar o serviço e validar de dois IPs diferentes

/usr/local/cpanel/scripts/restartsrv_ftpserver

Valide de dentro e de fora. Do IP permitido, o login completa normalmente. De um IP não listado (rede do celular serve), a conexão TCP abre e a recusa acontece na autenticação, com erro de acesso negado, não com timeout. Essa diferença é o seu método de diagnóstico: timeout aponta para firewall, recusa no login aponta para a regra do ProFTPD.

Aplicar a lista de permissão sem se trancar foraConfirmar daemonrestartsrv_ftpserver --statusCriar includeCaminho lido pelo grep includeAplicar Limit LOGINIPv4, IPv6 e link backupReiniciar e testarIP permitido e IP de foraDocumentar reversãoComando testado no runbook
Sequência de aplicação. No teste, recusa no login aponta ProFTPD; timeout aponta firewall.

SFTP não passa pelo ProFTPD

SFTP é subsistema do SSH. Regra em <Limit LOGIN> não tem efeito nenhum sobre a porta 22. Para restringir SFTP por origem existem duas camadas, e você escolhe uma delas:

Aqui mora o risco real de se trancar do lado de fora. Antes de recarregar o sshd, deixe uma sessão aberta em outra janela e agende a reversão. Copie o arquivo antes e programe o retorno:

cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
echo "cp /etc/ssh/sshd_config.bak /etc/ssh/sshd_config && systemctl reload sshd" | at now + 10 minutes

Se você conseguir abrir uma sessão nova dentro dos dez minutos, cancele o job com atrm. Se não conseguir, o servidor se conserta sozinho. O pacote at precisa estar instalado e o serviço ativo, confira antes de confiar no plano.

No firewall, lembre da faixa de portas passivas do FTP. Liberar só a 21 produz o sintoma clássico: login funciona, listagem de diretório trava. Libere a faixa passiva para os mesmos IPs.

O plano de saída, escrito antes de aplicar a regra

A lista de permissão só é segura de aplicar quando a rota alternativa já existe e está documentada, e quando todo mundo que publica naquele servidor sabe que a regra vale para o servidor inteiro. Monte isso primeiro:

Checklist reutilizável por cliente

Use a mesma tabela em todos os projetos e guarde preenchida junto das credenciais. Ela é o que transforma isso em processo em vez de heroísmo individual.

# Item Onde fica registrado
1 Tipo de hospedagem (compartilhada, revenda, VPS) ficha do cliente
2 Daemon de FTP em uso (ProFTPD ou Pure-FTPd) runbook do servidor
3 FTP ainda é necessário, ou dá para desligar ficha do cliente
4 IPs IPv4 da agência, link principal e backup documento de rede da agência
5 Prefixo IPv6 da agência, se houver documento de rede da agência
6 IPs são fixos contratados ou dinâmicos/CGNAT documento de rede da agência
7 Caminho do arquivo de include aplicado no servidor runbook do servidor
8 Escopo da regra: servidor inteiro ou <IfUser>, e quem foi avisado runbook do servidor
9 mod_ifsession disponível: estático, DSO ou ausente runbook do servidor
10 Comando de reversão testado runbook do servidor
11 SFTP tratado (firewall ou sshd), ou explicitamente fora do escopo runbook do servidor
12 Faixa passiva liberada no firewall runbook do servidor
13 Rota alternativa de upload comunicada ao cliente e-mail arquivado
14 Data da última revisão dos IPs ficha do cliente

Revise o item 14 a cada troca de operadora, mudança de escritório ou entrada de link novo. Uma lista de permissão desatualizada não falha em silêncio: ela falha na hora em que alguém precisa publicar.

A frase que você manda para o dono do site

Quando o cliente tentar conectar de casa e reclamar, o problema não é técnico, é de expectativa. Deixe a explicação pronta:

E seja honesto sobre o alcance. A regra protege o canal de arquivos, não o site inteiro. Login do WordPress, formulário vulnerável, plugin desatualizado e senha de painel fraca continuam sendo porta de entrada, e nenhum deles passa pelo ProFTPD. Vender lista de permissão de FTP como "site blindado" é o tipo de promessa que volta como chamado três meses depois.

Fonte da configuração de controle de acesso por host no ProFTPD: documentação oficial da cPanel, consultada em 20/09/2026. Este artigo é documental: não há medição própria por trás dos parâmetros citados.

Referências

  1. Documentação oficial (cpanel) — ProFTPD Configuration for Host Access Control. Consultado em 2026-09-20.
Leia também