A SOCKS5 load balancing proxy to combine multiple internet connections into one. Works on Windows and Linux. Reported to work on macOS. Written in pure Go with no additional dependencies.
It can also be used as a transparent proxy to load balance multiple SSH tunnels.
The idea for this project came from dispatch-proxy which is written in NodeJS. NodeJS is not entirely disk friendly considering the multitude of files it creates even for very simple programs. I needed something light & portable, preferably a single binary without polluting the entire drive.
The example below are shown on Windows. The steps are similar for other platforms.
The primary purpose of the tool is to combine multiple internet connections into one. For this we need to know the IP addresses of the interface we wish to combine. You can obtain the IP addresses using the
ifconfig on linux) command. Alternatively run
D:\>go-dispatch-proxy.exe -list --- Listing the available adresses for dispatching [+] Mobile Broadband Connection , IPv4:10.81.201.18 [+] Local Area Connection, IPv4:192.168.1.2
go-dispatch-proxy specifying the IP addresses of the load balancers obtained in the previous step. Optionally, along with the IP address you may also provide the contention ratio(after the @ symbol). If no contention ratio is specified, it's assumed as 1.
The tool can load balance multiple SSH tunnels. See Example 3 for usage.
SOCKS proxy running on localhost at default port. Contention ratio is specified.
D:\>go-dispatch-proxy.exe [email protected] [email protected] [INFO] Load balancer 1: 10.81.201.18, contention ratio: 3 [INFO] Load balancer 2: 192.168.1.2, contention ratio: 2 [INFO] SOCKS server started at 127.0.0.1:8080
SOCKS proxy running on a different interface at a custom port. Contention ratio is not specified.
D:\>go-dispatch-proxy.exe -lhost 192.168.1.2 -lport 5566 10.81.177.215 192.168.1.100 [INFO] Load balancer 1: 10.81.177.215, contention ratio: 1 [INFO] Load balancer 2: 192.168.1.100, contention ratio: 1 [INFO] SOCKS server started at 192.168.1.2:5566
Out of 5 consecutive connections, the first 3 are routed to
10.81.201.18 and the remaining 2 to
192.168.1.2. The SOCKS server is started by default on
127.0.0.1:8080. It can be changed using the
Now change the proxy settings of your browser, download manager etc to point to the above address (eg
127.0.0.1:8080). Be sure to add this as a SOCKS v5 proxy and NOT as a HTTP/S proxy.
The tool can be used to load balance multiple SSH tunnels. In this mode, go-dispatch-proxy acts as a transparent load balancing proxy.
First, setup the tunnels.
D:\> ssh -D 127.0.0.1:7777 [email protected] D:\> ssh -D 127.0.0.1:7778 [email protected]
Here we are setting up two SSH tunnels to remote hosts
192.168.1.101 on local ports
7778 respectively. The IP address (
127.0.0.1) if omitted defaults to localhost. The
-D option stands for dynamic port forwarding.
Next, launch go-dispatch-proxy using the
D:\> go-dispatch-proxy.exe -tunnel 127.0.0.1:7777 127.0.0.1:7778
Both the IP and port must be mentioned while specifying the load balancer addresses.
Optionally, the listening host, port and contention ratio can also be specified like in example 2.
D:\> go-dispatch-proxy.exe -lport 5555 -tunnel 127.0.0.1:[email protected] 127.0.0.1:[email protected]
lport if not specified defaults to 8080. This is the port where you need to point your web browser, download manager etc. Be sure to add this as a SOCKS v5 proxy.
Go-dispatch-proxy now supports Linux in both normal mode and tunnel mode. On Linux normal mode, Go-dispatch-proxy uses the
SO_BINDTODEVICE syscall to bind to the interface corresponding to the load balancer IPs. As a result, the binary must be run with
root privilege or by giving it the necessary capabilities as shown below.
$ sudo ./go-dispatch-proxy
$ sudo setcap cap_net_raw=eip ./go-dispatch-proxy $ ./go-dispatch-proxy
Tunnel mode doesn't require root privilege.
Ensure that Go is installed and available on the system path.
$ git clone https://github.com/extremecoders-re/go-dispatch-proxy.git $ cd go-dispatch-proxy # Compile for Windows x86 $ GOOS=windows GOARCH=386 go build # Compile for Windows x64 $ GOOS=windows GOARCH=amd64 go build # Compile for Linux x86 $ GOOS=linux GOARCH=386 go build # Compile for Linux x64 $ GOOS=linux GOARCH=amd64 go build # Compile for Macos x64 $ GOOS=darwin GOARCH=amd64 go build
Licensed under MIT