# Настройка уведомлений Fail2Ban в Telegram

### Создание скрипта для уведомлений

Создаем файл скрипта:

```bash
mcedit /etc/fail2ban/scripts/fail2ban-telegram.sh

```

Содержимое скрипта:

```bash
#!/bin/bash

TOKEN="ТВОЙ_ТОКЕН_БОТА"
CHAT_ID="ТВОЙ_CHAT_ID"
TEXT="$1"

curl -s -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
     -d chat_id="${CHAT_ID}" \
     -d text="${TEXT}" \
     -d parse_mode="Markdown"

```

Делаем скрипт исполняемым:

```bash
chmod +x /etc/fail2ban/scripts/fail2ban-telegram.sh

```

### Настройка Fail2Ban

Копируем стандартный action:

```bash
cp /etc/fail2ban/action.d/mail.conf /etc/fail2ban/action.d/telegram.conf

```

Редактируем конфигурацию:

```bash
mcedit /etc/fail2ban/action.d/telegram.conf

```

Содержимое файла:

```
[Definition]
actionstart =
actionstop =
actioncheck =
actionban = /etc/fail2ban/scripts/fail2ban-telegram.sh "🚫 [Fail2Ban] Бан: <ip> из тюрьмы <name>"
actionunban = /etc/fail2ban/scripts/fail2ban-telegram.sh "✅ [Fail2Ban] Разбан: <ip> из тюрьмы <name>"

[Init]

```

### Подключение в jail.local

```bash
mcedit /etc/fail2ban/jail.d/defaults-debian.conf

```

Пример конфигурации:

```
[DEFAULT]
maxretry = 2
findtime = 480
bantime = 720
action = iptables-allports
    telegram
ignoreip = 127.0.0.1/8 192.168.0.0/24

```

### Применение настроек

```bash
sudo systemctl restart fail2ban

```

### Тестирование

```bash
sudo fail2ban-client set sshd banip 1.2.3.4

```

### Улучшенная версия с геолокацией

**Установка зависимостей:**

```bash
sudo apt install geoip-bin whois jq curl -y

```

**Создание улучшенного скрипта:**

```bash
sudo mcedit /etc/fail2ban/scripts/fail2ban-telegram-geo.sh

```

Содержимое скрипта:

```bash
#!/bin/bash

TOKEN="ТВОЙ_ТОКЕН_БОТА"
CHAT_ID="ТВОЙ_CHAT_ID"
IP="$1"
JAIL="$2"
REASON="$3"
DATE="$(date '+%Y-%m-%d %H:%M:%S %Z')"

# Геолокация через ipinfo.io
INFO=$(curl -s "https://ipinfo.io/${IP}/json")

COUNTRY=$(echo "$INFO" | jq -r '.country // "Unknown"')
CITY=$(echo "$INFO" | jq -r '.city // "Unknown"')
ORG=$(echo "$INFO" | jq -r '.org // "Unknown"')

# Формируем сообщение
TEXT="🚫 *Fail2Ban ВНИМАНИЕ*
📅 Дата: ${DATE}
🔒 Тюрьма: ${JAIL}
❌ IP: ${IP}
🌍 Страна: ${COUNTRY}
🏙 Город: ${CITY}
🏢 Организация: ${ORG}
📄 Причина: ${REASON}"

# Отправка в Telegram
curl -s -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
     -d chat_id="${CHAT_ID}" \
     -d text="${TEXT}" \
     -d parse_mode="Markdown"

```

**Делаем исполняемым:**

```bash
sudo chmod +x /etc/fail2ban/scripts/fail2ban-telegram-geo.sh

```

**Создаем action для геолокации:**

```bash
sudo mcedit /etc/fail2ban/action.d/telegram-geo.conf

```

Содержимое:

```
[Definition]
actionstart =
actionstop =
actioncheck =
actionban = /etc/fail2ban/scripts/fail2ban-telegram-geo.sh "<ip>" "<name>" "Превышено число неудачных попыток входа"
actionunban = /etc/fail2ban/scripts/fail2ban-telegram-geo.sh "<ip>" "<name>" "Разбан"

[Init]

```

**Обновляем конфигурацию jail:**

```bash
mcedit /etc/fail2ban/jail.d/defaults-debian.conf

```

```
[DEFAULT]
maxretry = 2
findtime = 480
bantime = 720
action = iptables-allports
    telegram-geo
ignoreip = 127.0.0.1/8 192.168.0.0/24

```

**Применяем изменения:**

```bash
sudo systemctl restart fail2ban
sudo fail2ban-client set sshd banip 1.2.3.4
sudo fail2ban-client set sshd unbanip 1.2.3.4

```

**Пример уведомления:**

```
🚫 Fail2Ban Alert
📅 Дата: 2025-08-12 14:23:45 UTC
🔒 Тюрьма: sshd
❌ IP: 1.2.3.4
🌍 Страна: US
🏙 Город: Los Angeles
🏢 Организация: AS12345 Example ISP
📄 Причина: Превышено число неудачных попыток входа

```