New Hot

Open WebUI 0.13.4 调整 Tether 沙箱与本地 MCP 连接,常见异常怎么排查绕行

Open WebUITetherMCP沙箱

Open WebUI 0.13.4 用 Tether 取代 Direct Connections,并调整沙箱终端、本地 MCP 工具与编码代理的接入方式。版本不匹配、工具服务器开关未开、模型 ID 冲突或沙箱无法强制执行时,功能会表现为连接失败或入口消失,本文整理排查顺序。

0.13.4 用 Tether 取代直连,终端与 MCP 需对齐版本

Open WebUI 0.13.4 不是纯修复版本,但沙箱终端、MCP 工具与编码代理的行为调整会表现为连接或启动异常。 官方把这一版的重心放在 Tether 上。

沙箱无法启用时终端停止

Tether 0.1.13 起可以把终端锁进沙箱,只允许访问你选定的一个文件夹;无法强制执行沙箱时,终端会保持停止而不是静默运行。开启期间浏览器与桌面控制也会关闭,这容易被误认为功能失效。(来源:Open WebUI 官方发布说明)

本地 MCP 与端口

Open WebUI 可以通过 Tether 0.1.16 直接启动以 stdio 运行的本地 MCP 服务器,不需要 mcpo 代理,也不用开放端口。本地命令以你自己的账号权限运行,位于 Tether 工作区沙箱之外。

模型与工具列表不可见

Tether 需要 0.1.14 以上,MCP 服务器、工具服务器与终端需要 0.1.16;工具服务器还要打开 ENABLE TOOL SERVERS。与 Open WebUI 已有模型 ID 相同的 Tether 模型会保持隐藏,从官方描述看,这也是模型选择器里看不到条目的常见原因。

Direct Connections 退场,编码代理与终端共享改版

用本地模型、自建 MCP 或编码代理的用户需要重新检查版本与开关,普通聊天感知较小。 直接连接被 Tether 取代。

Direct Connections 退场

Tether 取代 Direct Connections。原来通过直接连接接入的 Ollama、LM Studio 或 OpenAI 兼容服务,需要迁移到 Tether 才能在模型选择器里出现。

编码代理与推理档位

Hermes、Antigravity、GitHub Copilot、Goose 与 Qwen Code 加入代理列表;选择模型不支持的推理档位时,代理会直接报错停止。把档位调回模型支持的范围即可恢复。

终端与共享

Terminals 0.4.0 起可以按用户、会话或模型分配沙箱计算机;启动与停止需要 0.4.1,起始目录与安装脚本需要镜像内的 Open Terminal 0.17.7 以上。页面、笔记、频道与自动化也可以以标签页形式打开,新聊天会保留已打开的标签。

依赖本地 MCP 的用户需把 Tether 升到 0.1.16

依赖本地 MCP、沙箱终端或编码代理的用户建议升级,但要把 Tether 版本一起对齐。 只用云端模型聊天的可以按计划跟进。

谁适合先升级

使用 Tether、接入本地 MCP 工具或在 Open WebUI 里跑编码代理的用户优先;仍在使用 Direct Connections 的团队需要安排迁移。

升级方式

升级 Open WebUI 到 v0.13.4 的同时,把 Tether 升到 0.1.16 以上、Terminals 升到 0.4.1 以上,并按需启用工具服务器。具体安装命令官方未披露。

出问题怎么排查

工具不显示时先核对 Tether 版本、ENABLE TOOL SERVERS 与模型 ID 冲突;终端不启动时检查沙箱能否强制执行;代理报错时降低推理档位。同类客户端异常也可以参考 Claude Code 2.1.327 修复 /export 覆盖文件与 MCP 配置被清空的异常问题。

常见问题

Open WebUI 0.13.4 为什么模型选择器里看不到 Tether 模型?
Tether 版本需要 0.1.14 以上,且与已有模型 ID 相同的 Tether 模型会保持隐藏。
Open WebUI 0.13.4 的本地 MCP 工具需要什么条件?
需要 Tether 0.1.16 以上,并打开 ENABLE TOOL SERVERS,工具服务器与终端才能显示。
Open WebUI 0.13.4 的沙箱终端为什么不启动?
沙箱无法强制执行时,终端会保持停止而不是静默运行,这是本版的设计。
Open WebUI 0.13.4 还能用 Direct Connections 吗?
Tether 取代了 Direct Connections,原来的直连需要迁移到 Tether。

相关术语

Tether
Tether 是 Open WebUI 的本地计算接入组件,把本机模型、工具与终端安全地暴露给网页端。
MCP
MCP 是模型上下文协议,用统一方式向模型提供工具与数据源。
沙箱终端
沙箱终端是限制在单一目录内运行的终端,模型与编码代理只能访问指定文件夹。
Direct Connections
Direct Connections 是 Open WebUI 旧版的直连方式,本版由 Tether 取代。

这篇文章的来源是什么?

文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。

  • v0.13.4 · Open WebUI · 2026-11-18
「v0.13.4」 —— Open WebUI

搜索文章

输入关键词,快速查找标题和正文内容。