Open WebUI 本地部署一条命令拉起 Ollama 聊天界面 【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个开源的 AI 聊天界面把 Ollama 本地模型和 OpenAI 兼容 API 收进同一个 Web 端。读完本文你可以完成 Open WebUI 本地部署一条命令拉起容器配好 Ollama 后端跑通第一条模型对话。运行环境看这一行就够方式要求Docker推荐Docker Desktop 或带 Compose 的 Docker Engine内存 ≥ 2 GB手动部署Python 3.11 Node.js依赖需自行安装团队里常见的局面是Ollama 在跑着llama3.2OpenAI API 也买了额度两个服务的入口、参数格式全不一样每次切换模型都要重新看文档。Open WebUI 的做法是把模型统一挂到一个 Web 界面后面对话、检索、笔记共用一套 UI模型只是可替换的选项。一条命令完成 Open WebUI 本地部署下面这条命令克隆仓库并用 Compose 同时启动 Ollama 与 Open WebUI 两个容器仓库里现成的docker-compose.yaml已经配好了两者的网络与数据卷。执行后首次会拉取镜像耐心等一两分钟。git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker compose up -d看到终端回显open-webui Started这类字样说明 Web 服务已经就绪。不想用 Docker 的话也可以装好 Python 3.11 依赖后直接运行backend/open_webui/main.py手动跑但排查问题会麻烦不少。启动后先做这 4 件事浏览器打开http://localhost:3000注册第一个账号——它是管理员后面的模型与知识库设置权限都归它。回到终端执行下面这条命令确认没有红色报错并留意Uvicorn running on http://0.0.0.0:8080这行启动信息。docker logs open-webui拉一个模型给 Ollama。这条命令会从模型库下载llama3.2到 Ollama 容器完成后终端打印success。docker exec -it ollama ollama pull llama3.2回到页面点顶部模型下拉框选llama3.2输入一句话。看到逐字生成的回复整套本地部署就算通了。Open WebUI 聊天界面左侧是工作区与频道入口主区域按当前模型对话进阶方向知识库Knowledge Base— 上传 PDF、网页后模型回答会自动带上文档里的内容。操作提示管理后台打开 Knowledge 页面添加文件并关联向量模型即可。多渠道接入— 频道Channels支持把同一界面接到 Telegram、Discord让团队在 IM 里直接问模型。操作提示Settings 里配置对应平台凭据再绑定到指定模型。工具与 MCP—backend/tools/与backend/routers/里挂了工具、MCP 服务器等扩展模型不只是聊天还能调真实接口。操作提示从 Tools 页面注册一个 MCP 端点试起。踩坑排查现象页面报 Server Connection Error消息发不出去→ 先确认容器能否访问到 Ollama。检查项OLLAMA_BASE_URL是否指向正确地址宿主机上的 Ollama 写http://host.docker.internal:11434同 Compose 网络则写http://ollama:11434→ 修复改环境变量后重启容器例如docker compose down OLLAMA_BASE_URLhttp://ollama:11434 docker compose up -d现象长回答到一半超时中断→ 后端对 Ollama 的默认等待上限是 5 分钟。检查项是否开了大模型或长输出 → 修复用环境变量AIOHTTP_CLIENT_TIMEOUT单位秒调大超时再重启。现象拉新模型后报版本不兼容→ 检查项docker exec -it ollama ollama --version输出的 Ollama 版本 → 修复升级到最新 Ollama 镜像后重新拉模型。其他问题先翻仓库根目录的TROUBLESHOOTING.md里面把容器与 Ollama 之间的代理链路讲得很细想接更多后端从backend/routers/openai.py这类文件入手。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考