2. 环境准备：Linux内核版本要求、bpftrace安装方法与权限配置

在开始系统调用延迟的微秒级分析之前，必须搭建一个符合要求的环境。bpftrace 依赖于内核的 BPF 基础设施，因此内核版本、编译选项、安装方式以及权限配置是本章节的核心内容。以下内容将帮助你快速、正确地准备好实验环境。

2.1 内核版本与编译要求

bpftrace 需要 Linux 内核支持 eBPF (extended Berkeley Packet Filter) 功能。不同内核版本对 BPF 特性的支持程度不同，建议使用较新的长期支持（LTS）内核以获得最佳兼容性。

除了版本号，内核还需要开启以下编译选项（通常主流发行版默认已开启）：

• CONFIG_BPF=y — 启用 BPF 子系统
• CONFIG_BPF_SYSCALL=y — 启用 bpf() 系统调用
• CONFIG_KPROBES=y — 内核动态插桩
• CONFIG_UPROBES=y — 用户态动态插桩
• CONFIG_DEBUG_INFO_BTF=y — BPF 类型格式（推荐）

2.2 bpftrace 安装方法

bpftrace 支持多种安装方式，包括包管理器安装和源码编译。对于大多数用户，推荐使用发行版官方仓库或 bpftrace 官方提供的安装脚本。

2.2.1 使用包管理器安装（推荐）

2.2.2 使用官方安装脚本（跨发行版）

bpftrace 官方提供了自动化安装脚本，适用于大多数 Linux 发行版：

# 下载并运行官方安装脚本
sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/bpftrace/bpftrace/master/scripts/install.sh)"

该脚本会自动检测发行版并选择合适的安装方式（apt、yum、dnf 或源码编译）。

2.2.3 源码编译安装（高级选项）

当需要最新特性或发行版仓库版本过旧时，可以选择源码编译。编译依赖较多，建议在干净的开发环境中进行。

# 安装编译依赖（以 Ubuntu 为例）
sudo apt install -y \
  build-essential cmake bison flex \
  libelf-dev libbpf-dev libclang-dev \
  llvm-dev libcereal-dev

# 克隆源码
git clone https://github.com/bpftrace/bpftrace.git
cd bpftrace

# 创建构建目录并编译
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)

# 安装到系统
sudo make install

2.3 权限配置与安全注意事项

bpftrace 需要特定的权限才能访问内核 BPF 子系统。不正确的权限配置可能导致工具无法运行或带来安全风险。

2.3.1 权限要求

运行 bpftrace 需要以下权限之一：

• root 用户 — 最直接的方式，但生产环境不推荐长期使用。
• CAP_BPF + CAP_PERFMON — 最小权限原则下的推荐方案。
• sudo 组 — 通过 sudo 临时提权。

配置 CAP_BPF 权限的示例：

# 授予 bpftrace 二进制文件 CAP_BPF 和 CAP_PERFMON 权限
sudo setcap cap_bpf,cap_perfmon=ep $(which bpftrace)

# 验证权限是否生效
getcap $(which bpftrace)
# 输出示例：/usr/bin/bpftrace cap_bpf,cap_perfmon=ep

2.3.2 安全注意事项

2.3.3 内核安全参数配置

通过 sysctl 可以调整 BPF 相关的安全参数：

# 查看当前 BPF 安全配置
sysctl kernel.unprivileged_bpf_disabled
sysctl kernel.bpf_stats_enabled

# 禁止非特权用户使用 BPF（推荐生产环境开启）
sudo sysctl -w kernel.unprivileged_bpf_disabled=1

# 启用 BPF 统计信息
sudo sysctl -w kernel.bpf_stats_enabled=1

# 持久化配置（写入 /etc/sysctl.conf 或 /etc/sysctl.d/）
echo "kernel.unprivileged_bpf_disabled=1" | sudo tee -a /etc/sysctl.conf
echo "kernel.bpf_stats_enabled=1" | sudo tee -a /etc/sysctl.conf

2.4 环境验证脚本

完成安装和权限配置后，建议运行以下验证脚本，确保所有组件正常工作：

#!/bin/bash
# bpftrace 环境验证脚本

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

echo "=== 2. 检查 BTF 支持 ==="
if [ -f /sys/kernel/btf/vmlinux ]; then
    echo "BTF: 支持"
else
    echo "BTF: 不支持（需要安装内核头文件）"
fi

echo "=== 3. 检查 bpftrace 版本 ==="
bpftrace --version

echo "=== 4. 检查权限 ==="
if capsh --print | grep -q "cap_bpf"; then
    echo "CAP_BPF: 已授予"
else
    echo "CAP_BPF: 未授予（需要 root 或 setcap）"
fi

echo "=== 5. 运行测试脚本 ==="
bpftrace -e 'BEGIN { printf("环境准备完成！\n"); exit(); }'