# 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 ```