# iptools

**Repository Path**: devop/iptools

## Basic Information

- **Project Name**: iptools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IPTools

一个基于 `C# + WinForms + .NET 8` 的 Windows 网络配置工具，用于快速查看和切换网卡的 `IPv4 / IPv6` 配置。

## 功能特性

- 查看本机网卡信息
- 编辑并应用 `IPv4` 配置
- 编辑并应用 `IPv6` 配置
- 支持 `IPv4 DHCP`
- 支持 `IPv6 DHCP`
- 配置方案管理
- 配置方案导入 / 导出
- 保存当前编辑配置为方案
- 网络连通性测试
  - 网关
  - DNS
  - 网关6
  - DNS6
  - 完整检测
  - 自定义 IP / 域名测试
- 操作日志记录

## 界面截图

### 当前配置

![当前配置](images/当前配置.png)

### 配置方案

![配置方案](images/配置方案.png)

### 网络测试

![网络测试](images/网络测试.png)

## 运行环境

- Windows 10 / 11
- 管理员权限

说明：修改网卡配置需要管理员权限，项目已通过 `app.manifest` 配置 `requireAdministrator`。

## 开发环境

- .NET SDK 8
- Windows Desktop Runtime 8

## 项目结构

- `Form1.cs`
  主界面逻辑
- `Form1.Designer.cs`
  主界面布局
- `NetworkConfigService.cs`
  网卡读取与配置应用逻辑
- `NetworkAdapterInfo.cs`
  网卡信息模型
- `NetworkPreset.cs`
  方案数据模型
- `AppDataService.cs`
  方案与日志存储
- `RoundButton.cs`
  自定义圆角按钮
- `RoundPanel.cs`
  自定义圆角面板
- `images/ip.ico`
  程序图标

## 本地运行

```powershell
dotnet build
dotnet run
```

## 发布

### 1. 单文件免安装版

```powershell
dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true /p:IncludeNativeLibrariesForSelfExtract=true -o publish-single
```

输出目录：`publish-single/`

特点：

- 单文件
- 不依赖目标机器安装 .NET
- 文件较大

### 2. 小体积单文件版

```powershell
dotnet publish -c Release -r win-x64 --self-contained false /p:PublishSingleFile=true -o publish-small
```

输出目录：`publish-small/`

特点：

- 单文件
- 体积更小
- 需要目标机器已安装 `.NET 8 Runtime`

小体积版目录下额外提供：

- `launch-iptools.vbs`

该脚本会先检测 `.NET 8 Desktop Runtime`，未安装时会提示并引导下载。

## 数据保存位置

程序数据默认保存在：

`C:\Users\<用户名>\AppData\Local\iptools\`

主要文件：

- `presets.json`
  配置方案
- `operations.log`
  操作日志

## 配置方案说明

支持保存以下内容：

- 目标网卡
- IPv4 DHCP
- IPv6 DHCP
- IPv4 地址 / 子网掩码 / 网关 / DNS
- IPv6 地址 / 前缀 / 网关 / DNS6

支持：

- 保存方案
- 复制方案
- 删除方案
- 导入方案
- 导出全部方案
- 导出选中方案

## 网络测试说明

测试页支持：

- 当前网卡 `IPv4` 网关测试
- 当前网卡 `IPv4 DNS` 测试
- 当前网卡 `IPv6` 网关测试
- 当前网卡 `IPv6 DNS` 测试
- 完整检测
- 自定义目标测试

完整检测默认包含：

- 网关
- DNS
- 公网 IPv4：`8.8.8.8`
- 公网 IPv6：`2001:4860:4860::8888`

## 图标

项目使用：

`images/ip.ico`

作为程序图标。

## 注意事项

- 修改网络配置前建议确认目标网卡选择正确
- `IPv6` 网关和 DNS6 是否可用，取决于当前网络环境
- 小体积版如果无法运行，请先安装 `.NET 8 Desktop Runtime`

## 许可证

当前仓库未单独声明许可证，如需开源发布，建议补充 `LICENSE` 文件。