sorah/wifidiag

Wifidiag 镜像文档

镜像概述

Wifidiag是一个面向客户端的快速Wi-Fi诊断工具，旨在支持网络运维工作。它提供直观的诊断页面，帮助收集关键Wi-Fi连接信息并实现问题报告，适用于网络管理员快速定位和解决客户端Wi-Fi连接问题。

核心功能与特性

• 诊断数据报告：支持将诊断结果发送至Slack聊天工具，便于实时监控和团队协作。
• 诊断数据收集：
  • 自动识别连接的无线接入点（AP）及客户端MAC地址
  • 执行快速网络速度测试和延迟检测
• Cisco WLC支持：兼容Cisco无线控制器，适用于采用Cisco网络设备的环境。

使用场景与适用范围

• 网络运维团队：实时监控客户端Wi-Fi连接状态，快速响应连接问题
• Wi-Fi管理员：收集客户端连接数据，分析网络性能瓶颈
• 企业/组织环境：适用于需要集中管理Wi-Fi网络、保障客户端连接质量的场景

使用方法与配置说明

安装方式

基于Gem安装（非Docker方式）

1. 在应用的Gemfile中添加依赖：

   ruby
   gem 'wifidiag'
   

2. 执行安装命令：

   bash
   bundle install
   # 或独立安装
   gem install wifidiag
   

Docker部署（假设镜像可用）

若提供Docker镜像，可通过以下命令启动（具体参数需根据实际镜像调整）：

bash
docker run -d --name wifidiag -p 80:80 sorah/wifidiag

使用说明

目前官方使用说明尚未完善，建议参考项目仓库获取最新使用指南。基本工作流程包括：

1. 启动服务后访问诊断页面
2. 自动收集客户端Wi-Fi连接信息
3. 查看诊断结果或配置Slack报告功能

开发与贡献

开发环境设置

1. 克隆仓库后，运行以下命令安装依赖：

   bash
   bin/setup
   

2. 运行测试：

   bash
   rake spec
   

3. 启动交互式开发终端：

   bash
   bin/console
   

版本发布

1. 更新version.rb中的版本号
2. 执行发布命令：

   bash
   bundle exec rake release
   

   该命令将创建版本标签、推送代码及标签，并将gem包发布至rubygems.org。

贡献指南

欢迎通过GitHub仓库（https://github.com/sorah/wifidiag%EF%BC%89%E6%8F%90%E4%BA%A4bug%E6%8A%A5%E5%91%8A%E5%92%8C%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E3%80%82

许可证

本工具基于MIT许可证开源。