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.

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
- O IP Blocker do cPanel não bloqueia FTP
- Em hospedagem compartilhada, o que realmente está na sua mão
- Em VPS com WHM: a lista de permissão no ProFTPD
- SFTP não passa pelo ProFTPD
- O plano de saída, escrito antes de aplicar a regra
- Checklist reutilizável por cliente
- 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:
- Abrir chamado no provedor pedindo restrição de origem para as contas de FTP daquele domínio, informando os IPs fixos. Alguns aplicam, outros não aplicam em ambiente compartilhado porque o daemon de FTP é único para todas as contas do nó. Pergunte antes de vender.
- Desligar o FTP na prática: apague as contas de FTP extras, deixe só a principal, e trabalhe por SFTP com chave, quando o plano oferecer acesso SSH. Chave privada com passphrase resolve o vazamento de senha melhor que uma regra de IP, e não quebra quando você viaja.
- Trocar o hábito de deploy: Gerenciador de Arquivos do cPanel para correção pontual, Git ou pipeline para o resto. Quem não usa FTP não precisa proteger FTP.
- Senha longa e única por cliente, gerada no gerenciador, mais autenticação em duas etapas no login do cPanel. Isso vale mesmo quando a lista de permissão existe.
É contraintuitivo, mas em compartilhada a resposta honesta muitas vezes é "remova o FTP" em vez de "restrinja o FTP".
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:
Order allow,denyavalia primeiro as permissões, depois a negação. Inverter a ordem muda o resultado.- Use endereço ou CIDR. Evite nome de host: vira dependência de DNS no caminho crítico do login.
- Se o escritório tem link principal e backup, os dois IPs entram. Failover de operadora é a causa mais chata de "parou do nada".
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.
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:
- Firewall (firewalld, csf, nftables): permitir 22 apenas para os IPs da agência. Simples e definitivo.
- sshd: bloco
Match Addressnosshd_configrestringindo quais usuários autenticam de onde.
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:
- Upload sem FTP: Gerenciador de Arquivos do cPanel. Funciona de qualquer origem, porque depende do login do painel, não da regra de FTP. Resolve o "preciso subir um arquivo agora e estou no aeroporto".
- Como chegar ao painel: cPanel em 2083 (SSL) ou 2082, WHM em 2087 ou 2086, webmail em 2096 ou 2095. Em rede corporativa ou hotel, essas portas às vezes são filtradas. Registre no documento do cliente o endereço que funciona, incluindo o acesso pelo domínio quando o provedor oferece proxy de painel.
- CGNAT: muitos links, principalmente residenciais e móveis, entregam IP compartilhado que muda. O IP "fixo" do escritório também muda quando o roteador renegocia o link. Se o cliente tem IP dinâmico, a lista de permissão vira suporte recorrente.
- 4G e 5G: a saída pela operadora quase nunca é o IP do escritório, e costuma girar. Assuma que trabalhar do celular significa usar o Gerenciador de Arquivos.
- IPv6: se a máquina da agência tem IPv6 e prefere IPv6, ela chega ao servidor por um endereço que a sua regra IPv4 não lista, e o
DenyAllrecusa. Antes de aplicar, descubra por qual endereço você sai de fato, testando IPv4 e IPv6 separadamente, e inclua o prefixo v6 no bloco. - Janela de reversão: aplique em horário em que você consiga desfazer, nunca na sexta às 18h, e guarde o arquivo de include em backup para poder removê-lo em um comando.
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
- Documentação oficial (cpanel) — ProFTPD Configuration for Host Access Control. Consultado em 2026-09-20.