编译步骤

本文介绍 kyanos 的本地编译方法，我的环境是 ubuntu 22.04，其他环境可能会有所不同。

工具版本要求

如果你使用的是 ubuntu 20.04 以及更新版本，可以使用一条命令即可完成编译环境的初始化。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/hengyoush/kyanos/refs/heads/main/init_env.sh)"

用下面的命令 clone 项目:

git clone https://github.com/hengyoush/kyanos
cd kyanos
git submodule update --init --recursive

编译环境除了上面工具链版本列出的软件外，还需要以下软件，请自行安装。

如果只是本地开发测试，可以执行

make build-bpf && make

之后在项目根目录下会生成 kyanos 可执行文件。

Important

但是需要注意的是该二进制文件中没有包含 btfhub-archive 中的 btf 文件，如果直接拿这个 kyanos 去没有开启 BTF 支持的低版本内核上执行可能会启动失败，通过下面的命令可以构建出一个内嵌 btf 文件的 kyanos 产物：
x86_64:

make build-bpf && make btfgen BUILD_ARCH=x86_64 ARCH_BPF_NAME=x86 && make

arm64:

make build-bpf && make btfgen BUILD_ARCH=arm64 ARCH_BPF_NAME=arm64 && make

需要注意 make btfgen 耗时可能超过 15min。

Tip

如果你的内核没有开启 BTF，你可能无法成功启动 kyanos.

检查是否开启 BTF：

grep CONFIG_DEBUG_INFO_BTF "/boot/config-$(uname -r)"

如果结果是 CONFIG_DEBUG_INFO_BTF=y 说明开启了，如果没开启请到 mirrors.openanolis.cn or btfhub-archive 上下载对应你的内核版本的 btf 文件，然后启动 kyanos 时使用 --btf 选项指定下载的 btf 文件。