Segurança em nível de kernel e resposta a ataques para servidores Linux.
Inteligência de tráfego em nível de kernel e remediação de ameaças para servidores Linux.
KernelEye é uma plataforma de monitoramento de segurança auto-hospedada para servidores Linux. Ela usa eBPF, TC e XDP em um agente Go para observar metadados de rede, pontuar atividades suspeitas e aplicar remediação por meio de bloqueio XDP em nível de kernel e regras ipset/iptables. Um backend Go armazena e analisa eventos, enquanto um dashboard React fornece gerenciamento de servidores, tráfego ao vivo, visualizações de ameaças, IPs bloqueados, lista de permissões, relatórios e análises.
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
O agent fica em agent/ e é o processo host Linux.
agent/main.go inicia o registro, o carregamento do eBPF, o rastreamento de largura de banda, a remediação, a pontuação, a agregação e o streaming de comandos de bloqueio.agent/ebpf/traffic_probe.c captura metadados de tráfego.agent/ebpf/xdp_firewall.c implementa a filtragem de pacotes XDP.agent/tc.go configura o rastreamento de largura de banda via TC.agent/aggregator.go agrupa e envia eventos ao backend.agent/history_store.go e agent/flush.go tratam a persistência local e o comportamento de retentativa.agent/remediation/ contém analisador, bloqueio automático, XDP, ipset e remediadores híbridos.O agent requer Linux e privilégios elevados para operações de eBPF/XDP.
O backend fica em backend/.
backend/cmd/api/main.go inicia a API HTTP Fiber e os serviços gRPC.backend/internal/api/ contém autenticação, handlers do dashboard, handlers gRPC, APIs de bloqueio, APIs de whitelist, tratamento de WebSocket e limitação de taxa.backend/internal/analysis/ contém workers de pontuação, gerenciamento de bloqueios, retenção de dados e lógica de relatórios mensais.backend/internal/database/ contém o código de acesso ao banco de dados gerado pelo sqlc.backend/internal/geoip/ trata o enriquecimento GeoIP.backend/internal/email/ envia e-mails via Mailtrap quando configurado.backend/migrations/ contém as migrações do PostgreSQL.O HTTP usa a porta 8080 por padrão; o gRPC usa a porta 9091 por padrão.
O dashboard fica em dashboard/ e é uma aplicação Vite React.
dashboard/src/pages/ inclui páginas de visão geral, servidores, detalhes do servidor, ameaças, alertas, relatórios, visualizador, IPs bloqueados, whitelist, login, perfil e callback OAuth.dashboard/src/components/ contém tráfego ao vivo, feed de bloqueios, gráficos, listas de servidores, configuradores e componentes de layout compartilhados.dashboard/src/api/client.ts define o cliente da API REST.dashboard/src/context/WebSocketContext.tsx gerencia atualizações de eventos ao vivo.O servidor de desenvolvimento está configurado para http://localhost:3000.
O site de marketing público fica em kerneleye-landing-page/. A imagem de frontend de produção compila tanto a landing page quanto o dashboard, e depois os serve através do nginx.
shared/scoring/ contém o módulo compartilhado de pontuação de ameaças usado tanto pelo agent quanto pelo backend.shared/cmdsigning/ contém o módulo de assinatura de comandos HMAC-SHA256 e proteção contra replay de nonce.proto/kerneleye/v1/ contém as definições protobuf para os serviços de ingestão e bloqueio.proto/gen/go/ contém o código Go protobuf gerado.O KernelEye não inspeciona payloads de pacotes nem conteúdo de aplicações.
Os metadados coletados incluem:
Não coletados:
A pontuação de ameaças é implementada em shared/scoring/scorer.go. O scorer atual é mais refinado do que uma única fórmula linear: ele considera taxa de SYN, acesso a portas únicas, handshakes falhos, comportamento de rajada, abuso de serviço, direção, confiança e decaimento da pontuação ao longo do tempo.
Limiares de classificação padrão:
< 20 normal
20-39 suspicious
>= 40 malicious
>= 40 eligible for auto-blocking when remediation is enabled
O worker de análise do backend também usa janelas de tráfego acumuladas e pode acionar o gerenciamento de bloqueio para fontes de alto risco.
O KernelEye oferece suporte à remediação ativa quando habilitada no agente.
| Camada | Implementação | Propósito |
|---|---|---|
| XDP | agent/remediation/xdp_remediator.go | Drops rápidos em nível de kernel antes da pilha de rede |
| IPSet | agent/remediation/ipset_remediator.go | Gerenciamento de bloqueio via ipset/iptables |
| Híbrido | agent/remediation/hybrid_remediator.go | Coordena o comportamento do XDP e do ipset |
| Auto-blocker | agent/remediation/auto_blocker.go | Bloqueia fontes acima dos limites de pontuação configurados |
| Gerenciador de bloqueio do backend | backend/internal/analysis/block_manager.go | Coordena o estado de bloqueio e os comandos gerados pelo backend |
O dashboard também expõe o gerenciamento de IPs bloqueados e da whitelist.
cp .env.example .env
Defina pelo menos:
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