Instalar o CSF no VPS sem perder o SSH: as 13 portas
A ordem de operações do CSF em servidor cPanel, com TESTING=1 como rede de segurança, a diferença entre csf.allow e csf.ignore e os comandos de reversão antes de precisar deles.

Resposta curta: libere as 13 portas essenciais em TCP_IN e TCP6_IN (22 ou a customizada, 25, 80, 443, 465, 587, 993, 995, 2077, 2078, 2083, 2087, 2096) antes do primeiro csf -s, mantenha TESTING=1 com TESTING_INTERVAL baixo e valide de uma segunda sessão independente.
Neste artigo
- A sequência de sete passos que evita o lockout
- As portas que precisam estar em TCP_IN antes do primeiro start
- TESTING=1 derruba o firewall sozinho e devolve o seu acesso
- csf.allow e csf.ignore não fazem a mesma coisa
- O que anula as regras que você acabou de escrever
- Validação a partir de uma segunda sessão independente
- Calibrar o lfd depois, não antes
- Como recuperar o acesso depois de um lockout
A sequência de sete passos que evita o lockout
O CSF bloqueia tudo o que não está em TCP_IN assim que você roda o primeiro csf -s. Se o seu SSH está em porta customizada e você não a incluiu, a sessão atual continua viva (a conexão já estabelecida é aceita pela regra de estado), mas a próxima não entra. É assim que a maioria dos lockouts acontece: o administrador testa nada, fecha o terminal e descobre o problema uma hora depois.
A ordem que funciona é esta, e ela não tem atalho:
- Instalar o CSF seguindo a documentação da cPanel, que já faz a instalação em modo de teste.
- Confirmar que
TESTING=1e queTESTING_INTERVALestá com um valor baixo. - Editar
TCP_INeTCP6_INcom todas as portas que você realmente usa. - Colocar o IP de administração em
csf.allowe emcsf.ignore. - Desativar firewalld/nftables concorrente.
csf -re validar de uma segunda sessão independente.- Só depois
TESTING=0, e só depois disso calibrar os gatilhos do lfd.
Calibrar LF_SSHD antes de validar o acesso é inverter o risco: você estará ajustando quem é banido antes de garantir que você não é.
As portas que precisam estar em TCP_IN antes do primeiro start
Em servidor cPanel/WHM, um TCP_IN enxuto demais derruba painel, webmail e entrega de e-mail ao mesmo tempo. A tabela abaixo é o conjunto mínimo para um host cPanel típico; corte o que você não usa, mas corte com consciência do que o serviço faz.
| Porta | Serviço | Consequência de esquecer |
|---|---|---|
| 22 (ou a customizada) | SSH | Lockout imediato de novas sessões |
| 25 | SMTP de entrada | Para de receber e-mail de fora |
| 465 | SMTPS (implícito) | Clientes de e-mail param de enviar |
| 587 | Submission | Idem, no caminho mais usado hoje |
| 993 | IMAPS | Clientes param de ler caixa |
| 995 | POP3S | Idem, em clientes legados |
| 2077 / 2078 | WebDAV / WebDAV SSL | Web Disk deixa de conectar |
| 2083 | cPanel SSL | Cliente perde o painel |
| 2087 | WHM SSL | Você perde o painel |
| 2096 | Webmail SSL | Webmail fora do ar |
| 80 / 443 | HTTP / HTTPS | O site sai do ar |
Se você mudou a porta do SSH, a porta antiga não serve de rede de segurança: inclua as duas durante a janela de mudança e remova a antiga depois de confirmar. E atenção ao PORTS_sshd, usado pelo lfd para saber qual porta observar nas tentativas de login: deixar 22 ali com o sshd em outra porta faz o bloqueio por força bruta simplesmente não disparar.
# /etc/csf/csf.conf (exemplo de valores para host cPanel)
TCP_IN = "22,25,53,80,110,143,443,465,587,993,995,2077,2078,2082,2083,2086,2087,2095,2096"
TCP6_IN = "22,25,53,80,110,143,443,465,587,993,995,2077,2078,2082,2083,2086,2087,2095,2096"
UDP_IN = "20,21,53"
O exemplo acima vai além das 13 da tabela porque cobre o default de um host cPanel inteiro. As extras: 53 (TCP e UDP) só se o servidor responde como nameserver autoritativo; 110 e 143 para POP3 e IMAP em texto claro com STARTTLS, que ainda existem em cliente legado; 2082, 2086 e 2095 são cPanel, WHM e webmail sem TLS, úteis apenas enquanto houver quem chegue por HTTP antes do redirecionamento. 20 e 21 em UDP vêm do default histórico do csf.conf e não têm relação com FTP ativo, que trafega em TCP 20 e 21: se não há nada escutando UDP nessas portas no seu host (confira com ss -lunp), remova as duas e deixe UDP_IN = "53" ou vazio. Se nada disso descreve o seu host, tire e revalide.
TESTING=1 derruba o firewall sozinho e devolve o seu acesso
Com TESTING=1, o CSF instala /etc/cron.d/csf_test, que executa csf -x (desabilita o firewall e remove as regras) a cada TESTING_INTERVAL minutos. Se você se trancar do lado de fora, espera o intervalo: o cron derruba o firewall e o acesso volta. É a única proteção que funciona quando você não tem console fora de banda.
TESTING = "1"
TESTING_INTERVAL = "5"
Duas consequências práticas que as pessoas esquecem:
- Com
TESTING=1, o lfd não roda. Nenhum bloqueio por força bruta acontece nessa janela. Modo de teste não é modo de produção. - Esquecer
TESTING=1ligado é o erro oposto: o servidor fica sem firewall efetivo, porque o cron desabilita o csf a cada ciclo. Depois de validar, coloqueTESTING="0", rodecsf -re confirme comsystemctl status lfdque o daemon está em execução.csf -vreporta a versão e se o modo de teste continua ligado, não o estado do lfd.
csf.allow e csf.ignore não fazem a mesma coisa
Este é o erro clássico, e ele gera o chamado "mas meu IP está liberado e mesmo assim fui bloqueado".
/etc/csf/csf.allow: adiciona regras de ACCEPT no iptables para aquele IP. Libera o tráfego na camada de pacote./etc/csf/csf.ignore: diz ao lfd para ignorar aquele IP nas verificações de login e de abuso. Não cria regra de firewall nenhuma.
Um IP só em csf.allow ainda pode ser bloqueado pelo lfd por tentativas de login: quem decide isso é a diretiva IGNORE_ALLOW no csf.conf, e no valor padrão (0) o lfd não poupa quem está apenas em csf.allow. Um IP só em csf.ignore não é bloqueado pelo lfd, mas continua sujeito ao TCP_IN: se a porta não está aberta, ele não entra.
Para o IP fixo de administração, coloque nos dois arquivos. Alterações em csf.ignore exigem reiniciar o lfd (csf -r resolve ambos).
# /etc/csf/csf.allow (exemplo)
203.0.113.10 # ip fixo do escritorio - admin
# /etc/csf/csf.ignore (exemplo)
203.0.113.10
Se o seu IP é dinâmico, não tente resolver com faixa larga. Use DYNDNS apontando para um hostname que você atualiza, ou aceite depender do TESTING_INTERVAL e do console do provedor.
O que anula as regras que você acabou de escrever
TCP6_IN vazio faz o SSH falhar só de algumas redes
Se o host tem endereço IPv6 e o TCP6_IN está vazio, novas conexões SSH que resolvem para o registro AAAA falham, enquanto o ssh -4 continua funcionando. O sintoma é confuso: "funciona da minha casa e não funciona do datacenter". O inverso também acontece: TCP6_IN copiado de um template com portas que você fechou no v4, abrindo no v6 o que você acha que está fechado.
Confirme com IPV6 = "1" no csf.conf e valide sempre nas duas famílias:
ss -ltnp | grep -E ':22|:2087'
nc -4 -vz seu.host 22
nc -6 -vz seu.host 22
firewalld ou nftables ligado junto com o CSF
Dois gerenciadores escrevendo na mesma tabela produzem resultado imprevisível: a ordem das chains depende de quem recarregou por último. Antes de habilitar o CSF, pare e desabilite o concorrente.
systemctl status firewalld
systemctl disable --now firewalld
systemctl status nftables
A documentação da cPanel orienta a instalação do CSF no servidor; a convivência com outro gerenciador de regras não é suportada por nenhum dos dois lados. Escolha um.
Validação a partir de uma segunda sessão independente
Nunca valide pela sessão em que você editou o csf.conf. Ela sobrevive por estado de conexão e mente para você.
Abra uma segunda sessão antes de recarregar
Deixe um terminal aberto e logado. Ele é o seu caminho de volta se a nova sessão falhar.
Recarregue e teste de fora
csf -r
De outra máquina, em outra rede:
nc -vz seu.host 22
nc -vz seu.host 2087
nc -vz seu.host 587
ssh -v [email protected]
Confira o que o CSF realmente aplicou
csf -g 203.0.113.10 # tudo que existe sobre esse IP
csf -t # bloqueios temporarios ativos
iptables -L -n --line-numbers | head -40
ip6tables -L -n | head -40
O csf -g mostra se o IP está em allow, ignore, deny permanente ou deny temporário, e é o comando certo para responder "por que fulano não conecta".
Calibrar o lfd depois, não antes
Com o acesso garantido e TESTING=0, aí sim mexa nos gatilhos. Os principais:
| Diretiva | O que controla | Observação |
|---|---|---|
LF_SSHD |
Falhas de login SSH antes do bloqueio | LF_SSHD_PERM define se é permanente ou temporário |
LF_TRIGGER |
Se usado, define um gatilho único para todos os serviços | Com valor diferente de 0, substitui os limites individuais |
LF_TRIGGER_PERM |
Duração do bloqueio do gatilho | Em segundos, ou 1 para permanente |
DENY_IP_LIMIT |
Quantos IPs ficam em csf.deny |
Acima do limite, os mais antigos são removidos |
DENY_TEMP_IP_LIMIT |
Teto da lista temporária | Evita tabela de iptables gigante |
CT_LIMIT |
Conexões simultâneas por IP antes de agir | Valor baixo demais barra NAT corporativo e CDN |
Bloqueio permanente em massa tem custo: cada entrada vira regra de iptables e a avaliação é linear. Prefira bloqueio temporário com duração maior a csf.deny infinito, e mantenha DENY_IP_LIMIT num valor que você consiga auditar.
Descobrir quem o lfd está barrando e por quê
tail -f /var/log/lfd.log
grep 'Blocked in csf' /var/log/lfd.log | tail -50
csf -g 198.51.100.7
Se o IP do seu monitoramento, do seu backup externo ou do seu cliente aparece ali, a correção é csf.ignore mais csf.allow, não aumentar o limite global. Afrouxar LF_SSHD para resolver um falso positivo é pagar com segurança o que se resolve com três linhas em dois arquivos.
Como recuperar o acesso depois de um lockout
Tenha esta lista decorada antes de precisar dela.
| Comando | Efeito |
|---|---|
csf -x |
Desabilita o CSF e limpa as regras |
csf -e |
Reabilita |
csf -f |
Flush das regras sem desabilitar |
csf -dr 203.0.113.10 |
Remove o IP de csf.deny |
csf -tr 203.0.113.10 |
Remove bloqueio temporário |
csf -a 203.0.113.10 |
Adiciona a csf.allow e aplica |
csf -r |
Recarrega csf e lfd |
Se você já perdeu o SSH, só restam três caminhos: esperar o cron do TESTING_INTERVAL, entrar pelo WHM na 2087 (se ela ficou aberta) e usar o plugin ConfigServer Security & Firewall, ou abrir o console serial/VNC do provedor e rodar csf -x localmente. Verifique que você tem acesso a esse console antes de instalar o firewall. Descobrir que a credencial do console expirou no momento do lockout é o pior momento possível.
A Napoleon Host não mediu tempos nem taxas de bloqueio para este artigo: o conteúdo acima é documental, apoiado no csf.conf distribuído pelo ConfigServer e no procedimento de instalação publicado pela cPanel. Os IPs e valores mostrados são exemplos; confira os seus contra o que o ss -ltnp reporta no seu host antes de aplicar.
Referências
- Documentação oficial (cpanel) — How to Install CSF. Consultado em 2026-09-29.