> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciamento do Fail2Ban

> Mostra os endereços IP que o Fail2Ban bloqueou, desbloqueia os que você escolher e guarda a lista de endereços que ele nunca bloqueia. O Fail2Ban é o vigia do servidor: ele lê os…

**Caminho no painel:** menu da esquerda > **SEGURANÇA** > **Gerenciamento do Fail2Ban**

![Gerenciamento do Fail2Ban: as prisões com a contagem de bloqueios, os botões Opções, Ações em massa e Desbloquear todos os IPs, a busca e a lista com onze endereços bloqueados pelo SSH](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/fail2ban-lista.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=c8e2499a7f46a599ab76416030b765a3)

## As prisões

Em **Prisões ativas e quantidade de endereços IP proibidos**, cada **prisão** é a
regra que vigia um serviço, e o número ao lado é quantos endereços ela está
bloqueando agora.

| Prisão | O que ela vigia | O que o bloqueio fecha para o endereço |
| - | - | - |
| `sshd` | a entrada por SSH | o SSH |
| `kh-postfix` e `kh-postfix-sasl` | o envio de e-mail | o envio de e-mail (portas 25, 465 e 587) |
| `kh-dovecot` | a leitura de e-mail pelo programa de e-mail | POP3, IMAP, os filtros de e-mail e o envio pelas portas 465 e 587 |
| `kh-ftp` | o FTP | o FTP |
| `kh-database` | a entrada no banco de dados de fora do servidor | o banco de dados (porta 3306) |
| `kh-phpmyadmin`, `kh-roundcube` e `kh-snappymail` | as entradas do phpMyAdmin e dos dois webmails | **as portas 80 e 443: o painel, os sites e o webmail** |

A regra é a mesma nas nove, pela configuração do servidor: **4 erros em 10 minutos,
vindos do mesmo endereço, bloqueiam o endereço por 10 minutos**, e o tempo cresce a
cada novo bloqueio dele, até duas semanas. Medido com um endereço de teste: o
primeiro bloqueio durou 10 minutos, e o segundo, no mesmo dia, 20.

**As regras não se mudam por esta tela.** Ela mostra, desbloqueia e isenta.

## A lista de endereços bloqueados

| Coluna | O que mostra |
| - | - |
| **IP** | o endereço bloqueado. É link: abre a [Pesquisa de IP Whois](/keyhelp-admin/pesquisa-de-ip-whois) dele numa janela separada |
| **BANIDO PELA PRISÃO** | a regra que bloqueou |
| **BANIDO DESDE** e **BANIDO ATÉ** | quando o bloqueio começou e quando acaba |
| **DURAÇÃO DO BANIMENTO** | o tempo total, em dias e horas |

Em **Opções de visualização**, a busca procura um trecho do texto em **Todos os
campos**, em **IP** ou em **Prisão**. Medido: `203.0.113` achou os endereços que
começam assim, e `kh-` achou os das regras do painel. **O `*` não funciona como
curinga aqui**: com ele, a lista voltou vazia, *"Nenhuma entrada disponível"*.

## Desbloquear um endereço

1. Na lista, marque a caixa da linha do endereço.
2. Em **Ações em massa**, escolha **Desbloquear os IPs selecionados** e clique em **Aplicar**.
3. Na janela *"Tem certeza de que deseja cancelar o bloqueio dos itens selecionados?"*, clique em **Sim**.

O painel responde *"Os IPs selecionados foram desbloqueados."*, e o Registro de
Eventos grava o aviso *"Unbanned 1x IP(s) from Fail2Ban."* Medido com um endereço de
teste: o bloqueio saiu do servidor na hora.

![Janela Desbloquear todos os IPs, com a pergunta de confirmação e os botões Sim e Cancelar](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/fail2ban-desbloquear-todos.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=7cf8f7220bc7216af73687be11bfe490)

O botão **Desbloquear todos os IPs** pede confirmação numa janela própria: *"Tem
certeza de que deseja cancelar o banimento de todos os itens?"* A lista inclui os
endereços bloqueados por todas as regras, como os que tentaram entrar por SSH.

## Opções

![Janela Opções: o campo Lista branca de IP e as caixas Modo de velocidade e Combinar informações de temporização](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/fail2ban-opcoes.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=6f231a3d5475d612a4f31d8c540316a3)

1. Clique em **Opções**, acima da lista.
2. Ajuste os campos.
3. Clique em **Salvar**.

O painel responde *"As configurações foram atualizadas."*, e o Registro de Eventos
grava *"Fail2Ban options updated."*

| Campo | Vem com | O que faz |
| - | - | - |
| **Lista branca de IP** | vazio | endereços que o Fail2Ban nunca bloqueia sozinho, um por linha |
| **Modo de velocidade** | desligado | esconde as colunas **BANIDO DESDE**, **BANIDO ATÉ** e **DURAÇÃO DO BANIMENTO**, para a lista abrir mais rápido quando é longa |
| **Combinar informações de temporização** | desligado | deixa só a coluna **BANIDO DESDE**; os três tempos aparecem numa caixa ao passar o mouse sobre a data |

### A lista branca

**Medido:** a lista vale **no minuto seguinte** ao **Salvar**, quando uma tarefa de
fundo a entrega ao Fail2Ban, e vale para **todas as prisões, inclusive a do SSH**.
Com o endereço da estação de teste na lista, uma senha errada no phpMyAdmin foi
ignorada, sem contar como erro; antes, a mesma tentativa tinha contado.

Ela aceita endereço IPv4, endereço IPv6 e faixa com máscara, como `198.51.100.0/24`.
Espaço antes ou depois é tirado. Endereço impossível, texto e nome de domínio são
recusados com *"Endereço de sub-rede IP / IP inválido."*, e nada é gravado.

> [!WARNING]
>
> **Pôr um endereço na lista não o desbloqueia**
>
> Medido: um endereço que já estava bloqueado continuou bloqueado depois de entrar
> na lista branca. Para liberar quem já foi bloqueado, desbloqueie também, como
> explicado acima.

> [!WARNING]
>
> **A lista aceita uma máscara que não existe, e o Fail2Ban usa outra coisa**
>
> Medido: a lista aceitou `203.0.113.0/33`, e a máscara `/33` não existe no IPv4 (a
> maior é `/32`). No minuto seguinte, o Fail2Ban passou a ignorar só o endereço
> `203.0.113.0`, sem a máscara. Confira as máscaras antes de salvar.

**Um endereço da lista fica livre em todos os serviços.** Se ele for o endereço de
um escritório inteiro, qualquer computador dali pode errar a senha do SSH, do
e-mail, do webmail ou do phpMyAdmin sem ser bloqueado.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O painel e os sites não abrem de um endereço, e de outros abrem** | o endereço está bloqueado por `kh-phpmyadmin`, `kh-roundcube` ou `kh-snappymail`, que fecham as portas 80 e 443 | de outra conexão, desbloquear o endereço nesta tela |
| Pus meu endereço na lista branca e continuo bloqueado | a lista não desbloqueia quem já está bloqueado | desbloquear o endereço na lista |
| Salvei a lista branca e ela ainda não vale | ela vale no minuto seguinte | esperar um minuto |
| *"Endereço de sub-rede IP / IP inválido."* | a lista branca tem um endereço impossível, um texto ou um nome de domínio | escrever só endereços IP ou faixas |
| A busca com `*` não acha nada | a busca não usa curinga | digitar um trecho do endereço ou da prisão |
| Sumiram as colunas de data da lista | o **Modo de velocidade** está ligado | desligar em **Opções** |

## Ver também

* [Firewall](/keyhelp-admin/firewall), as regras fixas do servidor, que o bloqueio do Fail2Ban não muda
* [Webmail](/keyhelp-admin/webmail) e [Interface Web do Banco de Dados](/keyhelp-admin/interface-web-do-banco-de-dados), as telas cujo erro de senha bloqueia o painel
* [Pesquisa de IP Whois](/keyhelp-admin/pesquisa-de-ip-whois), para saber de quem é um endereço bloqueado


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.