介绍
@maxmind/geoip2-node
是一个Node.js模块,用于与MaxMind的GeoIP2数据库进行交互,从而获取IP地址的地理位置信息。MaxMind的GeoIP2数据库包含了全球范围内的IP地址和对应的地理位置信息,如国家、城市、经纬度等。使用@maxmind/geoip2-node
模块,您可以轻松地在Node.js应用程序中查询IP地址的地理位置信息。
特点:
- 支持异步和同步方式打开MaxMind的GeoIP2数据库文件。
- 提供了丰富的方法来查询IP地址的地理位置信息,包括国家、城市、经纬度等。
- 可以通过IPv4或IPv6地址进行查询。
- 可以在Node.js应用程序中方便地集成和使用。
使用
- 安装
@maxmind/geoip2-node
模块
npm install @maxmind/geoip2-node
- 安装MAXMIND离线的GeoLite2数据库(免费、更快、但需要更新数据、准确率相对较低)
1、下载需要登录,先注册并登录,然后点击 Download Files
2、下载自己需要的资源即可,我这里选择的是GeoLite2 City
3、把需要的资源文件放到自己的目录下 - 在Node.js代码中引入
@maxmind/geoip2-node
模块:
const Reader = require('@maxmind/geoip2-node').Reader;
- 打开MaxMind的GeoIP2数据库文件并查询IP地址的地理位置信息:
Reader.open('/path/to/GeoLite2-City.mmdb').then(reader => {
const response = reader.city('128.101.101.101');
console.log(response.country.isoCode);
});
- 您可以根据需要使用不同的查询方法,如
.country()
、.city()
、.asn()
等来获取不同的地理位置信息。
案例
函数封装
//解析ip 查询地理位置信息: { country: '中国', city: '成都' }
const maxmind = require('@maxmind/geoip2-node');
// 封装查询地理位置信息的函数
function getGeoDataFromIP(ipAddress, callback) {
const dbPath = 'C:\\lalal\\config\\GeoLite2-City.mmdb';
// 使用Reader打开GeoLite2数据库
maxmind.Reader.open(dbPath)
.then((reader) => {
const geoData = reader.city(ipAddress);
// 创建一个简化的地理位置信息对象,尝试获取中文的国家和城市名称
const simplifiedGeoData = {
country: geoData.country.names['zh-CN'] ? geoData.country.names['zh-CN'] : '未知国家',
city: geoData.city.names['zh-CN'] ? geoData.city.names['zh-CN'] : '未知城市'
};
// 通过回调函数返回简化的地理位置信息
callback(null, simplifiedGeoData);
})
.catch((error) => {
console.error('Error opening GeoLite2 database: ', error);
callback(error, null);
});
}
// 导出这个函数,以便它可以在其他文件中被引入和使用
module.exports.getGeoDataFromIP = getGeoDataFromIP;
使用
getGeoDataFromIP(ip, (error, geoData) => {
if (error) {
console.error('查询地理位置信息时发生错误:', error);
return;
}
console.log('查询到的地理位置信息:', geoData);
});
结果