ip matching

IP匹配

独立模块具有有关IPS的一些方便功能：

• 快速易于使用的方法来检查IP是否满足要求
• 支持IPv4/IPv6通配符地址，范围，子网和口罩。
• 支持解析和输出所有常见的IPv6符号
• 实用程序方法，例如Next/上一个IP，范围为CIDRS列表，...
• 在发布之前，每个版本都经过彻底测试和覆盖

安装

npm install --save ip-matching
# or
yarn add ip-matching

附带其自己的内置打字稿声明，其中包含文档。

例子

 import { getMatch , IPMatch , IPSubnetwork , IPRange , matches } from 'ip-matching' ;

// matches(ip: string | IP, target: string | IPMatch): boolean;

matches ( '10.0.0.1' , '10.0.0.0/24' ) ; // true
matches ( '10.0.1.1' , '10.0.0.0/24' ) ; // false
matches ( 'abc::def' , 'abc:*::def' ) ; // true
matches ( 'abc::def' , 'abc:9::def' ) ; // false
matches ( '0001:2:3:4:5:6:7' , '1:2:3:4:5:6:7' ) ; // true

// getMatch returns an instance of
// IPv4, IPv6, IPRange, IPSubnetwork or IPMask, all extending IPMatch
const mySubnet : IPMatch = getMatch ( 'fefe::0001:abcd/112' ) ;
mySubnet . type ; // 'IPSubnetwork'
mySubnet instanceof IPSubnetwork ; // true
mySubnet instanceof IPMatch ; // true
mySubnet . toString ( ) ; // 'fefe::1:0/112'
mySubnet . matches ( 'FEFE::1:bbbb' ) ; // true
mySubnet . matches ( 'FEFE::2:bbbb' ) ; // false
mySubnet . equals ( new IPSubnetwork ( new IPv6 ( 'fefe::1:abcd' ) , 112 ) ) ; // true
mySubnet . getAmount ( ) ; // 65536
( mySubnet as IPSubnetwork ) . getLast ( ) . toString ( ) ; // 'fefe::1:ffff'

const myIp = new IPv6 ( 'a:0:0::B:0:C' ) ;
myIp . toString ( ) ; // 'a::b:0:c'
myIp . toLongString ( ) ; // 'a:0:0:0:0:b:0:c'
myIp . toFullString ( ) ; // '000a:0000:0000:0000:0000:000b:0000:000c'
new IPv6 ( '::ffff:a9db:*' ) . toMixedString ( ) ; // '::ffff:169.219.*.*'

const myRange = getMatch ( '10.0.0.0-10.1.2.3' ) as IPRange ;
myRange . convertToMasks ( ) . map ( ( mask : IPMask ) => mask . convertToSubnet ( ) . toString ( ) ) ;
// [ '10.0.0.0/16', '10.1.0.0/23', '10.1.2.0/30' ]

const mask1 = getMatch ( '10.0.1.0/255.0.255.0' ) as IPMask ;
const mask2 = getMatch ( '10.0.0.0/128.0.0.0' ) as IPMask ;
mask1 . isSubsetOf ( mask2 ) ; // true
mask2 . getAmount ( ) ; // 2147483648

getMatch ( 'a::abbc:1234/ffff::ff80:000f' ) . toString ( ) ; // 'a::ab80:4/ffff::ff80:f'

注意： matches功能和所有无效输入的构造函数错误

您可以查看所有功能的测试代码或打字稿声明。

允许的模式

• IP（IPv4/ipv6）
  • 常规IPv4： 10.0.0.0
  • 通配符IPv4： 10.0.0.*甚至10.*.0.*
  • 常规IPv6： 2001:0db8:85a3:0000:0000:8a2e:0370:7334
  • 缩短IPv6： 2001:db8:85a3::8a2e:0370:7334或:: OR ::1或a::
  • 通配符IPv6： 2001::*甚至2001::*:abc:*
  • 混合IPv6（映射IPv4）：:: ::ffff:127.0.0.1 （IPv4零件中不允许通配符）
  • 不允许： 10.0.1*.0或2001::a*c
• IP范围
  • IPv4： 10.0.0.0-10.1.2.3
  • IPv6： 2001::abc-2001::1:ffff
  • 注意：左侧必须比右侧“低”
• IP子网
  • IPv4： 10.0.0.0/16
  • IPv6： 2001::/123
• IP掩码
  • IPv4： 10.0.0.0/255.0.64.0
  • IPv6： 2001:abcd::/ffff:ff8::

IPMASK的toString()方法不会自动简化Eg /255.0.0.0至/8 ，即使这些方法是等效的。由于2.0.0，IPMASK随附了一种方法convertToSubnet()该方法在可能的情况下返回等效的ipsubnetwork，否则undefined 。

与类似库的比较

这是一些众所周知的类似NPM软件包，它们所缺乏的功能，反之亦然。在所有情况下，如果您认为它非常适合此模块，请随时请求新功能。

IP地址

• 支持解码TEREDO信息
• 支持阅读特殊属性（多播前缀，唯一本地地址前缀，是链接本地...）
• 支持URL解析IPv6地址（和端口）
• 支持解析IPv6 ARPA地址（ .ip6.arpa ）并进行范围（分区）地址
• 不支持通配符IP地址
• 不支持IP范围或口罩（也不支持任何相关方法）
• 不支持在子网中获取IP地址的数量
• 不支持获取IP地址的上一个/下一个

IP

• 废弃了4年以上（自2017年初以来）
• 支持获取本地IP地址
• 不支持/或IP地址之间/之间的操作
• 支持常规IPv4/IPv6地址
• 支持IPv4子网（带子网属性）
• 不支持通配符IP地址或IPv6子网
• 不支持IP范围或口罩（也不支持任何相关方法）
• 不支持获取IP地址的上一个/下一个

NetMask

• 仅支持IPv4 CIDR块（带有子网信息）
• 支持获取相同大小的下一个子网
• 支持检查一个子网是否是另一个子网
• 除了IPv4子网以外，不支持任何东西

链接

• github：https：//github.com/schoofskelvin/ip-matching
• NPM：https：//www.npmjs.com/package/ip-matching