Open WebUI：自建 ChatGPT 式聊天界面，接上本地模型
你能得到什么：一个长得像 ChatGPT 的网页聊天界面，后端接你自己的 Ollama 本地模型，或者任意 OpenAI 兼容接口；家里人、小团队共用一套，不用每人开一份订阅，聊天记录也存在自己机器上。适合：已经装好 Ollama、想给不懂命令行的人用的人。不适合：只有一台低配电脑又不想装 Docker 的人，它的 pip 安装包相当大（见下文）。
项目速览
| 项目 | 内容 |
|---|---|
| 仓库 | open-webui/open-webui |
| Star | 156,330（截至 2026-10-21） |
| 许可证 | Open WebUI License（BSD-3 条款基础上加了品牌条款：30 天内终端用户超过 50 人的部署，不得去掉或替换「Open WebUI」品牌，除非另获授权） |
| 最新版本 | v0.12.3（2026-10-16 发布） |
| 它做什么 | 自托管的 AI 聊天平台：多用户、对话历史、文档问答、插件和工具调用，支持 Ollama 和 OpenAI 兼容接口 |
安装指南
# Ollama 装在同一台机器上
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 3.11；用 uv 可以不动系统 Python
uv venv --python 3.11 .venv && source .venv/bin/activate
uv pip install open-webui
open-webui serve # 默认 http://localhost:8080# 先装 Python 3.11，然后：
py -3.11 -m venv .venv
.venv\Scripts\activate
pip install open-webui
open-webui serve想把 Ollama 和界面打包在一个容器里，可以用官方带 Ollama 的镜像 ghcr.io/open-webui/open-webui:ollama，命令见仓库 README。
使用教程：让家人用上本地模型
- 先跑通 Ollama：确认
curl http://localhost:11434/api/version有返回。 - 启动 Open WebUI：pip 方式可以在启动前指定数据目录和 Ollama 地址：
DATA_DIR=~/open-webui-data OLLAMA_BASE_URL=http://127.0.0.1:11434 open-webui serve。 - 立刻注册管理员：打开网页，第一个注册的账号自动成为管理员。我们实测注册后接口返回的角色就是
admin。 - 选模型聊天：左上角模型列表里会出现 Ollama 已有的模型，选中即可对话。
- 给家人开账号：在管理面板里添加用户，或者开放注册但设成需要审核，再把局域网地址发给他们。
避坑与解决方案
pip 安装一装就是好几 GB
在 Linux 上 pip install open-webui 会连带装上 PyTorch 和一整套 NVIDIA CUDA 库。我们这次装完，虚拟环境占了 6.8 GB。磁盘紧张就用 Docker 镜像，或者装在空间大的盘上。
Python 版本不对
README 明确要求 Python 3.11，用别的版本容易出现依赖装不上的问题。用 uv 或 pyenv 单独准备一个 3.11 环境，不要动系统自带的 Python。
第一次启动要联网下载向量模型
首次启动时，它会从 Hugging Face 下载一个句向量模型（我们这次是 sentence-transformers/all-MiniLM-L6-v2），用于文档检索。网络不通会卡在这一步；提前准备好网络，或者在官方文档里查离线部署的设置。
Docker 里连不上 Ollama
容器里的 127.0.0.1 指的是容器自己，不是你的电脑。README 给的解法：加 --add-host=host.docker.internal:host-gateway，或者改用 --network=host（这时端口变成 8080），并设置 OLLAMA_BASE_URL=http://127.0.0.1:11434。
公网暴露前先关注册
管理员是第一个注册的人。如果你把服务放到公网上却还没注册，任何人都可能抢先成为管理员。先在本机完成注册，再考虑开放访问，并在设置里关闭或限制新用户注册。
WANGXXXL 实测于 2026-10-21
- 环境：Linux 云电脑，8 核 CPU、无 GPU；Python 3.11 虚拟环境（uv 创建），open-webui 0.12.3。后端是同一台机器上的 Ollama 和 Qwen3 0.6B 小模型。
- 过程：
uv pip install open-webui约 35 秒完成，虚拟环境 6.8 GB；open-webui serve --port 8088首次启动下载句向量模型后进入正常运行，首页返回 200。 - 结果：通过接口注册第一个账号，角色为
admin；模型列表里出现qwen3-local:latest；用/api/chat/completions让它「列出三个省钱的小习惯」，约 2.4 秒返回三条。说实话，0.6B 小模型给的建议质量一般（比如「处理垃圾时多放垃圾袋」），界面没问题，答案好坏取决于你接的模型。