mirror of
https://github.com/davegallant/vpngate.git
synced 2025-08-06 08:43:40 +00:00
16aa16c66e
As mentioned in https://github.com/davegallant/vpngate/issues/126, adding support for proxies will help bypass issues when vpngate.net is not accessible directly. This works by: ```sh # http proxy sudo vpngate connect --proxy "http://localhost:8080" # socks5 proxy sudo vpngate connect --socks5 "127.0.0.1:1080" ```
108 lines
2.4 KiB
Markdown
108 lines
2.4 KiB
Markdown
# vpngate
|
|
|
|
This is a client for [vpngate.net](https://www.vpngate.net/).
|
|
|
|
|
|
|
|
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:
|
|
|
|
```shell
|
|
curl ipinfo.io
|
|
```
|
|
|
|
## Requirements
|
|
|
|
- [openvpn](https://github.com/OpenVPN/openvpn)
|
|
- macOS or Linux
|
|
|
|
## Install
|
|
|
|
The simplest method of installation is using homebrew. You can also build from source.
|
|
|
|
### from homebrew
|
|
|
|
vpngate can be installed with [homebrew](https://brew.sh/) (ensure that xcode is installed before installing homebrew by running `xcode-select --install`).
|
|
|
|
```shell
|
|
|
|
brew install openvpn davegallant/public/vpngate
|
|
```
|
|
|
|
### from source
|
|
|
|
Ensure that [go](https://golang.org/doc/install) is installed.
|
|
|
|
```shell
|
|
CGO_ENABLED=0 go get github.com/davegallant/vpngate
|
|
```
|
|
|
|
Ensure that the go bin path is discoverable:
|
|
|
|
```shell
|
|
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
|
|
|
|
```shell
|
|
vpngate list
|
|
```
|
|
|
|
### Connect to a server
|
|
|
|
Because openvpn creates a network interface, run the connect command with `sudo` or a user with escalated privileges.
|
|
|
|
```shell
|
|
sudo vpngate connect
|
|
```
|
|
|
|
#### Reconnect
|
|
|
|
To continually attempt to reconnect (this can be combined with `--random`):
|
|
|
|
```shell
|
|
sudo vpngate connect --reconnect
|
|
```
|
|
|
|
#### Random
|
|
|
|
If the country doesn't matter, a random server can be selected:
|
|
|
|
```shell
|
|
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.
|
|
|
|
```shell
|
|
sudo vpngate connect --proxy "http://localhost:8080"
|
|
```
|
|
|
|
##### SOCKS5
|
|
|
|
Use the specified SOCKS5 proxy to fetch the server list.
|
|
|
|
```shell
|
|
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
|