This is a client for 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/json, or run the following:
curl ipinfo.io- OpenVPN
- macOS, Linux, or Windows
You can install vpngate in a few different ways, and it will differ slightly depending on your OS.
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/vpngateOn 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.
Ensure that go is installed.
CGO_ENABLED=0 go get github.com/davegallant/vpngateEnsure that the go bin path is discoverable:
echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.profile
source ~/.profileIf on macOS, you may need to add openvpn to your PATH (if you installed it with brew):
export PATH=$(brew --prefix openvpn)/sbin:$PATH
vpngate is a client for vpngate.net
vpngate [flags]
-h, --help help for vpngate
Generate the autocompletion script for the specified shell
Generate the autocompletion script for vpngate for the specified shell. See each sub-command's help for details on how to use the generated script.
-h, --help help for completion
Generate the autocompletion script for bash
Generate the autocompletion script for the bash shell.
This script depends on the 'bash-completion' package. If it is not installed already, you can install it via your OS's package manager.
To load completions in your current shell session:
source <(vpngate completion bash)
To load completions for every new session, execute once:
vpngate completion bash > /etc/bash_completion.d/vpngate
vpngate completion bash > $(brew --prefix)/etc/bash_completion.d/vpngate
You will need to start a new shell for this setup to take effect.
vpngate completion bash
-h, --help help for bash
--no-descriptions disable completion descriptions
Generate the autocompletion script for fish
Generate the autocompletion script for the fish shell.
To load completions in your current shell session:
vpngate completion fish | source
To load completions for every new session, execute once:
vpngate completion fish > ~/.config/fish/completions/vpngate.fish
You will need to start a new shell for this setup to take effect.
vpngate completion fish [flags]
-h, --help help for fish
--no-descriptions disable completion descriptions
Generate the autocompletion script for powershell
Generate the autocompletion script for powershell.
To load completions in your current shell session:
vpngate completion powershell | Out-String | Invoke-Expression
To load completions for every new session, add the output of the above command to your powershell profile.
vpngate completion powershell [flags]
-h, --help help for powershell
--no-descriptions disable completion descriptions
Generate the autocompletion script for zsh
Generate the autocompletion script for the zsh shell.
If shell completion is not already enabled in your environment you will need to enable it. You can execute the following once:
echo "autoload -U compinit; compinit" >> ~/.zshrc
To load completions in your current shell session:
source <(vpngate completion zsh)
To load completions for every new session, execute once:
vpngate completion zsh > "${fpath[1]}/_vpngate"
vpngate completion zsh > $(brew --prefix)/share/zsh/site-functions/_vpngate
You will need to start a new shell for this setup to take effect.
vpngate completion zsh [flags]
-h, --help help for zsh
--no-descriptions disable completion descriptions
Connect to a vpn server (survey selection appears if hostname is not provided)
Connect to a vpn from a list of relay servers. Because openvpn creates a network interface, run the connect command with 'sudo' or a user with escalated privileges.
vpngate connect [flags]
-h, --help help for connect
-p, --proxy string provide a http/https proxy server to make requests through (i.e. http://127.0.0.1:8080)
-r, --random connect to a random server
-t, --reconnect continually attempt to connect to the server
-s, --socks5 string provide a socks5 proxy server to make requests through (i.e. 127.0.0.1:1080)
List all available vpn servers
vpngate list [flags]
-h, --help help for list
-p, --proxy string provide a http/https proxy server to make requests through (i.e. http://127.0.0.1:8080)
-s, --socks5 string provide a socks5 proxy server to make requests through (i.e. 127.0.0.1:1080)
- 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