swissmakers/fail2ban-ui

어떤 프로젝트인가요?

핵심 기능

• 01WebSocket을 통한 활성 jail 및 실시간 차단/차단 해제 이벤트 중앙 대시보드
• 02모든 jail과 서버에서 IP 주소 검색 및 차단 해제
• 03잘못된 설정 복구 기능을 포함한 원격 jail 및 필터 설정 관리
• 04실시간 로그 패턴 테스트를 통한 필터 디버깅
• 05MikroTik, pfSense, OPNsense, UniFi에서 영구 차단 및 상습 공격자 처리
• 06GeoIP/Whois 정보 보강을 지원하는 이메일, webhook, Elasticsearch 알림

활용 사례

• 하나의 브라우저 인터페이스에서 여러 Linux 서버의 Fail2Ban 관리
• 각 호스트에 로그인하지 않고 IP를 확인하고 차단 해제
• 프로덕션 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은(는) 무엇인가요?

하나 이상의 Linux 호스트에서 Fail2Ban의 차단, jail, 필터, 알림을 관리하는 웹 플랫폼입니다. Fail2Ban UI는 하나 이상의 Linux 호스트에서 실행되는 Fail2Ban 인스턴스를 관리할 수 있는 중앙 인터페이스를 관리자에게 제공합니다. Fail2Ban을 대체하는 것은 아닙니다. 각 호스트의 Fail2Ban 데몬이 계속 차단 여부를 결정하며, UI는 해당 인스턴스에 연결해 활성 jail과 최근 차단 및 차단 해제 내역을 표시하고 모든 서버를 대상으로 검색과 차단 해제를 실행합니다.

fail2ban-ui은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

fail2ban-ui은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

fail2ban-ui은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. fail2ban-ui의 마지막 커밋은 2026년 10월 11일입니다.

fail2ban-ui은(는) 어디에 사용할 수 있나요?

하나의 브라우저 인터페이스에서 여러 Linux 서버의 Fail2Ban 관리 각 호스트에 로그인하지 않고 IP를 확인하고 차단 해제 프로덕션 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