dswd
/
vpncloud
mirror of https://github.com/dswd/vpncloud.git
1
0
Fork 0
Code Issues Releases Wiki Activity

Readme

This commit is contained in:
Dennis Schwerdel 2015-11-23 21:05:07 +01:00
parent dc66b03f16
commit 0eab15b4d7
2 changed files with 20 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
README.md Normal file
View File

@ -0,0 +1,17 @@
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).

6
vpncloud.md
View File

@ -115,7 +115,7 @@ in 3 different modes:
This mode is the default mode for TUN devices that work with IP packets but This mode is the default mode for TUN devices that work with IP packets but
it can also be used with TAP devices and Ethernet frames. it can also be used with TAP devices and Ethernet frames.
All connected vpncloud nodes will form a peer-to-peer network and cross-connect All connected VpnCloud nodes will form a peer-to-peer network and cross-connect
automatically until the network is fully connected. The nodes will periodically automatically until the network is fully connected. The nodes will periodically
exchange information with the other nodes to signal that they are still active exchange information with the other nodes to signal that they are still active
and to allow the automatic cross-connect behavior. There are some important and to allow the automatic cross-connect behavior. There are some important
@ -156,7 +156,7 @@ address of the remote node and the the `X` in the interface address must be
unique among all nodes, e.g. 0, 1, 2, ...): unique among all nodes, e.g. 0, 1, 2, ...):
``` ```
vpncloud -c remote_node:3210 --ifup 'ifconfig $IFNAME 10.0.0.X/24 mtu 1400 up' vpncloud -c REMOTE_HOST:PORT --ifup 'ifconfig $IFNAME 10.0.0.X/24 mtu 1400 up'
``` ```
Afterwards, the interface can be used to communicate. Afterwards, the interface can be used to communicate.
@ -168,7 +168,7 @@ In this example, 4 nodes should communicate using IP. First, VpnCloud need to
be started on both nodes: be started on both nodes:
``` ```
vpncloud -t tun -c remote_node:3210 --subnet 10.0.0.X/32 --ifup 'ifconfig $IFNAME 10.0.0.0/24 mtu 1400 up' vpncloud -t tun -c REMOTE_HOST:PORT --subnet 10.0.0.X/32 --ifup 'ifconfig $IFNAME 10.0.0.0/24 mtu 1400 up'
``` ```