Repolode
swissmakers

swissmakers/fail2ban-ui

Веб-платформа для управления Fail2Ban на одном или нескольких Linux-хостах: блокировки, jail, фильтры и оповещения.

Звёзды
381
Форки
42
Открытые issues
4
Последний коммит
9 дней назад

Что это?

Fail2Ban UI предоставляет администраторам единый интерфейс для управления экземплярами Fail2Ban на одном или нескольких Linux-хостах. Он не заменяет Fail2Ban: решения о блокировках по-прежнему принимает демон Fail2Ban на каждом хосте, а интерфейс подключается к этим экземплярам, чтобы показывать активные jail и недавние события блокировки и снятия блокировки, а также выполнять поиск и снимать блокировки на всех серверах.

Интерфейс подключается к каждому хосту через локальный коннектор, SSH-коннектор или HTTP-агент. Каждый хост отправляет события блокировки и снятия блокировки обратно в интерфейс с помощью специального действия Fail2Ban. Интерфейс сохраняет эти события, в реальном времени передаёт их подключённым браузерам и может запускать оповещения. Кроме того, он позволяет редактировать конфигурацию jail и фильтров на удалённых хостах, проверять регулярные выражения фильтров на строках логов и добавлять постоянные блокировки в файрволы MikroTik, pfSense, OPNsense и UniFi.

Проект поставляется в виде единого бинарного файла Go, доступного как контейнер или служба systemd, и поддерживает вход через OIDC. Оповещения можно отправлять по электронной почте, через webhook или в Elasticsearch.

Ключевые возможности

  • 01Центральная панель с активными jail и событиями блокировки и снятия блокировки в реальном времени через WebSocket
  • 02Поиск IP-адресов и снятие блокировок во всех jail и на всех серверах
  • 03Управление конфигурацией jail и фильтров на удалённых хостах с восстановлением после ошибок в конфигурации
  • 04Отладка фильтров с проверкой шаблонов по логам в реальном времени
  • 05Постоянная блокировка и обработка повторных нарушителей в MikroTik, pfSense, OPNsense и UniFi
  • 06Оповещения по электронной почте, через webhook и в Elasticsearch с обогащением данных GeoIP/Whois

Сценарии использования

  • Управление Fail2Ban на нескольких Linux-серверах через единый веб-интерфейс
  • Просмотр IP-адресов и снятие блокировок без входа на каждый хост
  • Проверка регулярных выражений фильтров перед развёртыванием изменений в production jail
  • Добавление повторных IP-адресов атакующих в файрвол как постоянных блокировок

Быстрый старт

  1. 1

    Запустите контейнер с локальным коннектором

    podman run -d --name fail2ban-ui --network=host \ -v /opt/fail2ban-ui:/config:Z \ -v /etc/fail2ban:/etc/fail2ban:Z \ -v /var/run/fail2ban:/var/run/fail2ban \ -v /var/log:/var/log:ro \ swissmakers/fail2ban-ui:latest
  2. 2

    Откройте http://localhost:8080 в браузере

  3. 3

    Перейдите в Settings -> Manage Servers, включите локальный коннектор и нажмите Test connection

Что важно знать

  • На хостах Linux уже должен быть установлен Fail2Ban; это решение не заменяет Fail2Ban.
  • Для SSH-коннектора нужна отдельная служебная учетная запись с правилами sudo, поэтому настройка потребует некоторых усилий.
  • Рекомендуется запускать его за обратным прокси, VPN или межсетевым экраном, а не открывать доступ из публичного интернета.

Темы

Частые вопросы

Что такое fail2ban-ui?
Веб-платформа для управления Fail2Ban на одном или нескольких Linux-хостах: блокировки, jail, фильтры и оповещения. Fail2Ban UI предоставляет администраторам единый интерфейс для управления экземплярами Fail2Ban на одном или нескольких Linux-хостах. Он не заменяет Fail2Ban: решения о блокировках по-прежнему принимает демон Fail2Ban на каждом хосте, а интерфейс подключается к этим экземплярам, чтобы показывать активные jail и недавние события блокировки и снятия блокировки, а также выполнять поиск и снимать блокировки на всех серверах.
fail2ban-ui можно использовать бесплатно? Какая у него лицензия?
fail2ban-ui распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
fail2ban-ui всё ещё поддерживается?
Активно поддерживается. Последний коммит в fail2ban-ui — 11 окт. 2026 г..
Для чего можно использовать fail2ban-ui?
Управление Fail2Ban на нескольких Linux-серверах через единый веб-интерфейс Просмотр IP-адресов и снятие блокировок без входа на каждый хост Проверка регулярных выражений фильтров перед развёртыванием изменений в production jail Добавление повторных IP-адресов атакующих в файрвол как постоянных блокировок
Как установить fail2ban-ui?
Запустите контейнер с локальным коннектором: podman run -d --name fail2ban-ui --network=host \ -v /opt/fail2ban-ui:/config:Z \ -v /etc/fail2ban:/etc/fail2ban:Z \ -v /var/run/fail2ban:/var/run/fail2ban \ -v /var/log:/var/log:ro \ swissmakers/fail2ban-ui:latest Откройте http://localhost:8080 в браузере Перейдите в Settings -> Manage Servers, включите локальный коннектор и нажмите Test connection
Где скачать fail2ban-ui?
Исходный код и инструкции по установке — на GitHub: https://github.com/swissmakers/fail2ban-ui

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Trivy — сканер безопасности с открытым исходным кодом, который выявляет уязвимости, ошибки конфигурации, секреты и данные SBOM в контейнерах, файловых системах, Git-репозиториях, образах VM и Kubernetes.

38,5 тыс.774GoApache-2.0Обновлён вчера

Самостоятельно размещаемый инструмент для сетевой разведки на Go: обнаруживает, распознаёт и отслеживает устройства в локальной сети через веб-консоль с обновлениями в реальном времени.

1,9 тыс.132GoOtherОбновлён 2 месяца назад