zhangsir9901/bbrv3-onekey

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.