Skip to content

Force Proxy to any Windows/MacOS/Linux Application TCP and UDP traffic

docs(linux): the minimum kernel is 5.11, not 5.8

anof-cyber29a01c0bde69
diff --git a/Linux/README.md b/Linux/README.md
index f41cb75..f2c2353 100644
--- a/Linux/README.md
+++ b/Linux/README.md
@@ -208,7 +208,7 @@ EXAMPLES:
--rule firefox:*:*:BOTH:PROXY --rule curl:*:*:TCP:PROXY=work --verbose 2
NOTE:
- ProxyBridge needs root and a Linux kernel >= 5.8 with BTF and cgroup v2 (eBPF datapath).
+ ProxyBridge needs root and a Linux kernel >= 5.11 with BTF and cgroup v2 (eBPF datapath).
Credentials given on the command line are visible to other users via ps.
```
@@ -293,7 +293,7 @@ Add as many `--proxy` entries (CLI) or proxies (GUI) as you need; each rule choo
## Current Limitations
-- **Needs a recent kernel**: Linux 5.8+ with BTF (`/sys/kernel/btf/vmlinux`) and cgroup v2 mounted (default on current Ubuntu, Debian, Fedora, Arch). Older kernels are not supported
+- **Needs a recent kernel**: Linux 5.11+ with BTF (`/sys/kernel/btf/vmlinux`) and cgroup v2 mounted (default on current Ubuntu, Debian, Fedora, Arch). Older kernels are not supported
- **Root privileges required** - loading the eBPF programs needs root (CAP_BPF/CAP_SYS_ADMIN)
- **Native IPv6 UDP to a PROXY rule fails closed** - an unconnected UDP socket sending to a native IPv6 address cannot be redirected (kernel limitation); the `sendto()` returns `EPERM` and applications fall back to IPv4/TCP. Connected IPv6 UDP sockets, IPv6 TCP and UDP to IPv4 destinations through dual-stack sockets all work
- **IPv4 is the fully supported path**; IPv6 (TCP, connected UDP) works for IP rules but has no domain matching and the limits above
@@ -371,7 +371,7 @@ ProxyBridge hooks the **socket calls** (`connect()`, `sendmsg()`, `recvmsg()`) w
### Requirements
-- Linux kernel 5.8+ with BTF and cgroup v2 (to run); GCC, Make, **clang** and **bpftool** (to build the eBPF object and skeleton)
+- Linux kernel 5.11+ with BTF and cgroup v2 (to run); GCC, Make, **clang** and **bpftool** (to build the eBPF object and skeleton)
- Development libraries:
- libbpf-dev (Debian/Ubuntu) or libbpf-devel (Fedora/RHEL)
- libgtk-3-dev (optional, for GUI) or gtk3-devel (Fedora/RHEL)
diff --git a/Linux/cli/main.c b/Linux/cli/main.c
index f061691..bc33c03 100644
--- a/Linux/cli/main.c
+++ b/Linux/cli/main.c
@@ -119,7 +119,7 @@ static void show_help(const char* prog)
printf(" --rule firefox:*:*:BOTH:PROXY --rule curl:*:*:TCP:PROXY=work --verbose 2\n\n");
printf("NOTE:\n");
- printf(" ProxyBridge needs root and a Linux kernel >= 5.8 with BTF and cgroup v2 (eBPF datapath).\n");
+ printf(" ProxyBridge needs root and a Linux kernel >= 5.11 with BTF and cgroup v2 (eBPF datapath).\n");
printf(" Credentials given on the command line are visible to other users via ps.\n\n");
}
diff --git a/Linux/gui/main.c b/Linux/gui/main.c
index fc7d6b0..9887cc0 100644
--- a/Linux/gui/main.c
+++ b/Linux/gui/main.c
@@ -201,7 +201,7 @@ static void on_about(GtkWidget *widget, gpointer data) {
"<span size='xx-large' weight='bold'>ProxyBridge</span>\n"
"<span color='gray'>Version %s</span>\n\n"
"Universal proxy client for Linux applications\n"
- "eBPF backend (needs root, kernel 5.8+ with BTF and cgroup v2)\n\n"
+ "eBPF backend (needs root, kernel 5.11+ with BTF and cgroup v2)\n\n"
"Author: Sourav Kalal / InterceptSuite\n\n"
"Website: <a href=\"https://interceptsuite.com\">interceptsuite.com</a>\n"
"GitHub: <a href=\"https://github.com/InterceptSuite/ProxyBridge\">InterceptSuite/ProxyBridge</a>\n\n"
@@ -241,7 +241,7 @@ static bool start_engine() {
show_message(GTK_WINDOW(window), GTK_MESSAGE_ERROR,
"Failed to start the ProxyBridge engine.\n\n"
"Open the \"Activity Logs\" tab to see the reason.\n"
- "The eBPF backend needs root, a kernel >= 5.8 with BTF and cgroup v2.");
+ "The eBPF backend needs root, a kernel >= 5.11 with BTF and cgroup v2.");
return false;
}
diff --git a/Linux/src/ProxyBridge.h b/Linux/src/ProxyBridge.h
index dc8b863..a03ed15 100644
--- a/Linux/src/ProxyBridge.h
+++ b/Linux/src/ProxyBridge.h
@@ -73,7 +73,7 @@ void ProxyBridge_SetLogCallback(LogCallback callback);
void ProxyBridge_SetConnectionCallback(ConnectionCallback callback);
void ProxyBridge_SetTrafficLoggingEnabled(bool enable);
void ProxyBridge_ClearConnectionLogs(void);
-bool ProxyBridge_Start(void); /* needs root (CAP_BPF/CAP_SYS_ADMIN) and a BTF kernel >= 5.8; returns false and logs why on failure */
+bool ProxyBridge_Start(void); /* needs root (CAP_BPF/CAP_SYS_ADMIN) and a BTF kernel >= 5.11; returns false and logs why on failure */
bool ProxyBridge_Stop(void); /* keeps rules and proxies; Start() may be called again */
int ProxyBridge_TestConnection(const char* target_host, uint16_t target_port, char* result_buffer, size_t buffer_size);
int ProxyBridge_TestProxy(uint32_t proxy_id, const char* target_host, uint16_t target_port, char* result_buffer, size_t buffer_size);
diff --git a/Linux/src/pb_bpf.c b/Linux/src/pb_bpf.c
index 7dedb85..d4bf74f 100644
--- a/Linux/src/pb_bpf.c
+++ b/Linux/src/pb_bpf.c
@@ -138,7 +138,7 @@ int pb_bpf_start(const struct pb_bpf_cfg *cfg, pb_event_cb cb)
bpf_program__set_autoload(G.skel->progs.pb_getpeername6, false);
err = proxybridge_bpf__load(G.skel);
}
- if (err || !G.skel) { pb_core_log("loading the BPF programs failed (kernel needs BTF and cgroup sock_addr support, >= 5.8): %s", strerror(-err ? -err : errno)); goto out; }
+ if (err || !G.skel) { pb_core_log("loading the BPF programs failed (kernel needs BTF and cgroup sock_addr support, >= 5.11): %s", strerror(-err ? -err : errno)); goto out; }
}
{ // sockets of other network namespaces (containers) must not be redirected to our loopback relay