ebpf-docs XDP 实战:如何用 eBPF 编写高性能丢包过滤与 DDoS 防护程序
ebpf-docs XDP 实战:如何用 eBPF 编写高性能丢包过滤与 DDoS 防护程序
ebpf-docs 是一个致力于全面文档化 eBPF 技术的开源项目。本文基于该项目文档,带你认识 eBPF 的 XDP 程序类型,讲解如何用 XDP 实现高性能丢包过滤与 DDoS 防护——包括 5 种返回动作、IP 黑名单的 LPM Trie 实现、频率限制思路、三种挂载模式,以及新手最容易踩的坑。
🚀 什么是 XDP?为什么它是丢包过滤的最优解
XDP(eXpress Data Path)是 Linux 内核提供的一种 eBPF 程序类型,它可以挂载到网卡上,对每一个入站数据包进行处理。XDP 的最大特点是调用时机极早:在分配 socket buffer(skb)之前就介入。
这一点正是高性能的关键:
| 方案 | 调用时机 | 丢弃一个包的代价 |
|---|---|---|
| iptables / 普通 netfilter | 协议栈深处 | 先分配 skb、走完整栈再丢弃 |
| BPF_PROG_TYPE_SCHED_CLS | skb 已分配之后 | 分配了 skb 才丢弃 |
| XDP | skb 分配之前 | 几乎零浪费,接近线速丢弃 |
官方文档对 XDP 的典型场景描述就是:DDoS 防护、负载均衡、高吞吐包过滤。当大量流量需要被丢弃或转发时,XDP 能在其他技术"先分配内存再丢弃"的地方省下巨大的开销。📦
📖 完整参考:BPF_PROG_TYPE_XDP 文档(含驱动支持表与 MTU 上限表)
🛡️ XDP 的 5 种返回动作:丢包、放行与重定向
XDP 程序被内核以 xdp_md 上下文调用,返回值决定内核如何处理当前包:
| 返回动作 | 行为 | 典型用途 |
|---|---|---|
XDP_DROP |
直接丢弃数据包 | 黑名单 IP、畸形包过滤(本文主角) |
XDP_PASS |
交给内核网络栈继续处理 | 放行正常流量 |
XDP_TX |
从原接口原路发回 | 回送、反射攻击拦截 |
XDP_REDIRECT |
重定向到设备 / CPU / 用户态 | 负载均衡、AF_XDP 收包 |
XDP_ABORTED |
标记不可恢复错误 | 调试(生产环境慎用,开销大) |
两个新手必读的细节:
XDP_DROP的包对tcpdump不可见(丢弃得太早了)。想保持"可见性",建议配合 bpf_ringbuf_output 把丢弃事件上报到用户态做统计。XDP_REDIRECT必须配合 bpf_redirect_map 等 helper 使用,通常搭配 BPF_MAP_TYPE_DEVMAP 实现跨接口转发。
📝 编写第一个 XDP 丢包过滤器
XDP 程序约定放入名为 xdp 的 ELF section(section 命名规则见 SEC 文档)。一个最小可用的过滤器骨架如下:
SEC("xdp")
int xdp_filter(struct xdp_md *ctx)
{
void *data = (void *)(long)ctx->data;
void *data_end = (void *)(long)ctx->data_end;
/* 越界检查必须交给 verifier 验证:data <= ptr < data_end */
if (data + sizeof(struct ethhdr) > data_end)
return XDP_DROP;
/* ...解析以太网头、IP 头,按策略 DROP 或 PASS... */
return XDP_PASS;
}
xdp_md 上下文的常用字段(详见 XDP 文档的 Context 小节):
data/data_end:包数据首尾指针,每次读取前必须做边界检查,verifier 会强制要求;ingress_ifindex:包从哪个接口进来;rx_queue_index:网卡上的接收队列编号(可据此做 per-CPU 无锁计数)。
🎯 用 LPM Trie 构建高效的 IP 黑名单 / 白名单
"这个源 IP 在不在黑名单里?"是 DDoS 防护的核心问题。逐条比较地址太慢,而 BPF_MAP_TYPE_LPM_TRIE(最长前缀匹配)正好为 IP 网段而生:
- 插入
10.0.0.0/8、10.0.10.0/24、10.0.10.123/32三条规则后,查询10.0.10.200会命中更具体的/24,查询10.12.0.1命中/8,其余流量查不到——一次查表即可完成整个 CIDR 黑名单判断。 - key 结构很简单:前 4 字节是前缀长度(CIDR 里的
/N),后面是地址本身。 - 用户态可以随时通过
bpf()系统调用增删网段规则,无需重新加载 eBPF 程序——攻防场景下这条链路极其重要。
如果黑名单极大、且允许极低的误判率,还可以先过一层 BPF_MAP_TYPE_BLOOM_FILTER(布隆过滤器,O(1) 判定、内存占用极小)做快速预筛,命中后再查精确数据结构。🔍
⚡ DDoS 防护进阶思路:频率限制与 SYN Cookie
在 XDP 层构建一个完整的防 DDoS 程序,常见积木如下:
- per-IP 频率计数:用 BPF_MAP_TYPE_PERCPU_HASH 以源 IP 为 key 记录计数器。per-CPU 布局避免了多核竞争,是高频路径上的标准做法。
- 超阈值即丢:计数超过阈值直接
XDP_DROP,同时用 ring buffer 把"被限流的 IP"事件异步通知用户态,便于封禁决策。 - SYN Flood 对策:对 TCP SYN 洪水,XDP 层可直接调用 bpf_tcp_raw_gen_syncookie_ipv4 生成 SYN cookie,不依赖半连接队列,从根上缓解 SYN Flood。
- 可观测性:通过 bpf_ringbuf_output 输出丢包事件,弥补
tcpdump看不到XDP_DROP包的盲区。
查表用 bpf_map_lookup_elem / 更新用 bpf_map_update_elem,这两个 helper 均在 XDP 程序类型的可用列表中(完整列表见 XDP 文档的 Helper functions 小节)。
🖧 三种挂载模式:Native、Generic 与 Offload
XDP 程序有三种挂载方式(对应不同 flags),性能与兼容性各不相同:
| 模式 | Flag | 说明 |
|---|---|---|
| Native(驱动模式) | XDP_FLAGS_DRV_MODE |
在驱动收包路径最早处执行,性能最佳;需要驱动支持(mlx5、virtio、ixgbe、ice 等主流驱动均已支持,完整列表见驱动支持表) |
| Generic(SKB 模式) | XDP_FLAGS_SKB_MODE |
在 skb 分配后执行,任何驱动都可用,但损失了 XDP 的速度优势;官方建议此时改用 BPF_PROG_TYPE_SCHED_CLS(能力更多、性能相近) |
| 硬件 Offload | XDP_FLAGS_HW_MODE |
卸载到网卡硬件执行,目前仅个别厂商(如 Netronome)支持,且功能子集受限 |
两个前置条件(来自文档中的 warning,务必检查)⚠️:
- 硬件 GRO / LSO 必须关闭,否则挂载报
-EINVAL:ethtool -K {ifname} lro off gro off - 非 frags 模式的 XDP 有最大 MTU 限制(1500~4096 之间,取决于驱动)。若接口 MTU 高于上限,程序无法挂载。精确上限可查阅 XDP 文档中的 Max MTU 表格,仓库中还提供了 tools/mtu-calc 用于按公式自行计算。
🔧 挂载程序与多程序协作
挂载:libbpf 提供 bpf_program__attach_xdp,传入程序对象与接口 ifindex 即可,返回一个 bpf_link 用于管理生命周期(关闭 link fd 即卸载)。
多程序链:同一网卡上经常需要多个策略并存(如一个做黑名单、一个做 QoS)。libxdp 通过一个"dispatcher"程序把多个 XDP 组件程序按优先级链式调用,各组件返回 XDP_PASS / XDP_DROP 等动作决定是否继续执行后续程序;它还提供 AF_XDP 套接字配置能力。相关 API 一览见 libxdp functions 索引。
🧭 新手避坑清单
- MTU 超限:网卡 MTU 大于驱动 XDP 上限时挂载失败,netlink 方式挂载时内核会在 netlink 调试消息里给出确切上限。
- GRO/LSO 未关:最常见的挂载报错原因之一,先跑
ethtool -K检查。 - VLAN offload:开启硬件 VLAN 卸载时,XDP 看到的以太网头不带 VLAN 标签(VLAN 被驱动剥离到 skb 字段中)。可用
ethtool -k <dev> | grep vlan-offload检查。 - 生产环境别返回
XDP_ABORTED:它会触发xdp_exceptiontracepoint 并写 trace log,开销大;只适合调试。 - 丢弃要留痕:
XDP_DROP后 tcpdump 抓不到包,务必建立自定义的丢包计数通道。
📚 延伸阅读
- BPF_PROG_TYPE_XDP 完整文档:上下文字段、flags、驱动支持、MTU 上限
- BPF_PROG_TYPE_SCHED_CLS:XDP 不可用时的替代方案
- BPF_MAP_TYPE_LPM_TRIE / BPF_MAP_TYPE_BLOOM_FILTER:黑名单与快速预筛的数据结构
- libxdp 文档:多程序 dispatcher 与 AF_XDP
- AF_XDP 概念:XDP + 用户态零拷贝收包的进阶之路
掌握以上内容,你就已经具备了编写生产级 XDP 丢包过滤与 DDoS 防护程序的全部知识骨架——剩下的,就是去 ebpf-docs 里按图索骥了。🚀