Linuxサーバー向けのカーネルレベルのセキュリティと攻撃対応
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 のロード、帯域幅追跡、修復、スコアリング、集約、ブロックコマンドのストリーミングを開始します。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 サービスと block サービスの 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 を設定し、少なくとも 1 つの 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 で生成してください。