十分钟用 Docker 部署 Open WebUI:完整指南,跑起你的自托管 AI 对话平台

十分钟用 Docker 部署 Open WebUI:完整指南,跑起你的自托管 AI 对话平台

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

Open WebUI 是一个开源 AI 对话界面,能同时接上本地 Ollama 模型和任意 OpenAI 兼容 API。部署一次,浏览器里就有一个类 ChatGPT 的页面,数据全部留在自己的机器上。它适合想自托管 AI 助手、又不想依赖商业 SaaS 的读者。

它凭什么值得装

• 换模型不用换应用:聊天页顶部的模型下拉框会列出所有可用后端。今天接本地 Ollama,明天把地址改成 OpenAI 兼容 API,对话记录、设置和界面都不变。
• 可以完全离线跑:配合仓库自带的 Ollama 容器,不依赖外部网络,资料不出本机。
• 一份部署多人用:管理后台支持用户分组与权限划分,同一实例开放给同事,各自有独立会话空间。

动手前 30 秒自检

• Docker 已安装且守护进程在运行,docker ps能正常返回
• 本机 3000 端口空闲
• 磁盘留了约 2GB 空间,网络能正常拉取镜像

一条命令跑起来

仓库里的docker-compose.yaml会同时拉起 Open WebUI 和 Ollama 两个容器,不需要额外配置:

git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker compose up -d

构建完成后,浏览器打开http://localhost:3000就能看到注册页。更喜欢手动部署(pip 装后端依赖、npm 构建前端)的话,步骤在仓库根目录的 README.md 里写得很细,照着做即可。

首次进入的三步设置

1. 建账号做什么:按页面提示填写注册表单。在哪做:打开 3000 端口后的第一个页面就是注册页。看到什么算成功:注册完直接进入新建聊天界面,左下角显示你的名字和头像。

2. 接上 AI 后端做什么:填入 Ollama 服务器地址,或粘贴 OpenAI 兼容 API 的密钥。在哪做:右上角头像进入 Settings,再进 General 选项卡。看到什么算成功:输入框上方的模型下拉框里出现可选模型列表,说明 Ollama 对接成功。

3. 设默认模型做什么:打开聊天页顶部的模型选择器,选中常用模型并标记为默认。看到什么算成功:新建对话时自动带上这个模型,不用再手动挑。

三个顺手小动作

• 左侧边栏的 Folders 里建文件夹,按项目归档对话,会话多了不串。
• 输入框点加号上传文档,模型会基于文件内容回答,不用自己复制粘贴。
• 模型还在输出长回复时,继续输入下一条消息,它会排队,输出完自动发出。

卡住了怎么办

只有两个出口。先看容器日志,把报错定位出来:

docker logs open-webui

日志看不懂时,拿报错关键词去仓库根目录的 TROUBLESHOOTING.md 查,里面有专门讲容器连不上 Ollama 服务和端口占用的排查步骤,源码在 backend/open_webui/ 下,也方便对照着看。

收尾

到这里,一个自托管的 Open WebUI 就已经跑起来了。下一步建议把一份项目文档导入知识库,让模型基于你自己的资料作答。

仓库内置了多张背景图,在管理后台换成自己喜欢的星空,界面立刻不那么"默认"。

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