vpncloud/README.md

48 lines
2.1 KiB
Markdown
Raw Permalink Normal View History

2015-11-23 20:05:07 +00:00
VpnCloud - Peer-to-Peer VPN
---------------------------
[![Build Status](https://travis-ci.org/dswd/vpncloud.rs.svg?branch=master)](https://travis-ci.org/dswd/vpncloud.rs)
[![Coverage Status](https://coveralls.io/repos/dswd/vpncloud.rs/badge.svg?branch=master&service=github)](https://coveralls.io/github/dswd/vpncloud.rs?branch=master)
[![Latest Version](https://img.shields.io/crates/v/vpncloud.svg)](https://crates.io/crates/vpncloud)
**VpnCloud** is a simple VPN over UDP. It creates a virtual network interface on
the host and forwards all received data via UDP to the destination. It can work
on TUN devices (IP based) and TAP devices (Ethernet based). Tunneling traffic
between two nodes can be as easy as:
```
vpncloud -c REMOTE_HOST:PORT --ifup 'ifconfig $IFNAME 10.0.0.1/24 mtu 1400 up'
```
More details can be found in [the manpage](vpncloud.md).
2015-11-25 18:23:25 +00:00
Some performance measurements can be found [here](performance.md).
2015-11-24 17:39:42 +00:00
### Current Status
2015-12-10 08:53:14 +00:00
This project is still [under development](CHANGELOG.md) and has yet to reach a stable state.
2015-11-26 21:16:51 +00:00
However, the main functionality should work and you are invited to test it.
This is what works:
* Setting up tunnels between two networks via Ethernet (TAP) and IP (TUN)
* Connecting multiple networks with multiple forwarding behaviors (Hub, Switch, Router)
2015-12-02 13:16:13 +00:00
* Encrypted connections using [libsodium](https://github.com/jedisct1/libsodium)
2015-11-26 21:16:51 +00:00
* Automatic peer-to-peer meshing
* NAT and (limited) firewall traversal using hole punching
* Automatic reconnecting when connections are lost
* Non-native forwarding modes, e.g. IP based learning switch and prefix routed Ethernet networks.
* High throughput and low additional latency (see [performance page](performance.md))
* Support for tunneled VLans (TAP device)
2015-11-24 17:39:42 +00:00
However there are some open issues:
* Encryption has not been thoroughly reviewed, use with care.
2015-11-26 21:16:51 +00:00
* The software is not very well tested and the protocol can change.
2015-11-24 17:39:42 +00:00
Please feel free to help and contribute code.
### Semantic Versioning
2015-11-26 21:16:51 +00:00
This project uses [semantic versioning](http://semver.org). Currently that means that everything can change between versions before 1.0 is finally released.