在本地用 Docker 部署 Open WebUI私有 AI 聊天平台搭建指南【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOllama 已经在本机跑起来了Open WebUI 部署 只需一条 Docker 命令十来分钟就能得到带知识库的 Web 界面。它是自托管 AI 聊天前端本身不跑模型为 Ollama、OpenAI 兼容 API 等推理服务提供界面内置 RAG 与用户权限体系可完全离线运行适合开发者与运维新手自建私有化 AI 聊天平台。判断与定位先说清边界Open WebUI 不执行任何模型推理它是一层界面加管理台把 Ollama、LM Studio、vLLM 或 OpenAI 兼容 API 的能力包装成带账号体系的 Web 应用。类比餐厅它不是后厨后厨才是推理服务而是前台加收银台点单、记录、谁有权限用哪个模型和哪份文档都在这一层完成。它适合本机或内网已跑 Ollama、LM Studio、vLLM 等推理服务想快速给团队一个可用界面希望模型、知识库、账号在一个平台里统一管理可完全离线不适合只想做一次一次性演示——直接用云端服务比维护常驻服务省事与 ChatGPT-Next-Web 这类轻量前端壳相比它多出一整套用户体系、RBAC 组权限、RAG 知识库以及 Filters / Tools / Skills 插件机制和协作频道是完整平台而非单纯壳。启动与验证前提是一台装好 Docker 的机器官方单容器命令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逐条解释-p 3000:8080把容器 8080 端口映射到宿主机 3000。前段端口可随意改漏掉映射浏览器根本访问不到页面。--add-hosthost.docker.internal:host-gateway让容器内的host.docker.internal指向宿主机从而发现宿主机 11434 端口上的 Ollama。漏掉它模型列表是空的——这是连接报错的头号原因。-v open-webui:/app/backend/data数据卷存放数据库和上传文件。漏掉它重建容器后聊天历史全部丢失。--restart always进程崩溃自动拉起半夜挂掉不用人工干预。验证部署是否成功对照三条浏览器访问http://localhost:3000出现注册页第一个注册的账号自动成为管理员docker ps中容器状态为 Upcurl http://localhost:3000/health返回{status:true}不想用 Docker 也有替代方式pip install open-webui后执行open-webui serve服务跑在 localhost:8080。模型接入三条路径① 本机 Ollama零配置。启动后自动发现生效依赖上面的--add-host参数顶部模型列表直接出现模型名选中即可对话回答以流式逐字返回。② 远程 Ollama服务在另一台机器时给原命令追加一行-e OLLAMA_BASE_URLhttp://192.168.1.100:11434③ 云端 API只接 OpenAI 时追加密钥即可-e OPENAI_API_KEYyour_api_keyLM Studio、vLLM 等任意 OpenAI 兼容端点同样适用。以上配置都不必在启动时做——事后由管理员在管理后台「外部连接」填端点与 Key保存后对应模型即出现在列表中与本地模型并列使用。想把 Ollama 和 Open WebUI 装进同一个容器改用:ollama标签GPU 加--gpusall并挂载模型卷docker run -d -p 3000:8080 --gpusall \ -v ollama:/root/.ollama -v open-webui:/app/backend/data \ --name open-webui --restart always \ ghcr.io/open-webui/open-webui:ollama其中--gpusall把宿主机 GPU 透传给容器-v ollama:/root/.ollama保证 Ollama 下载的模型在重建后仍在。NVIDIA 用户还可以直接换:cuda标签前提是宿主机已装 NVIDIA 容器运行时。把文档变成模型的知识操作很直白在 Knowledge 页面拖入 PDF、Word 或纯文本文件系统用默认嵌入模型 all-MiniLM-L6-v2 在本地完成向量化存入本地 ChromaDB首次运行会下载约 90MB 的嵌入模型全程数据不出内网。使用时在输入框敲#选择已上传的文件该文档就成为这轮回答的依据。团队场景下管理员可按用户组控制每个人能访问哪些模型和文档敏感资料不必对全员开放。效果可以直接感受问「这份合同的退款流程是什么」模型引用的是你上传的条款而不是凭训练语料编造。排障与上线检查先过四条最常见的故障按「现象 → 修复」排查模型列表为空、发消息报连接错误容器访问不到 Ollama。保留--add-host参数仍不通可改--networkhost注意访问端口随之变为 8080远程服务则核对OLLAMA_BASE_URL地址是否正确重建容器后聊天历史消失数据卷没挂。命令里必须带-v open-webui:/app/backend/data长回复生成到一半中断默认请求超时 300 秒慢推理场景把环境变量AIOHTTP_CLIENT_TIMEOUT单位秒调大团队成员无法注册首个注册账号即管理员注册入口随之自动关闭后续账号由管理员在后台手动创建✅ 上线前检查清单容器 Up/health返回{status:true}首个账号已确认管理员身份注册入口已关闭数据卷已挂载重启容器后聊天历史仍在OLLAMA_BASE_URL或OPENAI_API_KEY已正确配置暴露到局域网/公网前已配置 HTTPS 与防火墙想继续扩展时仓库自带 docker-compose.yaml已配置好 Ollama 容器与两者互联连接类问题先翻 TROUBLESHOOTING.md后端核心代码在 backend/open_webui/。跑通之后剩下的事就是往里加模型和文档。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考