Files
vpngate/README.md
Dave Gallant a2afbc1e35 Add initial prototype (#1)
* Add survey library to select server

* Add speedtest

* Add --random flag to connect

* Add list command

* Cache server list

* Tail the openvpn logs so that it appears in vpngate logs

* Add goreleaser action

* Add golangci-lint action
2020-12-31 02:56:01 -05:00

57 lines
1.3 KiB
Markdown

# vpngate
This is a client for [vpngate.net](https://www.vpngate.net/).
![image](https://user-images.githubusercontent.com/4519234/103308173-ce250780-49df-11eb-9032-ef832e5b9463.png)
This client fetches the list of available relay servers provided by vpngate.net. Once connected to a relay server, speed tests kick off to determine latency, upload speed and download speed.
![image](https://user-images.githubusercontent.com/4519234/103308641-e47f9300-49e0-11eb-8ff2-77c6e3e8cc7b.png)
Once connected, you can check out your IP address: https://nordvpn.com/what-is-my-ip/
## Requirements
- [openvpn](https://github.com/OpenVPN/openvpn)
- macOS or Linux (might work on Windows)
## Install
```sh
go get github.com/davegallant/vpngate
```
## Usage
### List Available VPNs
```sh
$ vpngate list
```
### Connect to a VPN
Because openvpn creates a network interface, run the connect command with `sudo` or a user with escalated privileges.
```sh
$ sudo vpngate connect
```
#### Random
If the country doesn't matter, a random VPN can be selected:
```sh
$ sudo vpngate connect --random
```
## Notes
- I do not maintain any of the VPN servers on vpngate.net. Connect to these VPN servers at your own discretion
- Many of the listed servers claim to have a logging policy of 2 weeks
## Todo
- Allow for servers to be cycled periodically (--cycle)