215 lines
7.8 KiB
Markdown
215 lines
7.8 KiB
Markdown
# NetPilot 网络调试工具
|
||
|
||
NetPilot 是一个基于 Python Tkinter 的 Windows 网络调试工具，面向日常桌面网络排障、网卡配置、局域网资产发现和连通性检测场景。
|
||
|
||
应用采用左侧功能导航、右侧公共输出控制台的布局。所有功能页的执行日志、诊断过程和错误提示都会统一输出到右侧控制台，便于在不同工具之间切换时保留排障上下文。
|
||
|
||
## 功能概览
|
||
|
||
### 网卡配置
|
||
|
||
- 读取本机所有网卡，包括已启用和已禁用的网卡。
|
||
- 显示网卡描述、MAC 地址、连接状态、IPv4 地址、子网掩码、默认网关、DNS 等信息。
|
||
- 支持启用网卡、禁用网卡。
|
||
- 支持 DHCP 自动获取和静态 IPv4 / DNS 配置切换。
|
||
- 支持重新读取网卡信息，便于配置变更后快速刷新。
|
||
- 支持网卡配置模板保存、套用和删除。
|
||
|
||
说明：修改网卡状态、IP、网关、DNS 等配置通常需要以管理员权限运行程序。
|
||
|
||
### DNS 诊断
|
||
|
||
- 读取本机网卡 DNS 配置，并支持选择不同网卡进行诊断。
|
||
- 支持手动填写或自动补全 DNS 服务器。
|
||
- 支持多个域名、多个记录类型的解析测试。
|
||
- 对不同 DNS 服务器的解析结果、耗时、失败原因进行对比。
|
||
- 诊断结果以表格展示，支持复制摘要和导出 CSV。
|
||
- 提供“修复异常”功能，用于处理常见 DNS 配置异常。
|
||
|
||
### 设备发现
|
||
|
||
- 按所选网卡的配置网段进行局域网设备发现。
|
||
- 通过 Ping 探活和 ARP 信息补充发现设备。
|
||
- 展示 IP、MAC、厂商、来源网卡、延迟、发现方式和备注。
|
||
- 支持自动范围、刷新网卡、开始发现、停止发现。
|
||
- 支持复制设备清单和导出 CSV。
|
||
|
||
当前设备发现按配置网段扫描，不再做跨网段邻居表扩展，也不做主机名解析。
|
||
|
||
### Ping 探测
|
||
|
||
- 支持单目标 Ping 和批量 Ping。
|
||
- 支持指定次数、持续探测、间隔、超时、包大小、TTL、禁止分片。
|
||
- 支持选择本地源 IP。
|
||
- 批量目标支持 CIDR、IP 范围和列表输入。
|
||
- 输出实时探测结果，并统计丢包率、平均延迟、抖动和质量状态。
|
||
- 支持导入目标和导出 CSV。
|
||
|
||
### 端口扫描
|
||
|
||
- 支持单主机单端口连通性测试。
|
||
- 支持端口列表、端口范围和常用端口预设。
|
||
- 支持批量主机扫描，目标可使用 CIDR、IP 范围或列表。
|
||
- 支持并发数、超时、仅显示开放端口等控制项。
|
||
- 支持服务名识别和可选 Banner 探测。
|
||
- 支持复制开放端口和导出 CSV。
|
||
|
||
### 路由追踪
|
||
|
||
- 支持 IPv4 / IPv6 路由追踪。
|
||
- 支持主机名解析开关。
|
||
- 支持单次、指定次数和持续追踪。
|
||
- 支持最大跳数、单跳超时、高延迟阈值等参数。
|
||
- 展示逐跳 RTT 表格，并保留原始命令输出。
|
||
- 对超时、高延迟、波动等情况给出诊断摘要。
|
||
- 支持复制摘要和导出 CSV。
|
||
|
||
### 环网检测
|
||
|
||
- 基于本机网卡统计、广播 / 组播流量、ARP / 邻居表变化和网关 Ping 稳定性进行综合判断。
|
||
- 用于辅助发现疑似二层环路、广播风暴或局域网异常波动。
|
||
- 支持检测单个网卡或全部活动网卡。
|
||
- 输出诊断摘要，支持复制和导出 CSV。
|
||
|
||
### IP 冲突
|
||
|
||
- 支持检测本机 IP 冲突风险。
|
||
- 支持按网段进行安全限速扫描。
|
||
- 结合地址状态、系统事件、ARP / 邻居信息、IP / MAC 异常关系判断冲突风险。
|
||
- 支持自动范围、刷新网卡、复制摘要和导出 CSV。
|
||
|
||
## 界面说明
|
||
|
||
- 左侧为功能导航区。
|
||
- 中间为当前功能页的参数和结果区域。
|
||
- 右侧为公共输出控制台，所有页面共用。
|
||
- 底部状态栏显示当前状态、本机名、操作系统和权限状态。
|
||
|
||
公共控制台可用于查看执行过程、错误提示和诊断摘要；点击“清空”可以清除当前控制台内容。
|
||
|
||
## 运行环境
|
||
|
||
- 操作系统：Windows 10 / Windows 11
|
||
- Python：建议 Python 3.10 或更高版本
|
||
- UI 框架：Tkinter
|
||
- 系统依赖：PowerShell、Windows 网络相关命令
|
||
|
||
大部分只读诊断功能可以普通权限运行。涉及以下操作时建议使用管理员权限：
|
||
|
||
- 启用或禁用网卡
|
||
- 修改 IP、网关、DNS、DHCP
|
||
- 执行部分需要系统网络信息的诊断或修复动作
|
||
|
||
## 源码运行
|
||
|
||
在项目根目录执行：
|
||
|
||
```powershell
|
||
python main.py
|
||
```
|
||
|
||
如果需要管理员权限，可以使用管理员 PowerShell 进入项目目录后再执行：
|
||
|
||
```powershell
|
||
cd E:\Git\Network-tools
|
||
python main.py
|
||
```
|
||
|
||
## 打包
|
||
|
||
项目提供了 Windows 打包脚本：
|
||
|
||
```powershell
|
||
.\打包.bat
|
||
```
|
||
|
||
打包完成后，输出文件位于：
|
||
|
||
```text
|
||
dist\NetworkTool.exe
|
||
```
|
||
|
||
打包脚本会优先使用本机指定的 Python 运行时，并在 `.packaging\pyinstaller` 下安装 PyInstaller；如果指定运行时不存在，则尝试直接调用系统中的 `pyinstaller`。
|
||
|
||
## 目录结构
|
||
|
||
```text
|
||
Network-tools
|
||
├─ assets # 图标等静态资源
|
||
├─ core
|
||
│ ├─ Function # 网络检测和配置相关业务逻辑
|
||
│ └─ ui # Tkinter 界面、主题和各功能页
|
||
├─ main.py # 程序入口
|
||
├─ 打包.bat # PyInstaller 打包脚本
|
||
├─ NetworkTool.spec # PyInstaller 配置
|
||
└─ README.md
|
||
```
|
||
|
||
## 配置和导出文件
|
||
|
||
- 网卡配置模板会保存到程序同级目录的 `network_profiles.json`。
|
||
- 各功能页的 CSV 导出文件由用户在导出时选择保存路径。
|
||
- 程序不会主动上传网络检测结果，所有诊断和导出均在本机完成。
|
||
|
||
## 常见问题
|
||
|
||
### 为什么修改网卡配置失败？
|
||
|
||
请确认程序以管理员权限运行。Windows 对网卡启用/禁用、IP 配置、DNS 配置等操作有权限限制。
|
||
|
||
### 为什么设备发现扫不到某些设备？
|
||
|
||
常见原因包括：
|
||
|
||
- 目标设备禁用了 ICMP Echo 响应，无法被 Ping 探活。
|
||
- 目标设备与当前网卡不在同一配置网段内。
|
||
- 本机防火墙或安全软件限制了探测行为。
|
||
- 交换机、VLAN、无线隔离或终端防火墙阻止了局域网发现。
|
||
- 扫描期间目标设备未产生可见 ARP 信息。
|
||
|
||
当前设备发现按所选网卡的配置网段扫描，不会跨网段扫描，也不会解析主机名。
|
||
|
||
### 为什么 DNS 诊断的网卡数量和系统里看到的不一样？
|
||
|
||
程序会尽量读取启用和禁用网卡，但部分虚拟网卡、隧道网卡、隐藏适配器或驱动异常的网卡，可能无法提供完整 DNS/IP 信息。可以先在网卡配置页刷新网卡，确认目标网卡是否能被系统命令读取。
|
||
|
||
### 为什么部分按钮是灰色不可用？
|
||
|
||
按钮状态会根据当前任务状态和网卡状态变化。例如扫描正在运行时会禁用开始按钮；没有选择有效网卡或当前网卡状态不支持某项操作时，也会禁用对应按钮。
|
||
|
||
### 导出的 CSV 用 Excel 打开乱码怎么办？
|
||
|
||
建议使用 Excel 的“数据 -> 自文本/CSV”导入方式，并选择 UTF-8 编码。也可以先用支持 UTF-8 的编辑器检查文件内容。
|
||
|
||
## 开发说明
|
||
|
||
界面层主要位于 `core/ui`：
|
||
|
||
- `ui_main.py`：主窗口布局、侧边栏、公共输出控制台、页面切换。
|
||
- `theme.py`：全局颜色、字体、ttk 样式。
|
||
- `components.py`：公共 Page、Console、字段、按钮等组件。
|
||
- `tab_*.py`：各功能页 UI 和事件逻辑。
|
||
|
||
业务逻辑主要位于 `core/Function`：
|
||
|
||
- `network_fun.py`：网卡读取和配置。
|
||
- `dns_diag_fun.py`：DNS 诊断。
|
||
- `device_discovery_fun.py`：设备发现。
|
||
- `ping_fun.py`：Ping 探测。
|
||
- `telnet_fun.py`：端口连通性和扫描。
|
||
- `tracert_fun.py`：路由追踪。
|
||
- `loop_fun.py`：环网检测。
|
||
- `ip_conflict_fun.py`：IP 冲突检测。
|
||
|
||
开发时建议先运行：
|
||
|
||
```powershell
|
||
python -m compileall main.py core
|
||
```
|
||
|
||
再启动界面进行手动验证：
|
||
|
||
```powershell
|
||
python main.py
|
||
```
|