vpnlist
A tiny manager of OpenVPN configs obtained from vpngate.net for Linux.
Installation
Get a proper binary from the "Releases" page. Maybe make sure it's in your $PATH variable for convenience.
Usage
update
At first, you should get some servers from vpngate.net:
$ vpnlist update
vpngate.net API offers a fraction of its servers per request, so vpnlist
stores them in the local sqlite database located in the .config/vpnlist/
directory of the current user.
The update command is meant to be used from time to time, so it may be a good idea to run it on schedule to incrementally expand the list of available servers.
all
Show descriptions of all servers stored in the local database.
$ vpnlist all
IP Host Speed
ID xxx.xxx.xxx.xxx public-vpn-xxx 22.42 Mbps
JP xxx.xxx.xxx.xxx public-vpn-xxx 78.40 Mbps
...
Output of this command can be filtered with country
and speed
flags:
$ vpnlist all --country JP -c US --speed 100
countries
Show the list of all countries represented in the local database.
$ vpnlist countries
Australia (AU)
Egypt (EG)
Indonesia (ID)
Japan (JP)
...
show
Show config of a specific server
$ vpnlist show public-vpn-xxx
###############################################################################
# OpenVPN 2.0 Sample Configuration File
...
random
Show a random config
$ vpnlist random
###############################################################################
# OpenVPN 2.0 Sample Configuration File
...
Random selection can be limited the same way as the all
command:
$ vpnlist random --country JP --speed 20
How to use with OpenVPN
- Output of
show
and random
commands can be stored in .ovpn
file and used as usual.
- Alternatively the output can be piped:
$ vpnlist random | sudo openvpn /dev/stdin
Credits
- VPN Gate - Public Free VPN Cloud by Univ of Tsukuba, Japan