TCP BBR 拥塞控制模块编译

📅 2026/7/11 14:51:53 👁️ 阅读次数 📝 编程学习
TCP BBR 拥塞控制模块编译

Linux 内核中的 TCP BBR 拥塞控制模块源码,它不能像普通用户态程序那样用gcc bbr.c直接编译。
它必须在内核源码树环境下,以外部模块内建模块的方式编译,且依赖运行内核的版本和头文件。


1. 编译为独立内核模块(针对当前运行的内核)

假设你的系统已安装了内核头文件(linux-headers-$(uname -r)),可以按以下步骤操作:

步骤 1:创建工作目录并放入源码

mkdir-p~/bbr_modulecptcp_bbr.c ~/bbr_module/# 源码文件重命名或保持原名cd~/bbr_module

如果你习惯使用bbr.c,可以:
cp tcp_bbr.c bbr.c
但模块名称仍由源码中的tcp_congestion_ops .name = "bbr"决定,不影响最终模块名。

步骤 2:编写 Makefile

创建Makefile文件,内容如下:

obj-m := tcp_bbr.o # 如果文件已重命名为 bbr.c,则改为 obj-m := bbr.o

如果保持文件名为tcp_bbr.c,模块对象会自动是tcp_bbr.o
模块最终会被编译为tcp_bbr.ko,加载时使用的名称是tcp_bbr

步骤 3:编译模块

# 一般用下述方法编译即可:make-C/lib/modules/$(uname-r)/buildM=$(pwd)modules# 开启-O3编译(需要优化):# make -C /lib/modules/$(uname -r)/build M=$(pwd) modules EXTRA_CFLAGS="-O3"
  • -C指向当前内核的构建目录(由linux-headers包提供)。
  • M=$(pwd)指定模块源码所在目录。

如果成功,会生成tcp_bbr.ko

步骤 4:加载/测试模块

sudomodprobe tcp_bbr# 或 insmod tcp_bbr.kosysctlnet.ipv4.tcp_congestion_control=bbr# 启用 BBR

2. 常见问题说明

问题原因解决
提示缺少net/tcp.h等头文件直接gcc编译会失败必须使用内核构建系统(make -C /lib/modules/...
头文件版本不匹配内核版本与头文件不一致安装正确版本的linux-headers
sudo apt install linux-headers-$(uname -r)
需要修改内核配置才能使用当前内核可能已有 BBR 模块如果有,直接modprobe tcp_bbr即可,无需编译

多数现代 Linux 发行版已内置 BBR 模块,你只需:

sudomodprobe tcp_bbrsudosysctl-wnet.ipv4.tcp_congestion_control=bbr