@avindak/xgeoip

Resolve IP addresses to countries in memory

Usage no npm install needed!

<script type="module">
  import avindakXgeoip from 'https://cdn.skypack.dev/@avindak/xgeoip';
</script>

README

@avindak/xgeopip

npm (scoped) npm bundle size (minified)

Provides a fast, seamless in memory ip to country functionality based on the ip2nation db.

  • Dependencies (adm-zip, sqlite3)
  • Completely free
  • Country resolution only
  • Queries / sec > 2.3k per core
  • Memory footprint < 40 MB
  • Command line support
  • Does not use MaxMind

Install

$ npm install @avindak/xgeopip

Usage

const geoip = require('@avindak/xgeoip');

await geoip.load_memory();
//AU
let res = await geoip.resolve("1.1.1.1");
console.log(res.country_code);
//IL
res = await geoip.resolve("84.108.14.154");
console.log(res.country_code);
//US
res = await geoip.resolve("34.44.12.234");
console.log(res.country_code);
//US
console.log(res);
//
//{
//  country_code: 'US',
//  country: 'United States',
//}

//Private
res = await geoip.resolve("192.168.1.1");
console.log(res.country_code);
//
console.log(res);
//{ country_code: '', country: 'Private', ip: '192.168.1.1' }

//Proxy example - prints US
res = await geoip.resolve("34.44.12.234 192.168.1.1");
console.log(res.country_code);

This uses the database from : http://www.ip2nation.com/