Open WebUI 快速上手一条命令拉起本地 AI 聊天与知识库【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui照做完本文你的机器上会多出一个可登录、能接 Ollama / OpenAI 兼容 API、可挂私有文档问答的网页应用——访问http://localhost:3000就能开始对话且全部数据留在自己手里。Open WebUI 是一个自托管的 AI 交互平台它自己不跑模型而是为 Ollama、OpenAI 兼容 API 等推理服务提供一个带用户体系、权限和 RAG 知识库的前端。项目定位它给你什么先看清它能干的事再决定值不值得装多后端统一入口Ollama、LMStudio、vLLM、Groq、OpenRouter 等任何 OpenAI 兼容端点都能接进来本地与云端模型并列使用本地 RAG 知识库上传 PDF / Word / 文本本地向量化后供对话时通过#指令引用支持 9 种向量库默认 ChromaDB完整用户体系RBAC 角色、用户组、按组控制模型与文档访问企业场景可接 LDAP / SSO / SCIM可扩展插件Filters、Pipes、Tools、Skills以及 MCP / OpenAPI 工具服务器协作与增强功能Channels 团队频道、持久记忆、日历、Notes、语音输入输出装之前自问三个问题你手上有没有推理服务如果本机或内网已跑 Ollama / vLLM / LMStudio想给团队一个现成的网页入口——适合。你需要一次性演示还是常驻服务本文装出来的是常驻 Web 服务只试一次不如直接用云端聊天页面。数据能不能出内网要求私有化、离线运行的团队正合 Open WebUI 的卖点反之用公共产品更省事。跑通前自检环境与开销检查项要求备注运行方式Docker推荐或 Python 3.11pip 安装必须 3.11其他版本有兼容问题端口宿主机 3000 空闲可自行改-p 3000:8080前段磁盘数据卷存放数据库与上传文件首次启用 RAG 会本地下载约 90MB 的嵌入模型all-MiniLM-L6-v2网络完全离线可运行设HF_HUB_OFFLINE1禁止尝试联网拉模型同类方案差异ChatGPT-Next-Web 之类只是前端壳Open WebUI 自带用户体系、RBAC、RAG、插件与频道是完整平台最短可用路径一条命令装完Ollama 就跑在宿主机上时执行官方 README 推荐的命令镜像内 Ollama 在 8080 端口映射到宿主机 3000docker 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参数逐一说明参数作用漏掉后果-p 3000:8080宿主机 3000 端口转发到容器内 8080浏览器无法访问--add-hosthost.docker.internal:host-gateway让容器能用host.docker.internal找到宿主机上的 Ollama默认11434端口模型列表为空发消息报连接错误-v open-webui:/app/backend/data挂载数据卷存数据库与上传文件重建容器后聊天记录、知识库全部丢失--restart always进程崩溃后自动拉起需要手动docker startghcr.io/open-webui/open-webui:main官方稳定镜像:ollama为捆绑 Ollama 版:cuda为 NVIDIA 加速版换错标签可能装成不稳定的:dev分支怎么确认活起来了浏览器打开http://localhost:3000出现注册页——第一个注册的账号自动成为管理员之后注册入口关闭新成员由管理员在后台创建docker ps中容器状态为 Up执行curl http://localhost:3000/health返回{status: true}。备选安装方式pip 安装pip install open-webui后运行open-webui serve服务在http://localhost:8080需 Python 3.11捆绑 Ollama 单容器换用:ollama标签GPU 机器加--gpusall并追加-v ollama:/root/.ollama保存模型NVIDIA GPU镜像标签换:cuda宿主机需装 NVIDIA 容器运行时加--gpus allDocker Compose仓库自带 docker-compose.yaml内含 ollama 与 open-webui 两个服务端口默认 3000。第一次真实使用发出第一条消息对接 OllamaOllama 已在宿主机运行默认 11434 端口时上面的--add-host参数会自动完成发现打开页面后顶部模型下拉里直接出现已拉取的模型选中、在输入框发消息即可。Ollama 在另一台机器时原命令追加-e OLLAMA_BASE_URLhttp://192.168.1.100:11434把地址改成你的实际 IP 与端口。对接 OpenAI 兼容 APILMStudio、vLLM、OpenAI 本身都在支持范围内。只用 OpenAI API 的话部署命令加一个密钥变量即可docker run -d -p 3000:8080 -e OPENAI_API_KEYyour_api_key -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main也可是启动后由管理员在Settings Admin Panel External Connections中填端点与 Key保存后该服务的模型会与本地模型并列出现在列表中。验证对话链路给任意模型发一条用一句话介绍你自己回答以流式逐字返回且左侧出现会话记录即链路打通。此时数据卷里已有你的账号与这条会话——docker restart open-webui一次再刷新页面记录仍在说明持久化生效。高频进阶场景把私有文档喂给模型最常用的高价值用法是 RAG。操作路径左侧栏进入 Knowledge 页面拖入 PDF、Word 或纯文本文件系统用本地嵌入模型all-MiniLM-L6-v2向量化并写入默认 ChromaDB全程不出内网对话时在输入框敲#选择刚上传的文件模型的回答即基于该文档内容生成。效果对比问这份合同的退款流程是什么回答引用的是你上传的条款而不是模型训练语料里的泛泛而谈。团队使用时管理员可以在 Admin Panel 按用户组控制每个成员能看到哪些模型、哪些知识库。排错手册四类高频故障现象原因解决模型列表为空、发消息报连接错误容器访问不到 Ollama保留--add-host参数仍不行改用--networkhost此时地址变为http://localhost:8080远程 Ollama 则核对OLLAMA_BASE_URL重建容器后聊天历史消失未挂载数据卷命令必须带-v open-webui:/app/backend/data用已有卷重建长回复生成到一半断开默认 5 分钟超时不够用环境变量AIOHTTP_CLIENT_TIMEOUT单位秒调大新成员注册不了账号首账号即管理员注册入口自动关闭管理员在后台手动创建账号属设计行为而非故障详细排查思路见仓库内的 TROUBLESHOOTING.md其中解释了 Open WebUI 通过/ollama路由反向代理到OLLAMA_BASE_URL的架构——前端从不直连 Ollama所以 URL 配错时症状都是连接失败。上线前清单暴露到网络前查一遍✅curl http://localhost:3000/health返回{status: true}容器 Up✅ 首个账号已注册并确认为管理员身份注册入口已自动关闭✅ 数据卷已挂载重启容器后聊天记录与知识库仍在✅OLLAMA_BASE_URL或OPENAI_API_KEY已正确配置模型列表非空✅ 暴露到局域网/公网前已配置 HTTPS反代终结与防火墙白名单✅ 多实例部署时确认各实例WEBUI_SECRET_KEY一致延伸资源官方文档站功能与部署细节最全docs.openwebui.com后端核心代码backend/open_webui/路由层在 backend/open_webui/routers/排错指南TROUBLESHOOTING.md缺陷与讨论直接向仓库提 issue或加入官方 Discord 社区跑通之后剩下的事就是往里加模型和文档——用得越久这个界面越顺手。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考