Web UI
This content is not available in your language yet.
SRA WebUI 是 SRA 的网页控制面板,基于 Vue 3 + Element Plus + Pinia 构建, 由 SRA-server 直接托管静态资源,无需单独部署。 在线预览:StarRailAssistant WebUI
打开 WebUI
Section titled “打开 WebUI”启动服务端后访问监听地址即可:
sra servehttp://localhost:5073| 页面 | 路径 | 内容 |
|---|---|---|
| 首页 | / |
任务状态、运行配置管理、任务配置表单、公告 |
| 日志 | /logs |
实时画面、实时日志、后端控制 |
| 设置 | /settings |
应用设置表单(按分区导航) |
| 关于 | /about |
版本与运行时信息、GitHub 仓库、构建环境、数据目录 |
| 登录 | /login |
填写访问令牌(启用认证后出现) |
- 任务状态:显示当前任务运行状态,可启动/停止;
- 运行配置:从
/api/configs读取配置列表,选择当前配置,支持新建与删除; - 任务配置表单:完全由
/openapi/v1.json动态生成。后端配置模型是什么样,页面就渲染什么字段, 新增字段无需前端发版; - 公告:展示来自站点的活动与版本信息。
- 实时画面:以固定间隔轮询
/api/backend/screenshot,用于远程观察游戏画面; - 实时日志:通过 SSE(
/api/backend/logs/stream)推送,支持搜索、筛选、字号调整与断线重连, 最近的日志会缓存到浏览器localStorage,刷新后仍能保留; - 后端控制:重启(进程内重新初始化)与停止(请求停止任务并让服务退出)。
设置表单同样由 OpenAPI 规范驱动,字段说明来自后端附带的 x-i18n 信息,支持中/英/俄界面语言。
修改通过 PUT /api/settings 提交;启用了访问令牌时,修改配置或设置需要令牌有效。
启用访问令牌后(见认证与安全),任意 API 返回 401 都会跳转到 /login:
- 在登录页输入访问令牌并提交
POST /api/auth; - 校验通过后令牌写入
localStorage的sra_token; - 后续请求自动附加
X-Access-Token请求头; - SSE 无法自定义请求头,日志流改为通过
?access_token=携带。
开启 SRA_VISITOR_MODE 后,页面仍可浏览,但绝大多数写操作会被静默忽略(后端返回成功但不执行),
截图接口返回空图片,且 /mcp 不会挂载(停止后端 仍然有效)。适合只读展示,详见
认证与安全。
默认只监听 127.0.0.1,其他设备无法访问。需要局域网访问时:
sra serve --host# 或SRA_HOST=0.0.0.0 sra serve然后访问 http://<主机IP>:5073。
--host 会让同网段设备都能访问。暴露到公网前请启用访问令牌,并用反向代理屏蔽
/mcp、/openapi 等不鉴权的路径。
前端源码位于 SRAFrontend/srafrontend-webui:
pnpm installpnpm dev # http://localhost:5173,/api 与 /openapi 代理到 5073pnpm build # 类型检查 + 构建,产物自动复制到 SRAServer/staticpnpm test # Vitestpnpm build 结束时会执行 scripts/postbuild.mjs,清空并覆盖 SRAServer/static,
因此构建完成后直接重启服务端即可看到新界面。
