跳到主要内容

演示模式

演示模式允许公共预览部署展示 Libre WebUI,而无需真实的后端账户或提供商凭据。

演示模式的启用条件

出现以下任一情况时会启用演示模式:

  • 设置了 VITE_DEMO_MODE=true;或
  • 前端运行在 Vercel、Netlify、GitHub Pages 等已知预览主机,或 demo./preview. 子域名上。

除非设置 VITE_DEMO_MODE=true,否则本地开发不会使用演示模式。

登录行为

演示模式会预填演示凭据并禁用登录字段。用户只需单击 登录。注册和 OAuth 按钮会被隐藏。

演示模式提供的内容

演示模式为主要产品流程使用模拟 API 响应:

  • 聊天会话和消息
  • 模型
  • 角色
  • 构件
  • 偏好设置
  • 插件列表

这样既能保持演示的交互性,又不会写入真实用户数据。

演示模式不提供的内容

演示模式不是生产环境身份验证方案。它不提供真实持久化、真实提供商调用、真实账户管理,也不提供实际的 Work 任务容器和命令执行。

真实部署应以常规身份验证运行后端,并配置要公开的提供商。

配置演示模式

前端 .env

VITE_DEMO_MODE=true

照常构建和运行前端。即使后端同时运行,受支持的界面流程仍优先使用演示模式 API 模拟。

相关文档