{ "info": { "author": "Yury (Yurzs)", "author_email": "dev@best-service.online", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.7", "Topic :: Software Development :: Build Tools" ], "description": "# Socks5 async proxy server\nSaturn is a SOCKS5 server based on asyncio protocols\n## Installation\n### From [pypi.org](https://pypi.org/project/saturn-proxy-server/)\n```bash\npip install saturn-proxy-server\n```\n### From this repo\n```bash\ngit clone https://git.best-service.online/yurzs/saturn.git\ncd saturn\npython3 ./setup.py install\n```\n## Usage\nPlease edit `config.py` file before starting your server. \nBy default proxying allowed to all hosts (`ALLOWED_DESTINATIONS = [\"0.0.0.0/0\"]`). You can specify single IP addresses \n(both IPv4 and IPv6) and subnets. \n```python3\nimport saturn\nsaturn.config.ALLOWED_DESTINATIONS = [\"192.168.1.0/24\"]\nsaturn.config.AUTHENTICATION_METHODS = [\"saturn.auth.none\"]\nsaturn.start_server(\"127.0.0.1\", 8080) \n```\nThis config will allow passwordless connections with allowed proxying for `192.168.1.0-192.169.1.255` IP range.\nYou can use multiple auth methods at once like `[\"saturn.auth.none\", saturn.auth.dict\"]`\n## Authentication methods\nCurrent SOCKS5 standart supports\n- [x] None [\"saturn.auth.none\"]\n- [ ] GSSAPI [\"saturn.auth.gssapi\"]\n- [x] Login/Password (dict format) [\"saturn.auth.dict\"]\n### Custom authentication methods\nYou can implement your own authentication method (Login/Password) \nAll you need to do is to implement `Authenticator` class with `async def authenticate(self, data)` method which will return `bool`\nauthentication result. Then just import your module and use it in config \n`saturn.config.AUTHENTICATION_METHODS = [\"your_auth_method\"]`\nYou can see examples in `saturn.auth`\n\n### TODO list\n- [ ] Logging\n- [ ] Max socket limit\n- [ ] More tests", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://git.best-service.online/yurzs/saturn", "keywords": "Saturn,Socks5,proxy", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "saturn-proxy-server", "package_url": "https://pypi.org/project/saturn-proxy-server/", "platform": "", "project_url": "https://pypi.org/project/saturn-proxy-server/", "project_urls": { "Homepage": "https://git.best-service.online/yurzs/saturn" }, "release_url": "https://pypi.org/project/saturn-proxy-server/0.9/", "requires_dist": null, "requires_python": "", "summary": "Socks5 async proxy server", "version": "0.9", "yanked": false, "yanked_reason": null }, "last_serial": 6089927, "releases": { "0.4": [ { "comment_text": "", "digests": { "md5": "731939b6cb4e65126502c43709371070", "sha256": "65fc845cf2ed384a729f4ff1d44c46340cf20702ee529b05ae3b9662dad9e0c0" }, "downloads": -1, "filename": "saturn_proxy_server-0.4.tar.gz", "has_sig": false, "md5_digest": "731939b6cb4e65126502c43709371070", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8070, "upload_time": "2019-10-27T13:35:42", "upload_time_iso_8601": "2019-10-27T13:35:42.892259Z", "url": "https://files.pythonhosted.org/packages/09/04/bd24241b4cd86e238633b991aecf1fcd8337212542954e082f7fa2f51cb2/saturn_proxy_server-0.4.tar.gz", "yanked": false, "yanked_reason": null } ], "0.5": [ { "comment_text": "", "digests": { "md5": "2c285b17e9e8dc1837017c8120358696", "sha256": "435cf605c8b3a9ce9c6385315ad6cbad467388ca5ac3ad3a7b8cb440b48c6e83" }, "downloads": -1, "filename": "saturn_proxy_server-0.5.tar.gz", "has_sig": false, "md5_digest": "2c285b17e9e8dc1837017c8120358696", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7867, "upload_time": "2019-10-27T17:37:52", "upload_time_iso_8601": "2019-10-27T17:37:52.418803Z", "url": "https://files.pythonhosted.org/packages/d1/c0/e50bf2f9f44ba8afe649dc16d1721e18103bb909152dfde15d635d9a98c8/saturn_proxy_server-0.5.tar.gz", "yanked": false, "yanked_reason": null } ], "0.6": [ { "comment_text": "", "digests": { "md5": "c1cbf4cd5c112128bac8afc59d8cd229", "sha256": "4e191eab574d3de7682de8f6bf01ae998856ddaf381f0c1fb2edece3376fa955" }, "downloads": -1, "filename": "saturn_proxy_server-0.6.tar.gz", "has_sig": false, "md5_digest": "c1cbf4cd5c112128bac8afc59d8cd229", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7864, "upload_time": "2019-10-27T18:17:06", "upload_time_iso_8601": "2019-10-27T18:17:06.125059Z", "url": "https://files.pythonhosted.org/packages/bb/57/370d301e5baafbab328d54fe91b4094c2a6681427c7aa3f89c7e05f178af/saturn_proxy_server-0.6.tar.gz", "yanked": false, "yanked_reason": null } ], "0.7": [ { "comment_text": "", "digests": { "md5": "a4626e18a1d4f7f950b752d81dbfb6b2", "sha256": "dc8c295a3d836ce0373f968ebb7a0905ad1dd53c640dfad51c00ec83a7ed4e76" }, "downloads": -1, "filename": "saturn_proxy_server-0.7.tar.gz", "has_sig": false, "md5_digest": "a4626e18a1d4f7f950b752d81dbfb6b2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7861, "upload_time": "2019-10-27T18:53:27", "upload_time_iso_8601": "2019-10-27T18:53:27.025350Z", "url": "https://files.pythonhosted.org/packages/64/92/abb0cdb09c69305088755e2fffad0e15c0d58040beb5f4dead1bc423739f/saturn_proxy_server-0.7.tar.gz", "yanked": false, "yanked_reason": null } ], "0.9": [ { "comment_text": "", "digests": { "md5": "44fe0584547d24906ccad1a70bb7a6e5", "sha256": "0366b666cd97f2755de3a3053bca81a33353df8df2f34ffbef5d1116941775db" }, "downloads": -1, "filename": "saturn_proxy_server-0.9.tar.gz", "has_sig": false, "md5_digest": "44fe0584547d24906ccad1a70bb7a6e5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8353, "upload_time": "2019-11-06T22:03:05", "upload_time_iso_8601": "2019-11-06T22:03:05.142651Z", "url": "https://files.pythonhosted.org/packages/4b/27/fc8ef3c6d5dd584a09c59a59012b4ba209716981237c619c147162f96433/saturn_proxy_server-0.9.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "44fe0584547d24906ccad1a70bb7a6e5", "sha256": "0366b666cd97f2755de3a3053bca81a33353df8df2f34ffbef5d1116941775db" }, "downloads": -1, "filename": "saturn_proxy_server-0.9.tar.gz", "has_sig": false, "md5_digest": "44fe0584547d24906ccad1a70bb7a6e5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8353, "upload_time": "2019-11-06T22:03:05", "upload_time_iso_8601": "2019-11-06T22:03:05.142651Z", "url": "https://files.pythonhosted.org/packages/4b/27/fc8ef3c6d5dd584a09c59a59012b4ba209716981237c619c147162f96433/saturn_proxy_server-0.9.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }