ebpf-docs libxdp 教程:XDP 程序加载、Dispatcher 与 AF_XDP Socket 管理完整指南

原创2026-11-15 13:49:002,251 阅读

ebpf-docs libxdp 教程:XDP 程序加载、Dispatcher 与 AF_XDP Socket 管理完整指南

📚 ebpf-docs 是一个致力于"全面文档化 eBPF"的开源项目,本教程带你快速掌握其中的 libxdp 教程:如何加载 XDP 程序、用 Dispatcher 在单网卡上运行多个 XDP 程序,以及完成 AF_XDP Socket 管理——从 UMEM 创建到环形缓冲区收发包,一篇读懂。

什么是 libxdp?

libxdp 是一个轻量级 eBPF 库,专为 XDP 程序 提供了两大核心能力:

  • 🎯 多程序管理:借助 freplace 机制,通过一个"Dispatcher(调度器)"程序在单个网卡上加载并链式调用多个 XDP 程序;
  • ⚡ AF_XDP 支持:封装了 AF_XDP Socket 的创建、UMEM 内存配置与高速收发函数(该功能自 libbpf 1.0 起已完全迁移到 libxdp)。

XDP(Express Data Path)程序挂载在网卡收包路径的最前端,在内存分配之前就处理数据包,因此特别适合 DDoS 防护、负载均衡、高吞吐包过滤等场景。

libxdp 的完整概念文档见 libxdp.md,全部 40+ 个 API 的索引见 SUMMARY.md。

XDP 程序加载:六步从 ELF 到网卡

新手最常问的问题是:"编译好的 XDP 程序(.o 文件)怎么装到网卡上?" libxdp 提供了一组 xdp_program__* 加载函数:

场景 函数 说明
从 ELF 文件打开 xdp_program__open_file 最常用的加载入口,可指定 section 名
按路径查找 xdp_program__find_file 默认在 /usr/lib/bpf 搜索(可用 LIBXDP_OBJECT_PATH 覆盖)
从已加载对象获取 xdp_program__from_bpf_obj 从 bpf_object 中取出程序
从文件描述符 xdp_program__from_fd 复用已打开的 fd
从内核程序 ID xdp_program__from_id 按 prog ID 定位
从 pin 恢复 xdp_program__from_pin 从 bpffs 固定点恢复

加载之后,libxdp 会自动完成 attach 到网卡的流程;如果内核支持多程序特性且只有一个程序,它会退化为"单程序直接加载",无需 Dispatcher。

Dispatcher 多程序调度:优先级与链式调用 🎛️

要在同一张网卡上跑多个非 offload 的 XDP 程序(比如一个 DDoS 过滤器 + 一个流量统计器),libxdp 会插入一个 Dispatcher 程序作为统一入口,按顺序调用各个"组件程序"。它的关键规则有两条:

  1. 优先级(Priority):程序按 priority 从小到大排序执行,默认值为 50;
  2. 链式调用动作(Chain call action):程序必须返回"链式动作"(如 XDP_PASS、XDP_DROP)才允许继续执行下一个程序,否则处理链立即终止。默认链式动作为 XDP_PASS。

用 metadata 控制执行顺序

组件程序的优先级和链式行为可以在 eBPF 侧通过 metadata 声明(来自 libxdp.md):

struct {
    __uint(priority, 10);  // 优先级
    __uint(XDP_PASS, 1);   // 允许链式调用的动作
} XDP_RUN_CONFIG(my_xdp_func);

也可以在用户态通过 xdp_program__set_run_prio 和 xdp_program__set_chain_call_enabled 设置(⚠️ 注意:必须在 attach 之前修改,否则不生效)。

Dispatcher 的 pinning 机制

内核在组件程序失去最后一个引用时会自动将其从 Dispatcher 摘除。为防止这种情况,libxdp 会在 attach 前把组件程序 pin 到 bpffs(BPF 文件系统),路径形如:

  • /sys/fs/bpf/xdp/dispatch-IFINDEX-DID:Dispatcher 程序本体
  • …/prog0-prog、…/prog0-link:组件程序 0 的引用与 bpf_link 引用

一个 Dispatcher 最多挂载 10 个组件程序。相关查询接口包括 xdp_multiprog__get_from_ifindex(按网卡获取现有 Dispatcher)和 xdp_multiprog__detach 等。

💡 小贴士:可用 LIBXDP_BPFFS 环境变量覆盖 bpffs 挂载点;若未挂载 bpffs,可设置 LIBXDP_BPFFS_AUTOMOUNT=1 让 libxdp 自动挂载。

AF_XDP Socket 管理:控制面四步走 🧩

AF_XDP(XSK,XDP Socket)让数据包绕过内核网络栈直接进入用户态,是自定义协议、DDoS 深度检测等场景的高性能通道。libxdp 把繁琐的内核细节封装成两类 API:

第一步:创建 UMEM 内存区

UMEM 是存放所有收/发包数据的用户态内存区,可视为一个大 chunk 数组。核心函数:

第二步:创建并关联 Socket

UMEM 就绪后,创建与之关联的 AF_XDP Socket:

第三步:加载并绑定 XDP 程序

用 xsk_setup_xdp_prog 把 XDP 程序挂到网卡上;若网卡已有程序,libxdp 会尝试替换。

第四步:更新 XSKMAP

通过 xsk_socket__update_xskmap 把 Socket 注册进 XSKMAP——XDP 程序正是靠这张 map 把数据包重定向到正确的用户态 Socket。

数据面:四种环形缓冲区高效收发 🔁

AF_XDP 的数据面由 4 个 FIFO 环形缓冲区组成,libxdp 全部以 static inline 函数形式提供:

环 类型 作用 核心函数
Fill 环 生产者 向内核提供空闲 buffer xsk_ring_prod__reserve → fill_addr → submit
TX 环 生产者 发送数据包 xsk_ring_prod__tx_desc、needs_wakeup
RX 环 消费者 从内核接收数据包 xsk_ring_cons__peek → rx_desc → release
Completion 环 消费者 确认已发送包的完成 xsk_ring_cons__comp_addr

生产者环的节奏是:reserve(预留槽位)→ 填充 → submit(提交给内核)。 消费者环的节奏是:peek(窥视新数据)→ 读取 → release(归还给内核);若不想消费全部,还可调用 xsk_ring_cons__cancel 取消本次 peek。

新手常见问题 FAQ

  • Q:网卡驱动不支持 AF_XDP 怎么办? AF_XDP 需要驱动在普通 XDP 支持之上提供额外支持。可先查阅 XDP 程序类型文档 中的驱动支持表确认兼容性。

  • Q:bpffs 没挂载,多程序还能用吗? 可以。若内核不支持多程序特性所需能力,libxdp 会自动退化为"单程序直接加载"模式(可通过 xdp_multiprog__is_legacy 判断)。

  • Q:metadata 修改为什么没生效? xdp_program__set_run_prio 等接口只能在 attach 之前调用,attach 之后再改不会起作用。

延伸阅读与仓库资源 📖

资料 路径
libxdp 概念总览 docs/ebpf-library/libxdp/libxdp.md
libxdp API 完整索引 docs/ebpf-library/libxdp/SUMMARY.md
AF_XDP 概念详解 docs/linux/concepts/af_xdp.md
XDP 程序类型与返回值 docs/linux/program-type/BPF_PROG_TYPE_XDP.md
XSKMAP 映射表 docs/linux/map-type/BPF_MAP_TYPE_XSKMAP.md
库函数 YAML 数据源 data/libxdp-functions.yaml

掌握 XDP 程序加载、Dispatcher 多程序调度与 AF_XDP Socket 管理,你就具备了高性能网络数据面开发的核心拼图——配合 ebpf-docs 中的 libbpf 用户态 API 文档 继续深入吧!🚀

登录后查看全文
ebpf-docs