Skip to content

Latest commit

 

History

History
118 lines (71 loc) · 2.99 KB

README.md

File metadata and controls

118 lines (71 loc) · 2.99 KB
Raw

vpngate

This is a client for vpngate.net.

vpngate

This client fetches the list of available relay servers provided by vpngate.net, and allows you to filter and connect to a server of your liking.

You can check out your current IP address and region at https://ipinfo.io, or run the following:

curl ipinfo.io

Requirements

  • OpenVPN
  • macOS, Linux, or Windows

Install

You can install vpngate in a few different ways, and it will differ slightly depending on your OS.

Homebrew (macOS and linux)

vpngate can be installed with homebrew (if on macOS, ensure that xcode is installed before installing homebrew by running xcode-select --install).

brew install openvpn davegallant/public/vpngate

Windows

On Windows, install OpenVPN from the official website.

As there is no installer at the moment, you will need to download and extract the Windows release from the relevant Github release.

Once the release is extracted, open Command Prompt as Administrator, and run vpngate.exe from the location where it was extracted.

image image

Build from source

Ensure that go is installed.

CGO_ENABLED=0 go get github.com/davegallant/vpngate

Ensure that the go bin path is discoverable:

echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.profile
source ~/.profile

Usage

If on macOS, you may need to add openvpn to your PATH (if you installed it with brew): export PATH=$(brew --prefix openvpn)/sbin:$PATH

List available servers

vpngate list

Connect to a server

Because openvpn creates a network interface, run the connect command with sudo or a user with escalated privileges.

sudo vpngate connect

Reconnect

To continually attempt to reconnect (this can be combined with --random):

sudo vpngate connect --reconnect

Random

If the country doesn't matter, a random server can be selected:

sudo vpngate connect --random

Proxy

In some cases, anonymity is necessary to populate the list of available VPN servers.

A proxy is a way to bypass restrictions and in some cases, internet censorship.

HTTP/HTTPS

Use the specified HTTP/HTTPS proxy to fetch the server list.

sudo vpngate connect --proxy "http://localhost:8080"
SOCKS5

Use the specified SOCKS5 proxy to fetch the server list.

sudo vpngate connect --socks5 "127.0.0.1:1080"

Notes

  • I do not maintain any of the servers on vpngate.net (connect to these servers at your own discretion)
  • Many of the listed servers claim to have a logging policy of 2 weeks