# ipp

**Repository Path**: l024/ipp

## Basic Information

- **Project Name**: ipp
- **Description**: IPP 是一个用Rust编写的命令行工具，用于处理和分析IP地址。它支持多种IP格式输入，并可以生成IP地址清单和进行批量ping测试。

IPPw 是功能相同的UI工具，支持 windows
- **Primary Language**: Rust
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-14
- **Last Updated**: 2025-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IPP - IP地址处理工具

IPP 是一个用Rust编写的命令行工具，用于处理和分析IP地址。它支持多种IP格式输入，并可以生成IP地址清单和进行批量ping测试。

## 功能特性

- 解析多种格式的IP地址输入：
- 端口扫描功能（开发中）：
  - 支持指定端口范围
  - 支持常见协议检测（HTTP/HTTPS/SSH等）
  - 单IP地址
  - CIDR子网（如192.168.0.0/24）
  - IP范围（如192.168.0.100-103）
- 生成并输出IP地址清单
- 批量ping测试并显示连通性结果
- 丰富的命令行参数支持

## 截图
![输入图片说明](pic/ipp-demo-01.png)

![输入图片说明](pic/ipp-demo-02.png)

![输入图片说明](pic/ipp-demo-03.png)

![输入图片说明](pic/ipp-demo-04.png)

## 安装

1. 确保已安装Rust工具链
2. 克隆本仓库：
   ```bash
   git clone https://gitee.com/l024/ipp.git
   ```
3. 构建项目：
   ```bash
   cd ipp
   cargo build --release
   ```
4. 安装到系统：
   ```bash
   cargo install --path .
   ```

## 使用示例

### 端口扫描（开发中）
```bash
ipp 192.168.0.1 --ports 80,443,8000-9000
```
扫描192.168.0.1的指定端口范围

### 基本用法
```bash
ipp
```
获取当前机器的IP地址，并输出同网段可ping通的IP清单

### CIDR子网输入
```bash
ipp 192.168.0.0/24
```
输出192.168.0.0/24子网内可ping通的IP地址

### IP范围输入
```bash
ipp 192.168.0.100-103
```
输出192.168.0.100到192.168.0.103范围内的IP地址

### 输出所有IP地址
```bash
ipp 192.168.0.0/24 --all
```
输出192.168.0.0/24子网内所有IP地址，包括不可ping通的

### 限制输出数量
```bash
ipp 192.168.0.0/24 --max 50
```
最多输出50个IP地址

## 命令行参数

| 参数 | 简写 | 描述 |
|------|------|------|
| --max | -m | 限制输出的IP地址数量 |
| --all | -a | 输出所有IP地址（包括不可ping通的） |
| --list | -l | 仅输出IP地址清单，不进行ping测试 |
| --help | -h | 显示帮助信息 |
| --version | -v | 显示版本信息 |
| --ports | -P | 指定要扫描的端口（开发中） |

## 贡献

欢迎提交issue和pull request。请确保代码风格一致并通过所有测试。