BBRv3 管理脚本
一个用于 Debian/Ubuntu VPS 的 BBRv3 内核安装与网络加速管理脚本。
脚本入口:
bash <(curl -fsSL https://raw.githubusercontent.com/byJoey/Actions-bbr-v3/main/install.sh)首次运行后脚本会自动安装联网快捷命令,后续可直接运行:
b快捷命令每次都会从 GitHub 拉取最新版脚本执行,不使用本地缓存脚本。
脚本会自动识别当前系统架构,从本仓库 GitHub Releases 下载匹配的 BBRv3 内核 .deb 包,并提供安装、指定版本安装、状态检查、加速模式切换和卸载功能。安装内核时可选择标准 BBRv3 或 BBRv3 Max 激进吞吐内核。
支持环境
| 项目 | 要求 |
|---|---|
| 最低支持系统 | Ubuntu 24.04+ / Debian 12+ |
| 推荐系统 | Ubuntu 24.04+ / Debian 12+ |
| 包管理器 | apt-get |
| 架构 | x86_64 / aarch64 |
| 引导方式 | 建议使用 GRUB |
| 使用场景 | VPS / 云服务器 / 独立服务器 |
不建议在树莓派、NanoPi 等依赖 U-Boot 或厂商定制内核链路的设备上使用。此类设备的内核安装和启动流程通常与通用 Debian/Ubuntu VPS 不一致。
Debian testing/unstable 如果缺少 VERSION_ID,脚本会按 VERSION_CODENAME 识别 bookworm、trixie、forky 和 sid。Alpine Linux 暂不支持安装本项目内核包,因为当前 release 产物是 .deb,安装和引导流程依赖 Debian/Ubuntu 的包管理与内核安装链路。
本项目当前内核主线为 Linux 7.x。安装内核时脚本会按最低支持系统拦截过旧环境,避免因用户态、initramfs 或引导链路过旧导致启动失败或 kernel panic。推荐系统是更稳妥的部署选择;旧系统仍可使用状态检查、网络调优、清空优化和卸载功能。
菜单功能
运行脚本后会进入交互菜单:
1. 安装或更新 BBR v3 最新版
2. 指定版本安装
3. 检查 BBR v3 状态
4. 启用 BBR + FQ
5. 启用 BBR + FQ_CODEL
6. 启用 BBR + FQ_PIE
7. 启用 BBR + CAKE
8. 亚太机器 TCP 调优
9. 卸载 BBR 内核
10. BBR v3 智能带宽优化
11. 清空网络优化配置
12. BBR v3 疯批模式(极限测速挑战)
常用流程:
- 选择
1安装或更新 BBRv3 内核,并按提示选择标准版或 Max 极限版。 - 按提示重启系统。
- 重新运行脚本,选择
3检查 BBRv3 状态。 - 按需选择
4到7设置队列算法。 - 亚太线路机器可选择
8写入 TCP 收发窗口与空闲慢启动调优。 - 不确定线路参数时可选择
10自动测速并按带宽档位计算 TCP 缓冲区。 - 做自有链路极限测速挑战时可选择
12写入激进冲速率参数。 - 需要撤回调优时可选择
11清空脚本写入的网络优化配置。
内核与 BBR 策略
本项目的构建目标是:
BBRv3 补丁固定,内核自动跟随 kernel.org 最新 stable 更新。
也就是说,BBR 实现不会在自动构建时偷偷更新;自动更新的是 Linux stable 内核版本。构建流程会把仓库内固定的 BBRv3 patch 应用到最新 stable 内核上。
当前 patch 选择规则:
linux-7.0.y -> patches/bbrv3-linux-7.0.patch
linux-7.1.y -> patches/bbrv3-linux-7.1.patch
同一个主线系列内的小版本更新会自动复用同一个 patch,例如 7.0.11 -> 7.0.12。如果内核跳到新的主线系列但仓库内还没有对应 patch,构建会直接失败,避免产出不可验证的内核包。
安装最新版
bash <(curl -fsSL https://raw.githubusercontent.com/byJoey/Actions-bbr-v3/main/install.sh)首次运行后也可以直接输入:
b该命令会联网拉取最新版脚本后运行。
选择:
1. 安装或更新 BBR v3 最新版
脚本会:
- 检查系统是否为 Debian/Ubuntu。
- 检查架构是否为
x86_64或aarch64。 - 让用户选择标准 BBRv3 或 BBRv3 Max 激进吞吐内核。
- 从 GitHub Releases 获取当前架构和内核类型匹配的最新版本。
- 下载非 debug 的内核
.deb包。 - 安装新内核并更新引导配置。
- 提示是否重启。
如果遇到 GitHub API rate limit,可先设置 token:
export GITHUB_TOKEN=你的 GitHub Token
bash <(curl -fsSL https://raw.githubusercontent.com/byJoey/Actions-bbr-v3/main/install.sh)指定版本安装
运行脚本后选择:
2. 指定版本安装
脚本会先让用户选择标准 BBRv3 或 BBRv3 Max,再列出当前架构可用的 release tag,并按编号安装指定版本。
release tag 格式:
x86_64-7.0.11
arm64-7.0.11
x86_64-7.0.11-max
arm64-7.0.11-max
其中不带 -max 的 tag 是标准 BBRv3 内核,带 -max 的 tag 是 BBRv3 Max 激进吞吐内核。Max 版会提高 Startup、ProbeBW 和 cwnd 策略的进攻性,但保留 BBRv3 的 loss、ECN、inflight 和 ProbeBW 反馈闭环,只适合自有链路吞吐测试,不建议日常生产使用。
检查 BBRv3 状态
运行脚本后选择:
3. 检查 BBR v3 状态
脚本会检查:
tcp_bbr模块版本是否为3。- 当前 TCP 拥塞控制算法是否为
bbr。 - Dirty Frag 相关模块黑名单是否写入。
也可以手动检查:
uname -r
sysctl net.ipv4.tcp_congestion_control
sysctl net.core.default_qdisc
modinfo tcp_bbr 2>/dev/null | grep '^version:'加速模式
脚本支持以下组合:
| 菜单 | 拥塞控制 | 队列算法 |
|---|---|---|
| 4 | bbr | fq |
| 5 | bbr | fq_codel |
| 6 | bbr | fq_pie |
| 7 | bbr | cake |
选择后脚本会立即尝试应用配置,并询问是否永久写入:
/etc/sysctl.d/99-joeyblog.conf
脚本不仅会写入 net.core.default_qdisc,还会尝试把当前默认路由出口网卡的 root qdisc 立即替换为所选算法,避免只对新建队列生效、当前网卡实际仍保持旧队列。
对于需要模块加载的队列算法,脚本会尝试加载对应 sch_* 模块,并在需要时写入:
/etc/modules-load.d/joeyblog-qdisc.conf
亚太机器 TCP 调优
运行脚本后选择:
8. 亚太机器 TCP 调优
脚本会立即应用并永久写入以下配置:
net.ipv4.tcp_wmem = 4096 16384 12582912
net.ipv4.tcp_rmem = 4096 131072 33554432
net.ipv4.tcp_limit_output_bytes = 4194304
net.ipv4.tcp_slow_start_after_idle = 0
配置文件路径:
/etc/sysctl.d/99-joeyblog.conf
BBR v3 智能带宽优化
运行脚本后选择:
10. BBR v3 智能带宽优化
脚本会优先安装并运行 Ookla 官方 speedtest 1.2.0,自动尝试附近测速服务器并获取上传/下载带宽;如果检测到 Python 版 speedtest-cli,会先自动移除并安装需要的 Ookla 官方版本。测速失败时会提示手动输入上传带宽。Speedtest 的测速节点延迟会被隐藏,不展示也不参与 RTT 计算,避免把测速节点延迟误当作真实业务线路延迟。
优化逻辑:
- 自动启用
bbr拥塞控制和fq队列算法。 - 根据上传带宽和地区模式映射推荐 TCP buffer 档位。
- RTT 必须由用户手动输入,应填写真实链接延迟,使用 v2rayN 测出来的结果即可;不使用 Speedtest 测出来的 Ping。
- 用户手动选择亚太、美欧或手动 RTT + buffer 档位,不再按测速 RTT 自动判断。
- 亚太线路使用较保守的 buffer,美欧高延迟线路使用更大 buffer。
- 按机器内存设置 TCP buffer 上限,避免小内存 VPS 过度放大缓冲区。
- 同步写入
net.core.rmem_max/net.core.wmem_max/tcp_rmem/tcp_wmem。 - 保留
tcp_limit_output_bytes = 4194304和tcp_slow_start_after_idle = 0。
地区模式参考:
| 模式 | RTT 参考 |
|---|---|
| 亚太线路 | 通常小于 100ms |
| 美欧线路 | 通常 150-300ms |
| 手动 RTT | 按用户输入 RTT,并手动选择亚太或美欧 buffer 档位 |
配置同样写入:
/etc/sysctl.d/99-joeyblog.conf
未经允许不得转载:搬瓦工VPS_美国VPS » BBRv3 管理脚本
搬瓦工VPS_美国VPS









