extern/sshuttle
1
1
Fork 0
mirror of https://github.com/sshuttle/sshuttle.git synced 2024-11-22 07:53:43 +01:00
Code Issues Packages Projects Releases Wiki Activity
Transparent proxy server that works as a poor man's VPN. Forwards over ssh. Doesn't require admin. Works with Linux and MacOS. Supports DNS tunneling.
404 Commits 9 Branches 50 Tags 3.6 MiB
Python 95.9%
Shell 3.1%
Nix 0.5%
Dockerfile 0.5%
ba8e948c0d
Go to file
Brian May ba8e948c0d Don't allocate socket until we need it 
Wew were trying to allocate an IPv6 socket even though we weren't using
IPv6, causing failures on systems without IPv6 support available.

This change means a number of methods on MultiListener, e.g. setsockopt,
should not be called until after the bind call.

Closes #68
2016-01-30 11:28:59 +11:00
docs Remove references to number of years 2016-01-21 08:42:34 +11:00
sshuttle Don't allocate socket until we need it 2016-01-30 11:28:59 +11:00
.gitignore Experimental: Use setuptools-scm 2016-01-13 19:00:08 +11:00
.travis.yml Disable Python 2.6 tests 2015-11-17 09:33:46 +11:00
CHANGES.rst Release version 0.76 2016-01-17 18:38:43 +11:00
LICENSE Moved docs out of the src directory 2014-09-15 14:14:52 +10:00
MANIFEST.in Don't distribute sshuttle/version.py 2016-01-18 09:00:00 +11:00
README.rst Release version 0.76 2016-01-17 18:38:43 +11:00
requirements.txt Add requirements.txt for readthedocs 2016-01-17 16:32:53 +11:00
run Make sure we use Python 3.5 2016-01-30 11:27:37 +11:00
setup.py Fix installation from wheel 2016-01-17 10:21:21 +11:00
tox.ini Add tox.ini file. 2015-12-07 13:17:09 +11:00
VERSION.txt Version 0.75 2016-01-12 12:29:08 +11:00

README.rst 

sshuttle: where transparent proxy meets VPN meets ssh
=====================================================

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
------------------

- From PyPI::

      pip install sshuttle

- Clone::

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

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/