Proxy-IT/hana-network-utility

# 🌸 Hana — 网络实用工具 ## 什么是 Hana？ Hana 是一款免费的桌面网络实用工具，专为 IT 专业人员、网络管理员和技术爱好者打造，他们需要快速、可靠的网络诊断，而无需承受笨重的企业级工具的开销。 Hana 这个名字（ханa）在波斯尼亚语中意为“花朵”——小巧、实用且精心雕琢。这一理念贯穿于应用的每一个细节：轻量级的安装程序、清爽的界面以及即时的结果。 它在单一窗口中提供了 11 个模块，可在 Windows 和 macOS 上运行，不收集任何数据，并能保持自身更新。 ## 模块 ### ◎ Ping 测试主机是否可达，并精确测量往返时间。 - **固定模式** — 发送 1、2、4、8 或 16 个数据包，并获得清晰的 min/avg/max 汇总 - **连续模式** — 运行无限 Ping，配有实时滚动的 RTT 图表、实时丢包计数器以及颜色编码的延迟分类 - 正确将“目标主机不可达”的回复识别为失败 - 将结果导出为 `.txt` 或 `.csv` ### ⊛ Multi-Ping 在单个屏幕上同时监控多达 5 台主机。 - 每台主机都有自己的实时状态卡片——响应时为绿色，离线时为红色 - 迷你柱状图可一目了然地显示每台主机最近 20 次 Ping 的结果 - 全局状态栏即时显示总在线与离线数量 - 当您使用其他模块时，主机仍会在后台持续 Ping - 专为监控设备在重启或故障转移后恢复上线而设计 ### ⇄ TCP Ping 反复探测特定的主机:端口——当防火墙拦截了 Ping，但您关心的服务仍然可访问时，它是 ICMP Ping 的最佳补充。 - 每次尝试的阶段耗时：DNS 解析、TCP 连接和（可选的）TLS 握手，各自独立分开显示 - 明确的失败分类，而不是简单的通过/失败——拒绝、超时、不可达、DNS 失败和 TLS 失败都会清晰展示 - **固定模式**（5–100 次尝试）或带有实时耗时图表的**连续模式** - 提供 min/avg/max、丢包率、抖动和最长连续失败次数统计 - 将完整的尝试日志和摘要导出为 `.txt` 或 `.csv` ### ⊘ 端口扫描器 检查主机上的哪些 TCP 端口是开放的、关闭的或被过滤的。 - 24 个常用端口作为可选标签，并提供 Web / 远程 / 邮件 / 数据库 / 网络分组预设以及自定义端口字段 - 开放（绿色）、关闭（灰色）和被过滤（琥珀色）结果，并附带服务名称 - **停止**可随时取消正在运行的扫描 - 在启用扫描之前，必须勾选强制性的授权确认框 - 将结果导出为 `.txt` 或 `.csv` ### ⤵ Traceroute 追踪您的流量到达任何目的地所经过的精确网络路径。 - 实时逐跳流式传输——结果在到达时即刻显示 - 每跳的 RTT 采用颜色编码——从绿色到红色，让您一目了然地查看延迟 - 识别无响应的跳，而不会阻塞追踪过程 - 将完整的跳数表导出为 `.txt` 或 `.csv` ### ⊞ 子网扫描 无需触碰命令行即可发现子网上的每一台主机。 - **范围模式** — 输入前三个八位字节以及起始/结束主机范围 - **CIDR 模式** — 通过表示法扫描从 `/16` 到 `/30` 的整个子网，并提供实时主机计数和范围预览 - 并行 Ping 扫描，配有实时进度条 - **停止扫描**可立即取消正在运行的扫描并保留部分结果 - 结果支持分页（显示前 254 个，活动主机置顶），确保大规模扫描保持响应；导出操作始终包含所有结果 - 将完整结果导出为 `.txt` 或 `.csv` ### ⊟ 子网计算器 即时的 CIDR 子网计算——无需心算。 - 输入任何 IP 地址并拖动前缀滑块 - 即时计算网络地址、广播地址、第一个和最后一个可用主机、子网掩码、通配符掩码、总主机数、IP 类别，以及该地址是私有还是公网地址 - 提供二进制表示，并高亮显示网络位 - 在您调整前缀时实时更新 ### ◈ DNS 查询 解析任何主机名或 IP 地址的 DNS 记录。 - 支持 A、AAAA、CNAME、MX、TXT、NS 和 PTR 记录——或一次性选择 **ALL** - 选择解析器：Google (8.8.8.8)、Cloudflare (1.1.1.1) 或自定义服务器 - 输入 IP 地址时自动进行反向 (PTR) 查询 - 带有 TTL 和 MX 优先级的颜色编码记录标签 - 每个请求使用独立的解析器——不会篡改全局 DNS 状态 - 将结果导出为 `.txt` 或 `.csv` ### ⊕ IP 信息 & WhoIs 一个标签页包含三种工具——无需浏览器。 - **您的公网 IP** — 加载时自动检测，包含 ISP、位置、ASN、时区和坐标详情 - **IP 查询** — 输入任何 IP 地址以查看其完整的地理位置和网络信息 - **WhoIs** — 查询任何域名或 IP 的注册记录，包括注册商、创建和过期日期以及域名服务器 - 所有这三个部分均可导出为 `.txt` 和 `.csv` ### ↗ Hana 收藏 一个精心策划并注明出处的免费第三方网络与安全工具目录。 - 按类别分组：SSL/TLS、MAC/硬件、BGP/路由、可用性/性能和安全 - 每张卡片都是静态的内置链接——此处的内容均非动态获取或可编辑——并注明其运营方（例如 Qualys SSL Labs、Ookla） - 点击可在您的默认浏览器中打开该网站；Hana 绝不会自行联系这些服务 ### ≋ 延迟指南 一个内置参考，帮助您理解 Ping 结果的实际含义。 - 从环回（< 1ms）到卫星（> 700ms）的延迟分级表 - 针对游戏、VoIP、视频会议、网页浏览、数据库查询和 CDN 分发的应用阈值 - 实时分类器——输入任何 ms 值即可立即查看其评级 ## 为什么选择 Hana 而不是命令行？ | 任务 | 命令行 | Hana | |---|---|---| | 带图表的连续 Ping | `ping -t 8.8.8.8` + 心算 | 一键操作，实时图表 | | 监控多台主机 | 开启多个窗口 | Multi-Ping，单屏搞定 | | 子网扫描（范围或 CIDR） | 编写脚本或使用第三方工具 | 内置功能，可视化结果 | | 子网计算 | 查阅 RFC + 手动计算 | 即时计算，带二进制视图 | | Traceroute | `tracert -d hostname` | 流式传输，颜色编码 | | DNS 记录 | `nslookup -type=MX ...` | 支持所有记录类型，适配任何解析器 | | TCP 端口检测 | `Test-NetConnection` / `nc` 循环 | 预设 + 自定义，可取消 | | 公网 IP / WhoIs 查询 | 打开浏览器，搜索一下 | 内置工具，可导出 | | 导出结果 | 从终端复制/粘贴 | 一键导出 `.txt` 或 `.csv` | ## 安装说明 ### Windows 1. 前往 [Releases 页面](../../releases/latest) 2. 下载 `Hana-NetworkUtility-Setup-.exe` 3. 运行安装程序并按照提示操作 4. 从“开始”菜单启动 Hana ### macOS 1. 在 [Releases 页面](../../releases/latest) 下载对应您芯片架构的 `.dmg` 文件： - **Apple Silicon (M1–M4)** → 以 `arm64.dmg` 结尾的文件 - **Intel** → 标准的 `x64.dmg` 2. 打开 DMG 文件并将 **Hana - Network Utility** 拖入“应用程序”文件夹 3. 从“应用程序”中启动它 ## 保持更新 Hana 可以通过 **关于 → 更新** 进行自我更新： - 点击 **检查更新**。如果存在更新的版本，请选择 **下载**，然后选择 **安装并重启**。 - 默认情况下，系统不会自动执行任何操作。我们提供了一个可选的 **“在启动时自动检查更新”** 开关，且默认状态为**关闭**，因此除非您主动要求，否则应用不会发出任何更新请求。 更新安全性： - 更新源被**固定**在此 GitHub 存储库——应用绝不会跟随任意或网络提供的 URL。 - 每次下载在安装前都会根据已签名的发布元数据进行**完整性校验 (SHA-512)**；在 macOS 上，更新包还必须带有有效的 Apple 签名。 - **受防降级保护**——更新程序绝不会用旧版本或预发布版本替换您当前的构建版本。 ## 隐私与安全 Hana 不收集**任何数据**，也不会进行**任何后台网络连接**。出站请求仅发生在您明确触发它们时： - 向您指定的主机发送 Ping 和 Traceroute 数据包 - 向您选择的解析器发送 DNS 查询 (DNS Lookup) - 向您扫描的主机/端口发起 TCP 连接尝试 (Port Scanner) - 通过 [ipinfo.io](https://ipinfo.io) 进行 IP 地理定位，通过 [ipify.org](https://api.ipify.org) 检测公网 IP (IP Info) - 通过公共 RDAP ([rdap.org](https://rdap.org)) 和 WhoIs 服务进行 WhoIs 查询 - 仅在您点击**检查更新**时检查 GitHub Releases 更新，或在您启用了启动检查（默认关闭）的情况下进行 完整隐私政策请参阅 [PRIVACY.md](PRIVACY.md)；有关如何报告漏洞，请参阅 [SECURITY.md](SECURITY.md)。 ## 合理使用 Hana 仅提供用于合法的网络管理、故障排除和教育用途。在测试任何网络之前，您必须已获得相应许可。完整的使用条款请参阅 [TERMS.md](TERMS.md)。 ## 从源码构建 ``` # 前提条件：Node.js v22 或更高版本 git clone https://github.com/Proxy-IT/hana-network-utility.git cd hana-network-utility npm install npm start # run in development mode (Vite + Electron) npm test # run the Vitest suite npm run check:ipc # verify the renderer ↔ preload ↔ main IPC contract npm run build # produce an installer in dist/ ``` ## 版本历史 | 版本 | 亮点 | |---|---| | v1.11.0 | TCP Ping — 对 host:port 进行重复的 TCP 连接探测，包含 DNS/connect/TLS 阶段计时、失败分类、抖动以及连续失败追踪；侧边栏模块顺序按类别重新分组 | | v1.10.0 | Hana 收藏 — 一个精心策划并注明出处的免费 SSL/TLS、MAC、BGP 和安全查询工具目录 | | v1.9.2 | 修复了 macOS 自动更新问题（electron-updater 需要发布 `.zip` 格式的资产；之前的 mac 构建版本仅生成 `.dmg`） | | v1.9.1 | 子网扫描现在默认使用 CIDR 模式（原先为范围模式）；在 关于 → 更新 中添加了常驻的“更新日志”链接 | | v1.9.0 | 应用内自动更新器 — 支持手动检查以及可选的启动检查（默认关闭）；下载内容通过 SHA-512 验证，更新源锁定至 GitHub，并具备防降级保护 | | v1.8.2 | 安全与可靠性强化 — CSV 公式注入防护，统一的 CSV 转义，端口扫描器可取消功能，切换标签页时清理 Traceroute/Port Scanner，移除死代码 | | v1.8.1 | 正式品牌化 — 应用图标（Windows 和 macOS）、应用内 logo、favicon 以及落地页素材 | | v1.8.0 | 构建工具链从 Create React App 迁移至 Vite；添加了单元测试套件；收紧了生产环境 CSP；Node.js 要求提升至 v22 | | v1.7.2 | 应用内反馈通道（报告 Bug / 请求新功能）；macOS 代码签名与公证；强化了打开外部链接的处理器 | | v1.7.0 | 升级至 Electron 42；在所有模块中加入了主进程输入验证；实现了按请求隔离 DNS 解析器；修复了子网扫描的可靠性问题 | | v1.6.5 | DNS 查询和端口扫描器模块；CIDR 子网扫描；修复了 Shell 注入漏洞；添加了清除按钮 | | v1.5. | 持久化模块状态，实时 Ping 结果，精准检测不可达状态 | | v1.3.0 | 支持最多 5 台主机的 Multi-Ping 监控器；带有完整导出功能的 IP 信息 & WhoIs 模块 | | v1.2.0 | 品牌重塑为 Hana；在所有工具上支持 CSV/TXT 导出；重新设计了子网扫描结果界面 | | v1.1.0 | 带有实时 RTT 图表的连续 Ping；应用内操作指南；修复了 Windows 路径问题 | | v1.0.0 | 首次发布 | 完整的更新日志请参阅 [CHANGELOG.md](CHANGELOG.md)。 ## 许可证 该项目基于 **GNU General Public License v3.0** 授权。 详情请参阅 [LICENSE](LICENSE)。

_{用心打造。赋予意义。🌸}

标签：MITM代理, 情报分析, 数据统计, 桌面应用, 端口扫描, 网络工具, 网络诊断, 自定义脚本