This (macOS) tool automates the generation of WireGuard configuration files for NordVPN servers. It allows users to generate configurations for specific countries or all available countries, leveraging NordVPN's recommended servers.
This tool automates extracting of the NordVPN WireGuard privatekey from keychain (macOS). Please make sure you read Usage below.
npx generate-nordvpn-wgconf
or
npm install -g generate-nordvpn-wgconf
npx generate-nordvpn-wgconf --nordvpn-accountid yyy --outdir . --country TH,JP --amount 2
Generating 3 configs for Thailand
no --pk specified, trying to extract from keychain with id xxx
wrote config for Thailand at NordVPN Thailand #28.conf
wrote config for Thailand at NordVPN Thailand #33.conf
Generating 3 configs for Japan
no --pk specified, trying to extract from keychain with id xxx
wrote config for Japan at NordVPN Japan #690.conf
wrote config for Japan at NordVPN Japan #533.conf
You have to either specify your NordVPN WireGuard privatekey (if you know it already), or specify your NordVPN AccountID, get it from https://my.nordaccount.com/dashboard/nordvpn/manual-configuration/
- If
--pkis specified, it will just use that and no macOS specific functionality is used - If
--nordvpn-accountidis specified, it will do a keychain lookup to find your NordVPN credentials, to extract the privatekey.
❯ npx generate-nordvpn-wgconf --nordvpn-accountid XXXXXX --outdir . --country JP --amount 3
Generating 3 configs for Japan
no --pk specified, trying to extract from keychain with id XXXXXX
wrote config for Japan at /tmp/NordVPN Wireguard/NordVPN Japan #673.conf
wrote config for Japan at /tmp/NordVPN Wireguard/NordVPN Japan #517.conf
wrote config for Japan at /tmp/NordVPN Wireguard/NordVPN Japan #754.conf
Read carefully, otherwise it won't work.
- Install NordVPN from the Mac AppStore, not directly from the website or brew
- Go into settings and change protocol to NordLynx
- Connect to any server with NordLynx, doesn't matter which
After doing that, NordVPN will store the NordLynx (WireGuard) credentials in keychain, for us to extract.
--country,-c: Specify the country code(s) (ISO 3166-1 alpha-2 code) for which to generate the configuration. For example,USfor the United States.DE,JPfor Germany and Japan.--wireguard-privatekey,-pk: Your WireGuard private key. This is required unless using--nordvpn-accountid.--nordvpn-accountid,-id: Your NordVPN account ID. Required if you do not provide a WireGuard private key.--dns-server,-dns: Specify the DNS server to use in the configuration. Defaults to103.86.96.100.--amount,-a: The number of configurations to generate for the specified country. Defaults to1.--all-countries: Generate configurations for all available countries.--outdir,-o: The output directory for the generated configuration files. Defaults to the current working directory.
To generate a configuration for a specific country with your WireGuard private key:
npx generate-nordvpn-wgconf --country US --wireguard-privatekey YOUR_PRIVATE_KEY --outdir /path/to/output/dirTo generate multiple configurations for a specific country:
npx generate-nordvpn-wgconf --country US --wireguard-privatekey YOUR_PRIVATE_KEY --amount 5 --outdir /path/to/output/dirTo generate configurations for all available countries:
npx generate-nordvpn-wgconf --all-countries --wireguard-privatekey YOUR_PRIVATE_KEY --outdir /path/to/output/dirTo generate configurations for all available countries:
npx generate-nordvpn-wgconf --country JP,DE --wireguard-privatekey YOUR_PRIVATE_KEY --outdir /path/to/output/dirContributions are welcome. Please open an issue or submit a pull request with your improvements.
MIT