A nativeNode.js API for the GeoLite data from MaxMind.
This product includes GeoLite data created by MaxMind, available frommaxmind.com.

This module is an enhanced and updated version ofgeoip-lite, carefully designed to meet the latest programming standards.

All components have been thoroughly updated to ensure optimal performance and functionality.The module now runs even faster, thanks to file minification!

Furthermore, the testing process has been improved with the adoption of theJest testing library.

I am not the primary creator of this! All copyright rights belong to the originalauthors.

Remember to regularly update the Maxmind database. You'll need the token for this.

This module requires a significant amount of RAM because geolocation data is stored in memory.However, you can always opt for the official alternative, thegeoip2-api module, which sends requests to an API server and retrieves information about specific IP addresses directly from there.

You can see this module in action using myofficial API. The API interface is public and can be safely used in your projects without any limits. Happy coding!

• Specific IP:https://api.sefinek.net/api/v2/geoip/109.207.159.255
• Client's IP:https://api.sefinek.net/api/v2/geoip/me
• Documentation:https://api.sefinek.net/docs/v2

MaxMind provides a set of data files for IP to Geo mapping along with opensource libraries to parse and lookup these data files.One would typically write a wrapper around their C API to get access to this data in other languages (like JavaScript).

GeoIP-Lite instead attempts to be a fully native JavaScript library. A converter script converts the CSV files from MaxMind intoan internal binary format (note that this is different from the binary data format provided by MaxMind). The geo-ip module uses thisbinary file to lookup IP addresses and return the country, region and city that it maps to.

Both IPv4 and IPv6 addresses are supported, however since the GeoLite IPv6 database does not currently contain any city or regioninformation, city, region and postal code lookups are only supported for IPv4.

I was really aiming for a fast JavaScript native implementation for geomapping of IPs.My prime motivator was the fact that it was really hard to get libgeoip built for Mac OSX without using the library from MacPorts.

GeoIP-Lite is a fully JavaScript implementation of the MaxMind GeoIP API. It is not as fully featured as bindings that uselibgeoip.By reducing scope, this package is about 40% faster at doing lookups. On average, an IP to Location lookup should take 20 microseconds ona Macbook Pro. IPv4 addresses take about 6 microseconds, while IPv6 addresses take about 30 microseconds.

constgeoIp2=require('geoip-lite2');constip='146.19.109.255';constgeo=geoIp2.lookup(ip);console.log(geo);

{"range": [2450746624,2450746879 ],"country":"PL","region":"14","eu":"1","timezone":"Europe/Warsaw","city":"Warsaw","ll": [52.2296,21.0067 ],"metro":0,"area":20}

npm install geoip-lite2

Runcd node_modules/geoip-lite2 && npm run updatedb license_key=YOUR_LICENSE_KEY to update the data files. (ReplaceYOUR_LICENSE_KEY with your license key obtained frommaxmind.com)

You can create maxmind accounthere.

[!NOTE]
This requires a lot of RAM. It is known to fail on a Digital Ocean or AWS micro instance.There are no plans to change this. GeoIP-Lite2 stores all data in RAM in order to be fast.If you need an external API that provides GeoIP, you can usethis.

GeoIP-Lite2 is completely synchronous. There are no callbacks involved.All blocking file IO is done at startup time, so all runtime calls are executed in-memory and are fast.Startup may take up to 200ms while it reads into memory and indexes data files.

If you have an IP address in dotted quad notation, IPv6 colon notation, or a 32-bit unsigned integer (treatedas an IPv4 address), pass it to thelookup method. Note that you should remove any[ and] around anIPv6 address before passing it to this method.

constgeo=geoIp2.lookup(ip);

If the IP address was found, thelookup method returns an object with the following structure:

{range:[<lowboundofIPblock>,<highboundofIPblock> ],   country: 'CC',                 // 2 letter ISO-3166-1 country code   region: 'RR',                  // Up to 3 alphanumeric variable length characters as ISO 3166-2 code                                  // For US states this is the 2 letter state                                  // For the United Kingdom this could be ENG as a country like “England                                  // FIPS 10-4 subcountry code   eu: '0',                       // 1 if the country is a member state of the European Union, 0 otherwise.   timezone: 'Country/Zone',      // Timezone from IANA Time Zone Database   city: 'City Name',             // This is the full city name   ll: [<latitude>,<longitude>], // The latitude and longitude of the city   metro:<metrocode>,           // Metro code   area:<accuracy_radius>        // The approximate accuracy radius (km), around the latitude and longitude}

The actual values for therange array depend on whether the IP is IPv4 or IPv6 and should beconsidered internal togeoip-lite2. To get a human-readable format, pass them togeoip.pretty()

If the IP address was not found, thelookup returnsnull

If you have a 32-bit unsigned integer, or a number returned as part of therange array from thelookup method,thepretty method can be used to turn it into a human-readable string.

console.log('The IP is %s',geoIp2.pretty(ip));

This method returns a string if the input was in a format thatgeoip-lite2 can recognise, else it returns theinput itself.

This package contains an update script that can pull the files from MaxMind and handle the conversion from CSV.A npm script alias has been setup to make this process easy. Please keep in mind this requires internet and MaxMindrate limits that amount of downloads on their servers.

You will need, at minimum, a free license key obtained frommaxmind.com to run the update script.

Package stores checksums of MaxMind data and by default only downloads them if checksums have changed.

# Update data if new data is availablenpm run updatedb license_key=YOUR_LICENSE_KEY# Force update data even if checksums have not changednpm run updatedb-force license_key=YOUR_LICENSE_KEY

You can also run it by doing:

node ./node_modules/geoip-lite2/tools/updatedb.js license_key=YOUR_LICENSE_KEY

If you have a server runninggeoip-lite2, and you want to reload its geo data, after you finished update, without a restart.

You can do it programmatically, calling after scheduled data updates

// SynchronouslygeoIp2.reloadDataSync();// AsynchronouslygeoIp2.reloadData(()=>{console.log('Done');});

You can enable the data watcher to automatically refresh in-memory geo data when a file changes in the data directory.

geoIp2.startWatchingDataUpdate();

This tool can be used withnpm run updatedb to periodically update geo data on a running server.

The following environment variables can be set.

# Override the default node_modules/geoip-lite/data dirGEOTMPDIR=/some/path# Override the default node_modules/geoip-lite/tmp dirGEODATADIR=/some/path

This package includes the GeoLite database from MaxMind. This database is not the most accurate database available,however it is the best available for free. You can use the commercial GeoIP database from MaxMind with betteraccuracy by buying a license from MaxMind, and then using the conversion utility to convert it to a format thatGeoIP-Lite understands. You will need to use the.csv files from MaxMind for conversion.

Also note that on occasion, the library may take up to 5 seconds to load into memory. This is largely dependent onhow busy your disk is at that time. It can take as little as 200ms on a lightly loaded disk. This is a one timecost though, and you make it up at run time with very fast lookups.

Quick test on memory consumption shows that library uses around 100 MB per process.

constgeoIp2=require('geoip-lite2');console.log(process.memoryUsage());/** * Output: * { *     rss: 126365696, *     heapTotal: 7753728, *     heapUsed: 5844880, *     external: 164098897, *     arrayBuffers: 163675390 * }**/

• Documentation from MaxMind
• ISO 3166 (1 & 2) codes
• FIPS region codes

GeoIP-Lite is Copyright 2011-2018Philip Tellisphilip@bluesmoon.info
GeoIP-Lite2 is Copyright 2023-2024Sefinekcontact@sefinek.net (https://sefinek.net)

There are two licenses for the code and data. See theLICENSE file for details.