比 eBPF 更简单?用 Lunatik 的 XDP 与 TC 钩子在 Lua 中捕获、过滤网络数据包
比 eBPF 更简单?用 Lunatik 的 XDP 与 TC 钩子在 Lua 中捕获、过滤网络数据包
Lunatik 是一个用 Lua 脚本化 Linux 内核的框架。借助它的 XDP 与 TC 钩子,你可以在 Lua 里直接捕获、过滤网络数据包,无需手写 C 语言 eBPF 程序,几行脚本就能让内核按你的规则放行或丢弃流量。
为什么用 Lua 写网络钩子
传统 eBPF 开发要面对 C 语言、编译器、verifier 规则,门槛不低。Lunatik 把内核能力封装成 Lua 模块:你 require("xdp") 或 require("tc"),定义一个返回 verdict 的函数,挂上钩子即可。
核心差异:
- XDP 钩子:工作在驱动层,包还没进协议栈就处理,性能最高,适合丢包、限速、SNI 过滤。
- TC 钩子:挂在设备收发路径上,可用
SHOT丢包、REDIRECT重定向,适合转发与后处理。 - Lua 即程序:普通内核脚本运行在内核态的 Lua 运行时;
lunatik bpf还能把部分 Lua 函数编译成原生 eBPF。
XDP 与 TC 的 C 侧实现在 lib/luaxdp.c 和 lib/luatc.c,Lua 侧的调用逻辑则由内核脚本驱动。
快速安装 Lunatik
在 Linux 6.6+ 上编译安装:
git clone --depth 1 --recurse-submodules https://gitcode.com/gh_mirrors/lu/lunatik
cd lunatik && sudo make btf_install && make && sudo make install
完成后 sudo lunatik 会打开一个 REPL,每一行代码都在内核中执行。更多依赖与 OpenWRT 说明见 doc/guide/01-getting-started.md。
用 XDP 钩子丢包(5 行脚本)
XDP 钩子的写法极其直观:定义一个接收 ctx 的函数,返回 action.DROP 或 action.PASS,然后 xdp.attach。
local xdp = require("xdp")
local action = require("linux.xdp").action
local function on_packet(ctx)
return action.DROP -- 丢弃所有到达的包
end
xdp.attach(on_packet)
这段逻辑与仓库测试 tests/xdp/drop.lua 完全一致。用以下命令加载:
sudo lunatik run --dev=eth0 tests/xdp/drop
返回值语义:XDP 程序里 PASS/DROP/TX/REDIRECT/ABORTED 都按内核定义生效;返回其它值会丢包并在内核日志告警一次。详细说明见 doc/guide/08-luaebpf.md。
用 TC 钩子转发或丢包
TC 钩子把包交给流量控制框架,verdict 语义略不同:OK 放行、SHOT 丢包、REDIRECT 重定向,其它值交由后续 TC 程序处理。
local tc = require("tc")
local action = require("linux.tc").action
local function on_packet(ctx)
return action.SHOT -- 丢弃
end
tc.attach(on_packet)
对应示例在 tests/tc/drop.lua,测试目录还有 pass.lua、forward.lua、checksum.lua 等覆盖各种场景。
实战:Lua 过滤 HTTPS SNI 黑名单
更有趣的用法是解析包内容。仓库自带示例 filter:用 XDP/eBPF 程序从帧中定位 TLS ClientHello,再由 Lua 内核脚本解析 SNI,命中黑名单即丢包。核心逻辑在 examples/filter/sni.lua:
local function filter_sni(ctx)
local host = sni(ctx:packet(), offset(ctx:argument()))
if host then
local verdict = blacklist[host] and "DROP" or "PASS"
log(host, verdict)
return action[verdict]
end
return action.PASS
end
xdp.attach(filter_sni)
运行与验证步骤(默认拉黑 ebpf.io)见 examples/filter/README.md:
sudo lunatik run --context=softirq --percpu examples/filter/sni
sudo bpftool net attach xdp pinned /sys/fs/bpf/lunatik_filter dev <ifname>
XDP 与 TC 如何选择
| 维度 | XDP 钩子 | TC 钩子 |
|---|---|---|
| 执行位置 | 驱动层,最早 | 协议栈收发路径 |
| 性能 | 最高,零拷贝 | 略低,功能更全 |
| 典型用途 | 丢包、限速、DDoS 防御、SNI 过滤 | 转发、重定向、校验和修改 |
| verdict | PASS/DROP/TX/REDIRECT/ABORTED |
OK/SHOT/REDIRECT |
| Lua 模块 | require("xdp") |
require("tc") |
经验法则:能用 XDP 解决的性能敏感问题优先 XDP;需要精细流控、重定向到其它队列时选 TC。
进阶:把 Lua 编译成原生 eBPF
lunatik bpf 可以把程序文件中的函数编译成 eBPF,内核原生执行,Lua 运行时只负责声明 map 与挂载。编译与挂载:
sudo lunatik bpf -o /lib/modules/lua/protocols.bpf.o protocols.bpf.lua
sudo lunatik run --dev=eth0 protocols
每个语法结构最终编译成什么 eBPF 指令,完整示例见 doc/guide/09-luaebpf-by-example.md。
小结
- Lunatik 让 XDP 与 TC 钩子摆脱 C 语言束缚,Lua 几行即可上线网络过滤逻辑。
- XDP 适合极致性能场景,TC 适合转发与后处理,按需求选择。
- 框架自带大量测试与示例,tests/xdp/ 与 tests/tc/ 是最好的上手教材。
从「写 C + 调 verifier」到「写 Lua + 直接运行」,Lunatik 把网络数据包捕获与过滤的门槛降到了脚本级别 🚀