{"id":49780974,"url":"https://github.com/ike-sh/bbrv3-lite","last_synced_at":"2026-05-11T20:05:42.534Z","repository":{"id":354506491,"uuid":"1223938536","full_name":"ike-sh/bbrv3-lite","owner":"ike-sh","description":"轻量级 BBR v3 / XanMod / TCP 网络调优脚本，保留内核安装、BBR 优化、DNS 净化、IPv6 管理、Realm timeout 修复与测速功能。","archived":false,"fork":false,"pushed_at":"2026-05-08T03:34:29.000Z","size":166,"stargazers_count":13,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-08T05:32:16.858Z","etag":null,"topics":["bbr","bbrv3","debian","dns","ipv6","linux","network-tuning","realm","sysctl","tcp","ubuntu","vps","xanmod"],"latest_commit_sha":null,"homepage":"https://github.com/ike-sh/bbrv3-lite","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ike-sh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T19:59:52.000Z","updated_at":"2026-05-08T03:34:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ike-sh/bbrv3-lite","commit_stats":null,"previous_names":["ike-sh/bbrv3-lite"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ike-sh/bbrv3-lite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ike-sh%2Fbbrv3-lite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ike-sh%2Fbbrv3-lite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ike-sh%2Fbbrv3-lite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ike-sh%2Fbbrv3-lite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ike-sh","download_url":"https://codeload.github.com/ike-sh/bbrv3-lite/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ike-sh%2Fbbrv3-lite/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32910668,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-11T17:09:15.040Z","status":"ssl_error","status_checked_at":"2026-05-11T17:08:45.420Z","response_time":120,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bbr","bbrv3","debian","dns","ipv6","linux","network-tuning","realm","sysctl","tcp","ubuntu","vps","xanmod"],"created_at":"2026-05-11T20:05:41.656Z","updated_at":"2026-05-11T20:05:42.526Z","avatar_url":"https://github.com/ike-sh.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BBR v3 / XanMod / TCP 网络调优脚本\n\n当前版本：v5.2.7\n\n本精简版只保留网络调优相关功能，聚焦 XanMod 内核、BBR v3、TCP 参数调优、DNS 净化、IPv6 管理，以及必要的测速、预检和回滚能力。\n\n原项目 License 保持不变，详见 [LICENSE](LICENSE)。\n\n## 安装快捷命令\n\n新机器如果未安装 `curl`，请先执行：\n\n```bash\napt update -y \u0026\u0026 apt install curl -y\n```\n\n推荐安装 `/usr/local/bin/bbr` 系统命令：\n\n```bash\nbash \u003c(curl -fsSL \"https://raw.githubusercontent.com/ike-sh/bbrv3-lite/main/install-alias.sh?$(date +%s)\")\nbbr\n```\n\n安装脚本会优先写入 `/usr/local/bin/bbr`。如果当前用户无法写入 `/usr/local/bin`，会自动回退到 shell alias 方式，并提示执行 `source ~/.bashrc` 或 `source ~/.zshrc`。\n\n卸载快捷命令：\n\n```bash\nbash install-alias.sh uninstall\n```\n\n卸载时会同时尝试删除 `/usr/local/bin/bbr` 和 shell alias block。\n\n## 在线运行\n\n不安装快捷命令，临时在线运行：\n\n```bash\nbash \u003c(curl -fsSL \"https://raw.githubusercontent.com/ike-sh/bbrv3-lite/main/net-tcp-tune.sh?$(date +%s)\")\n```\n\n也可以下载到本地后执行：\n\n```bash\nwget -O net-tcp-tune.sh \"https://raw.githubusercontent.com/ike-sh/bbrv3-lite/main/net-tcp-tune.sh?$(date +%s)\"\nchmod +x net-tcp-tune.sh\n./net-tcp-tune.sh\n```\n\n## 保留功能\n\n| 编号 | 功能 |\n| :--: | --- |\n| 1 | 安装/更新 XanMod 内核 + BBR v3 |\n| 2 | 卸载 XanMod 内核 |\n| 3 | BBR 直连/落地优化（智能带宽检测） |\n| 4 | DNS 净化（抗污染/驯服 DHCP） |\n| 5 | IPv6 管理（临时/永久禁用/取消） |\n| 6 | 查看系统详细状态 |\n| 7 | 服务器带宽测试 |\n| 8 | iperf3 单线程测试 |\n| 9 | 三网回程路由测试 |\n| 10 | 一键全自动优化（BBR v3 + 网络调优） |\n| 11 | 环境预检 / 兼容性检查 |\n| 12 | 回滚 / 卸载管理 |\n\n## 系统兼容性\n\n完整支持 Debian/Ubuntu KVM；其他发行版仅保证部分功能可尝试，不作为主要支持目标。\n\n| 环境 | 支持状态 | 说明 |\n| --- | --- | --- |\n| Debian 12 bookworm / Debian 13 trixie + KVM + x86_64 | 完整支持 | 推荐环境，支持 XanMod + BBR v3 + TCP 调优 |\n| Ubuntu 22.04 / 24.04 或常见 LTS + KVM + x86_64 | 完整支持 | 使用系统自身 codename 添加 XanMod 源 |\n| Debian/Ubuntu ARM64 | 实验/部分支持 | 如脚本已有 ARM64 逻辑，可尝试；建议先做快照 |\n| Rocky / Alma / CentOS / Fedora / RHEL | 部分支持 | sysctl、测速等功能可尝试，不保证 XanMod 安装 |\n| OpenVZ / LXC / Docker 容器 | 不建议/通常不支持 | 通常不能自行更换内核 |\n| Alpine | 非主要目标 | 仅少量逻辑可能兼容 |\n| 非 systemd 系统 | 部分功能不可用 | DNS 净化、服务持久化等可能不可用 |\n\n建议先执行功能 11：环境预检 / 兼容性检查，截图结果便于排障。\n\n## XanMod 源与包名选择\n\n脚本不使用固定的 `releases` APT 源，也不固定安装单一包名。\n\n- 通过 `/etc/os-release` 读取 `VERSION_CODENAME`。\n- Debian 12 使用 `bookworm`，Debian 13 使用 `trixie`。\n- Ubuntu 使用系统自身 codename。\n- 添加的 XanMod APT 源格式为：\n\n```text\ndeb [signed-by=/usr/share/keyrings/xanmod-archive-keyring.gpg] http://deb.xanmod.org ${VERSION_CODENAME} main\n```\n\n`apt update` 后，脚本会通过 `apt-cache search '^linux-xanmod'` 查找仓库中实际可用的包名，并严格按 CPU 支持等级选择：\n\n- CPU 支持 x64v4：优先 `linux-xanmod-lts-x64v4`，再逐级回退到 x64v3、x64v2、x64v1。\n- CPU 支持 x64v3：优先 `linux-xanmod-lts-x64v3`，再回退到 x64v2、x64v1。\n- CPU 支持 x64v2：只会选择 x64v2 或 x64v1。\n- CPU 只支持 x64v1 或无法可靠识别：只会选择 x64v1。\n\n安装前会打印系统 codename、检测到的 CPU level、最终选择的 XanMod 包名和当前 XanMod APT 源。找不到合适包时，会打印当前 `apt-cache search '^linux-xanmod'` 的候选列表用于排障。\n\n## DoT 853 被封时的 DoH Fallback\n\n功能 4：DNS 净化会保留原有 DoT 853 连通性检测。\n\n- 如果 DoT 853 可达，继续使用原有 `systemd-resolved` + `DNSOverTLS` 配置。\n- 如果 DoT 853 不可达，脚本会提示可能是 NAT 商家或机房防火墙封锁出站 853，并询问是否自动切换到 DoH 443 模式。\n- DoH 443 模式优先使用系统源安装 `dnscrypt-proxy`，不会强行编译安装。\n- 配置 `dnscrypt-proxy` 前会检测本机 53 端口占用。\n- 如果 53 未占用，`dnscrypt-proxy` 监听 `127.0.0.1:53`。\n- 如果 53 已占用，自动改用 `127.0.0.1:5353`，并让 `systemd-resolved` 指向对应地址。\n- 如果 DoH 模式也失败，脚本会继续询问是否降级为普通 DNS 53。\n- 如果用户拒绝 DoH 和普通 DNS 53 降级，DNS 净化会被跳过，不影响后续 BBR/TCP 调优流程。\n\nDNS 净化执行前会备份 `systemd-resolved`、`resolv.conf`、`dnscrypt-proxy` 等相关配置；成功完成后会输出回滚脚本路径。\n\n## 功能 10：一键全自动优化\n\n一键全自动优化仍然保留原项目自动化逻辑。\n\n执行链路保持为：\n\n```text\n1 -\u003e 3 -\u003e 4 -\u003e 5\n```\n\n一键全自动优化分两阶段执行：\n\n- 首次执行：安装 XanMod/BBR v3 内核并提示重启。\n- 重启后再次进入脚本选择“一键全自动优化”：自动执行 BBR 直连优化、DNS 净化和 IPv6 管理。\n\nv5.1.0 起，一键优化最后会输出结果汇总，标记每一步成功、失败或跳过，并给出 DNS 回滚、IPv6 恢复、XanMod 卸载等提示。DNS、IPv6 这类辅助步骤失败时不会阻断 BBR/TCP 主流程。\n\nv5.1.1 起，IPv6 汇总状态以真实 sysctl 检测为准：只有 `net.ipv6.conf.all.disable_ipv6`、`net.ipv6.conf.default.disable_ipv6`、`net.ipv6.conf.lo.disable_ipv6` 三项均为 `1` 时，才显示 IPv6 已永久禁用。\n\nv5.2.1 起，如果系统已有 `/etc/sysctl.conf` 中的 `disable_ipv6=0`，脚本会在永久禁用 IPv6 前自动备份并注释冲突项，避免 `sysctl --system` 后旧配置覆盖禁用结果。\n\nv5.2.2 起，永久禁用 IPv6 时不会再把脚本自身的 `/etc/sysctl.d/.ipv6-state-backup.conf` 误报为其他 `sysctl.d` 冲突项；这是提示修复，不影响 IPv6 禁用/恢复核心逻辑。\n\nv5.2.3 起，DNS 净化安全检查的磁盘空间读取改为更稳健的 `df -Pm /`；只有明确读到根分区可用空间小于 100MB 时才阻止执行，无法读取时改为警告，不再误拦截。\n\nv5.2.4 起，小盘机器如果不适合安装 XanMod / BBR v3，但系统内核支持普通 BBR，一键优化会提示是否继续轻量优化（TCP 调优 / DNS 净化 / IPv6 管理）。\n\nv5.2.5 起，环境预检结论会综合磁盘空间、普通 BBR 支持和 XanMod 候选状态；小盘和轻量优化场景也会区分“系统普通 BBR”和“XanMod / BBR v3”。\n\nv5.2.6 起，speedtest 自动安装下载支持 curl/wget fallback；下载失败或缺少下载工具时会明确提示，并继续使用默认带宽值，不阻断 TCP 调优流程。\n\nv5.2.7 起，DNS 已存在有效配置并跳过重复执行时，一键优化汇总会显示“已配置，跳过重复执行”，不再误显示“未执行”。\n\n## 回滚 / 卸载\n\n功能 12：回滚 / 卸载管理提供统一入口：\n\n- 卸载 XanMod 内核。\n- 删除本脚本生成的 TCP/sysctl 调优配置。\n- 删除 `tc` / MSS clamp / `bbr-optimize-persist.service` 持久化。\n- 自动查找并执行最近一次 DNS 净化回滚脚本。\n- 恢复 IPv6。\n- 删除 `/usr/local/bin/bbr` 快捷命令。\n- 查看 DNS、sysctl 相关备份目录。\n\n所有删除或恢复操作都会打印将处理的路径，并要求二次确认。\n\n## 使用建议\n\n- 首次使用建议先执行功能 11 做环境预检。\n- 确认适合换内核后，再执行功能 1，重启进入 XanMod 内核后执行功能 3 或功能 10。\n- 不确定带宽档位时，功能 3 可使用自动检测，让脚本沿用原项目的 Speedtest、BDP 计算和 sysctl 模板逻辑。\n- 调优后可用功能 6 查看系统状态，用功能 7、8、9 辅助验证线路表现。\n\n## 风险提醒\n\n- 换内核前建议先给 VPS 做快照。\n- OpenVZ/LXC 等容器虚拟化环境通常不支持自行更换内核。\n- 生产机请谨慎执行内核安装、DNS 修改、IPv6 禁用等操作，建议确保有控制台或救援模式可用。\n\n## v5.2.7 更新记录\n\n- 修复 DNS 已配置时，一键优化汇总误显示“未执行”的问题。\n- DNS 已存在有效配置并跳过重复执行时，汇总会显示“已配置，跳过重复执行”。\n- 这是汇总文案/状态修复，不影响 DNS 净化主体逻辑。\n\n## v5.2.6 更新记录\n\n- 修复最小化系统只有 curl、没有 wget 时 speedtest 自动安装失败的问题。\n- speedtest 下载现在支持 curl/wget fallback。\n- 下载失败或缺少下载工具时，会明确提示并继续使用默认带宽值，不阻断 TCP 调优流程。\n\n## v5.2.5 更新记录\n\n- 环境预检结论现在会考虑磁盘空间、普通 BBR 支持、XanMod 候选状态，不再在 0MB 可用空间时推荐完整安装。\n- 当前 SWAP 已达到推荐值时不再重复重建 `/swapfile`。\n- 轻量优化模式下会区分“系统普通 BBR”和“XanMod / BBR v3”，避免文案误导。\n- DNS 净化在小盘空间不足时会明确提示原因并安全跳过。\n\n## v5.2.4 更新记录\n\n- 小盘机器上，如果不适合安装 XanMod / BBR v3，但系统内核支持普通 BBR，一键优化可提示继续轻量优化。\n- 统一磁盘空间检测为更稳健的 `df -Pm /` + 数字校验。\n- XanMod 安装的 3GB 空间保护仍然保留，不会被绕过。\n- IPv6 取消永久禁用时增加 `/etc/sysctl.conf` 备份提示。\n- `bbr` 快捷命令 wrapper 增强 curl/wget fallback、HTML 错误页检测和 shebang 校验。\n\n## v5.2.3 更新记录\n\n- 修复 DNS 净化安全检查磁盘空间误判为 0MB 的问题。\n- 磁盘检查改为更稳健的 `df -Pm /`。\n- 只有明确读到可用空间小于 100MB 时才阻止执行；无法读取时改为警告，不再误拦截。\n- 不影响 XanMod 内核安装的 3GB 空间保护逻辑。\n\n## v5.2.2 更新记录\n\n- 修复永久禁用 IPv6 时把脚本自身 `.ipv6-state-backup.conf` 误报为其他 `sysctl.d` 冲突项的问题。\n- 这是提示修复，不影响 IPv6 禁用/恢复核心逻辑。\n\n## v5.2.1 更新记录\n\n- 修复 `/etc/sysctl.conf` 中 `disable_ipv6=0` 覆盖永久禁用 IPv6 配置的问题。\n- IPv6 永久禁用前自动备份并注释冲突项。\n\n## v5.2.0 更新记录\n\n- 移除小众中转专项功能，进一步聚焦 BBRv3 / XanMod / TCP 调优。\n- 精简主菜单和一键优化流程。\n- 一键优化阶段 2 改为 TCP 调优、DNS 净化、IPv6 管理三步。\n- 回滚 / 卸载管理移除中转专项备份展示。\n- README 同步更新 lite 版定位。\n\n## v5.1.1 更新记录\n\n- 修复一键优化中 IPv6 禁用失败但汇总误报成功的问题。\n- 修复确认重启后脚本未立即退出导致菜单短暂重绘的问题。\n\n## v5.1.0 更新记录\n\n- 修复 XanMod 包选择逻辑，严格按 CPU 支持等级选择 x64v4/x64v3/x64v2/x64v1。\n- 新增系统兼容性矩阵与环境预检菜单。\n- 新增一键优化结果汇总。\n- 优化 DoH fallback，`dnscrypt-proxy` 自动避让 53 端口冲突。\n- 新增 `/usr/local/bin/bbr` 快捷命令安装方式。\n- 新增回滚/卸载管理入口。\n\n## 已删除内容\n\n删除了代理部署、AI 工具箱、Cloudflare Tunnel、Caddy、Sub-Store 等非调优功能。\n\nv5.2.0 起移除 Realm 相关小众中转功能，进一步聚焦 BBRv3 / XanMod / TCP 调优。\n\n本精简版不再包含 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 调优模块。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fike-sh%2Fbbrv3-lite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fike-sh%2Fbbrv3-lite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fike-sh%2Fbbrv3-lite/lists"}