ebpf-docs XDP 实战:如何用 eBPF 编写高性能丢包过滤与 DDoS 防护程序

原创2026-11-15 10:12:581,982 阅读

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 程序,常见积木如下:

  1. per-IP 频率计数:用 BPF_MAP_TYPE_PERCPU_HASH 以源 IP 为 key 记录计数器。per-CPU 布局避免了多核竞争,是高频路径上的标准做法。
  2. 超阈值即丢:计数超过阈值直接 XDP_DROP,同时用 ring buffer 把"被限流的 IP"事件异步通知用户态,便于封禁决策。
  3. SYN Flood 对策:对 TCP SYN 洪水,XDP 层可直接调用 bpf_tcp_raw_gen_syncookie_ipv4 生成 SYN cookie,不依赖半连接队列,从根上缓解 SYN Flood。
  4. 可观测性:通过 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_exception tracepoint 并写 trace log,开销大;只适合调试。
  • 丢弃要留痕:XDP_DROP 后 tcpdump 抓不到包,务必建立自定义的丢包计数通道。

📚 延伸阅读

掌握以上内容,你就已经具备了编写生产级 XDP 丢包过滤与 DDoS 防护程序的全部知识骨架——剩下的,就是去 ebpf-docs 里按图索骥了。🚀

登录后查看全文
ebpf-docs