# net-protocol-tester **Repository Path**: template-warehouse/net-protocol-tester ## Basic Information - **Project Name**: net-protocol-tester - **Description**: 网络协议测试工具是一个跨平台的网络调试应用，面向开发者、运维工程师与网络爱好者。通过统一的配置面板与控制台，用户可以快速建立连接、收发数据、监控响应，并实时查看通信日志。所有连接配置均可保存，方便重复测试 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-01 - **Last Updated**: 2026-08-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 网络协议测试工具（Net Protocol Tester）

版本 许可证 平台 Flutter

> 一款基于 Flutter 的多网络协议测试工具，覆盖 TCP、UDP、WebSocket、MQTT、HTTP/HTTPS、CoAP、RTSP/RTP 等主流协议，提供统一的科幻风格可视化界面与实时日志，便于网络调试与联调分析。 --- ## 项目简介 网络协议测试工具是一个跨平台的网络调试应用，面向开发者、运维工程师与网络爱好者。通过统一的配置面板与控制台，用户可以快速建立连接、收发数据、监控响应，并实时查看通信日志。所有连接配置均可保存，方便重复测试。 **核心特性：** - **多协议支持** —— 一套界面覆盖 9 种协议：TCP、UDP、WebSocket、MQTT、HTTP、HTTPS、CoAP、RTSP、RTP - **跨平台运行** —— 同一套代码支持 Android、iOS、Windows 与 Web - **严格自适应** —— 兼容 Windows 桌面、手机横竖屏、平板横竖屏，布局随窗口尺寸自动重排 - **可视化控制台** —— 表单化配置 + 实时流式日志，支持文本/十六进制收发 - **连接管理** —— 保存常用连接配置，支持收藏、备注与快速重连 - **科幻深色主题** —— 青色高亮暗色界面，适合长时间调试 --- ## 技术栈 | 类别 | 技术 | 说明 | |------|------|------| | 框架 | Flutter 3.x | 跨平台 UI 框架 | | 语言 | Dart 3.11+ | 编程语言 | | 状态管理 | Provider | 基于 ChangeNotifier 的响应式状态管理 | | 网络 | dart:io / web_socket_channel / mqtt_client / dio | Socket、WebSocket、MQTT、HTTP 客户端 | | 本地存储 | shared_preferences | 连接配置持久化 | | 图标 | cupertino_icons | 图标资源 | --- ## 目录结构 ``` net-protocol-tester/ ├── lib/ │ ├── core/ # 各协议客户端实现 │ │ ├── base_protocol_client.dart # 协议客户端抽象基类 │ │ ├── tcp_udp_client.dart # TCP / UDP 客户端 │ │ ├── websocket_client.dart # WebSocket 客户端 │ │ ├── mqtt_client.dart # MQTT 客户端 │ │ ├── http_client.dart # HTTP / HTTPS 客户端 │ │ ├── coap_client.dart # CoAP 客户端 │ │ ├── rtsp_rtp_client.dart # RTSP / RTP 客户端 │ │ └── protocol_factory.dart # 协议注册表与工厂 │ ├── models/ # 数据模型（连接配置、日志） │ ├── providers/ # 全局状态管理（AppProvider） │ ├── pages/ # 页面（配置 / 控制台 / 已存连接 / 工具 / 设置） │ ├── storage/ # 本地持久化服务 │ ├── theme/ # 科幻主题配色 │ ├── widgets/ # 通用科幻风格组件 │ └── main.dart # 应用入口与主框架 ├── android/ # Android 平台配置 ├── ios/ # iOS 平台配置 ├── windows/ # Windows 平台配置 ├── web/ # Web 平台配置 ├── docs/ # 文档目录 │ ├── 使用说明书.md # 用户使用指南 │ ├── 发布上架指南.md # Google Play 上架流程 │ └── images/ # 截图与素材 ├── APK/ # 打包产物（不提交 Git） ├── scripts/ # 辅助脚本（Windows Defender 排除等） ├── build.bat # 一键打包脚本 ├── LICENSE # MIT 许可证 └── README.md # 项目说明文档 ``` --- ## 快速开始 ### 环境要求 - Flutter SDK 3.11+ - Dart SDK 3.11+ - Android Studio / Xcode / Visual Studio（按目标平台） ### 安装依赖 ```bash cd net-protocol-tester flutter pub get ``` ### 运行项目 ```bash # 运行到默认设备 flutter run # 指定平台 flutter run -d windows flutter run -d chrome flutter run -d android ``` ### 构建发布 ```bash # Android（Google Play 用 AAB） flutter build appbundle --release # Android（直接安装用 APK） flutter build apk --release # Windows flutter build windows --release # Web flutter build web --release ``` --- ## 功能模块 ### 配置面板（Config） - 选择协议类型（自适应等宽网格，9 种协议一屏可见） - 填写目标地址、端口及各协议专属选项 - 各协议差异化选项（如 TCP 编码/保活/自动重连、UDP 本地端口绑定等） ### 控制台（Console） - 建立/断开连接，实时状态指示 - 发送文本或十六进制数据 - 流式日志展示收发内容与时间戳 ### 已存连接（Saved） - 保存、收藏、备注常用连接配置 - 一键载入并快速重连 ### 工具箱（Tools） - TCP 端口连通性测试 - IP 信息查询 - 编码/进制转换 ### 设置（Settings） - 应用信息与偏好配置 --- ## 支持的协议 | 协议 | 说明 | |------|------| | TCP | 面向连接的可靠传输，支持编码切换、保活、自动重连 | | UDP | 无连接数据报，支持本地端口绑定、组播 | | WebSocket | 全双工消息通道，支持自动重连 | | MQTT | 物联网发布/订阅消息协议 | | HTTP | 标准 Web 请求，支持多种方法与自定义头 | | HTTPS | 加密的 HTTP 请求 | | CoAP | 受限设备应用协议 | | RTSP | 实时流协议控制 | | RTP | 实时传输协议 | --- ## 相关资源 - [Flutter 官方文档](https://docs.flutter.dev/) - [Dart 语言指南](https://dart.dev/guides) --- ## 许可证 本项目采用 MIT 许可证，详见 [LICENSE](LICENSE) 文件。