How to enable plugin sandbox feature in self-hosted deployment, cannot create Excel

用户通过 docker compose 部署 LobeChat(自托管环境),在 Web 浏览器端请求 AI 助手创建 Excel 文件时,弹出“创建个人档案”授权弹窗,导致操作无法继续。用户期望在自部署环境中能正常使用 Excel 创建功能,无需与 LobeHub 社区市场进行认证。

How to enable plugin sandbox feature in self-hosted deployment, cannot create Excel

How to enable plugin sandbox feature in self-hosted deployment, cannot create Excel

快速结论:自部署 Docker 实例中使用创建 Excel 等插件功能时,会弹出“创建个人档案”认证弹窗。这是因为 Excel 创建依赖 LobeHub 官方的云沙箱(Cloud Sandbox)服务,目前无法完全自托管绕过云端认证。优先检查是否使用了 HTTPS,并确认已更新到最新版本。

问题场景

用户通过 docker compose 部署 LobeChat(自托管环境),在 Web 浏览器端请求 AI 助手创建 Excel 文件时,弹出“创建个人档案”授权弹窗,导致操作无法继续。用户期望在自部署环境中能正常使用 Excel 创建功能,无需与 LobeHub 社区市场进行认证。

报错原文

Why does creating Excel require creating a personal profile?
A popup appears to create a personal profile, but self-deployed instances should not be connected to the community.

原因分析

Excel 创建功能调用的是 lobe-cloud-sandbox(云沙箱插件),该插件依赖 LobeHub 官方市场服务 market.lobehub.com 进行身份认证和资源下发。自部署实例无法完全绕开此云端认证流程,因此会弹出“创建个人档案”的提示。另外,如果部署使用 HTTP 而非 HTTPS,浏览器 crypto.subtle API 的安全限制会导致 PKCE 认证流程失败,从而反复弹出授权提示。

注意:Issue 中明确标记为“目前没有办法完全自托管插件沙箱服务来绕过这个云端认证”。

环境排查

  • 确认 LobeChat 版本是否为 latest 或至少已更新到包含近期修复的最新镜像。
  • 确认部署环境是否使用 HTTPS(浏览器安全策略要求)。
  • 检查 Agent 插件设置中是否启用了 lobe-cloud-sandbox 插件。

解决步骤

  1. 推荐方式:禁用云沙箱插件 — 在 Agent 的插件设置中移除或禁用 lobe-cloud-sandbox 插件。这可以避免授权弹窗,但会失去 Excel 创建等云沙箱功能。
  2. 如果需要使用云沙箱功能 — 在弹窗中完成 LobeHub Marketplace 账号认证(此认证与本地实例认证独立,属于社区市场层面的认证)。
  3. 确保使用 HTTPS — 检查你的域名或 IP 是否通过 HTTPS 访问。如果仅使用 HTTP,浏览器会因 crypto.subtle 安全限制导致认证流程失败,表现为反复弹出授权弹窗。建议配置 SSL 证书或使用反向代理提供 HTTPS。
  4. 升级到最新版本 — Issue #15013 中反馈的“选择本地环境仍然弹出云沙箱授权”问题已在近期修复。使用 docker compose pull 拉取最新镜像并重启容器。

验证方法

执行解决步骤后,重新在对话框中请求“创建 Excel”或其他涉及云沙箱插件的操作。若不再弹出“创建个人档案”授权弹窗,或可正常完成操作,则问题已解决。如果禁用了云沙箱插件,确认相关插件已被移除或禁用状态生效。

参考来源

lobehub/lobe-chat #15464

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

celebrityanime
celebrityanime
文章: 8876

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注