Repolode
swissmakers

swissmakers/fail2ban-ui

1台以上のLinuxホストでFail2Banを運用し、ban、jail、filter、アラートを管理するWebプラットフォーム。

スター
381
フォーク
42
未解決の Issue
4
最終コミット
8 日前

これは何?

Fail2Ban UIは、1台以上のLinuxホストで稼働するFail2Banインスタンスを一元管理するためのインターフェースを管理者に提供します。Fail2Banを置き換えるものではなく、banの判断は各ホストのFail2Banデーモンが引き続き行います。UIは各インスタンスに接続して、稼働中のjailや最近のban・unbanの履歴を表示し、すべてのサーバーを対象に検索やunbanを実行できます。

UIはローカルコネクター、SSHコネクター、またはHTTPエージェントを介して各ホストに接続します。各ホストはカスタムのFail2Banアクションを使ってban・unbanイベントをUIに送信します。UIはイベントを保存し、接続中のブラウザーにリアルタイムで配信するとともに、アラートを発生させることもできます。また、リモートホスト上のjailやfilterの設定編集、ログ行に対するfilter regexのテスト、MikroTik、pfSense、OPNsense、UniFiファイアウォールへの恒久的なブロック登録にも対応しています。

単一のGoバイナリとして提供され、コンテナまたはsystemdサービスとして利用できます。OIDCログインにも対応しています。アラートはメール、webhook、またはElasticsearchで送信できます。

主な機能

  • 01稼働中のjailとban・unbanイベントをリアルタイムに表示する、WebSocket対応の一元管理ダッシュボード
  • 02すべてのjailとサーバーを対象にしたIPアドレスの検索とunban
  • 03リモートのjail・filter設定の管理と、不正な設定からの復旧
  • 04ログパターンをリアルタイムでテストできるfilterデバッグ機能
  • 05MikroTik、pfSense、OPNsense、UniFiでの恒久的なブロック登録と、繰り返し攻撃するIPへの対応
  • 06GeoIP/Whoisによる情報補完に対応した、メール、webhook、Elasticsearchアラート

ユースケース

  • 1つのブラウザーインターフェースから複数のLinuxサーバー上のFail2Banを管理する
  • 各ホストにログインせずにIPを確認してunbanする
  • 本番環境のjailに変更を適用する前にfilter regexをテストする
  • 攻撃を繰り返す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 とは?
1台以上のLinuxホストでFail2Banを運用し、ban、jail、filter、アラートを管理するWebプラットフォーム。 Fail2Ban UIは、1台以上のLinuxホストで稼働するFail2Banインスタンスを一元管理するためのインターフェースを管理者に提供します。Fail2Banを置き換えるものではなく、banの判断は各ホストのFail2Banデーモンが引き続き行います。UIは各インスタンスに接続して、稼働中のjailや最近のban・unbanの履歴を表示し、すべてのサーバーを対象に検索やunbanを実行できます。
fail2ban-ui は無料で使えますか?ライセンスは?
fail2ban-ui は AGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
fail2ban-ui は今もメンテナンスされていますか?
活発にメンテナンス中。fail2ban-ui の最終コミットは 2026年10月11日 です。
fail2ban-ui は何に使えますか?
1つのブラウザーインターフェースから複数のLinuxサーバー上のFail2Banを管理する 各ホストにログインせずにIPを確認してunbanする 本番環境のjailに変更を適用する前にfilter regexをテストする 攻撃を繰り返す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 をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト