Nexus Agent
e833b923c8
接入 Playwright Worker、会话 WebSocket 与全局浏览器面板（固定于 App Bar 下）； 含验证码 stealth、设置项默认音与 URL 安全校验；附带 worker 部署与设计文档。 Co-authored-by: Cursor <cursoragent@cursor.com>
1.8 KiB
1.8 KiB
内置 Web 浏览器 — 设计说明
背景与目标
运维需在 Nexus 内快速预览子机站点（域名），不必切换外部浏览器；与终端、文件管理并列的运维入口。
方案对比
| 方案 | 优点 | 缺点 |
|---|---|---|
| iframe 嵌入 | 无后端、实现快、无 SSRF | 部分站点 X-Frame-Options 禁止嵌入 |
| HTTP 反向代理 | 可绕过 frame 限制 | SSRF 风险、需维护代理与 Cookie |
| 仅外链新标签 | 零风险 | 非「内置」 |
选定（2026-06-11 前）：iframe + 地址栏 + 新标签兜底；首版不做 HTTP 代理。
2026-06-11 变更：用户拒绝 iframe 方案，改为 服务端 Playwright Chromium + WebSocket 画面流。
见 2026-06-11-server-browser-chromium-design.md。
本文档仍有效部分：路由入口、URL 白名单原则、UI 状态 API；iframe 渲染已废弃。
接口与路由
- 前端
#/browser?url=https://example.com - 服务器列表「站点」→ 带
url（由domain推导https://{host}，不含 SSH 端口）
安全
- 仅允许
http:/https:；拒绝javascript:、data:、凭据 URL - iframe
sandbox：allow-scripts allow-same-origin allow-forms allow-popups allow-downloads - 无后端 fetch，不引入 SSRF
- 不记录浏览审计（被动预览，非 CUD）
验收
- 全局浮动面板、最小化可拖、不可关闭（见 global-floating-browser changelog）
- 侧栏「浏览器」或左下角入口打开浮动窗
- 地址栏输入 URL 可导航；刷新 / 新标签打开
- 服务器列表「站点」跳转并加载域名
- 非法 URL 拒绝并提示
- 网站导航（收藏） — 见 browser-nav-bookmarks-design.md