
开发者用守护进程让OpenWrt设备接入UniFi控制器
来源标题:Unifi Adoption for OpenWRT Devices
一个运行在OpenWrt接入点上的小型守护进程通过UniFi inform协议,让UniFi控制器将旧AP识别为指定型号(默认UAP-AC-Pro、U7PG2)并统一管理。作者在自己的TP-Link OnHub(TGR1900)上测试,该设备自2023年1月起已停止官方支持,目前运行OpenWrt 25.12,接入后可在UniFi中像原生AP一样推送设置并查看客户端与射频统计。该方案仅在一台设备上验证过。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
让旧 OpenWrt 接入点在其厂商停止支持很久之后,仍能在 UniFi 网络中继续发挥作用。AP 上运行一个小型守护进程,使用 UniFi inform 协议通信,这样 UniFi 控制器就能将这个 AP 作为你选择的 UniFi 型号(默认:UAP-AC-Pro、U7PG2)进行 adopt,将设置推送到它,并像显示自家 AP 一样显示其客户端、射频和统计信息:一个网络,一处管理。如果你喜欢这个项目或觉得它有用,可以通过请我喝杯咖啡来支持这个项目。 我有一台 Google OnHub(TP-Link TGR1900)。它至今仍是一台能力不错的 3x3 Wi-Fi 5 接入点,但 Google 在 2023 年 1 月终止了对它的支持:不再有更新,不再能通过其应用管理,还建议将其回收。OpenWrt 让软件重新变得可用。不过我的家庭网络是 UniFi,而 UniFi 控制器只管理 Ubiquiti 自家的接入点,所以 OnHub 原本只能作为第二个网络存在,有自己的设置、自己的客户端,两者之间没有漫游。我不能接受还能正常工作的硬件因为厂商不再支持就变成电子垃圾,或者在网络中沦为二等公民。 仅在一台设备上测试过。本文所有内容仅在一台运行 OpenWrt 25.12 的 TP-Link OnHub(TGR1900)上测试过,将其作为 UAP-AC-Pro adopt 到 UniFi Express 7 上的 UniFi Network 10.6 中。其他 OpenWrt 设备、其他 UniFi 型号和其他控制器版本仅为尽力支持:它们可能可用,但尚未尝试。欢迎反馈。 它从不刷入 Ubiquiti 固件。来自控制器的升级请求会被应答并忽略;Ubiquiti 固件会让非 Ubiquiti 设备变砖。 安装软件包(OpenWrt 25.12+):用 tools/build.sh 和 tools/mkapk.sh 构建(见 docs/packaging.md),将适用于你 AP 架构(cat /etc/apk/arch)的 .apk 复制到 AP 并运行 apk add --allow-untrusted ./unifi-openwrt_*.apk。然后跳到步骤 3。 该软件包不会把基础版 wpad 换成完整版:如果你用的是基础版,它会打印出相应命令。 或者运行 tools/build.sh 并把 dist/openwrt/(包含 bin/、files/ 和 install.sh)复制到 AP,例如复制到 /tmp/uow,然后使用安装脚本(较旧的、使用 opkg 的 OpenWrt 也可以)。 使用安装脚本安装(用软件包方式则跳过此步): cd /tmp/uow && sh install.sh 安装脚本会检查可用闪存空间,从软件包源将基础版 wpad 替换为完整版(失败时恢复),添加 Requirements 下列出的软件包,安装 /usr/bin/uow、/etc/init.d/unifi-openwrt 和 /etc/config/unifi-openwrt(已有配置会保留),并打印最接近的 UniFi 型号。 选择型号。uow -models 列出全部型号;uow -ap local -suggest 为此 AP 排序(先按相同频段,再按 Wi-Fi 代际,再按流数)。U7PG2 是唯一有实测能力数据的型号。 uci set unifi-openwrt.main.model='U7PG2' uci set unifi-openwrt.main.inform_url='http://<controller IP>:8080/inform' uci set unifi-openwrt.main.apply='0' # 刚开始仅记录日志(见 Safety) uci set unifi-openwrt.main.enabled='1' uci commit unifi-openwrt /etc/init.d/unifi-openwrt enable /etc/init.d/unifi-openwrt start inform URL 需要 IP 地址,而不是主机名。文件中的其他选项:hostname、profile_caps、locate_beep、mesh_uplink、ssh_port(adopt 用 SSH 响应器,默认 2222)、hw_caps、inform_every、led_idle。 Adopt。AP 会以待 adopt 状态出现在 UniFi 中,显示所选型号的名称。点击 Adopt。 查看日志:logread -e uow。它会显示 adopt 过程、每一次变更计划、哪些被应用、被钳制或跳过,以及每次回滚。 当变更计划看起来正确后,将 apply 设为 '1' 并重启服务。 要停止管理该 AP:在 UniFi 中将其 Remove(守护进程会回到待 adopt 状态;OpenWrt 及其 Wi-Fi 不会被重置),然后执行 /etc/init.d/unifi-openwrt disable;/etc/init.d/unifi-openwrt stop。 除非另有标注,以上均在上文所述设备上实机测试过。 面向贡献者的技术说明在 docs/ 中: docs/internals.md:协议、配置转换、统计信息、满意度公式、型号与配置文件、LED、mesh、VLAN、访客门户和射频扫描。 GOOS=linux GOARCH=arm GOARM=7 CGO_ENABLED=0 go install github.com/antoniocosta/unifi-openwrt/cmd/uow@latest
二进制文件会生成到 $(go env GOPATH)/bin/linux_arm/uow
从克隆的仓库构建: go test ./... && go vet ./... CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -trimpath -ldflags='-s -w' -o uow ./cmd/uow tools/build.sh 会为 armv7、aarch64、mipsel、mips(软浮点)和 x86_64 构建 uow-<arch>,并在 dist/openwrt/ 中组装安装包。 路径 说明 cmd/uow 守护进程 cmd/owprobe、cmd/owplan、cmd/owctl 开发辅助工具:通过 SSH 打印某个 AP 的 inform 字段、为已保存的 system_cfg 打印 UCI 计划、执行单个 AP 操作 internal/ protocol(inform、device)、OpenWrt 侧(openwrt)、设置转换(translate)、型号目录(models)、只读 UniFi API 客户端(unifiapi) packaging/ 安装到 AP 上的文件、install.sh、OpenWrt 软件包 Makefile tools/ 构建、.apk 打包、型号目录生成器、一个小型 SNMP 测试客户端 docs/ internals、packaging 参与贡献 欢迎提交 issue 和 pull request。目前仅在一台设备上测试过,所以来自其他 OpenWrt 设备、UniFi 型号和控制器版本的反馈最有帮助:请说明设备型号、OpenWrt 版本、型号(-model)和控制器版本,并附上移除密钥和密码后的 logread -e uow(守护进程从不记录它们)。发送代码前请运行 go test ./... && go vet ./...。 本项目基于他人的工作构建: 本项目与 Ubiquiti 或 OpenWrt 项目无关联,未获其认可或支持。它依赖非官方的 UniFi 控制器行为,Ubiquiti 可能在任何更新中改变这些行为。本项目不包含任何 Ubiquiti 软件、固件或代码,也从不安装 Ubiquiti 固件。UniFi 和 Ubiquiti 是 Ubiquiti Inc. 的商标;OpenWrt 是其所有者的商标。这些名称仅用于说明本软件可与哪些产品配合使用。 GPL-2.0-or-later;见 LICENSE。第三方署名和许可证文本见 NOTICE。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。