Skip to content

Latest commit

 

History

History
105 lines (75 loc) · 2.16 KB

pvpn.8.txt

File metadata and controls

105 lines (75 loc) · 2.16 KB

pvpn(8) Manual Page

NAME

pvpn - VPN over SSH

SYNOPSIS

pvpn [OPTION] …​ SSH-HOST [ROUTE] …​

DESCRIPTION

pvpn sets up VPN connections via SSH servers. This can be useful to either get easy access to a private network, or to encrypt all Internet traffic when on a public network. pvpn is only little more than a wrapper around OpenSSH ssh(1), but provides a convenient interface to set up VPNs.

GENERAL OPTIONS

-h, --help

Show help and exit.

-v, --version

Show version and exit.

-d, --debug

Trace code execution.

CONNECT OPTIONS

-t TYPE, --type TYPE

Type of tunnel. Valid options are:

  • ppp (ppp over ssh)

  • ssh-3 (OpenSSH Layer 3)

-i IP1:IP2, --ip IP1:IP2

Use IP1 for local and IP2 for remote tunnel device IPs. Default any:any, which becomes 10.b.c.1:10.b.c.2 where b and c are random.

-s SSH-IP, --first-ssh-hop SSH-IP

Tell IP address or hostname of first SSH server. Needed when you connect through reverse tunnels or intermediate servers with ProxyCommand.

-D, --inherit-dns

Inherit DNS settings from SSH-HOST. When disconnecting, the current DNS settings will be restored.

DISCONNECT OPTIONS

-S [DEVICE], --stop [DEVICE]

Stop tunnel with client device DEVICE, or all if no DEVICE is given, then exit.

EXAMPLES

Gain access to the 192.168.xxx.yyy network at work

$ pvpn -i 10.10.0.1:10.10.0.2 root@work 192.168.0.0/16

Encrypt all IP traffic, e.g. when on a public wifi using OpenSSH Layer 3

$ pvpn -t ssh-3 root@secureproxy default

PORTABILITY

Works-for-me™. Developed and tested on Arch Linux. If you’re interested in porting or hacking, see https://www.github.com/halhen/pvpn.

FILES

/run/pvpn/

Tunnel state files

AUTHORS

BUGS

COPYRIGHT

{sys:head -n1 LICENSE}

Released under the BSD 3-Clause License, see LICENSE.

SEE ALSO

ssh(1), sshd(8), sshd_config(5), pppd(8), ssh-keygen(1), iptables(8)