Open WebUI 完整指南：5 步跑通自托管离线 AI 助手

Open WebUI 完整指南5 步跑通自托管离线 AI 助手【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui家里那台机器上跑着 Ollama模型能离线推理但你只能对着命令行提问文档扔不进去想分给家人用又不知道从哪下手——这就是你卡住的地方。Open WebUI 是一个自托管的 AI 对话界面设计上就为了完全离线运行Ollama、OpenAI 兼容 API 都能接一条 Docker 命令装好之后你的对话记录、上传的文档、全部设置都存在自己硬盘上不经过任何云端。这篇文章带你 10 分钟部署完 Open WebUI讲透你日常用得最多的三个功能再给 4 条踩坑速查。10 分钟部署两条命令就够 前置要求只有三个装好 Docker、至少 4GB 内存、一个可用的模型来源本机 Ollama 或任一 OpenAI 兼容 API。然后一条命令拉起容器docker run -d -p 3000:8080 \ --add-hosthost.docker.internal:host-gateway \ -v open-webui:/app/backend/data --name open-webui \ --restart always ghcr.io/open-webui/open-webui:main这里-v open-webui:/app/backend/data千万别省它把数据库挂到命名卷里容器删了重建数据也不丢。模型不在本机或不用 Ollama 的话加一个-e OLLAMA_BASE_URL你的模型服务地址即可。等容器起来浏览器打开http://localhost:3000注册第一个账号——它就是管理员账号。部署后最常碰的三个功能模型下拉框一换本地和云端随便混左边栏顶部就是模型选择框本机 Ollama 的模型、任何 OpenAI 兼容接口LM Studio、vLLM、Groq 都行都挂在同一份列表里切换不用改任何配置。它还支持多模型对话一次把两三个模型拉进同一屏答案并排对比选谁留谁一目了然。把资料喂给知识库AI 答题开始有出处 在知识库页面上传 PDF、文档Open WebUI 会自动分块、向量化之后提问时 AI 会引用库里的内容作答走的是向量 BM25 混合检索背后支持 9 种向量数据库。对话里输入#还能直接把某个网页拽进上下文。这部分实现可以看 知识库检索源码。调校到合身离线、超时与工具扩展⚙️ 三个最常改的地方纯离线设置环境变量HF_HUB_OFFLINE1它会停止尝试从网上拉模型内网环境必开。响应超时Ollama 生成默认 5 分钟超时慢机或大上下文可以调AIOHTTP_CLIENT_TIMEOUT秒放宽更多运行参数集中在 后端启动配置。工具扩展这是第三个高频功能——内置代码解释器可以直接在聊天里跑 Python再加网页搜索、自定义 Tools/Skills 或接 MCP 工具服务器AI 就从会说话变成会干活。内置工具的实现入口在 工具插件目录。踩坑速查4 个高频问题现象打开页面报 Server Connection Error。解法容器够不到宿主机的 Ollama127.0.0.1:11434给 docker run 加--networkhost端口变 8080或把OLLAMA_BASE_URL指向局域网 IP。现象重建容器后账号、对话全没了。解法启动时漏了数据卷挂载参数按上面那条命令补上-v open-webui:/app/backend/data。现象长回答或慢模型突然断开、超时。解法默认 5 分钟生成超时不够用调大AIOHTTP_CLIENT_TIMEOUT环境变量。现象界面里 Ollama 报错、行为怪异。解法先把 Ollama 升到最新版再核对 设置 → 常规 里的 Ollama Server URL 是否填对。最后一步现在就把它跑起来打开终端把那条 docker run 命令贴进去执行等半分钟访问http://localhost:3000注册账号你的离线 AI 助手就有了第一间办公室。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考