blog
Servidores

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.

JR · · 7 min de leitura · 3 tabelas · 9 blocos de código

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
  1. A sequência de sete passos que evita o lockout
  2. As portas que precisam estar em TCP_IN antes do primeiro start
  3. TESTING=1 derruba o firewall sozinho e devolve o seu acesso
  4. csf.allow e csf.ignore não fazem a mesma coisa
  5. O que anula as regras que você acabou de escrever
  6. Validação a partir de uma segunda sessão independente
  7. Calibrar o lfd depois, não antes
  8. 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:

  1. Instalar o CSF seguindo a documentação da cPanel, que já faz a instalação em modo de teste.
  2. Confirmar que TESTING=1 e que TESTING_INTERVAL está com um valor baixo.
  3. Editar TCP_IN e TCP6_IN com todas as portas que você realmente usa.
  4. Colocar o IP de administração em csf.allow e em csf.ignore.
  5. Desativar firewalld/nftables concorrente.
  6. csf -r e validar de uma segunda sessão independente.
  7. 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 é.

Ordem de instalacao do CSF sem lockoutInstalar em modo testeTESTING=1, intervalo baixoAbrir portasTCP_IN e TCP6_IN completosLiberar seu IPcsf.allow mais csf.ignoreRecarregar e validarcsf -r, segunda sessaoSair do testeTESTING=0, calibrar lfd
Ordem sem atalho: validar acesso antes de endurecer gatilhos do lfd.

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:

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".

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.

Caminhos de recuperacao depois do lockoutPerdeu o SSHNao feche sessoes abertasSessao antiga ainda viva?Rode csf -x por elaWHM na 2087 aberto?Use o plugin do CSFTESTING=1 ligado?Aguarde o cron csf_testConsole serial ou VNCcsf -x localmenteAcesso de voltaCorrija TCP_IN e revalide
Caminhos de recuperacao em ordem de custo. Confirme o console do provedor antes de instalar.

Referências

  1. Documentação oficial (cpanel) — How to Install CSF. Consultado em 2026-09-29.
Leia também