Ivan Ilves e434b6c562 Update README.md
Route discovery update.
2017-02-23 22:02:16 +01:00
2017-02-20 20:14:09 +01:00
2017-02-08 05:38:18 +01:00
2017-02-23 22:02:16 +01:00
2017-02-21 09:36:55 +01:00
2017-02-23 20:03:41 +01:00

xiringuito

SSH-based VPN for poors 😉

VPN made easy! No configuration. No VPN servers. No hassle. Just plug and use!

This is the "VPN without VPN" software done using nice built-in capabilities of SSH.

Install (just download it)

git clone https://github.com/ivanilves/xiringuito.git

Use (just run it)

cd xiringuito
./xiringuito user@your.ssh.server 10.0.0.0/8 192.168.0.0/16

Yes! That easy - just pass an SSH server and the list of networks your want to access through this server.

You will need:

  • Linux or Mac system
  • Local sudo privileges
  • Remote sudo privileges

Mac note

Install TunTap for Mac OS X first.

Route discovery

Specifiying routes by hand is not bad. But we could make it better by creating an executable discover-routes script in the project directory. If no routes are passed by hand, xiringuito will run discover-routes, pass SSH server hostname to it and use script output as a list of routes, so you may have per-host or per-domain route lists instead of boring manual typing. More information is available in AWS example which uses AWS CLI to discover VPC subnets and route traffic to them through our VPN tunnel.

You can have many of them!

As long as your routes do not overlap, you can run as many xiringuito tunnels as you want. Simultaneously.

Description
Languages
Shell 97.1%
Makefile 2.9%