mustafachyi/nordgen repository overview

⁠Nordgen

A high-performance CLI tool for generating optimized NordVPN WireGuard configurations. It automates credential exchange, minimizes latency through load-aware server selection, and outputs organized configuration files for immediate use.

This Dockerized Go implementation provides 1:1 functional parity with the Python version, optimized for minimal image size and zero-dependency container execution.

⁠Quick Start

The following commands handle directory setup, permission mapping, and container execution in a single line.

⁠Linux / macOS

Interactive Mode

mkdir -p generated_configs && docker run -it --rm -v "$(pwd)/generated_configs:/data" -u $(id -u):$(id -g) mustafachyi/nordgen

Automated Mode

mkdir -p generated_configs && docker run --rm -v "$(pwd)/generated_configs:/data" -u $(id -u):$(id -g) mustafachyi/nordgen --token "YOUR_TOKEN" --dns 1.1.1.1 --keepalive 15 --group standard p2p --exclude-dedicated

Get Private Key Only

docker run --rm mustafachyi/nordgen get-key --token "YOUR_TOKEN"

⁠Windows (PowerShell)

Interactive Mode

if (!(Test-Path generated_configs)) { mkdir generated_configs }; docker run -it --rm -v "${PWD}/generated_configs:/data" mustafachyi/nordgen

⁠Configuration Reference

Flags are appended directly to the container command.

⁠Output

Configurations are generated in the mounted volume under a timestamped directory (e.g., generated_configs/nordvpn_configs_20260206_202229/). The configurations are categorized by the server's group combination, country, and city:

nordvpn_configs_20260206_202229/
├── configs/
│   └── <group_combo>/<country>/<city>/<server_name>.conf
└── best_configs/
    └── <group_combo>/<country>/<city>/<server_name>.conf

• best_configs/: Optimally selected servers based on load and distance.
• configs/: Full server inventory.