⭐ fast search ip in range collection ipv4 and ipv6 (it is based on nesting Trie)
- support range format:
- ip CIDR range: 5.151.236.0/23
- ip-ip range string: 103.18.156.0-103.18.157.255
- ip-ip range bigint: 42540528726795050063891204319802818560-42540528806023212578155541913346768895 or 2548867325-2548867326
const IpCollection = new require('node-ip-collection');
const ip = new IpCollection({
useHash: false, // default value false ( hash string value to int is true param)
maxSearch: 100, // default value 100, max Number.MAX_SAFE_INTEGER
offsetIpV4: 2, // min split first ipv4
offsetIpV6: 2, // min split first ipv6
});
// fixture data
const BotSearch = [
{
"range": "103.18.156.0-103.18.157.255\n103.18.158.0-103.18.159.255\n103.197.28.0-103.197.29.255",
"value": "yandex"
},
{
"range": "103.197.30.0-103.197.31.255\n103.199.184.0-103.199.185.255",
"value": "yandex"
},
]
// load fixture
for(let index = 0, len = BotSearch.length; i < len; i++) {
const {range, value} = BotSearch[i];
ip.loadFromString(range, value);
}
// find ip in range collection
console.log(ip.lookup('103.18.158.1'))| method | description |
|---|---|
| castIpV6ToNum(ipString) | convert ipv6 to bingint string |
| castIpV4ToNum(ipString) | convert ipv4 to bingint string |
| castBigIntIpToV4Str(ipBigInt) | convert bigint to ipv4 string |
| castBigIntIpToV6Str(ipBigInt) | convert bigint to ipv6 string |
| loadFromString(list, value) | load data to database |
| lookup(ip, all) | find range for database |
| import(data) | import data from result export() method |
| export() | export data to json string |
| insertRange(startNumber, endNumber, ipType, value) | insert range to database |
| insertRangeAddress(startAddr, endAddr , ipType, value) | insert range Address4 or Address6 to database |
| clear() | clear all data |
full load data ~58sec (yes it’s long, but don’t rush to give up)
await (new Promise((resolve, reject) => {
fs.createReadStream(__dirname + '/GeoLite2-City-Blocks-IPv4.csv')
.pipe(csv.parse({headers: true}))
.on('error', error => console.error(error))
.on('data', row => {
ip.loadFromString(row.network, row.geoname_id)
})
.on('end', () => {
resolve();
})
}));search geoname_id ~0.736ms
console.time('test')
console.log('result', '151.236.160.253', ip.lookup('151.236.160.253', true));
console.timeEnd('test')- is export data to json and load data from json
- full load data ~8sec
- search geoname_id ~0.736ms