bbrv3-lite

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 59 Open GitHub ↗

轻量级 BBR v3 / XanMod / TCP 网络调优脚本，保留内核安装、BBR 优化、DNS 净化、IPv6 管理、Realm timeout 修复与测速功能。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BBR v3 / XanMod / TCP 网络调优脚本

当前版本：v5.2.14

本精简版只保留网络调优相关功能，聚焦 XanMod 内核、BBR v3、TCP 参数调优、DNS 净化、IPv6 管理，以及必要的测速、预检和回滚能力。
原项目：https://github.com/Eric86777/vps-tcp-tune
项目 License 保持不变，详见 [LICENSE](LICENSE)。

## 安装快捷命令

新机器如果未安装 `curl`，请先执行：

```bash
apt update -y && apt install curl -y
```

推荐安装 `/usr/local/bin/bbr` 系统命令：

```bash
bash <(curl -fsSL "https://raw.githubusercontent.com/ike-sh/bbrv3-lite/main/install-alias.sh?$(date +%s)")
bbr
```

安装脚本会优先写入 `/usr/local/bin/bbr`。如果当前用户无法写入 `/usr/local/bin`，会自动回退到 shell function 方式，并提示执行 `source ~/.bashrc` 或 `source ~/.zshrc`。

卸载快捷命令：

```bash
bash install-alias.sh uninstall
```

卸载时会同时尝试删除 `/usr/local/bin/bbr` 和 shell 快捷命令 block。

## 本地验证

```bash
bash scripts/validate.sh
bash install-alias.sh uninstall
```

## 在线运行

不安装快捷命令，临时在线运行：

```bash
bash <(curl -fsSL "https://raw.githubusercontent.com/ike-sh/bbrv3-lite/main/net-tcp-tune.sh?$(date +%s)")
```

也可以下载到本地后执行：

```bash
wget -O net-tcp-tune.sh "https://raw.githubusercontent.com/ike-sh/bbrv3-lite/main/net-tcp-tune.sh?$(date +%s)"
chmod +x net-tcp-tune.sh
./net-tcp-tune.sh
```

## 保留功能

| 编号 | 功能 |
| :--: | --- |
| 1 | 安装/更新 XanMod 内核 + BBR v3 |
| 2 | 卸载 XanMod 内核 |
| 3 | BBR 直连/落地优化（智能带宽检测） |
| 4 | DNS 净化（抗污染/驯服 DHCP） |
| 5 | IPv6 管理（临时/永久禁用/取消） |
| 6 | 查看系统详细状态 |
| 7 | 服务器带宽测试 |
| 8 | iperf3 单线程测试 |
| 9 | 三网回程路由测试 |
| 10 | 一键全自动优化（BBR v3 + 网络调优） |
| 11 | 环境预检 / 兼容性检查 |
| 12 | 回滚 / 卸载管理 |

## 系统兼容性

完整支持 Debian/Ubuntu KVM；其他发行版仅保证部分功能可尝试，不作为主要支持目标。

| 环境 | 支持状态 | 说明 |
| --- | --- | --- |
| Debian 12 bookworm / Debian 13 trixie + KVM + x86_64 | 完整支持 | 推荐环境，支持 XanMod + BBR v3 + TCP 调优 |
| Ubuntu 22.04 / 24.04 或常见 LTS + KVM + x86_64 | 完整支持 | 使用系统自身 codename 添加 XanMod 源 |
| Debian/Ubuntu ARM64 | 实验/部分支持 | 使用仓库内 `bbrv3arm.sh`；社区 XanMod 内核，建议先做快照 |
| Rocky / Alma / CentOS / Fedora / RHEL | 部分支持 | sysctl、测速等功能可尝试，不保证 XanMod 安装 |
| OpenVZ / LXC / Docker 容器 | 不建议/通常不支持 | 通常不能自行更换内核 |
| Alpine | 非主要目标 | 仅少量逻辑可能兼容 |
| 非 systemd 系统 | 部分功能不可用 | DNS 净化、服务持久化等可能不可用 |

建议先执行功能 11：环境预检 / 兼容性检查，截图结果便于排障。

## XanMod 源与包名选择

脚本不使用固定的 `releases` APT 源，也不固定安装单一包名。

- 通过 `/etc/os-release` 读取 `VERSION_CODENAME`。
- Debian 12 使用 `bookworm`，Debian 13 使用 `trixie`。
- Ubuntu 使用系统自身 codename。
- 添加的 XanMod APT 源格式为：

```text
deb [signed-by=/usr/share/keyrings/xanmod-archive-keyring.gpg] http://deb.xanmod.org ${VERSION_CODENAME} main
```

`apt update` 后，脚本会通过 `apt-cache search '^linux-xanmod'` 查找仓库中实际可用的包名，并严格按 CPU 支持等级选择：

- CPU 支持 x64v4：优先 `linux-xanmod-lts-x64v4`，再逐级回退到 x64v3、x64v2、x64v1。
- CPU 支持 x64v3：优先 `linux-xanmod-lts-x64v3`，再回退到 x64v2、x64v1。
- CPU 支持 x64v2：只会选择 x64v2 或 x64v1。
- CPU 只支持 x64v1 或无法可靠识别：只会选择 x64v1。

安装前会打印系统 codename、检测到的 CPU level、最终选择的 XanMod 包名和当前 XanMod APT 源。找不到合适包时，会打印当前 `apt-cache search '^linux-xanmod'` 的候选列表用于排障。

## DoT 853 被封时的 DoH Fallback

功能 4：DNS 净化会保留原有 DoT 853 连通性检测。

- 如果 DoT 853 可达，继续使用原有 `systemd-resolved` + `DNSOverTLS` 配置。
- 如果 DoT 853 不可达，脚本会提示可能是 NAT 商家或机房防火墙封锁出站 853，并询问是否自动切换到 DoH 443 模式。
- DoH 443 模式优先使用系统源安装 `dnscrypt-proxy`，不会强行编译安装。
- 配置 `dnscrypt-proxy` 前会检测本机 53 端口占用。
- 如果 53 未占用，`dnscrypt-proxy` 监听 `127.0.0.1:53`。
- 如果 53 已占用，自动改用 `127.0.0.1:5353`，并让 `systemd-resolved` 指向对应地址。
- 如果 DoH 模式也失败，脚本会继续询问是否降级为普通 DNS 53。
- 如果用户拒绝 DoH 和普通 DNS 53 降级，DNS 净化会被跳过，不影响后续 BBR/TCP 调优流程。

DNS 净化执行前会备份 `systemd-resolved`、`resolv.conf`、`dnscrypt-proxy` 等相关配置；成功完成后会输出回滚脚本路径。

## 功能 10：一键全自动优化

一键全自动优化仍然保留原项目自动化逻辑。

执行链路保持为：

```text
1 -> 3 -> 4 -> 5
```

一键全自动优化分两阶段执行：

- 首次执行：安装 XanMod/BBR v3 内核并提示重启。
- 重启后再次进入脚本选择“一键全自动优化”：自动执行 BBR 直连优化、DNS 净化和 IPv6 管理。

v5.1.0 起，一键优化最后会输出结果汇总，标记每一步成功、失败或跳过，并给出 DNS 回滚、IPv6 恢复、XanMod 卸载等提示。DNS、IPv6 这类辅助步骤失败时不会阻断 BBR/TCP 主流程。

v5.1.1 起，IPv6 汇总状态以真实 sysctl 检测为准：只有 `net.ipv6.conf.all.disable_ipv6`、`net.ipv6.conf.default.disable_ipv6`、`net.ipv6.conf.lo.disable_ipv6` 三项均为 `1` 时，才显示 IPv6 已永久禁用。

v5.2.1 起，如果系统已有 `/etc/sysctl.conf` 中的 `disable_ipv6=0`，脚本会在永久禁用 IPv6 前自动备份并注释冲突项，避免 `sysctl --system` 后旧配置覆盖禁用结果。

v5.2.2 起，永久禁用 IPv6 时不会再把脚本自身的 `/etc/sysctl.d/.ipv6-state-backup.conf` 误报为其他 `sysctl.d` 冲突项；这是提示修复，不影响 IPv6 禁用/恢复核心逻辑。

v5.2.3 起，DNS 净化安全检查的磁盘空间读取改为更稳健的 `df -Pm /`；只有明确读到根分区可用空间小于 100MB 时才阻止执行，无法读取时改为警告，不再误拦截。

v5.2.4 起，小盘机器如果不适合安装 XanMod / BBR v3，但系统内核支持普通 BBR，一键优化会提示是否继续轻量优化（TCP 调优 / DNS 净化 / IPv6 管理）。

v5.2.5 起，环境预检结论会综合磁盘空间、普通 BBR 支持和 XanMod 候选状态；小盘和轻量优化场景也会区分“系统普通 BBR”和“XanMod / BBR v3”。

v5.2.6 起，speedtest 自动安装下载支持 curl/wget fallback；下载失败或缺少下载工具时会明确提示，并继续使用默认带宽值，不阻断 TCP 调优流程。

v5.2.7 起，DNS 已存在有效配置并跳过重复执行时，一键优化汇总会显示“已配置，跳过重复执行”，不再误显示“未执行”。

v5.2.8 起，远程脚本、快捷命令 fallback、依赖安装判断、IPv6 取消永久禁用和 speedtest 自动安装路径增加安全校验；测速工具失败时仍降级到默认带宽，不阻断 TCP 调优流程。

## 回滚 / 卸载

功能 12：回滚 / 卸载管理提供统一入口：

- 卸载 XanMod 内核。
- 删除本脚本生成的 TCP/sysctl 调优配置。
- 删除 `tc` / MSS clamp / `bbr-optimize-persist.service` 持久化。
- 自动查找并执行最近一次 DNS 净化回滚脚本。
- 恢复 IPv6。
- 删除 `/usr/local/bin/bbr` 快捷命令。
- 查看 DNS、sysctl 相关备份目录。

所有删除或恢复操作都会打印将处理的路径，并要求二次确认。

## 使用建议

- 首次使用建议先执行功能 11 做环境预检。
- 确认适合换内核后，再执行功能 1，重启进入 XanMod 内核后执行功能 3 或功能 10。
- 不确定带宽档位时，功能 3 可使用自动检测，让脚本沿用原项目的 Speedtest、BDP 计算和 sysctl 模板逻辑。
- 调优后可用功能 6 查看系统状态，用功能 7、8、9 辅助验证线路表现。

## 风险提醒

- 换内核前建议先给 VPS 做快照。
- OpenVZ/LXC 等容器虚拟化环境通常不支持自行更换内核。
- 生产机请谨慎执行内核安装、DNS 修改、IPv6 禁用等操作，建议确保有控制台或救援模式可用。

## v5.2.14 更新记录

- 内核安装前增加 Secure Boot 预检，自动模式下检测到启用会中止，避免无人值守重启后断联。
- XanMod x86_64 安装前增加 APT dry-run，若预演会移除 `isc-dhcp-client`、`ifupdown`、`systemd-resolved`、`resolvconf`、`network-manager`、`dhcpcd5` 等网络关键包则中止。
- 内核安装前会将已安装网络关键包标记为 manual，安装后在 ifupdown DHCP 环境确认 `dhclient` 可用，降低内网 DHCP 机器丢 DNS/断网风险。

## v5.2.13 更新记录

- 一键优化阶段 1 设置 `AUTO_MODE`，`install_xanmod_kernel` 与 `bbrv3arm.sh` 免交互确认。
- `bbrv3arm.sh`：`dpkg -i` 失败后自动 `apt-get -f install` 修复依赖。
- 普通 BBR + `AUTO_MODE` 时跳过社区内核安装，直接进入轻量 TCP 调优路径。

## v5.2.12 更新记录

- 新增仓库内 `bbrv3arm.sh`，ARM64 不再从 `jhb.ovh` 下载第三方脚本。
- ARM64 优先使用同目录脚本，在线场景从 `ike-sh/bbrv3-lite` raw 拉取并校验。
- 社区 XanMod ARM64 内核可选安装（`zijiren233/xanmod-arm64` GitHub Release + SHA256 digest）。

## v5.2.11 更新记录

- DNS 预生成 `rollback.sh` 从 3 文件基础版升级为增强版，覆盖 dhclient/interfaces/persist/dnscrypt 等备份路径。
- 新增 `get_available_mem_mb()`，兼容 `free` 的 `available` 列与旧版 `free` 列；无法读取时改为警告而非误判失败。
- ARM64 安装：curl 超时、空文件/HTML/shebang 校验，并提示第三方脚本来源域名。

## v5.2.10 更新记录

- DNS 净化在 `AUTO_MODE` 下，DoT 853 不可达时自动尝试 DoH 443，失败则降级普通 DNS 53，不再阻塞一键优化。
- 移除未使用的 `log_warn` / `log_info` 封装；DNS 跳过/取消路径明确 `return 0` 并设置 `DNS_PURIFY_RESULT`。

## v5.2.9 更新记录

- 一键全自动优化（功能 10）在 `AUTO_MODE` 下不再阻塞等待带宽测速失败确认、地区选择等交互。
- XanMod GPG 密钥改为优先从官方 `dl.xanmod.org` 下载，镜像源仅作回退；安装与更新共用 `import_xanmod_gpg_key()`。
- `bbr_configure_direct` 在 sysctl 验证未全部生效时返回非零，一键优化汇总能正确标记 TCP 调优失败。
- `safe_download_script` 的 wget 分支补充 60 秒超时；`install-alias.sh` 增加与主脚本一致的项目标识校验。

## v5.2.8 更新记录

- shell fallback 从单行 alias 改为 `bbr()` 函数，支持 curl/wget 下载、空文件、HTML、shebang 和 `SCRIPT_VERSION` 校验。
- 远程脚本校验增加 `SCRIPT_VERSION` 与项目标识检查，下载内容不像本项目脚本时拒绝执行。
- 依赖安装改为区分命令存在性与包安装状态，Debian/Ubuntu 使用 `dpkg -s`，RHEL 系使用 `rpm -q`。
- IPv6 取消永久禁用会校验备份值，只恢复 0/1；可安全识别脚本注释标记时自动恢复 `/etc/sysctl.conf`。
- speedtest 自动安装增加 tar 可读性、路径穿越、按文件抽取和安装后版本验证；失败时继续使用默认带宽值。
- 新增 GitHub Actions CI，并补充本地验证命令。

## v5.2.7 更新记录

- 修复 DNS 已配置时，一键优化汇总误显示“未执行”的问题。
- DNS 已存在有效配置并跳过重复执行时，汇总会显示“已配置，跳过重复执行”。
- 这是汇总文案/状态修复，不影响 DNS 净化主体逻辑。

## v5.2.6 更新记录

- 修复最小化系统只有 curl、没有 wget 时 speedtest 自动安装失败的问题。
- speedtest 下载现在支持 curl/wget fallback。
- 下载失败或缺少下载工具时，会明确提示并继续使用默认带宽值，不阻断 TCP 调优流程。

## v5.2.5 更新记录

- 环境预检结论现在会考虑磁盘空间、普通 BBR 支持、XanMod 候选状态，不再在 0MB 可用空间时推荐完整安装。
- 当前 SWAP 已达到推荐值时不再重复重建 `/swapfile`。
- 轻量优化模式下会区分“系统普通 BBR”和“XanMod / BBR v3”，避免文案误导。
- DNS 净化在小盘空间不足时会明确提示原因并安全跳过。

## v5.2.4 更新记录

- 小盘机器上，如果不适合安装 XanMod / BBR v3，但系统内核支持普通 BBR，一键优化可提示继续轻量优化。
- 统一磁盘空间检测为更稳健的 `df -Pm /` + 数字校验。
- XanMod 安装的 3GB 空间保护仍然保留，不会被绕过。
- IPv6 取消永久禁用时增加 `/etc/sysctl.conf` 备份提示。
- `bbr` 快捷命令 wrapper 增强 curl/wget fallback、HTML 错误页检测和 shebang 校验。

## v5.2.3 更新记录

- 修复 DNS 净化安全检查磁盘空间误判为 0MB 的问题。
- 磁盘检查改为更稳健的 `df -Pm /`。
- 只有明确读到可用空间小于 100MB 时才阻止执行；无法读取时改为警告，不再误拦截。
- 不影响 XanMod 内核安装的 3GB 空间保护逻辑。

## v5.2.2 更新记录

- 修复永久禁用 IPv6 时把脚本自身 `.ipv6-state-backup.conf` 误报为其他 `sysctl.d` 冲突项的问题。
- 这是提示修复，不影响 IPv6 禁用/恢复核心逻辑。

## v5.2.1 更新记录

- 修复 `/etc/sysctl.conf` 中 `disable_ipv6=0` 覆盖永久禁用 IPv6 配置的问题。
- IPv6 永久禁用前自动备份并注释冲突项。

## v5.2.0 更新记录

- 移除小众中转专项功能，进一步聚焦 BBRv3 / XanMod / TCP 调优。
- 精简主菜单和一键优化流程。
- 一键优化阶段 2 改为 TCP 调优、DNS 净化、IPv6 管理三步。
- 回滚 / 卸载管理移除中转专项备份展示。
- README 同步更新 lite 版定位。

## v5.1.1 更新记录

- 修复一键优化中 IPv6 禁用失败但汇总误报成功的问题。
- 修复确认重启后脚本未立即退出导致菜单短暂重绘的问题。

## v5.1.0 更新记录

- 修复 XanMod 包选择逻辑，严格按 CPU 支持等级选择 x64v4/x64v3/x64v2/x64v1。
- 新增系统兼容性矩阵与环境预检菜单。
- 新增一键优化结果汇总。
- 优化 DoH fallback，`dnscrypt-proxy` 自动避让 53 端口冲突。
- 新增 `/usr/local/bin/bbr` 快捷命令安装方式。
- 新增回滚/卸载管理入口。

## 已删除内容

删除了代理部署、AI 工具箱、Cloudflare Tunnel、Caddy、Sub-Store 等非调优功能。

v5.2.0 起移除 Realm 相关小众中转功能，进一步聚焦 BBRv3 / XanMod / TCP 调优。

本精简版不再包含 Snell、Xray、SOCKS5 代理部署、Sub-Store 多实例管理、Cloudflare Tunnel、Caddy 多域名反代、AI 代理工具箱、Open WebUI、CRS、Fuclaude、Sub2API、OpenClaw、OpenAI Responses API 转换代理、Codex Console、CLIProxyAPI、OAI2、第三方工具跳转脚本、F 佬 sing-box 脚本、科技 lion 脚本、IP 质量检测、媒体/AI 解锁检测、NQ 一键检测等非 BBRv3/TCP 调优模块。

bbrv3-lite

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README