Node.js中离线集成ip2region：实现高效的IP地址定位

server/2024/10/18 6:10:15/

ip2region是一个离线IP地址定位库，支持多种编程语言，包括Node.js。其准确率高达99.9%，查询效率也非常高，非常适合在需要IP地址定位的场景中使用。下面是在Node.js项目中如何使用ip2region的详细步骤。

第一步：下载ip2region

由于npm上安装的ip2region模块可能基于TypeScript语法，而Node.js默认使用CommonJS模块化规范，因此建议从GitHub或Gitee上直接下载基于JS和CommonJS规范的版本。这里以Gitee为例：

访问Gitee上的ip2region仓库：https://gitee.com/lionsoul/ip2region。
下载仓库中的项目文件。

第二步：将项目文件导入到你的Node.js项目中

将下载的ip2region项目文件解压，并将你需要的部分（如JavaScript绑定和数据文件）复制到你的Node.js项目目录中。
确保ip2region.xdb数据文件在你的项目目录中，这是进行IP地址查询的关键文件。

第三步：设置和导入模块

在你的Node.js文件中，你需要导入ip2region模块，并设置数据文件路径。假设你的项目结构如下：

project/
│
├── node_modules/
│   └── ...
│
├── ip2region-master/
│   ├── binding/
│   │   └── nodejs/
│   │       └── index.js
│   └── data/
│       └── ip2region.xdb
│
└── app.js

在app.js中，你可以这样导入ip2region模块并设置数据文件路径：

const Searcher = require('./ip2region-master/binding/nodejs/index');
const dbPath = './ip2region-master/data/ip2region.xdb';

第四步：编写查询函数

使用ip2region进行查询，可以通过创建一个Searcher对象，并调用其search方法来实现。由于search方法是异步的，你需要使用async/await语法或者Promise来处理结果。

下面是一个示例查询函数：

async function getIpAddress(ip) {try {// 如果需要，可以同步读取vectorIndex来优化查询性能// const vectorIndex = Searcher.loadVectorIndexFromFile(dbPath);// 创建searcher对象，这里直接使用文件路径const searcher = Searcher.newWithFileOnly(dbPath);// 查询IP地址const data = await searcher.search(ip);// 处理查询结果（例如，格式化输出）console.log(data); // 输出：{region: '中国|0|江苏省|苏州市|电信', ioCount: 2, took: 0.402874}// 可以根据需要对数据进行进一步处理return data;} catch (e) {console.error('查询失败:', e);throw e;}
}// 测试查询函数
const ip = '218.4.167.70';
getIpAddress(ip);