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

  • <input type="checkbox" checked="" disabled="" /> None ["saturn.auth.none"]
  • <input type="checkbox" disabled="" /> GSSAPI ["saturn.auth.gssapi"]
  • <input type="checkbox" checked="" disabled="" /> 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

  • <input type="checkbox" disabled="" /> Logging
  • <input type="checkbox" disabled="" /> Max socket limit
  • <input type="checkbox" disabled="" /> 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.

Files for saturn-proxy-server, version 0.9
Filename, size File type Python version Upload date Hashes
Filename, size saturn_proxy_server-0.9.tar.gz (8.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page