Open WebUI 安装与本地部署：一条 Docker 命令跑通自托管 AI 聊天界面

Open WebUI 安装与本地部署一条 Docker 命令跑通自托管 AI 聊天界面【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个自托管的 AI 聊天平台给 Ollama、OpenAI 兼容接口这类模型后端套上开箱即用的网页界面并且可以完全离线运行。如果你正在做 Open WebUI 本地部署这篇按实际操作顺序走装好、验证跑通、把模型接上全程只依赖两三条命令。动手前环境与安装方式怎么选环境要求很轻Docker 或 Python 3.11 二选一即可有 NVIDIA 显卡的话再加装 NVIDIA 容器工具包。两条路一句话选型——Docker适合大多数人一条命令起服务依赖都在镜像里备好了本教程以此为主线pip适合已有 Python 环境的开发者pip install open-webui之后运行open-webui serve默认端口同为 8080。 安装 Open WebUIDocker 推荐路径假设 Ollama 已装在宿主机上默认监听 11434 端口直接执行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关键参数一行说清-p 3000:8080把容器内 8080 映射到本机 3000--add-host让容器能用 host.docker.internal 找到宿主机的 Ollama-v open-webui:/app/backend/data把数据库和上传文件放进命名卷避免数据随容器消失--restart always保证重启机器后服务自动拉起。如果只走 OpenAI 兼容 API、不用 Ollama在上述命令里补一个-e OPENAI_API_KEY你的密钥即可其余参数不动。✅ 首次运行验证怎么确认装好了浏览器打开 http://localhost:3000看到注册页面就说明服务已经正常注册第一个账号——它会自动成为管理员。登录后检查两点左侧能列出 Ollama 里的模型说明前后端已打通随便发一句消息能出流式回复整条链路就算跑通了。页面白屏或报错时先docker logs -f open-webui看日志再往下查。⚙️ 关键配置只动必须动的三项Ollama 不在本机时改 OLLAMA_BASE_URL在 docker run 中加-e OLLAMA_BASE_URLhttps://你的Ollama地址末尾不带 /就能指向远程服务器。只用 OpenAI API 时加 OPENAI_API_KEY同一个-e参数解决界面里即可选用 OpenAI 系模型。端口想换就换容器内固定 8080只改映射的左侧端口例如-p 8080:8080。向量库、数据库、RAG 等其余配置都有默认值先用默认跑起来之后在管理后台按需调整。 按需进阶GPU、离线与一体化镜像场景有 NVIDIA 显卡想让本地推理更快镜像标签换成:cuda并加--gpus allLinux/WSL 需先装 NVIDIA 容器工具包。场景机房完全断网启动前导出HF_HUB_OFFLINE1阻止服务尝试从 Hugging Face 拉取模型。场景连 Ollama 都还没装改用官方一体化镜像:ollama它把 Ollama 打包进同一容器再挂一个-v ollama:/root/.ollama保存模型文件省掉单独安装 Ollama 的步骤。️ 常见问题快查现象界面提示连不上 Ollama 服务器→ 容器里的 127.0.0.1 是容器自己而非宿主机。改用 host 网络模式重建容器docker run -d --networkhost ...同时指定OLLAMA_BASE_URLhttp://127.0.0.1:11434此时访问地址变为 http://localhost:8080。现象3000 端口被占用容器起不来→ 把映射端口换成空闲的如-p 8080:8080。现象重建容器后聊天记录没了→ 多半漏挂了数据卷。确认启动命令里有-v open-webui:/app/backend/data并复用同一个卷名。现象离线环境启动卡住、日志刷模型下载超时→ 设置HF_HUB_OFFLINE1后重启容器。继续深入装好只是开始RAG 知识库、分组权限、插件与 MCP 工具都能在管理后台逐项开启安全策略详见 docs/SECURITY.md想改行为而不只是改配置可以直接读 AI 功能的后端源码 backend/open_webui/。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考