davewalker5/subnetcalculator

subnetcalculator镜像说明

镜像概述

subnetcalculator是一个基于Python实现的网络子网计算API工具，提供IPv4网络的子网分析、划分及验证功能。用户可通过HTTP POST请求调用不同端点，获取网络地址、子网掩码、广播地址等详情，进行子网划分计算，或验证两个IP是否属于同一子网。

核心功能

1. /ipv4/network端点
   输入IP地址及子网掩码（或CIDR格式），返回网络地址、子网掩码、广播地址、首末可用主机IP等信息。
   请求示例：

   json
   {"ip_address": "172.16.35.123/20"}
   

   响应包含网络地址、广播地址、首末主机IP等二进制及十进制格式数据。

2. /ipv4/subnet端点
   根据输入的IP地址、子网掩码及需求（指定主机数、子网数或网络位），计算子网划分结果。支持三种场景：

   • 按指定主机数划分子网
   • 按指定子网数划分子网
   • 按指定网络位划分子网
     请求示例：

   json
   {"ip_address": "10.1.1.0/24", "hosts": 14}
   

   响应返回各子网的网络地址、广播地址、首末主机IP等信息。

3. /ipv4/samesubnet端点
   输入两个IP地址及子网掩码（或CIDR格式），验证是否属于同一子网。
   请求示例：

   json
   {"ip_address_1": "10.1.255.1/17", "ip_address_2": "10.1.128.2/17"}
   

   响应返回布尔值表示是否同子网。

使用场景

• 网络工程师进行子网规划与设计
• IT运维人员验证IP地址配置的正确性
• 开发人员集成子网计算功能到网络管理类应用
• 学习网络子网知识时的辅助工具

配置说明

运行参数

Docker部署示例

基础运行命令

shell
docker run -d --rm docker.xuanyuan.run/davewalker5/subnetcalculator:latest

端口映射运行命令

shell
docker run -d -p 80:5000 --rm docker.xuanyuan.run/davewalker5/subnetcalculator:latest

运行后可通过Postman等工具向主机80端口发送POST请求调用各端点。

技术栈

• Python 3.10.0
• Docker Desktop 4.21.1
• 依赖库见项目requirements.txt文件

项目链接

• GitHub仓库：https://github.com/davewalker5/NetworkCalculator
• 版本标签：https://github.com/davewalker5/NetworkCalculator/tags

许可证

本项目采用MIT许可证，详情见https://github.com/davewalker5/NetworkCalculator/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82