3. eBPF 开发环境搭建：内核版本要求、LLVM/Clang 工具链、libbpf 与 bcc 框架选择、开发容器配置

搭建一个稳定、可复现的 eBPF 开发环境是进行租户隔离与流量可视化开发的前提。本章将系统梳理内核版本约束、编译工具链选型、两大主流框架（BCC 与 libbpf）的适用场景，并给出基于 Docker 的开发容器配置方案，确保团队在不同主机上获得一致的构建行为。

3.1 内核版本与编译特性要求

eBPF 程序直接运行在内核虚拟机中，因此内核版本决定了可用的 BPF 辅助函数、Map 类型以及 CO-RE（Compile Once – Run Everywhere）支持程度。下表列出关键版本节点：

3.2 LLVM / Clang 工具链

eBPF 程序使用 C 编写，通过 LLVM 后端编译为 BPF 字节码。Clang 是当前唯一稳定支持 BPF 目标的编译器。关键版本要求如下：

• Clang ≥ 11：支持 -g 生成 BTF 信息，是 CO-RE 编译的硬性要求。
• Clang ≥ 14：支持 __attribute__((preserve_access_index))，简化结构体字段偏移重定位。
• llvm-strip / llvm-objcopy：用于剥离非 BPF 段，减小 ELF 体积。

# 验证工具链版本
clang --version | head -1
llc --version | grep "LLVM version"

# 编译一个最小 eBPF 程序（CO-RE 模式）
clang -g -O2 -target bpf -D__TARGET_ARCH_x86 \
  -I/usr/include/x86_64-linux-gnu \
  -c minimal.bpf.c -o minimal.bpf.o

3.3 libbpf 与 BCC 框架选择

两个框架在开发体验、运行时依赖和部署形态上有本质差异。下表从租户隔离场景出发进行对比：

3.4 开发容器配置（Dockerfile）

为消除“在我机器上能编译”的差异，推荐使用统一开发容器。以下 Dockerfile 基于 Ubuntu 22.04，集成 Clang 15、libbpf 库、bpftool 及 Go 工具链（用于用户态加载器）：

FROM ubuntu:22.04 AS bpf-builder

ENV DEBIAN_FRONTEND=noninteractive

# 安装系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    clang-15 \
    llvm-15 \
    lld-15 \
    libelf-dev \
    linux-tools-common \
    linux-tools-generic \
    pkg-config \
    git \
    make \
    cmake \
    wget \
    ca-certificates \
    && rm -rf /var/lib/apt/lists/*

# 设置 clang-15 为默认
RUN update-alternatives --install /usr/bin/clang clang /usr/bin/clang-15 100 \
    && update-alternatives --install /usr/bin/llc llc /usr/bin/llc-15 100

# 编译安装 libbpf（从源码获取最新稳定版）
RUN git clone --depth 1 --branch v1.4.0 https://github.com/libbpf/libbpf.git /tmp/libbpf \
    && cd /tmp/libbpf/src \
    && make -j$(nproc) \
    && make install \
    && ldconfig

# 安装 bpftool
RUN git clone --depth 1 --branch v7.4.0 https://github.com/libbpf/bpftool.git /tmp/bpftool \
    && cd /tmp/bpftool/src \
    && make -j$(nproc) \
    && make install

# 安装 Go（用于用户态加载器）
RUN wget -q https://go.dev/dl/go1.22.2.linux-amd64.tar.gz \
    && tar -C /usr/local -xzf go1.22.2.linux-amd64.tar.gz \
    && rm go1.22.2.linux-amd64.tar.gz
ENV PATH=$PATH:/usr/local/go/bin

WORKDIR /workspace

3.5 开发环境架构总览

下图展示了从源码到内核加载的完整工具链与数据流：

3.6 快速验证环境

进入开发容器后，执行以下步骤确认环境就绪：

1. 检查内核 BTF：ls -lh /sys/kernel/btf/vmlinux（应存在且非空）。
2. 编译测试 BPF 程序：使用 libbpf 的 minimal.bpf.c 示例编译，无报错。
3. 运行 bpftool：bpftool feature probe 列出内核支持的 BPF 特性。
4. 加载并查看 Map：bpftool map list 确认无权限错误。