turbo-geoip-country
This is an updated, performance-focused fork of node-geoip with only country data. Inspired by geoip-ultralight
This product uses GeoLite data created by MaxMind, available from https://www.maxmind.com/
ðĄ You would need to create an account and get a license key to update data by yourself
How to install ð
npm install turbo-geoip-country --save
How to use it ðĪ
const turboGeoip = require('turbo-geoip-country');
const ip = "207.97.227.239";
const country = turboGeoip.getCountry(ip);
console.log(country);
'US'
// Also it works with anonymized ip
const ip = "207.97.227.0";
const country = turboGeoip.getCountry(ip);
console.log(country);
'US'
Why turbo-geoip-country âĄïļ
- ð Get country code (2 letter ISO-3166-1) by IP v4/v6
- ð Works also with anonymized IP
- ðĨ Performance focused (see the section below)
- â
Less than 19 MB memory footprint (instead of +110 MB of node-geoip)
- â° Data updated on 1st January 2025
- ð
Using Calendar versioning
- ð Production-ready, used by Ghostboard.io
- âĄïļ Dependencies updated and 5 of them removed
- ðĪ Code reduced
Performance ðĨ
ðĄ Based on the average performance of 10 executions of each package on a 2018 Mac Mini i7 6c12t 16GB
| Metric | node-geoip | turbo-geoip-country | delta |
|---|
| Startup time | 47 ms | 17 ms | 63.83 % faster |
| Time to find 1 ip | 7 Ξs/ip | 4 Ξs/ip | 42.86 % faster |
| IP lookups per second | 139534.884 ip/s | 250000.000 ip/s | 44.19 % more ip/s |
Test yourself node test/performance.js
Found 30000 (17030/12970) ips in 120ms (250000.000 ip/s) (4Ξs/ip)
Took 17 ms to startup
vs node-geoip node test/geo-lookup.js
Found 30000 (16917/13083) ips in 215ms (139534.884 ip/s) (7Ξs/ip)
Took 47 ms to startup
How to update the data ð
- Log in into your MaxMind account
- ðĄ You can create a MaxMind account here
- Go to "GeoIP 2 / GeoLite 2" > Downloads
- Download the "GeoLite2 Country: CSV Format" zip
- Unzip and put the files into the input folder
- Run
npm run regenerate
- ðĄ This takes about 1 minute or less
Tests â
Run npm t
> nodeunit test/tests.js
tests.js
â testLookup
â testDataIP4
â testDataIP6
â testUpdatedIps
OK: 7 assertions (19ms)
References
Copyright
geoip-lite is Copyright 2011-2018 Philip Tellis philip@bluesmoon.info and the latest version of the code is
available at https://github.com/bluesmoon/node-geoip
License
There are two licenses for the code and data. See the LICENSE file for details.
