TheDuffman85/crowdsec-web-ui

어떤 프로젝트인가요?

핵심 기능

• 01CrowdSec 컨텍스트와 IP, AS, 위치 정보를 확인할 수 있는 검색 가능한 알림 이력
• 02기간을 직접 지정하는 수동 차단을 포함한 활성 및 만료 차단 결정 관리
• 03여러 CrowdSec LAPI에 연결하고 통합 범위 보기 제공
• 04선택 사항인 LAPI, bouncer, AppSec, parser용 Prometheus 메트릭 화면
• 05Email, Gotify, MQTT, ntfy 또는 webhook으로 전송하는 알림 규칙
• 06그룹 기반 역할을 지원하는 비밀번호, TOTP, passkey 및 OIDC SSO 로그인

활용 사례

• 여러 서버에서 CrowdSec을 운영하며 모든 LAPI를 하나의 대시보드에서 관리하려는 운영자
• 명령줄을 사용하지 않고 알림을 검토하고 IP를 수동으로 차단하거나 차단 해제하려는 팀
• 새 알림과 차단 결정에 대한 푸시 알림을 받고 싶은 홈랩 또는 소규모 팀 관리자
• 기존 OIDC ID 공급자와 CrowdSec 접근 관리를 연동하려는 조직

빠른 시작

1. 1

   openssl로 무작위 비밀번호를 생성합니다

   openssl rand -hex 32
2. 2

   CrowdSec 컨테이너에서 Web UI를 machine으로 등록합니다

   docker exec crowdsec cscli machines add crowdsec-web-ui --password 'replace-with-generated-password' -f /dev/null
3. 3

   포함된 docker-compose.yml을 사용해 Docker Compose로 Web UI를 시작합니다

   docker compose up -d
4. 4

   브라우저에서 http://localhost:3000을 열고 최초 관리자 계정을 만듭니다

사용 전 알아둘 점

• !연결할 실행 중인 CrowdSec LAPI가 필요합니다.
• !강한 카피레프트 라이선스인 AGPL-3.0으로 제공됩니다.
• !앱이 TLS를 처리하지 않으므로 공개 배포 시 HTTPS와 보안이 강화된 리버스 프록시 뒤에 배치해야 합니다.
• !인증 기능이 도입되기 전에 설치한 시스템을 마이그레이션한 경우, 인증을 활성화할 때까지 인증 없이 유지됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

crowdsec-web-ui은(는) 무엇인가요?

알림 조사, 차단 결정 관리, 런타임 메트릭 확인, 알림 전송을 지원하는 CrowdSec용 셀프 호스팅 웹 대시보드입니다. CrowdSec Web UI는 하나 이상의 CrowdSec Local API(LAPI)에 연결하는 셀프 호스팅 대시보드입니다. 검색과 빠른 필터로 알림 이력을 살펴보고, 각 알림의 CrowdSec 컨텍스트를 확인하고, 활성 및 만료된 차단 결정을 조회할 수 있습니다. 기간과 사유를 직접 지정해 수동 차단을 추가할 수 있으며, 같은 인터페이스에서 정리 작업도 수행할 수 있습니다.

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

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

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

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

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

여러 서버에서 CrowdSec을 운영하며 모든 LAPI를 하나의 대시보드에서 관리하려는 운영자 명령줄을 사용하지 않고 알림을 검토하고 IP를 수동으로 차단하거나 차단 해제하려는 팀 새 알림과 차단 결정에 대한 푸시 알림을 받고 싶은 홈랩 또는 소규모 팀 관리자 기존 OIDC ID 공급자와 CrowdSec 접근 관리를 연동하려는 조직

crowdsec-web-ui는 어떻게 설치하나요?

openssl로 무작위 비밀번호를 생성합니다: openssl rand -hex 32 CrowdSec 컨테이너에서 Web UI를 machine으로 등록합니다: docker exec crowdsec cscli machines add crowdsec-web-ui --password 'replace-with-generated-password' -f /dev/null 포함된 docker-compose.yml을 사용해 Docker Compose로 Web UI를 시작합니다: docker compose up -d 브라우저에서 http://localhost:3000을 열고 최초 관리자 계정을 만듭니다

crowdsec-web-ui은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/TheDuffman85/crowdsec-web-ui