Open WebUI 安装配置完全攻略：一条命令跑起本地大模型界面

Open WebUI 安装配置完全攻略：一条命令跑起本地大模型界面

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui

本地模型能跑了，可对着终端敲命令对话实在不是人干的活——想要一个像样的聊天界面吗？Open WebUI 就是一个自托管 AI 平台：接上 Ollama 或任意 OpenAI 兼容接口，本地大模型立刻有脸可看，全程可离线运行。

它内置知识库检索、插件扩展、多用户权限管理，甚至还有语音通话。但对只想快速跑起来的你，记住三件事就够：一条命令装好、把模型接上、避开几个高频坑。

🚀 一键部署：Docker 最简启动命令

结论先说：装 Docker 就行，别碰 Python 环境。

下面这条命令做三件事：拉官方镜像并后台启动、把容器 8080 端口映射到本机 3000 端口、挂一个数据卷保存对话记录（这条-v不能省）：

docker run -d -p 3000:8080 --add-host=host.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 ，注册第一个账号（自动成为管理员），就算完成了。

更习惯 Python 的话，pip install open-webui后运行open-webui serve（要求 Python 3.11），访问 http://localhost:8080，其余流程一致。

🔌 接模型：Ollama 与 OpenAI 接口怎么连

Open WebUI 自己不跑模型，它负责"连"模型。按模型所在位置分三种情况。

模型跑在本机

最简命令里的--add-host=host.docker.internal:host-gateway就是在告诉容器：宿主机的 Ollama 默认监听 127.0.0.1:11434。装好 Ollama、拉一个模型，界面模型列表里直接能选。

模型在远程服务器

加一个OLLAMA_BASE_URL环境变量指向远程地址即可，其余参数照抄最简命令：

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://your-ollama-server.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

用 GPU 加速或只接 OpenAI 接口

有 NVIDIA 显卡：把镜像标签:main换成:cuda并加上--gpus all（前提是先装好 NVIDIA 容器工具包）。只接云端 API：加-e OPENAI_API_KEY=你的密钥，LMStudio、vLLM 这类 OpenAI 兼容服务同理，把 BASE_URL 指过去就行。

⚙️ 进阶开关：数据卷、离线与自定义端口

数据卷：-v open-webui:/app/backend/data是账号、对话、设置的唯一落盘处，项目官方文档把它列为必选项。重建容器前记得备份这个卷。

离线环境：没外网的机器加-e HF_HUB_OFFLINE=1，系统就不会再去尝试从 Hugging Face 下载模型。

改端口：-p 3000:8080冒号左边是外部端口，改成任意空闲端口即可，右边的 8080 是容器内部端口，别动。

🐛 踩坑速查：端口被占与连接失败

现象：3000 端口被占，起不来。原因：本机已有服务占着 3000。 解法：-p 3000:8080换成-p 8080:8080，浏览器访问地址同步改。

现象：界面里看不到本机 Ollama 的模型。原因：容器默认访问不到宿主机的 127.0.0.1:11434。 解法：改用 host 网络模式重跑，此时不再需要--add-host，访问地址变成 http://localhost:8080：

docker run -d --network=host -e OLLAMA_BASE_URL=http://127.0.0.1:11434 -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

现象：容器一重建，账号和对话全没了。原因：启动时漏挂了数据卷。 解法：确认命令里有-v open-webui:/app/backend/data，之后定期备份该卷。

现在就把第一条命令跑起来，几分钟后你会有一个完全跑在本地机器上、能接任意模型的聊天界面。想往下深挖，看这两处就够：后端源码在 backend/open_webui/，安全策略见 docs/SECURITY.md。

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui