WrtHub-UI 概述

WrtHub-UI 运行在服务器上,提供对设备会话的可视化管理:查看所有已接入的 OpenWrt 设备、远程配置无线网络、审计操作日志,并通过角色权限控制管理员的操作范围。

技术栈Go(Gin)+ HTMX + Bootstrap,设备通信采用 /auth 登录 + UBUS JSON-RPC
数据来源frps_helper 北向接口(7443,设备与会话);设备侧经 UBUS 读写配置
界面结构顶部导航 + 左侧菜单(设备管理、审计日志等),深色侧边栏布局

功能总览

设备管理

设备列表(可分页、条件查询)与设备详情:名称、IP、状态、型号、序列号、MAC 地址等,从列表进入单台设备的无线与配置管理。

无线管理

多 radio 支持、SSID 增删改、安全模式配置、应用生效(带回滚防失联),底层经 UBUS 的 uci 读写与 iwinfo 采集。

审计日志

记录管理操作,便于事后审计与问题追溯。

用户与权限

本地登录(后续考虑集成 Casdoor 等认证中心),用户注册、密码重置/修改、角色与权限(RBAC)管理。

界面预览

WrtHub-UI 设备列表页截图
WrtHub-UI 设备列表页:展示已接入设备的名称、IP、状态、型号、序列号、MAC 等信息

部署

WrtHub-UI 编译为单个可执行文件,通过 config.yaml 配置:

  • 会话密钥(SessionSecret)与服务监听地址。
  • frps_helper 北向接口地址(HTTPS 7443)。
  • SQLite 数据文件(dist/data)。

启动后默认跳转 /devices;未登录访问受保护路由会被重定向到登录页。