nordselect 1.0.0

Select the ideal NordVPN server
Documentation

NordSelect

Build Status

A fast CLI and Rust crate to find the perfect NordVPN server to connect to, based on given filters.

Installation

Arch Linux

If you're on Arch Linux, you can install the nordselect AUR package.

Using Cargo

To install the nordselect CLI using Cargo (Rust package manager), enter cargo install nordselect.

Pinging

Because of the pinging functionality, you have to execute the following command if you want to use the ping feature:

# allow binary to send ping packets
sudo setcap cap_net_raw+ep ~/.cargo/bin/nordselect

Official binaries (PPA for Ubuntu and a binary AUR package) will be available when nordselect reaches the 1.0.0 release.

CLI Usage

nordselect [FLAGS] [OPTIONS] [filter ..]

For a full list of options and flags, run nordselect -h.

Filters

Possible filters are:

  • A country (in ISO 3166-1 alpha-2 format)
  • A protocol (tcp, udp)
  • A servertype (standard, p2p, tor, double, obfuscated, dedicated)

To see all filters, use nordselect --filters

Examples

# I don't care, just pick a server
nordselect

# A server in Latvia with P2P that supports p2p over tcp.
nordselect lv tcp p2p

# A server that supports both Tor and double VPN.
# At the moment of writing, no such server is available.
nordselect tor double

# Use case: in combination with the official NordVPN CLI:
# https://nordvpn.com/download/linux/
nordvpn connect `nordselect ua`

Library Usage

The documentation of the library can be found at docs.rs.

Development

The application is in development. If you encouter a bug, please open an issue describing how the bug occured or open a PR.

New features are not planned for now, but feel free to open issues to discuss them.

Warning: before running cargo test, use dummydata.sh to generate some dummy data.

Selection method

To select a server without waiting too long, we use the following method to find your preferred server.

  1. Download the list with all servers using the NordVPN API.
  2. Apply your filters on the received data.
  3. Sort the data on load.
  4. Pick the best one.

When using -p or -s, it will take the 10 servers with the least load and compare their ping values. If you think you have a better selection procedure, please let me know by opening an issue.

License

This project is licensed under the very permissive MIT License.