Open WebUI
Open WebUI Desktop 0.0.20 是连接本地或兼容 API 模型的聊天工作区，可管理对话、模型、知识库和工具；桌面包与服务器部署的权限边界需要分开理解。
适合做什么
Open WebUI 适合把本地模型或兼容 API 包装成可访问的聊天工作区，并提供会话、知识库、模型切换和工具入口。它的桌面包和服务端部署是两条不同路径：个人测试可以先用桌面包，多用户使用则需要同时考虑容器、数据库、反向代理、账户和数据卷。
0.0.20 与部署边界
当前归档桌面包为 macOS Apple Silicon 版本 0.0.20。Windows、Linux 或服务器场景应按服务端部署方式核对容器与依赖版本。桌面界面版本、Open WebUI 服务版本、Ollama 版本和模型版本不一定同步，升级时应逐层验证兼容性。
知识库、工具与权限
聊天、嵌入、向量库、附件、模型和工具可能分别读写数据或访问网络。使用云端模型时，提示词和文档片段可能交给对应服务商；启用函数、工具或自定义模型前先限制文件范围、网络范围和账户权限，并保留可恢复备份。
维护记录
本页于 2026-08-23 根据 Open WebUI Desktop 0.0.20 macOS ARM64 归档包、服务端部署路径、本地模型连接、知识库和多用户权限边界复核。
保存到自己的网盘
打开网盘后可直接获取，也可以先保存到自己的网盘，方便换设备继续使用。
夸克网盘（无需提取码）
推荐将「Open WebUI」保存到该网盘
百度网盘
将「Open WebUI」保存到该网盘
Open WebUI Desktop 0.0.20 与本地模型连接教程
先在非敏感测试环境中完成桌面启动、模型连接和一轮对话，再考虑 Docker、多用户、知识库和外部工具配置。
安装前准备
- 当前桌面归档包为 macOS Apple Silicon DMG；其他系统优先确定服务端部署方案和反向代理方式。
- 准备本地 Ollama 或兼容 API，记录地址、模型名和访问范围；在线服务使用限额测试密钥。
- 准备不含隐私的测试文件，明确聊天、嵌入、向量库、附件和日志的存储位置。
安装步骤
- 01
安装桌面归档包
macOS Apple Silicon 打开 DMG 后完成安装，首次启动确认应用版本 0.0.20 与系统权限；若使用服务器模式，先固定容器版本和数据卷。
- 02
连接模型服务
在管理员或首次配置界面中添加本地 Ollama 或兼容 API，先使用一个模型完成最小对话；保存前核对地址和认证字段。
- 03
建立最小权限账户
多用户部署时先设置管理员、普通用户和邀请策略，关闭不需要的注册、外部工具和共享功能，确认数据隔离后再开放使用。
快速上手
- 01
验证对话与模型切换
用固定测试问题检查响应、上下文、模型名称和错误提示；分别确认本地模型与云端模型的网络行为。
- 02
导入一份测试文档
只导入公开或虚构文件，检查解析、嵌入、引用和删除；文件能在知识库中检索不代表答案自动准确。
- 03
备份数据卷与配置
记录容器、数据库、模型服务和存储卷关系，导出应用配置并测试恢复；升级前先复制数据卷，避免直接覆盖唯一实例。
使用建议
- Open WebUI 是工作区界面，模型推理、嵌入、向量库和工具可能由不同服务提供，数据路径应按组件分别核对。
- 反向代理、注册入口和管理员账户是部署边界的一部分，不能只依赖前端页面隐藏按钮。
- 自定义模型、工具和函数可能执行外部请求或读取文件，接入前建立来源清单与最小权限策略。
故障排查与卸载方法
页面能打开但模型没有响应怎么办？
先确认模型服务本机可用，再检查 Open WebUI 中的地址、模型名、容器网络和代理；用最小请求区分服务端故障与界面配置问题。
知识库检索结果不准确怎么办？
用短文档验证解析和分块，检查嵌入模型、向量库和引用片段；调整设置前保留原始文件与索引备份，不把生成答案当作原文替代。
- 备份账户与数据导出需要保留的会话、知识库清单、模型配置和管理员设置，撤销外部 API 密钥及工具令牌。
- 停止服务并处理数据卷桌面端退出后卸载；服务器模式先停止容器，再按备份策略处理数据库、上传文件、缓存和模型目录，避免误删共享数据。
常见问题
Open WebUI Desktop 与 Docker 服务端是同一个安装方式吗？
不是。当前归档桌面包面向 macOS Apple Silicon；Windows、Linux 或多人使用通常采用服务端部署方式。部署前要分别核对客户端、容器、数据库和模型服务的版本。
Open WebUI 可以连接 Ollama 吗？
可以，在同一设备或网络中配置 Ollama 服务地址即可；连接前先确认监听范围、代理和防火墙，不要把未保护的模型 API 直接暴露到公网。
知识库上传的文件会发送到云端吗？
取决于模型、嵌入、向量库和工具配置。使用云端提供商时，提示词或文档片段可能离开本机；重要资料先用测试文件验证数据路径。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。