Gathering detailed insights and metrics for turbo-geoip-country
An updated, performance-focused fork of node-geoip with only country data
Installations
npm install turbo-geoip-countryDeveloper Guide
BETA
Typescript
No
Module System
CommonJS
Min. Node Version
>=5.10.0
Node Version
20.15.0
NPM Version
10.7.0
Score
72.4
Supply Chain
99.4
Quality
83.9
Maintenance
100
Vulnerability
88
License
Releases
Unable to fetch releases
Contributors
1
Unable to fetch Contributors
Languages
1
JavaScript
JavaScript (100%)
Developer
Download Statistics
Total Downloads
25,691
Last Day
69
Last Week
207
Last Month
623
Last Year
8,607
GitHub Statistics
2 Stars
291 Commits
1 Watching
2 Branches
Bundle Size
29.63 kB
Minified
9.47 kB
Minified + Gzipped
Maintainers
1
Package Meta Information
Latest Version
25.1.0
Package Id
turbo-geoip-country@25.1.0
Unpacked Size
20.68 MB
Size
5.31 MB
File Count
11
NPM Version
10.7.0
Node Version
20.15.0
Publised On
02 Jan 2025
Total Downloads
Cumulative downloads
Total Downloads
25,691
Last day
430.8%
69
Compared to previous day
Last week
130%
207
Compared to previous week
Last month
36.6%
623
Compared to previous month
Last year
-14.8%
8,607
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
1
Dev Dependencies
4
Versions
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 ð
1npm install turbo-geoip-country --save
How to use it ðĪ
1const turboGeoip = require('turbo-geoip-country'); 2 3const ip = "207.97.227.239"; 4const country = turboGeoip.getCountry(ip); 5console.log(country); 6'US' 7 8// Also it works with anonymized ip 9const ip = "207.97.227.0"; 10const country = turboGeoip.getCountry(ip); 11console.log(country); 12'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
1Found 30000 (17030/12970) ips in 120ms (250000.000 ip/s) (4Ξs/ip) 2Took 17 ms to startup
vs node-geoip node test/geo-lookup.js
1Found 30000 (16917/13083) ips in 215ms (139534.884 ip/s) (7Ξs/ip) 2Took 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
1> nodeunit test/tests.js 2 3 4tests.js 5â testLookup 6â testDataIP4 7â testDataIP6 8â testUpdatedIps 9 10OK: 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.
No vulnerabilities found.
No security vulnerabilities found.