在浏览器中使用 RikkaHub · 局域网 HTTP 服务器
什么是 Web 界面
RikkaHub 提供了局域网 Web 访问能力——你在手机上启动 RikkaHub 内置的 HTTP 服务器，同一 Wi-Fi 下的任何设备（笔记本、平板、另一部手机）打开浏览器就能用完整的 RikkaHub 聊天界面。
Web 界面只是访问窗口——RikkaHub 仍然运行在你的 Android 手机上，所有数据仍然存储在手机本地。Web 界面是纯前端，通过 HTTP 请求和手机上的 RikkaHub 后端通信。
什么时候用 Web 界面
| 场景 | 说明 |
|---|---|
| 不想在小屏幕上打字 | 笔记本键盘比手机舒服 |
| 正在用电脑 | 不想切换到手机 |
| 多人共用 | 同一局域网里多人可以轮流用（但要设置密码） |
| 平板体验 | 平板上浏览器打开 RikkaHub 比手机更舒服 |
启动服务器的完整流程
- 打开 设置 → Web 访问
- 配置端口（默认 8080，可用 1024-65535）
- 选择网络可见性：
- 仅本机访问：只能从手机自身访问（ADB 端口转发场景）
- 关闭"仅本机访问" → 同一 Wi-Fi 下其他设备可以访问
- 设置访问密码（强烈推荐）
- 启用 JWT 认证（有密码后自动可用）
- 点击 启动 按钮
- RikkaHub 请求通知权限（Android 15+ 还请求本地网络权限）→ 允许
- 服务器启动成功，Web 访问页面显示可用地址
可用地址
服务器启动后，Web 访问页面会显示：
| 地址类型 | 示例 | 说明 |
|---|---|---|
| 局域网地址 | http://192.168.1.42:8080 | Wi-Fi 下其他设备可以访问 |
| mDNS 地址 | http://android-device.local:8080 | 更容易输入的友好名称 |
| 本机地址 | http://localhost:8080 | 手机自身浏览器访问 |
点击任意地址行可复制到剪贴板。
mDNS 地址说明
.local 结尾的 mDNS 地址（如 android-device.local）更好记，在大多数家庭路由器（Apple AirPort、华硕、TP-Link 等）上自动工作。如果 mDNS 地址打不开，回退用局域网 IP 地址。
浏览器访问体验
- 完整的聊天功能：对话、助手、模型切换、附件、分享——手机上有的 Web 界面都有
- 界面自适应：大屏（笔记本）和小屏（手机浏览器）都能正常显示
- 性能：取决于手机的处理能力和 Wi-Fi 速度，通常很快
- 限制：手机 RikkaHub 进程必须运行（前台或后台）。关闭或杀死 RikkaHub 进程 → 服务器停止
安全警告
局域网暴露风险
如果你关闭了"仅本机访问"，同一 Wi-Fi 下的任何人都能访问 RikkaHub 聊天界面——这意味着他们能：
- 看到你的完整对话历史
- 看到你配置的所有 AI 提供商 API 密钥（Web 界面直接从 RikkaHub 后端拉）
- 在你账户里发消息
强烈建议
一定要设置访问密码并启用 JWT 认证。详见下一节。
停止服务器
- 点击 Web 访问设置页面上的 停止 按钮
- 或在 Android 通知栏关闭 RikkaHub 的持久前台通知
停止后：
- 所有活跃的浏览器会话立即断开
- 服务器关闭，端口释放
- 再次启动需要重新点击"启动"
常见问题
服务器启动了但浏览器打不开
排查：
- 确认手机和浏览器设备在同一 Wi-Fi 下
- 确认手机没开移动数据优先（某些 Android 设置会导致不同网络接口）
- 确认"仅本机访问"没开启
- 确认端口号没被占用（换一个试试，比如 8081）
- 确认 RikkaHub 进程没被系统杀掉
Web 界面加载很慢
- 手机性能是瓶颈（手机是服务器 + 推理引擎）
- 大对话历史可能需要较长时间初始化
- Wi-Fi 信号弱会有影响