Sicurezza a livello di kernel e risposta agli attacchi per server Linux.
Intelligence sul traffico a livello kernel e remediation delle minacce per server Linux.
KernelEye è una piattaforma di monitoraggio della sicurezza self-hosted per server Linux. Utilizza eBPF, TC e XDP in un agent Go per osservare i metadati di rete, assegnare un punteggio alle attività sospette e applicare la remediation tramite blocco XDP a livello kernel e regole ipset/iptables. Un backend Go archivia e analizza gli eventi, mentre una dashboard React fornisce gestione dei server, traffico in tempo reale, viste delle minacce, IP bloccati, whitelisting, report e analisi.
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
L'agent risiede in agent/ ed è il processo host Linux.
agent/main.go avvia la registrazione, il caricamento di eBPF, il monitoraggio della larghezza di banda, la remediation, lo scoring, l'aggregazione e lo streaming dei comandi di blocco.agent/ebpf/traffic_probe.c cattura i metadati del traffico.agent/ebpf/xdp_firewall.c implementa il filtraggio dei pacchetti XDP.agent/tc.go configura il monitoraggio della larghezza di banda TC.agent/aggregator.go raggruppa e invia gli eventi al backend.agent/history_store.go e agent/flush.go gestiscono la persistenza locale e il comportamento di retry.agent/remediation/ contiene gli analyzer e i remediator auto-blocking, XDP, ipset e ibridi.L'agent richiede Linux e privilegi elevati per le operazioni eBPF/XDP.
Il backend risiede in backend/.
backend/cmd/api/main.go avvia l'API HTTP Fiber e i servizi gRPC.backend/internal/api/ contiene l'autenticazione, gli handler della dashboard, gli handler gRPC, le API di blocco, le API della whitelist, la gestione WebSocket e il rate limiting.backend/internal/analysis/ contiene i worker di scoring, la gestione dei blocchi, la conservazione dei dati e la logica dei report mensili.backend/internal/database/ contiene il codice di accesso al database generato da sqlc.backend/internal/geoip/ gestisce l'arricchimento GeoIP.backend/internal/email/ invia email tramite Mailtrap quando configurato.backend/migrations/ contiene le migrazioni PostgreSQL.HTTP usa per impostazione predefinita la porta 8080; gRPC usa per impostazione predefinita la porta 9091.
La dashboard risiede in dashboard/ ed è un'applicazione Vite React.
dashboard/src/pages/ include le pagine panoramica, server, dettaglio server, minacce, avvisi, report, visualizzatore, IP bloccati, whitelist, login, profilo e callback OAuth.dashboard/src/components/ contiene i componenti per traffico live, feed dei blocchi, grafici, elenchi server, configuratori e layout condiviso.dashboard/src/api/client.ts definisce il client REST API.dashboard/src/context/WebSocketContext.tsx gestisce gli aggiornamenti degli eventi live.Il server di sviluppo è configurato per http://localhost:3000.
Il sito marketing pubblico risiede in kerneleye-landing-page/. L'immagine frontend di produzione compila sia la landing page che la dashboard, per poi servirle tramite nginx.
shared/scoring/ contiene il modulo condiviso di threat scoring utilizzato sia dall'agent che dal backend.shared/cmdsigning/ contiene il modulo di firma dei comandi HMAC-SHA256 e di protezione dal replay dei nonce.proto/kerneleye/v1/ contiene le definizioni protobuf per i servizi di ingest e block.proto/gen/go/ contiene il codice protobuf Go generato.KernelEye non ispeziona i payload dei pacchetti né il contenuto delle applicazioni.
I metadati raccolti includono:
Non raccolti:
Il threat scoring è implementato in shared/scoring/scorer.go. Lo scorer attuale è più articolato di una singola formula lineare: considera il tasso di SYN, l'accesso a porte uniche, gli handshake falliti, il comportamento a burst, l'abuso dei servizi, la direzione, la confidenza e il decadimento del punteggio nel tempo.
Soglie di classificazione predefinite:
< 20 normal
20-39 suspicious
>= 40 malicious
>= 40 eligible for auto-blocking when remediation is enabled
Il worker di analisi del backend utilizza anch'esso finestre di traffico accumulate e può attivare la gestione dei blocchi per le sorgenti ad alto rischio.
KernelEye supporta la remediation attiva quando è abilitata sull'agent.
| Livello | Implementazione | Scopo |
|---|---|---|
| XDP | agent/remediation/xdp_remediator.go | Drop rapidi a livello kernel prima dello stack di rete |
| IPSet | agent/remediation/ipset_remediator.go | Gestione dei blocchi tramite ipset/iptables |
| Hybrid | agent/remediation/hybrid_remediator.go | Coordina il comportamento di XDP e ipset |
| Auto-blocker | agent/remediation/auto_blocker.go | Blocca le sorgenti che superano le soglie di punteggio configurate |
| Backend block manager | backend/internal/analysis/block_manager.go | Coordina lo stato dei blocchi e i comandi generati dal backend |
La dashboard espone anche la gestione degli IP bloccati e della whitelist.
cp .env.example .env
Imposta almeno:
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
Le integrazioni opzionali includono il rate limiting con Redis, l'email con Mailtrap, OAuth con GitHub/Google e GeoIP con MaxMind.