issue: Copy path in open-terminal fails on latest dev

该报错发生在 Open WebUI 最新 dev 版本中,点击 Open Terminal 的 "Copy Path" 按钮后浏览器控制台报错 `navigator.clipboard` 未定义,且剪贴板无内容。优先排查是否通过非 HTTPS(如局域网 HTTP)访问界面,因为 Clipboard

快速结论:该报错发生在 Open WebUI 最新 dev 版本中,点击 Open Terminal 的 “Copy Path” 按钮后浏览器控制台报错 `navigator.clipboard` 未定义,且剪贴板无内容。优先排查是否通过非 HTTPS(如局域网 HTTP)访问界面,因为 Clipboard API 仅在安全上下文(HTTPS 或 localhost)下可用。

适用环境:Open WebUI dev-slim 版本(2026-08-25T06:22:29.419435095Z)、Docker 安装方式、Pop!_OS 22.04、Chrome 浏览器最新版;Open Terminal 版本 0.12.1。

最快修复方案:暂无确认的一步修复方案。Issue 讨论中确认通过 localhost 访问可以正常复制,可优先尝试改用 localhost 或在 Open WebUI 前配置 TLS 反向代理。

注意事项:该方案只是绕过问题,并未修复 dev 版本底层代码逻辑;需要在非 localhost 环境使用剪贴板功能时,仍需等待官方合入 `document.execCommand(‘copy’)` 回退逻辑。

问题场景

用户在 Open WebUI 最新 dev 版本中打开 Open Terminal 0.12.1,点击任意文件或文件夹的 “Copy Path” 按钮时,界面无任何错误提示,但剪贴板中没有任何内容。浏览器 DevTools 控制台出现 JavaScript 报错。

报错原文

issue: Copy path in open-terminal fails on latest dev
navigator.clipboard is undefined in FileEntryRow.svelte

原因分析

可能原因:Open WebUI 的 “Copy Path” 功能调用了浏览器 Clipboard API(navigator.clipboard),但该 API 只在安全上下文(HTTPS 或 localhost)中可用。当用户通过局域网 HTTP 地址访问 Open WebUI 时,navigator.clipboardundefined,导致复制操作静默失败。Issue 评论中确认改用 localhost 访问后功能正常;同时指出代码块复制功能在 HTTP 下仍可用,说明其可能使用了不同的复制实现方式(如 document.execCommand('copy'))。

环境排查

  • 确认 Open WebUI 访问地址是否为 http://<局域网IP>:<端口> 而非 https://http://localhost
  • 检查浏览器控制台是否报错 navigator.clipboard is undefined
  • 确认是否使用 Open WebUI dev-slim 版本(2026-08-25T06:22:29.419435095Z)
  • 确认 Open Terminal 版本是否为 0.12.1

解决步骤

  1. 将浏览器访问地址从 http://<IP>:<端口> 改为 http://localhost:<端口>,再点击 “Copy Path” 验证是否恢复正常(Issue 评论中已验证此方法有效)。
  2. 如果必须在局域网内使用,可优先尝试在 Open WebUI 前配置 TLS 反向代理(如 Nginx、Caddy),使其通过 HTTPS 访问。
  3. 如需彻底修复 dev 版本的功能,可在官方 Issue 中跟踪进展,等待合入 document.execCommand('copy') 回退逻辑(讨论中提到的可能修复方案,尚未验证)。

验证方法

点击 “Copy Path” 后,在任意文本编辑器中粘贴(Ctrl+V),确认剪贴板中是否有文件路径内容;同时检查浏览器控制台是否不再出现 navigator.clipboard is undefined 报错。

参考来源

open-webui/open-webui #29015

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 20228

发表回复

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