SoulBrowser Docs

Appearance

部署与运行 ​

本页把旧快速开始和技术文档里与部署相关的内容收成一个稳定入口，重点说明开发、联调和基础部署时最需要关心的事项。

常见运行形态 ​

本地开发 ​

适合：

  • 前后端联调
  • 运行态问题排查
  • 本地浏览器模式验证

典型组合：

bash
# backend
SOUL_EXECUTION_MODE=local SOULBROWSER_AUTH_DISABLED=1 cargo run --bin soulbrowser -- serve --disable-auth

# frontend
cd web-console-dx
trunk serve

# docs
cd docs-site
npm run dev

Web 服务模式 ​

适合：

  • 本地单机体验
  • 服务器部署 web console
  • 使用服务端浏览器运行

典型命令：

bash
cargo run --bin soulbrowser -- serve --port 8808

桌面 / 本地浏览器模式 ​

适合：

  • 需要看到真实本地浏览器
  • 需要人工接管或处理验证码

这类模式与 执行模式 联动理解更合适。

关键环境变量 ​

常见变量包括：

  • SOUL_EXECUTION_MODE
  • SOULBROWSER_AUTH_DISABLED
  • SOULBROWSER_CHROME
  • OPENAI_API_KEY

具体执行模式相关差异，见 执行模式。

部署前要确认的事 ​

鉴权默认值 ​

不要依赖开发期关闭鉴权的行为。部署时应明确：

  • 是否启用认证
  • token / secret 是否安全配置
  • 是否暴露了管理接口

端口与入口 ​

最常见默认服务端口是：

  • 8808：后端 API / 控制台入口

如果端口冲突：

bash
cargo run --bin soulbrowser -- serve --port 9999

浏览器依赖 ​

如果是本地模式，还要确认：

  • Chrome / Chromium 可发现
  • 路径没有被错误配置覆盖
  • 本地端口与已有浏览器实例不冲突

推荐的部署检查顺序 ​

  1. 服务是否能启动
  2. /api/config 是否符合预期
  3. 鉴权是否按预期启用
  4. /api/chat、/api/sessions、/api/tasks 是否可访问
  5. 前端实际调用的 base URL 是否正确

相关页面 ​

SoulBrowser Documentation

Docs in monorepo