리눅스 서버용 커널 수준 보안 및 공격 대응.
Linux 서버를 위한 커널 수준 트래픽 인텔리전스 및 위협 교정.
KernelEye는 Linux 서버용 자체 호스팅 보안 모니터링 플랫폼입니다. Go 에이전트에서 eBPF, TC, XDP를 사용하여 네트워크 메타데이터를 관찰하고, 의심스러운 활동을 점수화하며, 커널 수준의 XDP 차단 및 ipset/iptables 규칙을 통해 교정을 적용합니다. Go 백엔드는 이벤트를 저장하고 분석하며, React 대시보드는 서버 관리, 실시간 트래픽, 위협 뷰, 차단된 IP, 화이트리스트, 보고서, 분석 기능을 제공합니다.
shared/scoring의 공유 Go 점수 산정 로직을 기반으로 한 위협 점수 산정.Monitored Linux host
eBPF traffic probe + TC bandwidth hooks
XDP firewall and ipset/iptables remediation
Go agent (HMAC command verification, audit log)
|
| gRPC (TLS/mTLS) + HMAC-signed block commands
v
Go backend API
Fiber HTTP API
gRPC ingest/block services (TLS/mTLS, command signing)
analysis worker, block manager, retention, reports
integrity report handler
|
v
PostgreSQL
^
|
React dashboard
REST API + WebSocket live updates
에이전트는 agent/에 위치하며 Linux 호스트 프로세스입니다.
agent/main.go는 등록, eBPF 로딩, 대역폭 추적, 교정(remediation), 점수 산정, 집계, 차단 명령 스트리밍을 시작합니다.agent/ebpf/traffic_probe.c는 트래픽 메타데이터를 캡처합니다.agent/ebpf/xdp_firewall.c는 XDP 패킷 필터링을 구현합니다.agent/tc.go는 TC 대역폭 추적을 구성합니다.agent/aggregator.go는 이벤트를 배치로 묶어 백엔드로 전송합니다.agent/history_store.go와 agent/flush.go는 로컬 영속성과 재시도 동작을 처리합니다.agent/remediation/에는 분석기, 자동 차단, XDP, ipset, 하이브리드 교정기가 포함되어 있습니다.에이전트는 eBPF/XDP 작업을 위해 Linux와 상승된 권한이 필요합니다.
백엔드는 backend/에 위치합니다.
backend/cmd/api/main.go는 Fiber HTTP API와 gRPC 서비스를 시작합니다.backend/internal/api/에는 인증, 대시보드 핸들러, gRPC 핸들러, 차단 API, 화이트리스트 API, WebSocket 처리, 속도 제한이 포함되어 있습니다.backend/internal/analysis/에는 점수 산정 워커, 차단 관리, 데이터 보존, 월간 보고서 로직이 포함되어 있습니다.backend/internal/database/에는 sqlc로 생성된 데이터베이스 접근 코드가 포함되어 있습니다.backend/internal/geoip/는 GeoIP 보강을 처리합니다.backend/internal/email/은 구성된 경우 Mailtrap 기반 이메일을 전송합니다.backend/migrations/에는 PostgreSQL 마이그레이션이 포함되어 있습니다.HTTP는 기본적으로 포트 8080을 사용하며, gRPC는 기본적으로 포트 9091을 사용합니다.
대시보드는 dashboard/에 위치하며 Vite React 애플리케이션입니다.
dashboard/src/pages/에는 개요, 서버, 서버 상세, 위협, 경보, 보고서, 시각화 도구, 차단된 IP, 화이트리스트, 로그인, 프로필, OAuth 콜백 페이지가 포함되어 있습니다.dashboard/src/components/에는 실시간 트래픽, 차단 피드, 차트, 서버 목록, 구성 도구, 공유 레이아웃 컴포넌트가 포함되어 있습니다.dashboard/src/api/client.ts는 REST API 클라이언트를 정의합니다.dashboard/src/context/WebSocketContext.tsx는 실시간 이벤트 업데이트를 관리합니다.개발 서버는 http://localhost:3000으로 구성되어 있습니다.
공개 마케팅 사이트는 kerneleye-landing-page/에 위치합니다. 프로덕션 프론트엔드 이미지는 랜딩 페이지와 대시보드를 모두 빌드한 후 nginx를 통해 제공합니다.
shared/scoring/에는 에이전트와 백엔드 모두에서 사용하는 공유 위협 점수 산정 모듈이 포함되어 있습니다.shared/cmdsigning/에는 HMAC-SHA256 명령 서명 및 nonce 재전송 방지 모듈이 포함되어 있습니다.proto/kerneleye/v1/에는 수집(ingest) 및 차단 서비스용 protobuf 정의가 포함되어 있습니다.proto/gen/go/에는 생성된 Go protobuf 코드가 포함되어 있습니다.KernelEye는 패킷 페이로드나 애플리케이션 콘텐츠를 검사하지 않습니다.
수집되는 메타데이터는 다음과 같습니다:
수집하지 않는 항목:
위협 점수 산정은 shared/scoring/scorer.go에 구현되어 있습니다. 현재 점수 산정기는 단일 선형 공식보다 더 정교합니다: SYN 비율, 고유 포트 접근, 실패한 핸드셰이크, 버스트 동작, 서비스 남용, 방향, 신뢰도, 시간 경과에 따른 점수 감쇠를 고려합니다.
기본 분류 임계값:
< 20 normal
20-39 suspicious
>= 40 malicious
>= 40 eligible for auto-blocking when remediation is enabled
백엔드 분석 워커 또한 누적된 트래픽 윈도우를 사용하며 고위험 소스에 대한 차단 관리를 트리거할 수 있습니다.
KernelEye는 에이전트에서 활성화된 경우 능동적 교정을 지원합니다.
| 계층 | 구현 | 목적 |
|---|---|---|
| XDP | agent/remediation/xdp_remediator.go | 네트워크 스택 이전에 커널 수준에서 빠른 드롭 |
| IPSet | agent/remediation/ipset_remediator.go | ipset/iptables 차단 관리 |
| 하이브리드 | agent/remediation/hybrid_remediator.go | XDP와 ipset 동작 조정 |
| 자동 차단기 | agent/remediation/auto_blocker.go | 구성된 점수 임계값을 초과하는 소스 차단 |
| 백엔드 차단 관리자 | backend/internal/analysis/block_manager.go | 백엔드에서 생성된 차단 상태 및 명령 조정 |
대시보드는 차단된 IP 및 화이트리스트 관리 기능도 제공합니다.
cp .env.example .env
최소한 다음을 설정하세요:
DATABASE_URL=postgres://kerneleye:<password>@localhost:5432/kerneleye?sslmode=disable
JWT_SECRET=<at-least-32-characters>
API_KEY_SECRET=<strong-secret>
CORS_ORIGINS=http://localhost:3000
선택적 통합에는 Redis 속도 제한, Mailtrap 이메일, GitHub/Google OAuth, MaxMind GeoIP가 포함됩니다.
cd backend
go mod download
go run cmd/api/main.go
백엔드가 시작됩니다:
http://localhost:8080의 HTTP APIlocalhost:9091의 gRPCcd dashboard
npm install
npm run dev
http://localhost:3000을 엽니다.
로그인은 OAuth 전용입니다. 대시보드에 접근하려면 AUTH_OWNER_EMAIL을 설정하고 최소 하나의 OAuth 제공자(GitHub 또는 Google)를 구성하십시오. 구성된 소유자 이메일만 로그인이 허용됩니다.
cd agent
bpftool btf dump file /sys/kernel/btf/vmlinux format c > ebpf/vmlinux.h
go generate ./...
go build -o kerneleye-agent
sudo KERNELEYE_API_KEY=<server-api-key> \
KERNELEYE_SERVER=localhost:8080 \
KERNELEYE_GRPC_URL=localhost:9091 \
./kerneleye-agent
유용한 에이전트 플래그:
-enable-remediation enable active blocking and auto-blocking
-xdp enable XDP fast-path blocking
-interface <name> select XDP network interface
--read-only monitor and report only, never block
--insecure disable TLS (dev only)
--tls-ca-file <path> backend CA certificate for TLS verification
--tls-cert-file <path> agent client certificate for mTLS
--tls-key-file <path> agent client private key for mTLS
-list-blocked print current ipset state and exit
-flush-blocklists flush ipset and XDP blocklists and exit
-clear-data remove local agent SQLite stores and exit
-version print build version
--enable-remediation이 설정된 경우, 에이전트와 백엔드 양쪽 모두에서 CMD_SIGNING_KEY가 구성되어 있어야 합니다. openssl rand -base64 32로 생성하십시오.