Skip to content
Easily connect to a VPN in a country of your choice.
Branch: master
Clone or download
Latest commit 0a23ee2 Jun 26, 2019


Code Climate dependencies Status devDependency Status npm npm version

This project was inspired by autovpn. Automatically connect you to a random VPN in a country of your choice. It uses openvpn to connect you to a server obtained from VPN Gate.

Differently from autovpn, this tool is able to run on Windows. Instead of executing sudo directly from the code, this tool leaves the task up to the user, so it is supposed to work on any platform.


openvpn must be installed and set in the environment.

your cmd/powershell/shell etc... must have user elevation.


npm install easyvpn -g


To connect to any received vpn connection:

$ easyvpn

To connect to a VPN from a specific country:

$ easyvpn -c US

Country name may be short or long:

$ easyvpn -c Japan

$ easyvpn -c JP

You can even wait for easyvpn to resolve the countries and then choose between them:

$ easyvpn -q

A proxy can be used to get data from

$ easyvpn -p http://myproxy:3128

To pass special arguments to openvpn:

$ easyvpn -o "--dev-type tun --dev tun0"


  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request


Regarding the security concerns, this tool is not even close to be safe to use. VPN connections are dangerous and may expose you to threats. I'd never recommend to use this tool inside a network that can't be compromised.


Licence © Rodrigo Gomes da Silva

You can’t perform that action at this time.