
Open WebUI 部署与使用教程如何在家用电脑搭建免费的本地 AI 助手【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui你有一台 16G 内存的电脑也装好了 Ollama但每次想让它帮你分析一份合同都要先把文件粘贴进网页版聊天框既不方便也不安全。Open WebUI 就是为这个场景准备的一个可以完全离线运行的开源网页界面把本地模型变成带文件、知识库和工具功能的个人 AI 助手。它是什么适合谁Open WebUI 是一个自托管即装在你自己设备上、数据不出本机的 AI 对话平台用 Python 写后端、Svelte 写前端。模型本体由 Ollama 这类本地推理引擎负责它负责界面、会话管理和功能扩展。任何装过 Docker、希望 AI 对话不经过第三方服务器的人都能直接用。主界面示意模型下拉菜单、语音输入和侧边栏会话管理都集成在一屏里从零到第一次使用准备工作安装好 Docker预留约 8G 内存和 10G 以上磁盘留给模型文件。仓库里自带的 docker-compose 文件会同时拉起 Open WebUI 和 Ollama 两个容器数据存放在名为 open-webui 的卷里git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker-compose up -d如果 Ollama 已经装在本机也可以走 pip 路线pip install open-webui后执行open-webui serve需要 Python 3.11。访问验证等容器启动后打开 http://localhost:3000首次进入会要求注册一个账号这个账号自动成为管理员页面顶部出现模型下拉菜单就说明和 Ollama 的链路已经通了。Ollama 部署在别的机器时加上环境变量OLLAMA_BASE_URL指向它的地址即可。把核心能力用起来接入多种模型一个界面切换能做什么同一个窗口里用本地小模型也能挂上兼容 OpenAI 接口的云端服务比如 vLLM、Groq、Mistral。需要时直接切换对话记录互不影响。怎么用右上角下拉菜单选择模型管理员在后台配置页填入云端 API 的密钥和地址就能追加新来源。让 AI 读懂你的私人文档能做什么上传 PDF 后提问模型能引用文档内容作答全程数据留在本地。怎么用创建知识库 → 上传文件 → 在对话输入框敲#调用知识库系统会自动解析文档、切块并向量化支持 ChromaDB、PGVector、Qdrant 等 9 种向量库。相关实现在 backend/open_webui/retrieval/。把散落的文档汇成一片可检索的知识星云开箱即用的工具与记忆能做什么内置联网搜索、Python 代码执行、图像生成与编辑还有跨会话的长期记忆也能通过 MCP 协议接入你自己写的工具。怎么用聊天时直接点名要搜索或运行代码即可内置工具的实现集中在 backend/open_webui/tools/builtin.py。自定义与性能调优外观右上角齿轮图标里切换明暗模式也可加载社区主题文件布局与快捷键均可调整。性能最大的变量是模型体积——16G 内存跑 7B~8B 级别流畅13B 以上会明显变慢有 NVIDIA 显卡时改用:cuda标签的镜像生成速度提升明显。其他参数数据库、向量库、缓存等行为都通过环境变量控制清单见 backend/open_webui/config.py。避坑手册页面提示连不上 Ollama容器内默认访问不到宿主机的 127.0.0.1:11434。改用--networkhost启动访问地址随之变为 http://localhost:8080或把OLLAMA_BASE_URL指向可达的地址。升级后账号和会话消失多半是docker run时漏挂数据卷。务必带上-v open-webui:/app/backend/data用 compose 部署则已默认处理。回答半天才出字通常是本地模型选大了。换成 8B 左右的小模型或量化版本再调短上下文长度响应会立刻改善。写在最后Open WebUI 让本地数据不出门同时拥有云端助手级别的体验。今天就把它跑起来先上传一份自己的文档试试知识库。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考