WebUI 远程访问

WebUI 提供浏览器版 SoniBot。最简单的方式是在桌面应用中启用，不需要手动运行命令。

启用 WebUI

1. 在 SoniBot 桌面端进入“设置 → 远程连接”；
2. 打开“启用 WebUI”；
3. 保持默认端口，或设置一个 1–65535 范围内的可用端口；
4. 只在本机使用时关闭“允许远程访问”；
5. 需要同一局域网的手机或电脑访问时，打开“允许远程访问”；
6. 等待状态显示“运行中”；
7. 复制本地地址或网络地址，在目标浏览器中打开。

改变端口或“允许远程访问”时，SoniBot 会重启 WebUI 服务以应用新的监听配置。

地址怎么选

• http://localhost:<端口>：只在当前机器上使用；
• http://<局域网-IP>:<端口>：同一局域网中的其他设备使用；
• 二维码：用手机扫描后打开对应地址，并按页面提示登录。

如果手机扫描后打不开，先确认手机和电脑在同一网络，并检查电脑防火墙是否允许该端口。

账号与密码

首次启动会生成管理员账号和初始密码。请立即：

1. 保存初始密码；
2. 登录 WebUI；
3. 在桌面设置中修改用户名或密码；
4. 使用至少 8 个字符、且不常见的密码。

初始密码可能只显示一次，之后以星号隐藏。忘记密码时，在桌面应用中使用“重置密码”；浏览器端不能管理 WebUI 服务和敏感设置。

常见问题

地址拒绝连接

• 确认桌面设置显示“运行中”；
• 检查端口是否被其他应用占用；
• 重启 WebUI 开关；
• 确认复制的是当前端口，而不是旧地址。

本机可以，其他设备不行

• 开启“允许远程访问”；
• 使用局域网 IP，不要在手机上使用 localhost；
• 确认设备在同一局域网；
• 放行操作系统防火墙；
• 检查访客 Wi-Fi 是否隔离设备。

页面能打开但 Agent 不能工作

• 桌面 SoniBot 和后端必须仍在运行；
• 目标 Agent 需要完成认证；
• 本机项目目录必须可访问；
• 查看桌面端是否有等待确认的权限请求。

安全建议

开启“允许远程访问”会让服务监听局域网接口。只在可信网络使用，不要在公共 Wi-Fi 或无访问控制的公网环境直接开放。

• 定期更新 SoniBot；
• 修改默认凭据，不复用常用密码；
• 跨网络优先使用 VPN 或带 HTTPS 的反向代理；
• 不在远程会话中扩大不必要的项目目录权限；
• 不使用时关闭 WebUI。