Web 服务器仅在 Rikka 在你的 Android 设备上运行时有效。关闭或强制停止应用会关闭服务器。一个持久的前台通知会在应用处于后台时保持服务器运行。
启动服务器
1
打开 Web 访问设置
在 Rikka 中，前往设置 → Web 访问。
2
配置端口
在端口字段中输入端口号。默认值为 8080。可使用 1024 到 65535 之间的任意值。服务器运行时无法更改端口。
3
选择网络可见性
如果你只希望从设备本身访问服务器（适用于 ADB 端口转发），请开启仅本机访问。关闭此选项则允许 Wi-Fi 网络中的其他设备访问。
4
设置访问密码（推荐）
在访问密码字段中输入密码。参见下方的保护服务器安全。
5
启动服务器
点击启动按钮。Rikka 会请求通知权限，在 Android 15 及更高版本上还会请求本地网络权限，然后启动服务器。
查找服务器 URL
服务器运行后，Web 访问页面会显示可用地址：
点击任意地址行即可复制到剪贴板。提示消息会确认复制成功。在同一网络的任何浏览器中打开该 URL 即可。
保护服务器安全
Rikka 使用基于 JWT 的认证来保护服务器：1
输入访问密码
在 Web 访问设置页面的访问密码字段中输入密码。
2
启用 JWT 认证
开启启用 JWT 认证。此开关仅在密码字段非空时可用。清空密码会自动禁用 JWT 认证。
3
在浏览器中认证
首次打开服务器 URL 时，Web 界面会提示你输入密码。验证成功后，浏览器会话中会存储一个 JWT 令牌，在令牌过期前无需再次输入。
配置参考
HTTP 服务器监听的 TCP 端口。必须在 1024 到 65535 之间。如果值超出范围会显示错误状态。服务器运行时无法更改。
启用时，服务器绑定到
127.0.0.1，只能从设备本身访问。禁用时，服务器绑定到所有网络接口，可以从同一网络中的其他设备访问。服务器运行时无法更改。要求每个请求携带签名的 JWT 令牌。令牌在使用访问密码登录时签发。仅在访问密码字段非空时可用。
用户在浏览器中获取 JWT 令牌时必须输入的密码。清空此字段会自动禁用 JWT 认证。请像对待其他敏感凭据一样妥善保管。