10分钟装好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就能获得一个支持离线运行、RAG 知识库和多用户权限管理的完整对话界面10 分钟即可装通。 装之前先确认三件事先核对下面几点能省掉后面 90% 的排查时间Docker 已装并在运行docker --version输出版本号、docker ps不报错即可3000 端口空闲ss -lntp | grep :3000没有任何输出磁盘至少空出 5GBdf -h /var/lib/docker看可用空间是否够放镜像和数据 两条安装路线任选其一路线 ADocker 一条命令推荐。拉官方镜像、挂上数据卷、映射端口执行后终端会直接输出容器 ID启动容器并映射端口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怎么确认装好了docker ps里状态是Up浏览器打开 http://localhost:3000 能看到左上角的模型下拉框。路线 Bpip 安装没有 Docker 的机器。需要 Python 3.11执行后终端会持续滚动 Uvicorn 启动日志安装并启动服务pip install open-webui open-webui serve日志出现Uvicorn running on http://0.0.0.0:8080就算装好了访问 http://localhost:8080。⚙️ 首次启动与最小可用配置第一次打开页面只需注册一个新账号它会自动成为管理员。接着在 Ollama 所在机器上执行ollama pull llama3.2拉一个模型回来刷新页面模型就出现在下拉框里了。真正要留意的配置只有三项配置项作用示例值-p 3000:8080把容器 8080 映射到主机 3000供浏览器访问-p port:8080-v open-webui:/app/backend/data挂载数据卷聊天记录和配置重启不丢按上面启动命令保持即可OLLAMA_BASE_URL要对接的 Ollama 服务地址http://host.docker.internal:11434WEBUI_SECRET_KEY之类保持默认即可不用动。 可选能力按需取用基础链路通了剩下这些就是菜单你挑着吃。如果你想用 GPU 加速本地推理需先装 NVIDIA 容器工具包只需换用 CUDA 镜像换成 CUDA 镜像启动docker run -d -p 3000:8080 --gpus all \ -v open-webui:/app/backend/data \ --name open-webui ghcr.io/open-webui/open-webui:cuda跑起来后embedding 等本地推理走 GPU知识库建索引明显变快。如果 Ollama 部署在另一台机器上只需加一个环境变量指向它指定远程 Ollama 地址docker run -d -p 3000:8080 \ -e OLLAMA_BASE_URLhttp://your-host:11434 \ -v open-webui:/app/backend/data \ --name open-webui ghcr.io/open-webui/open-webui:main那台机器上的模型会直接出现在下拉框里别的什么都不用改。如果机器完全不能联网加一行就能关掉对外下载请求开启离线模式export HF_HUB_OFFLINE1 # 禁止联网下载此后所有能力都走本地已有模型启动不再卡在外网请求上。️ 踩坑速查与装完之后的路菜单吃到这儿接下来是最常被问到的几个坑现象页面能打开但模型列表空着日志报连接错误 →原因容器访问不到宿主机的 127.0.0.1 →修复docker run -d --networkhost -v open-webui:/app/backend/data \ -e OLLAMA_BASE_URLhttp://127.0.0.1:11434 \ --name open-webui ghcr.io/open-webui/open-webui:main现象启动时报 3000 端口被占用 →原因别的进程占着 →修复把映射改成-p 8080:8080再用 http://localhost:8080 访问现象容器重启后聊天记录全没了 →原因漏了数据卷挂载 →修复按路线 A 的命令重建容器执行上面那条启动命令即可能聊起来之后三个自然延伸方向用#命令把文档或网页拉进对话做知识库在管理后台接入 vLLM、Groq 等 OpenAI 兼容 API把团队拉进来建组、配权限。想再往下钻可以看 backend/open_webui/ 核心模块源码和 安全策略。打开那个页面发第一句话试试你的本地 AI 已经就位了。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考