issue: Auto-Copy Response switch is not saved over plain HTTP on a LAN address

这个报错通常出现在通过局域网 IP 以明文 HTTP 打开 Open WebUI 时,开启 Settings > Interface 里的 Auto-Copy Response to Clipboard 开关后设置不落盘、刷新后自动关闭。优先排查当前页面是否处于浏览器认可的安全上下文(HTTPS 或

快速结论:这个报错通常出现在通过局域网 IP 以明文 HTTP 打开 Open WebUI 时,开启 Settings > Interface 里的 Auto-Copy Response to Clipboard 开关后设置不落盘、刷新后自动关闭。优先排查当前页面是否处于浏览器认可的安全上下文(HTTPS 或 localhost),以及前端是否有 clipboard 不可用时的回退处理。

适用环境:Open WebUI 0.13.1(Issue 中称当前 dev 版本同样存在);浏览器通过明文 HTTP、以局域网 IP(如 192.168.1.20:8080)访问,而非 HTTPS 或 localhost。Issue 未提供操作系统、Python、CUDA、显卡等信息,此处不做补写。

最快修复方案:暂无确认的一步修复方案。Issue 未给出已验证的修复动作;按浏览器对 clipboard 的限制,可优先尝试改用 HTTPS 或 localhost 访问后再保存该开关,作为规避方式(属推测性建议,非 Issue 验证结论)。

注意事项:该问题本质是浏览器只在 HTTPS 或 localhost 下提供现代 clipboard 访问权限,普通局域网 HTTP 地址不满足条件;开关失败时无任何提示,容易让用户误以为已保存。改用 HTTPS 只是规避,Issue 未确认已修复前端缺少回退与提示的问题。

问题场景

用户在局域网另一台电脑或手机上,通过类似 http://192.168.1.20:8080 的明文 HTTP 地址访问 Open WebUI 0.13.1,登录后进入 Settings > Interface,点击开启 Auto-Copy Response to Clipboard 开关。开关当下显示为开启,但设置从未保存,也没有任何提示;刷新页面或换设备后开关恢复关闭状态,回复内容不会被复制。在 HTTPS 或 localhost 下同样的点击可以正常保存。

报错原文

Cannot read properties of undefined (reading 'readText')

原因分析

最可能的原因是:浏览器只在 HTTPS 或 localhost 这类安全上下文中提供现代 clipboard 访问能力,明文 HTTP 的局域网地址下相关 API 不可用。开关在处理点击时直接检查 clipboard 访问(调用 readText),未对此类地址做回退处理,导致抛出异常,设置保存流程随之中断,界面也没有给出错误提示。Issue 将其描述为更广泛的不安全上下文 clipboard 问题,同类现象也出现在 Copy Formatted Text 等相邻界面设置上。

环境排查

  • 确认 Open WebUI 版本是否为 0.13.1 或对应 dev 版本。
  • 确认访问地址:是 http:// 加局域网 IP,还是 https:// 或 localhost。
  • 确认问题是否只在其他设备(手机、另一台电脑)上出现,本机 localhost 是否正常。
  • 打开浏览器开发者工具控制台,确认是否出现 readText 相关报错。
  • 确认刷新页面后开关是否回到关闭状态、设置是否确实未保存。
  • Issue 未提供操作系统、Python、CUDA、PyTorch、显卡或节点依赖版本,这些项目无法作为排查依据。

解决步骤

  1. 先用 localhost 或 HTTPS 地址访问同一 Open WebUI 实例,重复开启 Auto-Copy Response to Clipboard 并刷新验证。若此时设置能正常保存,可确认问题与明文 HTTP 局域网访问有关。
  2. 在出问题的明文 HTTP 页面上打开浏览器控制台,记录是否出现 Cannot read properties of undefined (reading 'readText'),作为问题定位证据。
  3. 若必须使用局域网 IP 访问,可优先尝试为 Open WebUI 配置 HTTPS(例如通过反向代理),再重新开启该开关并刷新验证。该方式为基于浏览器限制的规避思路,Issue 未将其列为已验证修复。
  4. 若无法改用 HTTPS,暂不要在局域网 HTTP 环境下依赖该自动复制功能,并注意开关显示开启并不代表设置已保存。
  5. 关注该 Issue 的关闭状态与后续修复,Issue 正文提到相关端到端测试已改为在明文 HTTP 下运行所有浏览器测试,可作为后续回归验证的参考。

验证方法

在目标访问地址下重新开启开关,刷新页面后再次进入 Settings > Interface,确认开关仍为开启;发送一条消息,确认完成的回复被复制到剪贴板;同时检查浏览器控制台不再出现 readText 相关报错。若在 HTTPS 或 localhost 下验证通过、明文 HTTP 下仍失败,则说明仅完成了规避,原问题尚未在该环境下解决。

参考来源

open-webui/open-webui #33935

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 33495

发表回复

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