比 eBPF 更简单?用 Lunatik 的 XDP 与 TC 钩子在 Lua 中捕获、过滤网络数据包

原创2026-11-15 10:23:531,712 阅读

比 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 把网络数据包捕获与过滤的门槛降到了脚本级别 🚀

登录后查看全文
lunatik