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

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

João Rizzon · 2026-10-02 · Servidores

---

## 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](https://docs.cpanel.net/knowledge-base/third-party/how-to-install-csf/), que já faz a instalação em modo de teste.
- Confirmar que `TESTING=1` e que `TESTING_INTERVAL` está com um valor baixo.
- Editar `TCP_IN` e `TCP6_IN` com todas as portas que você realmente usa.
- Colocar o IP de administração em `csf.allow` **e** em `csf.ignore`.
- Desativar firewalld/nftables concorrente.
- `csf -r` e 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=1` ligado é o erro oposto: o servidor fica sem firewall efetivo, porque o cron desabilita o csf a cada ciclo. Depois de validar, coloque `TESTING="0"`, rode `csf -r` e confirme com `systemctl status lfd` que o daemon está em execução. `csf -v` reporta 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:

```bash
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.

```bash
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

```bash
csf -r
```

De outra máquina, em outra rede:

```bash
nc -vz seu.host 22
nc -vz seu.host 2087
nc -vz seu.host 587
ssh -v usuario@seu.host
```

### Confira o que o CSF realmente aplicou

```bash
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ê

```bash
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](https://docs.cpanel.net/knowledge-base/third-party/how-to-install-csf/). Os IPs e valores mostrados são exemplos; confira os seus contra o que o `ss -ltnp` reporta no seu host antes de aplicar.

