18 releases (stable)

1.4.4 Jul 26, 2022
1.4.3 Oct 17, 2021
1.4.2 Jan 16, 2021
1.4.1 Mar 1, 2020
0.3.0 Jul 26, 2018

#963 in Network programming

36 downloads per month

MIT license

53KB
921 lines

NordSelect

This package is passively maintained. As I don't have a NordVPN account anymore, I'm no longer developing NordSelect. If someone finds a bug, open an issue and I'll do my best to fix it. If you feel like a feature is missing, feel free to open a PR. I'll be happy to have a look at it and merge.

- Ward Segers, maintainer of NordSelect

Build Status dependency status

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

Installation

Arch Linux

Nordselect is available for Arch Linux as the nordselect AUR package.

If you don't want to compile this program (which can take a while if you're compiling from scratch), you can use my custom repository and install a precompiled binary. The repo only supports x86_64.

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

We might add extra installation options in the future.

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.

Dependencies

~8–21MB
~303K SLoC