3. eBPF开发环境搭建：内核版本要求、LLVM/Clang工具链、BCC与libbpf库、开发容器构建

搭建一个稳定、可复现的eBPF开发环境是进行网络观测与容器性能分析的前提。本章将系统梳理内核版本约束、编译工具链选型、两大主流库（BCC与libbpf）的差异，并最终通过容器化方案实现环境标准化。

3.1 内核版本与配置要求

eBPF程序直接运行在内核中，因此内核版本和编译选项决定了可用的特性集。下表列出关键内核版本对应的eBPF里程碑：

3.2 LLVM/Clang工具链

eBPF程序通常使用C语言编写，并由LLVM/Clang编译为BPF字节码。Clang后端直接支持BPF目标架构，无需额外交叉编译链。

• 最低版本： LLVM 10+（推荐 LLVM 14+ 以获得更好的BPF内联与优化支持）。
• 安装方式（Ubuntu 22.04 示例）：

# 安装完整LLVM/Clang工具链
sudo apt-get update
sudo apt-get install -y llvm clang

# 验证BPF目标支持
llc --version | grep bpf
# 输出应包含 "bpf" 或 "bpfel" 目标

• 关键组件：

3.3 BCC与libbpf库：选型对比

BCC（BPF Compiler Collection）和libbpf是当前最主流的两个eBPF开发库。它们的设计哲学和适用场景有显著差异。

3.4 开发容器构建（Dockerfile）

为了消除“在我机器上能跑”的环境差异，我们构建一个包含完整eBPF工具链的开发容器。该容器基于Ubuntu 22.04，集成LLVM 14、libbpf、bpftool及BCC可选组件。

# Dockerfile.eBPF-dev
FROM ubuntu:22.04 AS base

ENV DEBIAN_FRONTEND=noninteractive

# 安装系统依赖
RUN apt-get update && apt-get install -y \
    git \
    build-essential \
    cmake \
    linux-tools-common \
    linux-tools-generic \
    linux-headers-$(uname -r) \
    clang-14 \
    llvm-14 \
    lld-14 \
    libelf-dev \
    zlib1g-dev \
    pkg-config \
    python3 \
    python3-pip \
    && rm -rf /var/lib/apt/lists/*

# 安装bpftool（从源码编译以获得最新版本）
RUN git clone --depth 1 --branch v7.3.0 https://github.com/libbpf/bpftool.git /tmp/bpftool \
    && cd /tmp/bpftool/src \
    && make \
    && make install \
    && rm -rf /tmp/bpftool

# 安装libbpf（静态库 + 头文件）
RUN git clone --depth 1 --branch v1.3.0 https://github.com/libbpf/libbpf.git /tmp/libbpf \
    && cd /tmp/libbpf/src \
    && make \
    && make install \
    && rm -rf /tmp/libbpf

# 安装BCC（可选，用于快速原型）
RUN apt-get update && apt-get install -y bpfcc-tools \
    && rm -rf /var/lib/apt/lists/*

# 设置Clang/LLVM默认版本
RUN update-alternatives --install /usr/bin/clang clang /usr/bin/clang-14 100 \
    && update-alternatives --install /usr/bin/llc llc /usr/bin/llc-14 100

WORKDIR /workspace
CMD ["/bin/bash"]

docker build -t ebpf-dev:latest -f Dockerfile.eBPF-dev .
docker run -it --privileged --pid=host --network=host \
  -v /sys/kernel/btf:/sys/kernel/btf:ro \
  -v /sys/kernel/debug:/sys/kernel/debug:rw \
  ebpf-dev:latest

3.5 环境验证与架构总览

以下SVG图展示了开发容器内部各组件之间的协作关系，以及从C源码到内核eBPF程序的完整编译-加载链路。

3.6 快速验证脚本

进入开发容器后，执行以下脚本验证环境是否就绪：

#!/bin/bash
# verify_ebpf_env.sh

echo "=== 1. 内核版本 ==="
uname -r

echo "=== 2. BTF 支持 ==="
ls -la /sys/kernel/btf/vmlinux && echo "BTF OK" || echo "BTF MISSING"

echo "=== 3. Clang/LLVM 版本 ==="
clang --version | head -1
llc --version | grep bpf

echo "=== 4. bpftool 版本 ==="
bpftool --version

echo "=== 5. libbpf 头文件 ==="
ls /usr/include/bpf/libbpf.h && echo "libbpf OK" || echo "libbpf MISSING"

echo "=== 6. 编译测试（最小BPF程序） ==="
cat << 'EOF' > /tmp/test.bpf.c
#include <linux/bpf.h>
#include <bpf/bpf_helpers.h>
SEC("kprobe/sys_clone")
int test_prog(void *ctx) { return 0; }
char _license[] SEC("license") = "GPL";
EOF
clang -O2 -target bpf -c /tmp/test.bpf.c -o /tmp/test.bpf.o && echo "编译成功" || echo "编译失败"