10 分钟跑通私有本地 AI 聊天Open WebUI 从零部署到第一句对话【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个开源的自托管 AI 聊天平台它不跑模型本身而是用一条 docker 命令部署把本地 Ollama 或任意 OpenAI 兼容 API 变成完整的 Web 聊天界面内置模型管理、RAG 知识库检索和用户权限全程可离线。动手前核对 3 件事少走弯路机器装好 Docker 的一台机器即可想脱离 Docker 裸跑则需要 Python 3.11模型服务需要一个已跑起来的推理服务Ollama 默认 11434 端口或一个 OpenAI 兼容端点加 API Key都没有就先装 Ollama网络首次启用 RAG 知识库会本地下载约 90MB 的嵌入模型那一刻需要外网之后可完全离线⚠️ 只做一次性演示、不想维护常驻服务的话直接用云端服务更省事。Open WebUI 的定位是长期部署和团队共用。一条 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保留--add-host容器才能通过host.docker.internal自动发现宿主机的 Ollama这是 README 明确要求的-v open-webui:/app/backend/data存数据库和上传文件漏掉它重建容器后聊天历史全丢--restart always让进程崩溃后自动拉起做完你应该看到三个信号docker ps里容器状态为 Up浏览器打开http://localhost:3000出现注册页第一个注册的账号直接成为管理员curl http://localhost:3000/health返回{status:true}对应实现在 backend/open_webui/main.py。不想用 Docker 的话执行pip install open-webui后运行open-webui serve服务在 8080 端口。启动后的欢迎画面在此注册首个账号接入本地 Ollama 模型跑通第一轮对话Ollama 与容器同机运行时无需任何额外配置界面顶部模型列表会自动出现模型名。选中一个在底部输入框发一句话回答以流式逐字返回对话历史就落在你挂载的数据卷里。模型选择与流式回答界面Ollama 在另一台机器时给原命令追加一个环境变量指向它-e OLLAMA_BASE_URLhttp://192.168.1.100:11434做完你应该看到界面模型列表从空变成远程的模型名。NVIDIA GPU 用户可把镜像标签换成:cuda想 Ollama 与界面同容器部署则改用官方:ollama标签并加--gpusall。让模型照着你的文档回答这是 Open WebUI 最有价值的闭环。在 Knowledge 页面拖入一份 PDF 或 Word 合同系统用默认嵌入模型all-MiniLM-L6-v2在本地完成向量化并写入 ChromaDB不出内网。对话时在输入框敲#选中该文件模型就基于这份文档作答。做完你应该看到的效果问退款流程是什么引用的是你上传的条款而不是训练语料里编的内容。团队场景下管理员还能按用户组控制每人可见的模型和文档范围。排错 30 秒定位交付前过一遍检查现象可能原因解法模型列表为空、发消息报连接错误容器访问不到 Ollama保留--add-host参数或改用--networkhost远程则核对OLLAMA_BASE_URL重建容器后聊天历史消失未挂载数据卷命令里补上-v open-webui:/app/backend/data长回复生成到一半中断默认 5 分钟超时不够设置AIOHTTP_CLIENT_TIMEOUT秒调大团队成员无法注册首个账号成为管理员后注册入口自动关闭管理员在后台手动创建账号更多连接类问题先查仓库里的 TROUBLESHOOTING.md。交付前逐项确认✅ 容器 Up/health返回{status:true}✅ 数据卷已挂载重启容器后历史仍在✅ 首账号已注册且确认管理员身份✅OLLAMA_BASE_URL或 API Key 配置正确下一步是把服务铺给更多人仓库自带 docker-compose.yaml 可编排 Ollama 容器随部署启动多实例与 GPU 集群则按官方文档的 Helm、Kustomize 方式扩展。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考