开源项目：wifi-kickout 使用手册

一、项目目录结构及介绍

项目地址: https://github.com/smallerxie/wifi-kickout.git

本项目基于bash脚本，专为OpenWrt设计，用于自动踢出Wi-Fi信号弱的客户端。其目录结构简洁明了，核心在于以下几个文件：

• kickout.sh
  主要的脚本文件，实现了判断并踢出信号低于阈值的Wi-Fi客户端的功能。

• LICENSE
  许可证文件，声明该项目遵循GPL-3.0许可证。

• README.md
  项目说明文档，提供了快速入门指导以及一些基本设置信息。

二、项目启动文件介绍

kickout.sh

• 功能概述： 这个脚本通过比较Wi-Fi客户端的信号强度（RSSI）与设定的阈值，来决定是否踢除那些连接不稳定、信号极弱的设备。它支持周期性执行，可通过crontab定时任务或者循环执行方式实现。

• 关键参数与命令：

  • 使用ubus调用hostapd服务接口来删除（deauthenticate）指定客户端。
  • 根据信号强度(rssi)与预设的阈值(thr)判断是否执行踢出操作。
  • 自动创建日志文件于/tmp/wifi-kickout.log记录操作信息。

• 执行方式：

  • 直接在OpenWrt环境下以shell命令执行此脚本。
  • 配置crontab定时执行或循环调用。

三、项目的配置文件介绍

本项目没有单独的传统配置文件。然而，配置是通过修改kickout.sh脚本来完成的。主要涉及以下几点：

• 信号阈值 (thr) 的设置： 用户需在脚本中找到相关变量定义，如 thr=你的阈值dBm，并按需调整这个数值来控制踢出客户端的信号强度标准。

• 日志文件路径： 脚本默认将日志写入到 /tmp/wifi-kickout.log，根据需要，你可以在这里修改日志文件的保存位置。

• 执行频率： 若要定期执行，配置不在脚本内进行，而是在系统层面（如crontab），具体时间取决于对网络稳定性的要求。

综上所述，通过调整kickout.sh内的参数和利用Linux系统的计划任务机制，用户可以灵活地管理和优化自己OpenWrt路由器上的Wi-Fi连接质量，确保网络环境的高效稳定。记得在应用任何更改前备份重要数据，并测试脚本以防不测影响到正常的网络访问。