Open WebUI 安装教程：5 分钟装好本地 AI 聊天界面

Open WebUI 安装教程5 分钟装好本地 AI 聊天界面【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui这篇 Open WebUI 安装与部署教程带你用 Docker 或 pip 两种方式把一套自托管的大模型聊天平台跑进浏览器装完打开 localhost 就能直接和模型对话完全支持离线。先搞清它适合谁你手头已经有 Ollama 或 OpenAI 兼容的模型服务但嫌命令行和 API 调用太原始想要一个开箱即用的聊天界面还带文件管理、工作区和权限控制——Open WebUI 就是干这个的。它把模型跑在你自己的机器上数据不出本机个人本地部署、企业内网部署这类在意隐私的场景都能直接落地。安装方式怎么选方式适合人群一句话说明Docker 部署绝大多数新手一条命令拉起容器依赖全部打包好备份升级最省心pip 原生安装熟悉 Python 的开发者装上就能open-webui serve方便改代码做二次开发除非你要动源码否则直接选 Docker。三步装好容器 第一步基础镜像。整体复制下面命令执行-d让容器后台运行-p 3000:8080把容器内的 8080 端口映射到主机的 3000装完访问 http://localhost:3000docker 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-v open-webui:/app/backend/data把聊天数据挂到持久化卷容器删了数据还在对应仓库里的 backend/data/ 目录--restart always保证开机自启。第二步pip 方式可选。不用 Docker 的话两条命令搞定装完访问 http://localhost:8080界面与 Docker 版完全一致pip install open-webui open-webui serve第三步GPU 加速可选。想启用 CUDA先确保宿主机装了 NVIDIA 容器工具包再把镜像标签换成ghcr.io/open-webui/open-webui:cuda并在命令里追加--gpus all把宿主机 GPU 全部透传给容器其余参数保持不变。装好打开浏览器你会看到这样的聊天主界面关键配置项怎么写 ⚙️配置项作用怎么写数据持久化防止重建容器后聊天记录、账号设置丢失-v open-webui:/app/backend/data远程 Ollama 地址Ollama 不在本机时指向远端服务-e OLLAMA_BASE_URLhttps://your-ollama-server.com离线配置无外网环境禁止访问 Hugging Face 下载export HF_HUB_OFFLINE1自定义模型配置以 JSON 注入模型参数-e MODEL_CONFIG_JSON{your: config}排错速查 模型列表连不上、提示 Ollama 不可达→ 容器默认访问不到宿主机 → 加上--add-hosthost.docker.internal:host-gateway仍不行就改用--networkhost共享宿主机网络并配-e OLLAMA_BASE_URLhttp://127.0.0.1:11434。3000 端口被占用→ 本地已有其他服务占着这个端口 → 把端口映射改成-p 8080:8080浏览器改访问 http://localhost:8080。GPU 没生效→ 少了--gpus all或镜像标签没用 cuda 版 → 两者缺一不可另需宿主机先装好 NVIDIA 容器工具包。收尾到这里Open WebUI 的 Docker 部署或 pip 安装就算完成了接上 Ollama 马上能聊。更多参数去 docs/ 目录下的官方文档里查后端 AI 功能源码在 backend/open_webui/想深挖某块功能直接翻目录就行。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考