악성 웹 크롤러와 공격자를 탐지하는 현대적인 웹 허니팟 서버
중간맛 분석
Python 기반 FastAPI(uvicorn) 웹 프레임워크로 구축된 클라우드 네이티브 허니팟입니다. SQLite 단독 모드와 PostgreSQL+Redis 스케일 모드 2가지 배포 옵션을 지원하며, , Compose, (Helm), 또는 Python 직접 실행이 가능합니다. 허니팟 경로 생성, 가짜 로그인 페이지, Canary 연동, 지연 주입, 공격 패턴 탐지, 실시간 대시보드, GeoIP 시각화 같은 기능을 제공하며, AI 생성 페이지 기능으로 공격 표면을 동적으로 확장할 수 있습니다. 개발 및 홈랩 단계에서는 즉시 시작할 수 있고, 대규모 프로덕션 환경에서는 수평 확장이 가능합니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 리버스 프록시 뒤에 배치하여 실제 웹 애플리케이션을 보호하고 악성 크롤러 및 자동화 스캐너의 행동 추적
- 침입 탐지 및 위협 인텔 수집을 위해 GeoIP, ISP, 공격 유형 분류 대시보드를 통한 공격자 행동 분석
- 생성된 Banlist를 이용해 알려진 악성 IP를 사전 차단하거나 Canary Token으로 외부 보안 팀에 실시간 알림 전송
핵심 기능
대안 대비 차별점
Spider Trap을 통한 무한 링크 루프, AI 기반 동적 페이지 생성, 행동 기반 분석을 결합하여 웹 크롤러와 공격자를 구분하며, Kubernetes 네이티브 설계와 커뮤니티 Banlist 제공으로 클라우드 규모의 방어를 제공합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/BlessedRebuS/Krawl.git && cd Krawl && uv sync
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- Docker로 단독 모드 실행
docker run -d \
-p 5000:5000 \
-e KRAWL_DASHBOARD_SECRET_PATH="/my-secret-dashboard" \
-e KRAWL_DASHBOARD_PASSWORD="my-secret-password" \
-v krawl-data:/app/data \
--name krawl \
ghcr.io/blessedrebus/krawl:latest
- 서버 접속 확인
http://localhost:5000
- 대시보드 접속 (시크릿 경로로 접근)
http://localhost:5000/my-secret-dashboard
- Docker Compose로 PostgreSQL+Redis 스케일 모드 배포 (config.yaml 준비 후)
docker compose up -d
- Python 환경에서 직접 실행 (개발용)
pip install -r requirements.txt
uvicorn app:app --host 0.0.0.0 --port 5000 --app-dir src --no-server-header
- Kubernetes Helm 배포 (프로덕션)
helm install krawl oci://ghcr.io/blessedrebus/krawl-chart --version 2.2.0 \
-n krawl-system --create-namespace \
--set postgres.password=your-password \
--set redis.password=your-redis-password \
--set dashboardPassword=your-dashboard-password \
--set config.dashboard.secret_path=/my-secret-dashboard
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try BlessedRebuS/Krawl
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
이걸로 써먹는 법
맛봤다면 이제 써먹을 차례 — 이 레포를 내 일과 사업에 응용하는 방법을 모아뒀어요.
🍳 레시피 — AI에게 이대로 시켜보세요
레시피 불러오는 중…
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2025년 생성
「데이터·크롤링」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/BlessedRebuS/Krawl)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기