Nexus/docs/changelog/2026-06-12-remove-remote-browser.md

2026-06-12 移除远程内置浏览器方案

摘要

整体下线 Playwright Worker + 全局浮动 canvas 浏览器：删前端组件/路由、后端 /api/browser/* 与 /ws/browser、 browser-worker/ 目录及单测。

动机

黑屏与状态机复杂、验证码与 SSRF 未闭环；运维场景下「站点」新标签打开即可。经验沉淀见 docs/design/specs/2026-06-12-remote-browser-retired-lessons.md。

涉及文件（删/改）

• 删：frontend/src/components/GlobalBrowserPanel.vue、useGlobalBrowser.ts、useRemoteBrowserSession.ts、BrowserPage.vue
• 删：server/api/browser.py、browser_session.py、server/infrastructure/browser/*、server/utils/browser_*
• 删：browser-worker/、tests/test_browser_*
• 改：server/main.py（已不注册路由）、server/config.py（移除 BROWSER_*）
• 保留：frontend/src/utils/browserUrl.ts；ServersPage「站点」→ window.open

迁移/重启

• 生产可保留 NEXUS_BROWSER_* 于 .env（Settings.extra=ignore 忽略）；建议删除 Worker 容器与 8443 规则。
• 需 重启 Nexus API 与 前端 build 同步。

验证

venv/bin/pytest tests/test_settings_sound_defaults.py -q
cd frontend && npm run type-check && npx vite build
curl -sf https://api.synaglobal.vip/health
# 404 预期：GET /api/browser/status（需 JWT）