适用于 OpenWrt 的 MESH 插件

家里或者办公室有多台无线 AP,最麻烦的事情之一,就是修改 Wi-Fi 设置。换个名称、改个密码,都要逐台登录。为了解决这个问题,我做了一个适用于 OpenWrt 的无线集中管理插件——QMESH。它可以让一台路由器充当控制器,把 Wi-Fi 设置统一同步到其他 AP,并在一个页面里查看各台设备的状态。

控制器不需要有 Wi-Fi 功能,软路由也可以用来管理无线 AP。

主要功能

目前主要支持以下功能:

  • 统一设置:向多台 AP 同步无线名称、密码和漫游设置。
  • 批量接入:生成一个接入码,多台设备都可以使用,不用逐台填写控制器地址和认证资料。
  • 查看状态:显示设备名称、管理地址、客户端数量,以及在线和同步状态。
  • 修改参数:调整各频段的信道、频宽和功率,改好后统一应用。
  • 调优建议:扫描周围的无线网络,提出调整方案,由用户决定是否应用。
  • 手机适配:方便在手机上查看和操作。

控制器和 AP 使用同一个安装包,装好后在页面中选择角色即可。

需要说明的是,QMESH 主要解决的是多台 AP 的配置和管理问题。LAN、DHCP、VLAN 等基础网络设置,仍然需要先在设备上配置好。

功能截图

常规设置:

节点列表:

设备调优:

AP   设置:

网络设置

第一次使用,建议先采用有线连接:

主路由/交换机
    ├── QMESH 控制器
    ├── 无线 AP 1
    └── 无线 AP 2

控制器也可以直接安装在主路由上。

常见的 AP 设置方式是:

  1. 给每台 AP 设置一个不冲突的管理 IP。
  2. 关闭 AP 自己的 DHCP 地址分配功能,由主路由统一分配地址。
  3. 把无线网络桥接到 LAN。
  4. 确认 AP 能访问控制器的 HTTPS 地址。

如果已经使用 VLAN 或其他特殊网络结构,按原有规划配置即可。在 QMESH 中切换为 AP,并不会自动完成这些网络设置。

安装前建议备份配置,操作时尽量保留网线连接,避免修改无线设置后暂时无法管理设备。

安装插件

项目地址:https://github.com/Opnwall/QMESH-for-OpenWRT

根据路由器使用的包管理器选择:

安装包 适用情况
IPK 使用 opkg 安装软件的固件
APK 使用 apk 安装软件的固件

IPK 安装

把安装包上传到路由器的 /tmp/ 目录,通过 SSH 执行:

opkg install /tmp/luci-app-mesh-control_0.1.63-1_all.ipk

APK 安装

apk add --allow-untrusted /tmp/luci-app-mesh-control-0.1.63-r1.apk

APK 为未签名的本地构建包,因此需要加上 --allow-untrusted。

安装完成后,打开路由器管理页面,在「网络 → QMESH」中进行设置。如果页面没有更新,可以强制刷新浏览器。

设置方法

控制器

进入「常规设置」,选择「控制器」,点击「应用角色」。

然后在「无线配置」里填写:

  • Wi-Fi 名称,也就是 SSID。
  • Wi-Fi 密码。
  • 是否启用漫游。

填写完成后,点击「同步配置」。

接下来,在「节点注册」中点击「生成接入码」。控制器会自动带上地址和认证信息,不需要手动填写这些内容。

AP设置

在无线 AP 上安装相同版本的 QMESH,然后:

  1. 选择「AP」角色。
  2. 粘贴控制器生成的完整接入码。
  3. 勾选需要管理的无线接口。
  4. 点击「应用角色」。

等待页面显示绿色「已同步」,再回到控制器的节点列表中检查。

最后,用手机连接 Wi-Fi,确认能够正常获取地址和上网。

接入码

可以。同一个批量接入码可以让多台 AP 加入,每台 AP 都会得到独立的身份资料。

接入码默认有效期为 30 分钟,过期后不能再添加新设备,但已经加入的 AP 仍会正常同步。

生成新的接入码会使旧码失效。接入码不要公开,也不要直接把一台 AP 的配置文件复制给另一台,否则可能造成两台设备共用同一个身份。

查看节点

节点列表可以看到每台 AP 的无线参数、客户端数量和状态。

  • 在线:最近 60 秒内收到过设备上报。
  • 离线:超过 60 秒没有收到上报。
  • 已同步:AP 已确认应用控制器的配置。

“已同步”不代表已经完成上网和漫游测试,仍然建议用手机实际连接检查。

参数修改

需要修改无线参数时,点击对应频段的「调整参数」,选择信道、频宽和功率。可以先修改多台设备,最后点击一次「应用更改」。

应用参数时,无线连接可能短暂中断。

设备调优

设备调优页面支持先勾选设备,再点击「自动检测」。系统会根据扫描结果提出调整建议。

自动检测只负责检测和提出建议,不会自动修改无线设置。核对方案后,点击应用才会下发。

周围 Wi-Fi 的扫描结果,不能完全代表每个房间的实际覆盖情况。因此,建议需要结合现场使用效果判断。没有足够的覆盖数据时,系统会保持当前功率,不会盲目调整。

漫游也是一样:开启 802.11r/k/v 后,能否顺畅切换,还要看无线驱动和手机、电脑是否支持,不能保证所有设备都做到完全无感。

双回传测试

在两台配对的 HG5585F 测试设备上验证了以下过程:平时使用网线 → 网线断开后切到无线 → 网线恢复后切回有线,测试过程一切正常。

该功能有明确的适配范围,其他设备需要另外检查驱动和网络结构,参与回传的设备中至少一台要保持有线上联。

暂无评论

发送评论 编辑评论


				
|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
(╯‵□′)╯︵┴─┴
 ̄﹃ ̄
(/ω\)
∠( ᐛ 」∠)_
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ`)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ( ̄∇ ̄o)
ヾ(´・ ・`。)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò。)
Σ(っ °Д °;)っ
( ,,´・ω・)ノ"(´っω・`。)
╮(╯▽╰)╭
o(*////▽////*)q
>﹏<
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
颜文字
Emoji
小恐龙
花!
上一篇