Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Full-featured" VPN over an SSH tunnel

Project description

As far as I know, sshuttle is the only program that solves the following common case:

  • Your client machine (or router) is Linux, FreeBSD, or MacOS.
  • You have access to a remote network via ssh.
  • You don’t necessarily have admin access on the remote network.
  • The remote network has no VPN, or only stupid/complex VPN protocols (IPsec, PPTP, etc). Or maybe you are the admin and you just got frustrated with the awful state of VPN tools.
  • You don’t want to create an ssh port forward for every single host/port on the remote network.
  • You hate openssh’s port forwarding because it’s randomly slow and/or stupid.
  • You can’t use openssh’s PermitTunnel feature because it’s disabled by default on openssh servers; plus it does TCP-over-TCP, which has terrible performance (see below).

Obtaining sshuttle

  • Debian stretch or later:

    apt-get install sshuttle
    
  • From PyPI:

    sudo pip install sshuttle
    
  • Clone:

    git clone https://github.com/sshuttle/sshuttle.git
    cd sshuttle
    sudo ./setup.py install
    

It is also possible to install into a virtualenv as a non-root user.

  • From PyPI:

    virtualenv -p python3 /tmp/sshuttle
    . /tmp/sshuttle/bin/activate
    pip install sshuttle
    
  • Clone:

    virtualenv -p python3 /tmp/sshuttle
    . /tmp/sshuttle/bin/activate
    git clone https://github.com/sshuttle/sshuttle.git
    cd sshuttle
    ./setup.py install
    
  • Homebrew:

    brew install sshuttle
    

Documentation

The documentation for the stable version is available at: http://sshuttle.readthedocs.org/

The documentation for the latest development version is available at: http://sshuttle.readthedocs.org/en/latest/

Project details


Release history Release notifications

This version
History Node

0.78.4

History Node

0.78.3

History Node

0.78.2

History Node

0.78.1

History Node

0.78.0

History Node

0.77.2

History Node

0.77.1

History Node

0.77

History Node

0.76

History Node

0.75

History Node

0.74

History Node

0.73

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
sshuttle-0.78.4-py2.py3-none-any.whl (46.9 kB) Copy SHA256 hash SHA256 Wheel 3.6 Apr 2, 2018
sshuttle-0.78.4.tar.gz (72.5 kB) Copy SHA256 hash SHA256 Source None Apr 2, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page