局域网远程连接——在电脑上管理手机 Root 模块

为什么远程访问

手机屏幕小、打字不方便，在电脑浏览器里管理 root 模块和参数调优效率更高。远程访问也是模块开发者调试时的标配——手机只负责运行，电脑负责操作和查看日志。

前提条件

• 手机和电脑在同一局域网（连同一个 WiFi 或同一个路由器的有线 / 无线）
• 手机已授予 KsuWebUI root 权限并成功启动
• 电脑能通过局域网 IP 访问手机

步骤

第一步：获取手机局域网 IP

在手机上打开：

• 设置 → WiFi → 点击当前连接的网络 → 查看 IP 地址
• 或者在 KsuWebUI 设置页里找「局域网地址」

假设你的手机 IP 是 192.168.1.100。

第二步：获取 KsuWebUI 端口

默认端口是 8080。在 KsuWebUI 启动后显示的地址里能看到，或者去设置页面确认。

第三步：电脑浏览器打开

在电脑上打开浏览器，输入：

http://192.168.1.100:8080

应该就能看到和手机上一样的管理界面了。

远程模式 vs 本地模式

远程访问和本地 WebView 渲染的是完全相同的界面——没有功能限制、没有区别对待。只是访问方式从 APP 内置的 WebView 换成了电脑浏览器。

移动端访问电脑的情况

KsuWebUI 是手机上的 Web 服务——它不会反向去访问电脑。所以电脑不能主动连接手机上的 KsuWebUI 服务，必须是你在电脑浏览器里输入地址来访问。

多个设备同时访问

同一局域网下可以有多个设备同时打开 KsuWebUI 的远程地址——多台电脑、平板、手机浏览器一起访问都没问题。所有设备看到的是同一份实时数据。

安全提示

⚠️ KsuWebUI 的远程接口没有内置鉴权——任何能访问你局域网的设备都能打开管理界面。这意味着：

• 不要在公共场所 WiFi 上开启远程访问（咖啡馆、机场、酒店）
• 家里路由器没开 AP 隔离时，访客 WiFi 上的设备也能访问
• 用完远程管理后建议关闭 WiFi 或停止 KsuWebUI 的后台服务
• 如果担心，可以只在本机 WebView 里用，不开远程

连接不上的排查