仅审计的 Linux eBPF 运行时传感器 - 容器逃逸检测,设计即加固。
19 个检测动作 · 24 个 BPF 程序 · BPF-LSM 解析路径规则 · IPv6 · 线格式 v4
支持本项目:
[!IMPORTANT] 仅检测与审计,不强制执行。 没有任何 BPF 程序返回
-EPERM; 任何系统调用都不会被阻止。这是一个运行时观测平面,而非 防御平面。参见docs/SECURITY.md和THREAT_MODEL.md。
| 🎯 金丝雀文件 | 在内核 O(1) 映射中植入不可见路径 - 任何触碰都会立即触发 CRITICAL 告警,包括 openat2 以及对不存在文件的探测 |
| 🛡️ 抗规避 | 挂钩 openat2 · unshare(CLONE_NEWUSER) 升级为 CRITICAL · 自我排除基于 PID(无法通过 prctl 伪造) · release_agent 在 /sys/fs/cgroup/ 下任意位置匹配 |
| 🧠 BPF LSM 模式 | 在活动 LSM 列表包含 bpf 的内核上,lsm/file_open 对内核解析后的路径(bpf_d_path)进行分类 - 一步关闭 io_uring 打开和用户字符串竞态;自动回退到 tracepoint |
| 🌐 全栈网络视野 | IPv4 和 IPv6 连接,可疑端口严重级别可配置 |
| 📈 内置可观测性 | 手写 Prometheus /metrics(零依赖)、Sensor_Heartbeat 合成告警用于 SIEM 静默检测、degraded/last_err 健康字段 |
| 🏥 自愈 | systemd Type=notify + WatchdogSec=30,以及基于 10 秒心跳的 K8s 存活探针 - 挂起的传感器会自行重启(已用 SIGSTOP 实测验证) |
| 🔐 最小权限部署 | privileged: false + 仅 CAP_BPF/PERFMON/SYS_ADMIN,seccomp RuntimeDefault,SIEM 令牌使用 Secrets,system-node-critical 优先级 |
| ⚡ 快速且轻量 | 空闲 CPU 约 0.7%,25,000 次 fork 下 0 次环形缓冲区丢弃,RSS 33–43 MB,零依赖 Go 守护进程 |
| 📤 SIEM 原生 | JSON · ECS 8.11 · OCSF 1.3.0 · CEF · LEEF 2.0 → file/stdout/syslog/HTTPS-webhook(Splunk HEC),支持批处理、重试和熔断 |
git clone https://github.com/0xmfbk/ebpf-container-escape-framework.git
cd ebpf-container-escape-framework
make check-env # read-only probe: toolchain, BTF, tracefs, LSM, systemd
sudo make deps # one-shot bootstrap: clang, libbpf, bpftool, Go 1.26+
make kernel userspace emulation
sudo -E make verify # full suite: 104 checks (97 core + 7 SIEM) on Debian/6.12
sudo ./install.sh # systemd service (hardened unit, config preserved)
要求:内核 ≥ 5.15,启用 CONFIG_DEBUG_INFO_BTF(/sys/kernel/btf/vmlinux),以 root 身份运行并具备 CAP_BPF CAP_PERFMON CAP_SYS_ADMIN 权限。make deps/make check-env 可在 Debian、Ubuntu 和 WSL2 上运行(docs/WSL2.md)。
| # | 动作 | 严重级别 | MITRE | 钩子 |
|---|---|---|---|---|
| 1 | Container_Namespace_Unshare | T1611 | kprobe __x64_sys_unshare - CLONE_NEWUSER 会升级为 | |
| 2 | Container_Pivot_Root_Escape | T1611 | kprobe __x64_sys_pivot_root | |
| 3 | Sensitive_File_Access | T1003.008 | /etc/shadow · 运行时套接字(docker/containerd/crio/k3s) | |
| 4 | Process_Execution | T1059.004 | sys_enter_execve | |
| 5 | Network_Connection | T1071 | sys_enter_connect - IPv4 + IPv6,可配置可疑端口 | |
| 6 | Process_Injection | T1055.008 | sys_enter_ptrace | |
| 7 | Log_Tampering | T1562.001 | unlinkat · truncate · rename/renameat/renameat2 · 写入意图打开(O_TRUNC/O_WRONLY) | |
| 8 | Ebpf_Tampering | T1562.001 | sys_enter_bpf(load/attach/link 命令) | |
| 9 | Perf_Event_Open | T1562.001 | sys_enter_perf_event_open (默认抑制) | |
| 10 | Suspicious_Mount | T1611 | sys_enter_mount | |
| 11 | Namespace_Switch | T1611 | sys_enter_setns | |
| 12 | Chroot_Escape | T1611 | sys_enter_chroot | |
| 13 | Executable_Memory | T1620 | sys_enter_mprotect(PROT_EXEC)(默认抑制) | |
| 14 | Core_Pattern_Modification | T1611 | core_pattern · modprobe · uevent_helper | |
| 15 | Cgroup_Release_Agent | T1611 | /sys/fs/cgroup/ 下的任意 release_agent/notify_on_release | |
| 16 | Canary_Triggered | T1552.001 | canary 映射命中 - 即使路径不存在也会触发 | |
| 17 | Memfd_Create | T1055.012 | sys_enter_memfd_create - 无文件载荷 | |
| 18 | Execveat | T1620 | sys_enter_execveat - fd/memfd 执行 | |
| 19 | Kernel_Module_Load | T1547.006 | sys_enter_init_module + finit_module |
文件路径规则的两类检测(动作 3、14、15、16):
open/openat/openat2 跟踪点上:即使目标文件不存在,它们也会在系统调用入口处触发——而在 cgroup-v2 主机上,探测 release_agent 本身就是攻击行为。bpf 时,由 lsm/file_open 负责(通过 bpf_d_path 获取内核解析的路径,包括 io_uring 打开操作),否则由跟踪点负责。无论哪种方式,每次打开操作都恰好产生一个事件。 KERNEL (24 programs)
├─ 23 syscall hooks (tracepoints + kprobes) ──► action_enabled gate
│ └─► PID self-exclusion → comm/cgroup filters
├─ lsm/file_open (optional, resolved paths) ──► canary O(1) map · path classifiers
└────────────────────────────► 1 MiB ringbuf · event_t v4 (224 B, zeroed)
│
USERSPACE (Go daemon, zero deps) │
ringbuf → bounded chan → enrich (container ID · cgroup path · lineage ≤16 ·
K8s pod/ns/SA via LRU caches) → per-action token bucket → severity/MITRE
→ encoder (JSON/ECS/OCSF/CEF/LEEF) → sink (file/syslog/webhook) + Prometheus
heartbeat 10s → systemd watchdog · K8s probes · Sensor_Heartbeat → SIEM