zhangsir9901/bbrv3-onekey — explained in plain English
Analysis updated 2026-05-18
Speed up a VPS by installing BBRv3 and picking the right network queue preset for your region.
Fix Cloudflare 403 blocks affecting VPS IPs from providers like Alibaba Cloud Hong Kong or AWS Japan.
Check whether BBRv3 and kernel tuning are actually active on a server after setup.
| zhangsir9901/bbrv3-onekey | christitustech/zed-titus | q1uf3ng/dirty-merge | |
|---|---|---|---|
| Stars | 29 | 29 | 29 |
| Language | Shell | Shell | Shell |
| Setup difficulty | easy | easy | hard |
| Complexity | 2/5 | 2/5 | 5/5 |
| Audience | ops devops | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires root access on a Debian or Ubuntu VPS.
BBRv3-Onekey is a shell script for Debian 12 and 13, and Ubuntu 20.04 through 26.04 LTS, that installs the XanMod kernel with BBRv3 congestion control and tunes Linux network queue scheduling in one run. You run it as root with a single curl command, and it walks you through a menu of tuning presets. The script tries to detect where your server is physically hosted by checking its route through Cloudflare's edge network, then highlights the tuning option it thinks fits best. It offers four main presets: two aimed at low latency in Asia Pacific regions such as Japan, Singapore, Hong Kong, and Korea, and two aimed at long distance links to the US, Canada, Europe, or Australia. Within each region pair, one preset is tuned for servers that also host websites, balancing network buffers so a database or web app does not run out of memory, and the other is tuned for servers used purely to relay traffic, pushing the queue algorithm harder for throughput or latency. The queue algorithms used are FQ_CODEL, CAKE, and FQ depending on the preset. A fifth menu option checks the current kernel, sysctl settings, and network queue discipline to confirm the tuning took effect. The script targets users on VPS providers where IPs from certain regions, such as Alibaba Cloud Hong Kong or AWS Japan, sometimes get blocked by Cloudflare with a 403 error. It includes workarounds for this, including disguising its outbound requests and falling back to IPv4. If your kernel is already up to date, it skips reinstalling it and applies the sysctl settings immediately, so changes take effect without a reboot. For safety, installing a new kernel does not remove your existing one. If a new kernel causes your server to fail to boot, which the author says is rare, you can restart through your hosting provider's console and pick the old kernel from the GRUB boot menu to recover. The author offers support over WeChat and Telegram and accepts optional donations via Alipay or USDT.
A one-click shell script that installs the XanMod BBRv3 kernel and tunes network queues on Debian and Ubuntu servers for faster networking.
Mainly Shell. The stack also includes Shell, Linux, XanMod kernel.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
double-check against the repo, no cap.