2. eBPF 开发环境搭建：Linux 内核源码准备、LLVM/Clang 编译器安装、bpftool 与 libbpf 库安装、开发机与目标机分离部署方案

搭建一个稳定、可复现的 eBPF 开发环境是进行网络观测与延迟曲线分析的基础。本章将指导你完成从内核源码准备到编译器、工具链安装，再到生产环境分离部署的全流程。一个正确的环境能避免 90% 的编译与运行时错误，确保后续课程中的 eBPF 程序能够顺利挂载到网络栈并采集延迟数据。

2.1 环境概览与组件依赖

eBPF 开发环境的核心组件包括：Linux 内核源码（头文件与 BTF 信息）、LLVM/Clang 编译器（生成 BPF 字节码）、libbpf 库（用户态加载与交互）以及 bpftool（调试与 introspection）。下表列出了各组件的版本要求与核心作用：

2.2 Linux 内核源码准备

内核源码并非必须完整编译，但需要提供 内核头文件 和 BTF 信息 供 eBPF 程序引用。BTF 是 CO-RE 的核心依赖，它记录了内核数据结构的布局，使得 eBPF 程序无需在每台机器上重新编译。

2.2.1 安装内核头文件

# Ubuntu/Debian
sudo apt update
sudo apt install linux-headers-$(uname -r)

# CentOS/RHEL/Fedora
sudo yum install kernel-devel-$(uname -r)
# 或
sudo dnf install kernel-devel-$(uname -r)

2.2.2 获取 BTF 信息

BTF 信息通常内置于内核镜像中，位于 /sys/kernel/btf/vmlinux。如果该文件不存在，说明内核未开启 BTF 支持（常见于旧发行版）。此时需要手动生成或从内核源码中提取：

# 检查 BTF 是否存在
ls -lh /sys/kernel/btf/vmlinux

# 如果不存在，从内核源码生成（需要 pahole 工具）
# 进入内核源码目录
cd /usr/src/linux-headers-$(uname -r)
# 或下载对应版本内核源码
# 生成 BTF
sudo apt install dwarves
bpftool btf dump file /sys/kernel/btf/vmlinux format c > vmlinux.h

2.3 LLVM/Clang 编译器安装

LLVM/Clang 是编译 eBPF 程序的核心工具。eBPF 后端（BPF target）从 LLVM 11 开始稳定，推荐使用 LLVM 14+ 以获得更好的内联优化和调试信息支持。

2.3.1 通过包管理器安装（推荐）

# Ubuntu 20.04+
sudo apt install clang llvm

# 安装特定版本（如 LLVM 14）
wget https://apt.llvm.org/llvm.sh
chmod +x llvm.sh
sudo ./llvm.sh 14

# CentOS/RHEL 8+
sudo yum install llvm-toolset-14-clang llvm-toolset-14-llvm
# 或启用 EPEL 后
sudo dnf install clang llvm

2.3.2 验证编译器对 BPF 的支持

# 查看 LLVM 版本
clang --version

# 测试 BPF 编译
echo 'int main() { return 0; }' | clang -x c -target bpf -O2 -c - -o /dev/null
# 如果无报错，说明 BPF 后端可用

# 查看 BPF 目标支持列表
llc --version | grep bpf

2.4 bpftool 与 libbpf 库安装

bpftool 是调试和检查 BPF 程序/映射的瑞士军刀。libbpf 是用户态加载 eBPF 程序的标准库，也是 CO-RE 的核心实现者。

2.4.1 安装 bpftool

# 方法一：从发行版安装（推荐）
sudo apt install bpftool
# 或
sudo yum install bpftool

# 方法二：从内核源码编译
git clone --depth 1 https://github.com/torvalds/linux.git
cd linux/tools/bpf/bpftool
make
sudo make install

# 验证安装
bpftool --version
bpftool feature probe

2.4.2 安装 libbpf

# 方法一：作为 Git 子模块引入（推荐用于项目）
git submodule add https://github.com/libbpf/libbpf.git
cd libbpf/src
make
sudo make install

# 方法二：通过包管理器
sudo apt install libbpf-dev
# 或
sudo yum install libbpf-devel

# 验证头文件与库文件
ls /usr/include/bpf/libbpf.h
ls /usr/lib/x86_64-linux-gnu/libbpf.a

2.5 开发机与目标机分离部署方案

在生产环境中，开发机（编译 eBPF 程序）与目标机（运行 eBPF 程序）通常是分离的。CO-RE 技术使得这种分离成为可能：开发机编译出的 BPF 字节码可以在不同内核版本的目标机上运行，只要目标机提供 BTF 信息。

2.5.1 分离部署架构

下图展示了开发机与目标机分离部署的典型流程：

2.5.2 分离部署步骤清单

1. 开发机准备： 安装 LLVM/Clang、libbpf 开发库、内核头文件（或 vmlinux.h）。
2. 编译 eBPF 程序： 使用 clang -target bpf -O2 -g 编译源码，生成 .bpf.o 文件。
3. 打包制品： 将 .bpf.o 文件与用户态加载器（C/Rust/Go 程序）一起打包，上传到制品库。
4. 目标机部署： 从制品库拉取 BPF 字节码，使用 libbpf 加载到目标机内核。
5. 运行时验证： 使用 bpftool prog list 和 bpftool map dump 确认程序已挂载并开始采集延迟数据。

2.5.3 分离部署的注意事项

2.6 环境验证与快速测试

完成上述安装后，运行以下命令验证环境是否就绪：

# 1. 验证内核 BTF
ls /sys/kernel/btf/vmlinux && echo "BTF OK"

# 2. 验证 LLVM BPF 后端
echo 'int main() { return 0; }' | clang -x c -target bpf -O2 -c - -o /dev/null && echo "Clang BPF OK"

# 3. 验证 libbpf 编译
cat << 'EOF' > test_bpf.c
#include <linux/bpf.h>
#include <bpf/bpf_helpers.h>
SEC("xdp")
int xdp_pass(struct xdp_md *ctx) { return XDP_PASS; }
char _license[] SEC("license") = "GPL";
EOF
clang -target bpf -O2 -g -c test_bpf.c -o test_bpf.o && echo "BPF compile OK"

# 4. 验证 bpftool
bpftool prog list && echo "bpftool OK"