WebUI 与远程访问

Aichat 的 WebUI 可以用浏览器访问。桌面客户端负责启动本机 WebUI 服务，浏览器负责打开对应地址。

需要注意的是：扫码登录不是远程穿透。扫码只负责把手机或另一台设备上的浏览器登录到 WebUI；真正能不能打开页面，取决于那台设备能不能访问到你电脑上的 WebUI 地址。

这几个概念的区别

功能	作用
启用 WebUI	在当前电脑上启动一个可用浏览器访问的 WebUI 服务
允许远程访问	让 WebUI 不只绑定本机地址，而是允许局域网内其它设备访问
扫码登录	在已经能打开 WebUI 的浏览器里完成登录
内网穿透或 VPN	让不在同一局域网的设备也能访问你的电脑

所以，同一 Wi-Fi 下的手机通常可以直接用浏览器打开局域网地址；如果手机用蜂窝网络，或你人在外面访问家里的电脑，就需要 Tailscale、ZeroTier、Cloudflare Tunnel、FRP、ngrok 或 VPS 反向代理这类网络方案。

同一局域网访问

1. 在 Aichat 客户端里启用 WebUI。
2. 打开“允许远程访问”。
3. 记下客户端显示的局域网访问地址。
4. 在同一 Wi-Fi 下，用手机或另一台电脑浏览器打开这个地址。
5. 如果页面要求登录，再使用扫码登录或账号密码登录。

如果地址是 127.0.0.1 或 localhost，它只代表当前这台电脑，手机上不能直接用。手机需要打开客户端显示的局域网 IP 地址。

跨网络访问

跨网络访问时，浏览器仍然可以使用，但你需要先解决网络可达性。

推荐方式：

方式	适合场景
Tailscale 或 ZeroTier	自己的手机、电脑之间远程访问，配置相对简单
Cloudflare Tunnel	希望通过域名访问，并且不想暴露家庭公网 IP
FRP、ngrok 或 VPS 反向代理	已经有服务器或熟悉网络配置

不要把未加保护的 HTTP WebUI 直接暴露到公网。远程访问至少应配合可信隧道、访问控制或 HTTPS 代理。

扫码后空白怎么办

先按下面顺序排查：

1. 确认手机浏览器能直接打开 WebUI 首页，而不是只扫二维码。
2. 确认扫码地址不是 127.0.0.1、localhost 或手机无法访问的内网地址。
3. 如果不在同一 Wi-Fi，先连接 Tailscale、ZeroTier 或其它隧道。
4. 刷新客户端里的二维码后重新扫码，二维码可能会过期。
5. 更新到最新版 Aichat。新版已经修复 WebUI 扫码页被前端页面吞掉、以及扫码登录字段不匹配导致失败的问题。

扫码页正常时，即使登录失败，也应该显示错误提示，而不是纯空白页。如果一直空白，通常是访问地址不可达、静态 WebUI 版本过旧，或本地 WebUI 服务没有正确代理扫码登录页面。