Skip to content

Releases: btwise/net-tools-box

V1.3

13 Apr 03:37
@btwise btwise
V1.3
d55b28c

Choose a tag to compare

View all tags
V1.3 Latest
Latest

网络测试工具箱发布说明

版本：v1.1
摘要：扩展监控与局域网相关小工具，强化连接类测试与打包运行稳定性，统一多页控件高度与主窗口启动布局。

版本：v1.2
摘要：完善ARP绑定校验功能；添加交换机简单检测和命令生成功能。

版本：v1.3
摘要：添加常用交换机路由器配置资料查询功能。增加ssh等远程连接和交换机console串口连接终端功能

新增与增强

导航与模块

  • 侧栏「局域网与设备」「监控与流量」分类更清晰，相关工具入口归位、补充。
  • 网络唤醒（WOL）：魔术包发送；广播地址、UDP 端口、重复次数、绑定本机出口 IP（多网卡）；端口与次数为普通输入框，与同排按钮等高。
  • NetFlow 分析（简易）：UDP 监听、TOP 会话与协议分布等；TOP 表列宽拉伸铺满卡片；监听区控件与按钮等高。
  • SNMP 探测：SNMPv2c 只读（sysName / sysDescr / sysUpTime）；优先系统 snmpget，否则 pysnmp；端口为单行输入，与按钮等高。
  • 局域网 MITM 风险提示：基于默认网关与 ARP/邻居表的启发式说明；后台线程执行，不阻塞界面。
  • 连接测试：扩展 TLS、HTTP·API、WebSocket 等；连接追踪（TCP/UDP、过滤、进程名等）；耗时逻辑使用 BasePage._run_in_thread，降低卡界面风险；业务放在独立 *_tool.py，控制 network_tools.py 体积。
  • 仪表盘：文案与功能入口说明随 v1.1 更新。

数据与解析

  • MITM / ARP：邻居采集与 ARP 表页对齐数据源与解析（含 BSD 风格 MAC 等），减少网关与邻居表不一致。
  • 可选使用仓库内 scripts/snmp_dev_agent.py 等脚本在本地模拟 SNMP Agent（自测用）。

界面与体验

  • 主窗口：启动时在主屏 可用工作区内水平居中，高度占满可用工作区（已扣除任务栏等系统预留区域）。
  • 标题栏：打赏图标左侧增加 「打赏」 文字标签。
  • 同排控件高度：通过 BasePage._sync_ctrl_h 统一 QLineEdit / QComboBox（可编辑）/ QSpinBox 等 与 QPushButton 高度，覆盖 Ping 全部 Tab、路由追踪、端口扫描、IP 信息检测（含 IP 信息查询、IP 归属地、域名 WHOIS、IP 冲突检测中网卡行与按钮）、ARP 邻居表、MITM 提示、数据包抓包、SNMP、WOL 等。仅图标按钮（如「刷新网卡」）保持方形，主题样式由页面单独套用。

打包与运行（重要）

  • PyInstaller：各平台打包脚本中字节码优化由 --optimize 2 改为 1。
  • 原因说明：optimize=2 会剥离字节码中的 docstring；PLY / pysmi（pysnmp 路径依赖）用词法函数的首行字符串作为规则，剥离后会导致 Can't build lexer——表现为 源码运行 SNMP 正常、Windows 单文件包异常。
  • Windows 打包目录内 打包说明.txt 已补充与 SNMP / 优化级别相关的提示。

依赖与升级提示

  • SNMP：无系统 snmpget 时依赖 pysnmp；请使用当前仓库 requirements.txt 建议版本打包。
  • 抓包 / 部分系统功能：仍可能依赖 Npcap、管理员权限、系统命令 等，以各页面说明为准。
  • 操作系统：例如 Windows 仍为 10/11（不支持 Windows 7），与既有策略一致。
Assets 11
Loading

V1.0

10 Apr 23:50
@btwise btwise
V1.0
929ad5d

Choose a tag to compare

View all tags
V1.0

网络测试工具箱 v1.0 发布说明

产品定位

网络测试工具箱是一款面向运维工程师、网络管理员、实施工程师和技术支持人员的跨平台桌面工具，聚焦“网络故障定位 + 网络服务验证 + 安全与权限诊断”三类核心场景。
产品采用 PyQt6 图形界面，支持 Windows / macOS / Linux，在统一交互下提供多模块网络检测、抓包分析、服务器模拟与系统级诊断能力。

版本亮点

  • 完整覆盖常用网络排障链路：连通性、路由、DNS、端口、服务、抓包、WiFi、防火墙。
  • 提供“工具化 + 服务化”双模式：既可做客户端诊断，也可临时启动 DHCP/FTP/TFTP/Syslog/HTTP 服务用于联调。
  • macOS 适配增强：WiFi 扫描、权限提示、界面缩放、防火墙能力与抓包体验全面完善。
  • 多项页面布局优化：非全屏下卡片、日志区、按钮区可用性提升，浅色主题可读性更好。

功能架构总览

一、主机与连通性诊断

  • 主机发现

    • 扫描局域网在线主机，识别可达设备。
    • 支持快速发现网络活跃节点，辅助资产巡检与异常设备排查。

  • Ping 检测

    • 支持目标主机时延、丢包率、可达性评估。
    • 适用于基础连通性判断和链路质量初筛。

  • 路由追踪

    • 提供逐跳路径可视化，定位高时延或不可达节点。
    • 适合跨网段、跨出口链路问题分析。

  • 网络健康检查

    • 汇总网卡、网关、DNS、外网状态等关键指标。
    • 输出结构化诊断结果，便于现场快速判断故障层级。

  • 环路检测

    • 基于底层流量与统计行为进行环路风险判断。
    • 可用于交换网络异常广播风暴前置排查。

二、信息查询与地址规划

  • IP 信息检测

    • 查询本机/目标的网络相关信息，辅助地址与路由核查。

  • MAC 地址查询

    • 提供厂商识别能力，帮助快速判断设备类型来源。

  • 路由表查看

    • 读取系统路由信息，支持网关与路由策略核对。

  • 子网规划工具（5 个子模块）

    • IPv4 计算
    • IPv6 计算
    • 子网划分
    • VLSM 子网划分
    • 路由汇总
      适用于地址规划、汇总策略设计、网络改造前预演。

三、WiFi 管理与无线分析

  • WiFi 分析

    • 扫描无线网络并展示 SSID、BSSID、信号强度、信道、加密信息等关键字段。
    • 支持无线网卡选择与刷新，便于多网卡场景排查。
    • 对 macOS 增强适配（含 CoreWLAN 路径），提升扫描可用性与字段完整性。

  • WiFi 管理

    • 根据平台能力提供配置查看与管理辅助。
    • macOS 下采用“系统限制说明 + 一键打开系统网络设置/钥匙串”的引导方案，避免误导性操作。

四、系统工具与安全诊断

  • 端口扫描

    • 支持目标主机端口开放状态探测，辅助服务可达性核对。

  • 防火墙管理

    • 支持防火墙状态查看、开关控制（依赖管理员权限）。
    • 提供“一键诊断（端口占用 + 防火墙放行）”，用于服务不可达场景的组合排查。

  • DHCP 检测

    • 主动发现 DHCP 服务器，识别多 DHCP/私接路由风险。
    • 输出服务器标识、网关、DNS、租约等关键字段。

  • 数据包抓包

    • 基于 Scapy 抓取数据包，支持过滤条件与结果查看。
    • 用于协议层级排障、端口行为验证、设备通信路径确认。

  • 摄像头扫描

    • 用于网络摄像头类设备的发现与辅助识别。

五、高级功能与联调能力

  • 网络连接测试

    • 面向 DNS、目标可达性、服务连通等维度进行综合验证。

  • 内网测速

    • 支持服务端/客户端模式，提供局域网吞吐测试能力。

  • 网络服务器（5 个服务 Tab）

    • DHCP 服务器
    • FTP 服务器
    • TFTP 服务器
    • Syslog 服务器
    • HTTP 静态服务器
      适用于实验室、交付现场、设备联调、临时验证等场景。

跨平台支持说明

Windows

  • 已完成主要功能链路测试，适合作为主力运维终端使用。
  • 抓包等能力建议安装 Npcap，并以管理员权限运行。

macOS

  • 已完成本版本重点适配：界面缩放、WiFi 扫描、抓包权限、防火墙能力、DHCP 检测等。
  • 打包版 .app 启动时支持管理员提权流程，便于执行需要系统权限的操作。
  • WiFi 某些字段受系统隐私策略影响，需正确授予定位/网络相关权限。

Linux

  • 支持核心检测能力；部分底层功能需 root/CAP_NET_RAW 等权限。
  • 具体能力受发行版、权限策略和系统工具安装情况影响。

权限与依赖说明

  • 以下功能通常需要管理员权限：

    • 抓包
    • DHCP 检测/服务端
    • 防火墙状态修改与部分规则读取
    • 低端口服务（如 21/69/514）

  • 关键依赖（按功能）：

    • PyQt6：桌面界面
    • scapy：抓包与协议处理
    • psutil：系统/连接信息
    • pyftpdlib / tftpy：FTP/TFTP 服务
    • pyobjc（macOS）：WiFi/CoreWLAN 相关能力
    • cryptography：HTTPS 证书生成等安全能力

典型使用场景

  • 新网络上线前的地址规划与连通验证。
  • 用户反馈“网络慢/打不开”时的分层定位（Ping → 路由 → DNS → 端口 → 抓包）。
  • 现场设备交付时临时启用 FTP/TFTP/HTTP/Syslog 服务进行联调。
  • WiFi 质量巡检与信道/加密状态核查。
  • 防火墙与端口占用冲突排查。

已知边界与建议

  • 本工具定位为“工程诊断与联调工具”，不替代企业级长期运行服务系统。
  • 无线信息展示受平台隐私与权限机制约束，建议按系统提示授予权限后再测试。
  • 在高安全环境中，建议配合最小权限原则与审计策略使用。

发布包说明

  • Windows提供标准 .exe 单文件应用包。
  • Linux 采用AppImae和deb文件打包，可安装或直接运行。
  • macOS采用标准dmg格式打包。

致谢

感谢使用网络测试工具箱。欢迎在仓库提交 Issue / 建议 / 适配反馈，帮助我们持续完善跨平台网络诊断体验。

Loading