multisocks 1.0.1

A SOCKS proxy that aggregates multiple remote SOCKS proxies

MultiSocks

A SOCKS proxy that aggregates multiple remote SOCKS proxies, increasing your bandwidth by distributing traffic across them.

Features

• Supports multiple remote SOCKS proxies
• Round-robin or weighted load balancing
• Automatic handling of failed or slow proxies
• Support for SOCKS4, SOCKS4a, SOCKS5, and SOCKS5h protocols
• Detailed logging
• Load proxies from command line or text file
• Auto-optimization to dynamically adjust proxy usage based on bandwidth

Installation

From PyPI

pip install multisocks

From Source

git clone https://github.com/tboy1337/multisocks.git
cd multisocks
pip install -r requirements.txt

Usage

# Show help
multisocks --help

# Show version
multisocks --version

# Start the proxy server with multiple remote proxies specified on the command line
multisocks start --port 1080 --proxies socks5://user:[e-mail]:1080/10 socks5h://proxy2.example.com:1080/5

# Start the proxy server with proxies loaded from a text file
multisocks start --port 1080 --proxy-file proxies.txt

# Start with auto-optimization (automatically adjusts how many proxies to use based on your connection speed)
multisocks start --port 1080 --proxy-file proxies.txt --auto-optimize

Proxy Format

Proxies are specified in the format: protocol://[username:password@]hostname:port[/weight]

• protocol: Either socks4, socks4a, socks5, or socks5h
• username:password: Optional authentication for SOCKS5/SOCKS5h
• hostname: The proxy server hostname or IP address
• port: The proxy server port
• weight: Optional priority weight (default: 1)

Protocol Information

• socks4: Basic SOCKS4 protocol with IP addresses only
• socks4a: Extended SOCKS4 with hostname resolution on the proxy server
• socks5: SOCKS5 protocol with hostname resolution on the client
• socks5h: SOCKS5 protocol with hostname resolution on the proxy server (useful for avoiding DNS leaks)

Proxy File Format

You can specify proxies in a text file, with one proxy per line:

# This is a comment
socks5://user:[e-mail]:1080/10
socks5h://proxy2.example.com:1080/5
socks4://proxy3.example.com:1080

• Empty lines are ignored
• Lines starting with # are treated as comments and ignored

Auto-Optimization

When enabled with the --auto-optimize flag, MultiSocks will:

1. Measure your direct connection speed
2. Test the speed of your proxies
3. Automatically determine how many proxies to use to saturate your connection
4. Periodically adjust the active proxy count based on network conditions

This feature is especially useful when:

• You have a large list of proxies but don't want to manually configure how many to use
• Your internet connection speed varies throughout the day
• You want to maximize your connection bandwidth without manual tuning

Auto-optimization is re-evaluated every 10 minutes to adjust to changing network conditions.

Development

Setup Development Environment

git clone https://github.com/tboy1337/multisocks.git
cd multisocks
pip install -r requirements.txt

Run Tests

python -m unittest discover tests

License

This project is licensed under the MIT License - see the LICENSE file for details.