GitPedia

Easyvpn

Easily connect to a VPN in a country of your choice.

From rodrigogs·Updated March 11, 2026·View on GitHub·

This project was inspired by [autovpn](https://github.com/adtac/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](http://www.vpngate.net/en/). The project is written primarily in JavaScript, distributed under the BSD 2-Clause "Simplified" License license, first published in 2017. Key topics include: autovpn, choice, countries, nodejs, openvpn.

Latest release: 1.3.1Updated dependencies
December 19, 2017View Changelog →

easyvpn

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.

Requirements

openvpn must be installed and set in the environment.

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

Install

npm install easyvpn -g

Usage

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 vpngate.net:

$ easyvpn -p http://myproxy:3128

To pass special arguments to openvpn:

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

Contributing

  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

Disclaimer

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.

License

Licence © Rodrigo Gomes da Silva

Contributors

Showing top 3 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from rodrigogs/easyvpn via the GitHub API.Last fetched: 6/14/2026