Kernel-Level-Sicherheit und Angriffsreaktion für Linux-Server.
Verkehrsanalyse und Bedrohungsbehebung auf Kernel-Ebene für Linux-Server.
KernelEye ist eine selbst gehostete Sicherheitsüberwachungsplattform für Linux-Server. Sie nutzt eBPF, TC und XDP in einem Go-Agenten, um Netzwerk-Metadaten zu beobachten, verdächtige Aktivitäten zu bewerten und Behebungsmaßnahmen durch XDP-Blockierung auf Kernel-Ebene sowie ipset/iptables-Regeln anzuwenden. Ein Go-Backend speichert und analysiert Ereignisse, während ein React-Dashboard Serververwaltung, Live-Verkehr, Bedrohungsansichten, blockierte IPs, Whitelisting, Berichte und Analysen bereitstellt.
shared/scoring.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
Der Agent befindet sich in agent/ und ist der Linux-Host-Prozess.
agent/main.go startet Registrierung, eBPF-Laden, Bandbreitenverfolgung, Remediation, Scoring, Aggregation und Block-Command-Streaming.agent/ebpf/traffic_probe.c erfasst Traffic-Metadaten.agent/ebpf/xdp_firewall.c implementiert XDP-Paketfilterung.agent/tc.go konfiguriert die TC-Bandbreitenverfolgung.agent/aggregator.go bündelt und übermittelt Ereignisse an das Backend.agent/history_store.go und agent/flush.go übernehmen lokale Persistenz und Retry-Verhalten.agent/remediation/ enthält Analyzer, Auto-Blocking, XDP-, ipset- und Hybrid-Remediatoren.Der Agent erfordert Linux und erhöhte Privilegien für eBPF/XDP-Operationen.
Das Backend befindet sich in backend/.
backend/cmd/api/main.go startet die Fiber-HTTP-API und die gRPC-Dienste.backend/internal/api/ enthält Auth, Dashboard-Handler, gRPC-Handler, Block-APIs, Whitelist-APIs, WebSocket-Verarbeitung und Rate Limiting.backend/internal/analysis/ enthält Scoring-Worker, Block-Verwaltung, Datenaufbewahrung und Logik für Monatsberichte.backend/internal/database/ enthält den von sqlc generierten Datenbankzugriffscode.backend/internal/geoip/ übernimmt die GeoIP-Anreicherung.backend/internal/email/ versendet Mailtrap-gestützte E-Mails, wenn konfiguriert.backend/migrations/ enthält PostgreSQL-Migrationen.HTTP verwendet standardmäßig Port 8080; gRPC verwendet standardmäßig Port 9091.
Das Dashboard befindet sich in dashboard/ und ist eine Vite-React-Anwendung.
dashboard/src/pages/ umfasst Übersichts-, Server-, Serverdetail-, Bedrohungs-, Alarm-, Berichts-, Visualizer-, Blockierte-IPs-, Whitelist-, Login-, Profil- und OAuth-Callback-Seiten.dashboard/src/components/ enthält Live-Traffic, Block-Feed, Diagramme, Serverlisten, Konfiguratoren und gemeinsame Layout-Komponenten.dashboard/src/api/client.ts definiert den REST-API-Client.dashboard/src/context/WebSocketContext.tsx verwaltet Live-Ereignisaktualisierungen.Der Dev-Server ist für http://localhost:3000 konfiguriert.
Die öffentliche Marketing-Website befindet sich in kerneleye-landing-page/. Das Produktions-Frontend-Image baut sowohl die Landing Page als auch das Dashboard und stellt sie anschließend über nginx bereit.
shared/scoring/ enthält das gemeinsam genutzte Bedrohungs-Scoring-Modul, das sowohl vom Agent als auch vom Backend verwendet wird.shared/cmdsigning/ enthält das Modul für HMAC-SHA256-Befehlssignierung und Nonce-Replay-Schutz.proto/kerneleye/v1/ enthält Protobuf-Definitionen für Ingest- und Block-Dienste.proto/gen/go/ enthält generierten Go-Protobuf-Code.KernelEye inspiziert keine Paket-Payloads oder Anwendungsinhalte.
Zu den erfassten Metadaten gehören:
Nicht erfasst:
Das Bedrohungs-Scoring ist in shared/scoring/scorer.go implementiert. Der aktuelle Scorer ist differenzierter als eine einzelne lineare Formel: Er berücksichtigt SYN-Rate, Zugriff auf eindeutige Ports, fehlgeschlagene Handshakes, Burst-Verhalten, Dienstmissbrauch, Richtung, Konfidenz und Score-Zerfall über die Zeit.
Standard-Klassifizierungsschwellenwerte:
< 20 normal
20-39 suspicious
>= 40 malicious
>= 40 eligible for auto-blocking when remediation is enabled
Der Backend-Analyse-Worker nutzt ebenfalls akkumulierte Traffic-Fenster und kann die Blockverwaltung für Quellen mit hohem Risiko auslösen.
KernelEye unterstützt aktive Behebung, wenn diese auf dem Agenten aktiviert ist.
| Ebene | Implementierung | Zweck |
|---|---|---|
| XDP | agent/remediation/xdp_remediator.go | Schnelle Drops auf Kernel-Ebene vor dem Netzwerk-Stack |
| IPSet | agent/remediation/ipset_remediator.go | ipset/iptables-Blockverwaltung |
| Hybrid | agent/remediation/hybrid_remediator.go | Koordiniert XDP- und ipset-Verhalten |
| Auto-Blocker | agent/remediation/auto_blocker.go | Blockiert Quellen, die konfigurierte Score-Schwellenwerte überschreiten |
| Backend-Block-Manager | backend/internal/analysis/block_manager.go | Koordiniert den vom Backend generierten Block-Status und die Befehle |
Das Dashboard bietet außerdem die Verwaltung blockierter IPs und von Whitelists.
cp .env.example .env
Legen Sie mindestens fest:
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
Optionale Integrationen umfassen Redis-Ratenbegrenzung, Mailtrap-E-Mail, GitHub/Google OAuth und MaxMind GeoIP.
cd backend
go mod download
go run cmd/api/main.go
Das Backend startet:
http://localhost:8080localhost:9091