给 OpenWrt 的无线网络广播自定义的 802.11 vendor-specific information element(IE tag 221),让特定客户端设备识别后显示对应的厂商图标——例如让 MIUI 手机在 WiFi 列表里给这个网络显示小米路由器的小图标。
Note
如果你的网络拓扑中有多个 OpenWrt 设备,且仅有部分设备参与 Wi-Fi 发射,则请将该应用安装至 发射 Wi-Fi 的 AP 设备 上。
本应用不支持以单臂路由方式运行的 Wrt 设备,亦对非 Wi-Fi 发射设备无效。
前往 Releases 下载最新版构建。CI 会同时产出两种包,先确认你的路由器用的是哪个包管理器再下载对应的:
# 在路由器上执行,看输出哪个存在
which opkg apk- 输出
/bin/opkg(OpenWrt 24.10 及更早)→ 下载文件名带.ipk的那个 - 输出
/bin/apk(OpenWrt 25.12 起的新固件)→ 下载文件名带.apk的那个
把文件传到路由器上(scp/LuCI 的“上传软件包”功能都行),然后:
# opkg
opkg install luci-app-wifi-vendorie_*.ipk或
# apk
apk add --allow-untrusted luci-app-wifi-vendorie_*.apk如果想要中文界面,还需要额外装一个 luci-i18n-wifi-vendorie-zh-cn(同样在 Releases 页面下载);英文是内置的默认语言,不用额外装包。
装完之后打开 LuCI,菜单里「网络」下面会多一个「WiFi 身份广播」页面:
- 页面会按 SSID 列出每个无线网络(同一 SSID 下的多个频段自动合并成一行)
- 在「宣称身份」里勾选想广播的身份,可以多选
- 点保存并应用,插件会自动写入
vendor_elements并wifi reload让配置生效 - 拿一台开着对应识别功能的设备(比如 MIUI 手机)重新扫描一下 WiFi 列表就能看到效果,已经连接的设备可能需要断开重连才会刷新
802.11 beacon 帧里的 vendor-specific IE(tag=221/0xDD)是标准预留给厂商自定义数据的字段,
格式是 DD <长度> <3字节OUI> <厂商自定义payload>。
MIUI 的 com.android.settings 里有一段 XiaomiRouterUtils.isXiaomiRouter(),专门扫描
beacon 里的这类 IE,只要 payload 满足以下任一条件就会判定“这是小米路由器”,在WiFi列表SSID旁边显示图标:
- 以
80 AD 16 01 01 01(小米私有OUI + 固定标记字节)开头,且长度 > 6 字节 - payload 里任意位置包含 ASCII 字符串
"xiaomi"(不分大小写)
这段逻辑是从真机拉取 Settings.apk 反编译验证得到的。
iPhone 个人热点 预设用的是苹果自己的 vendor IE(00:17:F2 OUI),这是 iOS/macOS 用来识别“这是另一台苹果设备开的个人热点”的信号。连接后对方设备会把这个网络当成按流量计费网络处理(可能触发低数据模式、后台App网络访问受限等),请谨慎使用。插件界面里也标注了这个警告。
- 每个 SSID 一行(同一 SSID 下的多个频段/wifi-iface 会被自动合并显示、一起设置,不用分别操作)
- 多选:可以同时给一个网络叠加广播多个身份(vendor_elements 支持拼接多段IE)
- 保存后自动
wifi reload生效
由于使用了 LuCI 的 JS 前端框架,本插件兼容 OpenWrt 19.07 或更新 版本。
.
├── Makefile
├── po/
│ └── zh_Hans/wifi-vendorie.po # 中文翻译源文件
├── root/
│ └── usr/share/
│ ├── luci/menu.d/luci-app-wifi-vendorie.json # 菜单注册(网络 -> WiFi 身份广播)
│ └── rpcd/acl.d/luci-app-wifi-vendorie.json # ACL 权限(读写 wireless uci)
└── htdocs/
└── luci-static/resources/view/wifi-vendorie.js # 页面逻辑(英文原文,键名即英文)
日常直接用 GitHub Actions 出的产物就行(见上面「使用方法」),不需要自己编译。如果想手动构建:
这个包是 PKGARCH:=all(纯 uci/JS,没有需要交叉编译的原生代码),用哪个架构的 SDK 都行;但 输出格式(ipk / apk)取决于 SDK 对应的 OpenWrt 版本——25.12 起默认换成了 apk,之前的版本(包括 24.10.x)还是 opkg。想要哪种格式就下载对应版本的官方 OpenWrt SDK:
# 在 SDK 根目录
ln -s /path/to/luci-app-wifi-vendorie package/luci-app-wifi-vendorie
./scripts/feeds update base luci
./scripts/feeds install -a -p luci
make defconfig
make package/luci-app-wifi-vendorie/compile V=s编译产物在 bin/packages/<arch>/base/ 下,文件名带 .ipk 或 .apk 后缀取决于用的哪个SDK。
请参阅 CONTRIBUTING.md。
这是个纯粹为了好玩做的小工具,广播的 vendor IE 内容不涉及冒充身份进行欺诈,单纯是利用了各厂商自己写在客户端里、本身就公开可被任意 AP 触发的展示逻辑。请自行承担使用后果,尤其是“iPhone 个人热点”这个预设。