{
    "info": {
        "author": "Vladislav Yarmak",
        "author_email": "vladislav-ex-src@vm-0.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 4 - Beta",
            "Environment :: No Input/Output (Daemon)",
            "Intended Audience :: System Administrators",
            "License :: OSI Approved :: MIT License",
            "Natural Language :: English",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3.5",
            "Topic :: Internet",
            "Topic :: Security"
        ],
        "description": "rsp\n===\n\nRapid SSH Proxy. Like `ssh -ND`, but much faster.\n\n`rsp` is a SSH client which implements SOCKS5 proxy feature of SSH protocol. Key feature of this implementation is use of multiple connections to overcome downsides of multiplexing many tunneled TCP connections in single SSH session. Multiple sessions are not limited with TCP window size of single connection and packet loss does not affect all tunneled connections at once. In order to cut latency of connection establishment `rsp` maintains pool of steady connections, which replenished with configurable rate.\n\n## Features\n\n* High speed as compared to conventional OpenSSH client.\n* Cross-platrorm (Windows, Linux, macOS and other Unix-like systems).\n* Zero-setup required for server. `rsp` can be used right away with any SSH server.\n* Self-sufficient: doesn't require OpenSSH on client side to operate.\n* SOCKS5 remote DNS support.\n* Connection establishment latency hidden from user with asynchronous connection pool.\n* Connection establishment rate limit guards user from being threated as SSH flood.\n* Supports transparent mode of operation (Linux only), which means rsp can be used on Linux gateway to wrap traffic of entire network seamlessly.\n\n## Performance\n\nTested with Debian 9 server through 100Mbps connection. Round trip time to server is 128 ms, average packet loss is about 0.5%.\n\nClient is a Linux desktop (Fedora 30, Python 3.7.3, OpenSSH 8.0p1).\n\n| OpenSSH | rsp |\n| ------- | --- |\n| ![Speedtest - OpenSSH](https://www.speedtest.net/result/8425714040.png) | ![Speedtest - rsp](https://www.speedtest.net/result/8425718956.png) |\n\n## Installation\n\nPython 3.5.3+ required.\n\nFrom PyPI:\n\n```\npip3 install rsp\n```\n\nFrom source (run in a source directory):\n\n```\npip3 install .\n```\n\nWindows note: make sure you have Python3 installed and executable locations added into your PATH enviroment variable (it's an option available during install). Also make sure to run install command from Administrator command line.\n\n## Synopsis\n\n### Proxy\n\n```\n$ rsp --help\nusage: rsp [-h] [-v {debug,info,warn,error,fatal}] [-l FILE]\n           [--disable-uvloop] [-a BIND_ADDRESS] [-p BIND_PORT] [-T]\n           [-n POOL_SIZE] [-B BACKOFF] [-w TIMEOUT] [-r CONNECT_RATE]\n           [-L LOGIN] [-I KEY_FILE] [-P PASSWORD] [-H FILE]\n           [--client-version CLIENT_VERSION]\n           dst_address [dst_port]\n\nRapid SSH Proxy\n\npositional arguments:\n  dst_address           target hostname\n  dst_port              target port (default: 22)\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -v {debug,info,warn,error,fatal}, --verbosity {debug,info,warn,error,fatal}\n                        logging verbosity (default: info)\n  -l FILE, --logfile FILE\n                        log file location (default: None)\n  --disable-uvloop      do not use uvloop even if it is available (default:\n                        False)\n\nlisten options:\n  -a BIND_ADDRESS, --bind-address BIND_ADDRESS\n                        bind address (default: 127.0.0.1)\n  -p BIND_PORT, --bind-port BIND_PORT\n                        bind port (default: 1080)\n  -T, --transparent     transparent mode (default: False)\n\npool options:\n  -n POOL_SIZE, --pool-size POOL_SIZE\n                        target number of steady connections (default: 30)\n  -B BACKOFF, --backoff BACKOFF\n                        delay after connection attempt failure in seconds\n                        (default: 5)\n  -w TIMEOUT, --timeout TIMEOUT\n                        server connect timeout (default: 4)\n  -r CONNECT_RATE, --connect-rate CONNECT_RATE\n                        limit for new pool connections per second (default:\n                        0.5)\n\nSSH options:\n  -L LOGIN, --login LOGIN\n                        SSH login. Default is name of current user (default:\n                        None)\n  -I KEY_FILE, --identity KEY_FILE\n                        SSH private key file. By default program looks for SSH\n                        keys in usual locations, including SSH agent socket.\n                        This option may be specified multiple times (default:\n                        None)\n  -P PASSWORD, --password PASSWORD\n                        SSH password. If not specified, password auth will be\n                        disabled (default: None)\n  -H FILE, --hosts-file FILE\n                        overrides known_hosts file location (default:\n                        /home/user/.rsp/known_hosts)\n  --client-version CLIENT_VERSION\n                        override client version string (default: None)\n```\n\n#### Usage examples\n\nNote: host keys must be added to trusted list before proxy operation. See synopsis for `rsp-trust` utility.\n\nConnect to example.com with SSH on port 22, using default pool size, and accept SOCKS5 connections on port 1080. Authentication is using SSH Agent and username `root`.\n\n```\nrsp -L root example.com\n```\n\nConnect to example.net with SSH on port 2222, using private key in file `proxy_key` and username `user`.\n\n```\nrsp -I proxy_key -L user example.net 2222\n```\n\nConnect to example.com with SSH on port 22, using password and username of current user:\n\n```\nrsp -P MyGoodPassword example.com\n```\n\n#### Transparent mode\n\nIn order to use `rsp` in transparent mode you should add `-T` option to command line and redirect TCP traffic to `rsp` port like this:\n\n```sh\niptables -I PREROUTING 1 -t nat -p tcp -s 192.168.0.0/16 '!' -d 192.168.0.0/16 -j REDIRECT --to 1080\n```\n\nIn this example it is assumed your local network is covered by prefix 192.168.0.0/16 and `rsp` is running on it's default port 1080.\n\n**NOTE:** any application which supposed to accept `REDIRECT`-ed connection has to listen address on same interface where connection comes from. So, in this example you should also add command line option like `-a 192.168.0.1` or `-a 0.0.0.0` to rsp command line. Otherwise redirected connection will be refused. See also `man iptables-extension` for details on `REDIRECT` action of iptables.\n\n### Trust management utility\n\n```\n$ rsp-trust --help\nusage: rsp-trust [-h] [-H FILE] dst_address [dst_port]\n\nRapid SSH Proxy: TOFU key trust utility\n\npositional arguments:\n  dst_address           target hostname\n  dst_port              target port (default: 22)\n\noptional arguments:\n  -h, --help            show this help message and exit\n\nSSH options:\n  -H FILE, --hosts-file FILE\n                        overrides known_hosts file location (default:\n                        /home/user/.rsp/known_hosts)\n```\n\n#### Usage examples\n\nGet host key from example.com, port 22\n\n```\nrsp-trust example.com\n```\n\nGet host key from example.net, port 2222 and use non-default location of trusted keys file:\n\n```\nrsp-trust -H myhostkeysfile example.net 2222\n```\n\n### Key generation utility\n\n```\n$ rsp-keygen --help\nusage: rsp-keygen [-h] [-f FILE]\n                  [-t {ssh-ed25519,ssh-rsa,ecdsa-sha2-nistp256,ecdsa-sha2-nistp384,ecdsa-sha2-nistp521,ssh-dss}]\n                  [-b BITS]\n\nRapid SSH Proxy: key generation utility\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -f FILE, --file FILE  output file name (default: proxy_key)\n  -t {ssh-ed25519,ssh-rsa,ecdsa-sha2-nistp256,ecdsa-sha2-nistp384,ecdsa-sha2-nistp521,ssh-dss}, --type {ssh-ed25519,ssh-rsa,ecdsa-sha2-nistp256,ecdsa-sha2-nistp384,ecdsa-sha2-nistp521,ssh-dss}\n                        key type (default: ssh-ed25519)\n  -b BITS, --bits BITS  key type (default: 2048)\n```\n\n#### Usage examples\n\nGenerate SSH key with good default parameters:\n\n```\nrsp-keygen\n```\n\nPrivate and public key will be saved to `proxy_key` and `proxy_key.pub` respectively.\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/Snawoot/rsp",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "rsp",
        "package_url": "https://pypi.org/project/rsp/",
        "platform": "",
        "project_url": "https://pypi.org/project/rsp/",
        "project_urls": {
            "Homepage": "https://github.com/Snawoot/rsp"
        },
        "release_url": "https://pypi.org/project/rsp/0.4.1/",
        "requires_dist": [
            "sdnotify (>=0.3.2)",
            "asyncssh (>=1.16.0)",
            "setuptools (>=38.6.0) ; extra == 'dev'",
            "wheel (>=0.31.0) ; extra == 'dev'",
            "twine (>=1.11.0) ; extra == 'dev'",
            "uvloop (>=0.11.0) ; extra == 'uvloop'"
        ],
        "requires_python": ">=3.5.3",
        "summary": "Rapid SSH Proxy",
        "version": "0.4.1"
    },
    "last_serial": 5858747,
    "releases": {
        "0.2.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "0b8cd5ba0558951909b6bba3685add74",
                    "sha256": "011902e332ea86898e660cb634b2f01840cbf1f9c959d632064112280f082322"
                },
                "downloads": -1,
                "filename": "rsp-0.2.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "0b8cd5ba0558951909b6bba3685add74",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5.3",
                "size": 15032,
                "upload_time": "2019-07-19T22:29:46",
                "url": "https://files.pythonhosted.org/packages/af/b0/76267febfe7dff358b8be591db52566516e422367d6a934e16f24a5bfcd7/rsp-0.2.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "45e84e5dcac9bbb50b25da20d6a40c53",
                    "sha256": "4564440dade750b5b87b2749948be8ecb0dbe930a284bf6eb6bae5af8966ecd2"
                },
                "downloads": -1,
                "filename": "rsp-0.2.0.tar.gz",
                "has_sig": false,
                "md5_digest": "45e84e5dcac9bbb50b25da20d6a40c53",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5.3",
                "size": 13637,
                "upload_time": "2019-07-19T22:29:49",
                "url": "https://files.pythonhosted.org/packages/4d/3b/7a59fb6f9844e2d68c2b1a414859639fbd3d91c89aba983cb0c16efcb052/rsp-0.2.0.tar.gz"
            }
        ],
        "0.2.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "7e336cf2a6527a37436e956921eb88d8",
                    "sha256": "af1f665c02bdf7af9232948ce5f1ce639a53755a2af048e3e881be393420c8bb"
                },
                "downloads": -1,
                "filename": "rsp-0.2.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "7e336cf2a6527a37436e956921eb88d8",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5.3",
                "size": 15132,
                "upload_time": "2019-07-20T10:10:05",
                "url": "https://files.pythonhosted.org/packages/79/19/17b4e0f1cf6673f6ab84e2dcf128af914d4dbfaec50a5238ff2f69514fa1/rsp-0.2.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "40868986b103fe721ff0045b4083da0a",
                    "sha256": "d551cab8ac9d5be0a3c1b0129a7b28e4ad8395981ca9f1c2b1365809d2f4a8a8"
                },
                "downloads": -1,
                "filename": "rsp-0.2.1.tar.gz",
                "has_sig": false,
                "md5_digest": "40868986b103fe721ff0045b4083da0a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5.3",
                "size": 13728,
                "upload_time": "2019-07-20T10:10:07",
                "url": "https://files.pythonhosted.org/packages/af/4a/8662d2d296680ff04df6b383970108e8f4a17cb1188224aa5af3d02ed298/rsp-0.2.1.tar.gz"
            }
        ],
        "0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "fb1c6bcf299303e3fc208a1fb774b68e",
                    "sha256": "6bbb229caaa02f698066ac065b6a938463bdda805913a8b15cdde341ed07a90c"
                },
                "downloads": -1,
                "filename": "rsp-0.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "fb1c6bcf299303e3fc208a1fb774b68e",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5.3",
                "size": 15188,
                "upload_time": "2019-08-21T16:25:04",
                "url": "https://files.pythonhosted.org/packages/b5/0c/254ec8a48063912a5d8509e4473b03e3aadfc7903f6bcfce4fb447f1af43/rsp-0.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "9398396b36007cd52fe2282e5ca988ab",
                    "sha256": "70b6641a312b53dc422b45920441d126f752b5d35c8b809a8dcf09fececabc97"
                },
                "downloads": -1,
                "filename": "rsp-0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "9398396b36007cd52fe2282e5ca988ab",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5.3",
                "size": 13850,
                "upload_time": "2019-08-21T16:25:05",
                "url": "https://files.pythonhosted.org/packages/24/4e/591cc2c661ad1fa21933c52aff2414125111701bc5fa2af4d105dbd7e71b/rsp-0.3.tar.gz"
            }
        ],
        "0.3.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f82c21d708263fc426c84148898a0db0",
                    "sha256": "34c7464510c992c923fb4ccf000142bf54047ee0d245d9d6f00a081a9c15ca93"
                },
                "downloads": -1,
                "filename": "rsp-0.3.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "f82c21d708263fc426c84148898a0db0",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5.3",
                "size": 15333,
                "upload_time": "2019-08-30T17:41:19",
                "url": "https://files.pythonhosted.org/packages/aa/36/a462fac27ab738a5cded6188f59bbfc305181b1a5181e3a8adca999f47d6/rsp-0.3.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "c8bd7378a802812ea49d3e434676ab93",
                    "sha256": "be7fd25a8023f4e934acc34d66f27e4703374b5c5097c6f6d72f9458ff58e1f7"
                },
                "downloads": -1,
                "filename": "rsp-0.3.1.tar.gz",
                "has_sig": false,
                "md5_digest": "c8bd7378a802812ea49d3e434676ab93",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5.3",
                "size": 13939,
                "upload_time": "2019-08-30T17:41:21",
                "url": "https://files.pythonhosted.org/packages/fb/24/662c11f3f782743205e92d5f19043baa92c9bc1dfd4ff46410c4bd5a6769/rsp-0.3.1.tar.gz"
            }
        ],
        "0.4.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c01b5d131eb09444411468722a5a0971",
                    "sha256": "d20637a2cc017d95616b729aeb83ab5c8760294843812b1c47eed40d6a2f7059"
                },
                "downloads": -1,
                "filename": "rsp-0.4.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "c01b5d131eb09444411468722a5a0971",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5.3",
                "size": 18070,
                "upload_time": "2019-09-19T20:52:57",
                "url": "https://files.pythonhosted.org/packages/a9/ef/74349821fb898bb8a1c8d9430f2c6245c00605005160d6a7df217f3b20ca/rsp-0.4.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "8613ea0f68a083526f75278452a1fd35",
                    "sha256": "f376f134bda2f20087072715e8927bdc2db99eab69eed8830e2d90e9065e01d8"
                },
                "downloads": -1,
                "filename": "rsp-0.4.0.tar.gz",
                "has_sig": false,
                "md5_digest": "8613ea0f68a083526f75278452a1fd35",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5.3",
                "size": 15830,
                "upload_time": "2019-09-19T20:52:59",
                "url": "https://files.pythonhosted.org/packages/1f/6c/24fb0e0f529281af1e772bc03768922485abbede39ebe0b3787c5851b136/rsp-0.4.0.tar.gz"
            }
        ],
        "0.4.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "fca8e47a619f02043967bb2484700e13",
                    "sha256": "e2646852bf26e5d2013275b79e2b823bfa2108bb5197730f45d6c9f16f5b09cc"
                },
                "downloads": -1,
                "filename": "rsp-0.4.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "fca8e47a619f02043967bb2484700e13",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5.3",
                "size": 18067,
                "upload_time": "2019-09-19T20:57:54",
                "url": "https://files.pythonhosted.org/packages/84/2b/1bfcd45e2d13d19e73317a7f4a1c2fab7840d3c3dc2c917251320a763bc6/rsp-0.4.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "9f9df82a9a77f61916e40328a820cb98",
                    "sha256": "d3e1e2e34c1d4c49b7034ad2c5b3ebeaab34d53c3ea63d8dca795f6a5b5adbdc"
                },
                "downloads": -1,
                "filename": "rsp-0.4.1.tar.gz",
                "has_sig": false,
                "md5_digest": "9f9df82a9a77f61916e40328a820cb98",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5.3",
                "size": 15839,
                "upload_time": "2019-09-19T20:57:55",
                "url": "https://files.pythonhosted.org/packages/3c/a3/3f3cbaa791a4a65db31c4607c6b97145d10510f613402a25df673f1562b9/rsp-0.4.1.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "fca8e47a619f02043967bb2484700e13",
                "sha256": "e2646852bf26e5d2013275b79e2b823bfa2108bb5197730f45d6c9f16f5b09cc"
            },
            "downloads": -1,
            "filename": "rsp-0.4.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "fca8e47a619f02043967bb2484700e13",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.5.3",
            "size": 18067,
            "upload_time": "2019-09-19T20:57:54",
            "url": "https://files.pythonhosted.org/packages/84/2b/1bfcd45e2d13d19e73317a7f4a1c2fab7840d3c3dc2c917251320a763bc6/rsp-0.4.1-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "9f9df82a9a77f61916e40328a820cb98",
                "sha256": "d3e1e2e34c1d4c49b7034ad2c5b3ebeaab34d53c3ea63d8dca795f6a5b5adbdc"
            },
            "downloads": -1,
            "filename": "rsp-0.4.1.tar.gz",
            "has_sig": false,
            "md5_digest": "9f9df82a9a77f61916e40328a820cb98",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5.3",
            "size": 15839,
            "upload_time": "2019-09-19T20:57:55",
            "url": "https://files.pythonhosted.org/packages/3c/a3/3f3cbaa791a4a65db31c4607c6b97145d10510f613402a25df673f1562b9/rsp-0.4.1.tar.gz"
        }
    ]
}