IP Range Check

This module lets you check if an IP matches one or more IP's or CIDR ranges. It handles IPv6, IPv4, and IPv4-mapped over IPv6 addresses.

It accepts either:

• A single CIDR or IP string, e.g. "125.19.23.0/24", or "2001:cdba::3257:9652", or "62.230.58.1"
• An array of CIDR and/or IP strings, e.g. ["125.19.23.0/24", "2001:cdba::3257:9652", "62.230.58.1"]

Importantly, it cannot match an IPv4 address to an IPv6 CIDR or vice versa, (IPv4-mapped IPv6 addresses notwithstanding).

Installing

1npm install ip-range-check --save

IPv4

1var ipRangeCheck = require("ip-range-check");
2
3// Checks CIDR
4ipRangeCheck("192.168.1.1", "102.1.5.2/24")
5// > false
6ipRangeCheck("192.168.1.1", "192.168.1.0/24")
7// > true
8
9// Checks if IP matches string
10ipRangeCheck("192.168.1.1", "192.168.1.1")
11// > true
12
13// Checks array of CIDR's and string
14ipRangeCheck("192.168.1.1", ["102.1.5.2/24", "192.168.1.0/24", "106.1.180.84"])
15// > true
16
17// Compare IPv6 with IPv4
18ipRangeCheck("195.58.1.62", ["::1/128", "125.92.12.53"])
19// > false
20

IPv6

1var ipRangeCheck = require("ip-range-check");
2
3// Handles IPv6 in the same fashion as IPv4
4ipRangeCheck("::1", "::2/128")
5// > false
6ipRangeCheck("::1", ["::2", "::3/128"])
7// > false
8ipRangeCheck("2001:cdba::3257:9652", "2001:cdba::3257:9652/128")
9// > true
10
11// IPv4-mapped IPv6 addresses are automatically converted back to IPv4 addresses
12// and will match against IPv4 CIDR/IP's.
13ipRangeCheck("0:0:0:0:0:FFFF:222.1.41.90", "222.1.41.0/24")
14// > true
15
16// IPv6 addresses/CIDR's are normalised
17ipRangeCheck("2001:cdba:0000:0000:0000:0000:3257:9652", ["2001:cdba::3257:9652"])
18// > true

Developing

To run the tests:

npm test