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-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 注册第一个账号自动成为管理员就算完成了。更习惯 Python 的话pip install open-webui后运行open-webui serve要求 Python 3.11访问 http://localhost:8080其余流程一致。 接模型Ollama 与 OpenAI 接口怎么连Open WebUI 自己不跑模型它负责连模型。按模型所在位置分三种情况。模型跑在本机最简命令里的--add-hosthost.docker.internal:host-gateway就是在告诉容器宿主机的 Ollama 默认监听 127.0.0.1:11434。装好 Ollama、拉一个模型界面模型列表里直接能选。模型在远程服务器加一个OLLAMA_BASE_URL环境变量指向远程地址即可其余参数照抄最简命令docker run -d -p 3000:8080 -e OLLAMA_BASE_URLhttps://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_OFFLINE1系统就不会再去尝试从 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:8080docker run -d --networkhost -e OLLAMA_BASE_URLhttp://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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 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-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 注册第一个账号自动成为管理员就算完成了。更习惯 Python 的话pip install open-webui后运行open-webui serve要求 Python 3.11访问 http://localhost:8080其余流程一致。 接模型Ollama 与 OpenAI 接口怎么连Open WebUI 自己不跑模型它负责连模型。按模型所在位置分三种情况。模型跑在本机最简命令里的--add-hosthost.docker.internal:host-gateway就是在告诉容器宿主机的 Ollama 默认监听 127.0.0.1:11434。装好 Ollama、拉一个模型界面模型列表里直接能选。模型在远程服务器加一个OLLAMA_BASE_URL环境变量指向远程地址即可其余参数照抄最简命令docker run -d -p 3000:8080 -e OLLAMA_BASE_URLhttps://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_OFFLINE1系统就不会再去尝试从 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:8080docker run -d --networkhost -e OLLAMA_BASE_URLhttp://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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考