أمان على مستوى النواة واستجابة للهجمات لخوادم لينكس.
استخبارات حركة المرور على مستوى النواة ومعالجة التهديدات لخوادم Linux.
KernelEye هي منصة مراقبة أمنية ذاتية الاستضافة لخوادم Linux. تستخدم eBPF وTC وXDP في وكيل مكتوب بلغة Go لمراقبة بيانات الشبكة الوصفية، وتقييم النشاط المشبوه، وتطبيق المعالجة عبر الحظر على مستوى النواة باستخدام XDP وقواعد ipset/iptables. تخزّن خدمة خلفية مكتوبة بلغة Go الأحداث وتحللها، بينما توفر لوحة تحكم React إدارة الخوادم، وحركة المرور المباشرة، وعروض التهديدات، وعناوين IP المحظورة، والقوائم البيضاء، والتقارير، والتحليلات.
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
يقع الوكيل في agent/ وهو عملية المضيف على Linux.
agent/main.go التسجيل، وتحميل eBPF، وتتبّع النطاق الترددي، والمعالجة التصحيحية، والاحتساب، والتجميع، وبثّ أوامر الحظر.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، والمعالجات التصحيحية الهجينة.يتطلّب الوكيل نظام Linux وصلاحيات مرتفعة لعمليات eBPF/XDP.
يقع الخادم الخلفي في backend/.
backend/cmd/api/main.go واجهة برمجة تطبيقات Fiber HTTP وخدمات gRPC.backend/internal/api/ على المصادقة، ومعالجات لوحة التحكم، ومعالجات gRPC، وواجهات برمجة تطبيقات الحظر، وواجهات برمجة تطبيقات القائمة البيضاء، ومعالجة 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/ على تعريفات protobuf لخدمات الاستقبال والحظر.proto/gen/go/ على شيفرة protobuf المولّدة بلغة Go.لا يفحص 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، وOAuth من GitHub/Google، وMaxMind GeoIP.
cd backend
go mod download
go run cmd/api/main.go
يبدأ الـ backend:
http://localhost:8080localhost:9091cd 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