子网与 IP 计算 API

CIDR 子网计算（IPv4 / IPv6），IP 地址与整数互转

数据来源：本地计算

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

子网计算：网络地址、广播地址、掩码、可用主机范围，判断 IP 是否在网段内

GET /api/tools/cidr

请求参数

cidr（必填）：网段：IP/前缀长度（192.168.1.0/24、2001:db8::/48），或 IP 加子网掩码（10.0.0.5 255.255.0.0、10.0.0.5/255.255.0.0）；只写 IP 时按单个地址（/32 或 /128）计算，示例 192.168.10.130/26
ip：可选：判断这个 IP 是否在网段内，须与网段同为 IPv4 或 IPv6，示例 192.168.10.190

返回字段

version（number）：IP 版本：4 或 6
ip（string）：输入的 IP 地址（规范化写法，IPv6 为 RFC 5952 压缩形式）
prefix（number）：前缀长度（IPv4 为 0~32，IPv6 为 0~128）；用子网掩码输入时为换算出的前缀长度
cidr（string）：规范化后的网段：网络地址/前缀长度，如 192.168.10.128/26
network（string）：网络地址（主机位全部置 0）
netmask（string）：子网掩码：IPv4 为点分十进制（如 255.255.255.192），IPv6 为压缩写法（如 ffff:ffff:ffff::）
totalAddresses（string）：网段内地址总数（十进制字符串，IPv6 可能非常大，统一用字符串避免精度丢失）
type（string）：网络地址所属的特殊用途类别，如私有地址、本机回环地址、链路本地地址、组播地址、文档示例地址；都不属于时 IPv4 为公网地址、IPv6 为其他地址
contains（boolean|null）：参数 ip 是否在网段内；没传 ip 时为 null
wildcard（string）：仅 IPv4：反掩码（通配符掩码），即子网掩码按位取反，常用于 ACL 与 OSPF 配置
broadcast（string）：仅 IPv4：广播地址（主机位全部置 1）
firstHost（string）：仅 IPv4：第一个可用主机地址（网络地址 + 1；/31、/32 时为网络地址本身）
lastHost（string）：仅 IPv4：最后一个可用主机地址（广播地址 − 1；/31、/32 时为最后一个地址）
usableHosts（string）：仅 IPv4：可用主机数（十进制字符串），一般为地址总数 − 2；/31（RFC 3021 点对点链路）为 2，/32 为 1
ipClass（string）：仅 IPv4：传统分类地址类别 A / B / C / D（组播）/ E（保留），按网络地址的第一个字节判断
binaryNetmask（string）：仅 IPv4：子网掩码的二进制形式，每 8 位用 . 分隔
networkExpanded（string）：仅 IPv6：网络地址的完整写法（8 组、每组 4 位十六进制，不压缩）
firstAddress（string）：仅 IPv6：网段内第一个地址（即网络地址，IPv6 没有广播地址）
lastAddress（string）：仅 IPv6：网段内最后一个地址

IP 地址与整数互转（IPv4 / IPv6），同时给出十六进制和二进制

GET /api/tools/ip-int

请求参数

value（必填）：IP 地址（如 192.168.1.1、2001:db8::1）或整数（如 3232235777，也可写 0x 开头的十六进制），示例 192.168.1.1
version：整数按哪个版本解释：4 或 6；不传时 ≤ 4294967295 按 IPv4，更大的按 IPv6，示例 6

返回字段

version（number）：IP 版本：4 或 6
ip（string）：IP 地址（IPv4 点分十进制；IPv6 为 RFC 5952 压缩写法）
int（number|string）：对应的无符号整数：IPv4 为数字（0~4294967295）；IPv6 超出 JavaScript 安全整数范围，为十进制字符串
hex（string）：十六进制，0x 开头，IPv4 补足 8 位、IPv6 补足 32 位，小写
binary（string）：二进制：IPv4 每 8 位用 . 分隔（共 4 段）；IPv6 每 16 位用 : 分隔（共 8 段）
expanded（string）：仅 IPv6：完整写法（8 组、每组 4 位十六进制，不压缩）