Skip to main content

Socks5 async proxy server

Project description

Socks5 async proxy server

Saturn is a SOCKS5 server based on asyncio protocols



pip install saturn-proxy-server

From this repo

git clone
cd saturn
python3 ./ install


Please edit file before starting your server.
By default proxying allowed to all hosts (ALLOWED_DESTINATIONS = [""]). You can specify single IP addresses (both IPv4 and IPv6) and subnets.

import saturn
saturn.config.ALLOWED_DESTINATIONS = [""]
saturn.config.AUTHENTICATION_METHODS = ["saturn.auth.none"]
saturn.start_server("", 8080) 

This config will allow passwordless connections with allowed proxying for IP range. You can use multiple auth methods at once like ["saturn.auth.none", saturn.auth.dict"]

Authentication methods

Current SOCKS5 standart supports

  • None ["saturn.auth.none"]
  • GSSAPI ["saturn.auth.gssapi"]
  • Login/Password (dict format) ["saturn.auth.dict"]

Custom authentication methods

You can implement your own authentication method (Login/Password)
All you need to do is to implement Authenticator class with async def authenticate(self, data) method which will return bool authentication result. Then just import your module and use it in config
saturn.config.AUTHENTICATION_METHODS = ["your_auth_method"] You can see examples in saturn.auth

TODO list

  • Logging
  • Max socket limit
  • More tests

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

saturn_proxy_server-0.9.tar.gz (8.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page