Open WebUI 完整入门3 步搭建自托管 AI 对话平台【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个可以完全自托管、支持离线运行的 AI 对话平台解决的核心问题只有一个让你在自己的机器上接 Ollama 本地模型或 OpenAI 兼容 API聊天数据不出内网。它适合想给团队搭私有 AI 助手、又不想依赖 SaaS 的用户。部署完成后你得到的是一个浏览器界面顶部能切模型能上传文件做知识问答还能管理多用户权限。如果你之后想读源码仓库地址是 https://gitcode.com/GitHub_Trending/op/open-webui 。1️⃣ 三条命令跑起来以最常见的环境为例一台能装 Docker 的 Linux 或 Mac 电脑。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打开浏览器访问http://localhost:3000注册第一个账号。第一个账号自动成为管理员之后想接本地 Ollama就在管理后台填一下 Ollama 地址只有 OpenAI 兼容 API 也可以把 API 地址和密钥填进去就行。如果你习惯源码安装要求 Python 3.11pip install open-webuiopen-webui serve然后访问http://localhost:8080注意是 8080不是 3000。不同硬件和模型部署方式只差参数和镜像标签场景镜像标签额外参数访问地址纯 CPU:main无localhost:3000NVIDIA GPU:cuda--gpus alllocalhost:3000容器内置 OllamaCPU:ollama-v ollama:/root/.ollamalocalhost:3000容器内置 OllamaGPU:ollama--gpusall 上行数据卷localhost:3000pip 安装不适用需 Python 3.11localhost:8080内置 Ollama 的:ollama镜像最省事一个容器同时跑 Open WebUI 和 Ollama不用单独装模型服务。 核心功能走查多模型对话好处是同一个界面随意切换模型对比回答质量或者中途换个模型继续聊。界面上在顶部标题栏的模型下拉菜单里能看到所有已连接的 Ollama 模型和 API 模型。一句话用法点开下拉框选一个模型直接在输入框提问即可。知识库 RAG好处是让 AI 基于你自己的文档回答而不是泛泛而谈。界面上进入 Workspace工作区上传 PDF、Markdown、Word 等文件等待解析完成即入库。一句话用法聊天时在输入框打#加空格可以引用知识库里的内容或网页 URL 参与对话。管理后台与权限好处是多人使用时谁能用什么模型、谁能注册都由你控制。界面上点右上角头像进入 Admin管理后台里面分 Users、Settings、Functions 等页签。一句话用法在 Users 页手动创建团队成员在 Settings 页改 Ollama 连接地址、开关注册。笔记与频道好处是把聊天之外的内容也收进来Notes 是带富文本的笔记区AI 可以改写选中文本、把笔记挂到任意会话里作为上下文Channels 是共享频道把模型拉进来当成员团队和 AI 在同一个时间线协作。界面上都在左侧边栏。一句话用法新建一个 Channel把常用模型加进去它 让它参与讨论。⚠️ 踩坑指南1. 界面提示连不上 OllamaCould not connect to Ollama现象页面加载正常但模型列表是空的管理后台显示 Ollama 连接失败。原因Docker 容器里的127.0.0.1指向容器自己而不是你装 Ollama 的主机。怎么修run 命令加上--add-hosthost.docker.internal:host-gateway或者用--networkhost模式并在环境变量里把 OLLAMA_BASE_URL 指向http://127.0.0.1:11434。2. 容器删了重建账号和文件全没了现象重建容器后一切回到初始状态。原因run 命令漏了-v open-webui:/app/backend/dataSQLite 数据库和上传文件都存在容器内部。怎么修停掉容器补上这个挂载参数重新 run数据没备份的话找不回来所以首装就带上挂载。3. 提示 Bind for 0.0.0.0:3000 failed: port is already allocated现象docker run 直接报端口冲突。原因3000 端口已被别的服务占用。怎么修把-p 3000:8080改成-p 3001:8080然后访问http://localhost:3001。4.:cuda镜像启动报 GPU 相关错误现象容器起不来日志里有 nvidia、CUDA 相关报错。原因宿主机没装 NVIDIA Container Toolkit容器拿不到显卡。怎么修先给 Linux/WSL 装 NVIDIA 容器工具再运行带--gpus all的命令装不了就退回:main镜像让 Ollama 在宿主机跑。5. 换了--networkhost后访问 3000 打不开现象改用 host 网络模式后localhost:3000失效。原因host 模式下没有端口映射服务直接监听宿主机的 8080。怎么修访问http://localhost:8080这是预期行为不是故障。6. 同事无法注册界面没有注册入口现象部署完想邀请同事发现注册入口消失了。原因默认启用认证WEBUI_AUTH第一个注册账号成为管理员后注册通道自动关闭。怎么修在 Admin 的 Users 页手动给同事建账号或者启动时设环境变量ENABLE_SIGNUPtrue保持注册开放公网部署不建议。✅ 部署后自查清单逐项打勾全过就算跑通了浏览器能打开首页并完成第一个账号注册管理后台 Ollama 一栏显示已连接或 API 模型列表非空随便选一个模型能发出一条消息并收到回复run 命令带-v open-webui:/app/backend/data删容器不丢数据GPU 环境确认:cuda或:ollama镜像已用上显卡注册入口按预期关闭管理员账号已设好上传一份 PDF 到 Workspace用#引用它问出一个答案都勾上了下一步建议建一个自己的知识库把你最常用的文档喂进去让回答从通识变成懂你的业务。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考