跟着本站教程用 Ollama 把大模型装进电脑后，你可能会发现一个问题：Ollama 是命令行工具——敲 ollama run 才能对话，切模型要记命令，聊天记录全在黑窗口里，手机更是用不了。Open WebUI 就是来补这一课的：它是一个开源、可完全离线运行的自托管 AI 平台，给 Ollama 套上一层和 ChatGPT 几乎一样的网页界面，浏览器打开就能聊，支持多模型切换、对话历史、文档知识库（RAG），局域网内手机、平板都能访问。项目前身叫 ollama-webui，目前 GitHub Star 已超过 15 万、累计下载量超 3.85 亿次（据 Open WebUI 官网；GitHub 仓库），最新版本为 v0.11.1（2026 年 8 月发布，据官网），官方文档地址 docs.openwebui.com。
一、安装前准备
- 已装好 Ollama 并拉取过至少一个模型（如 qwen、deepseek-r1 等）。还没装的先看本站《Ollama Windows 安装教程》《Ollama Mac 教程》，官网下载页：ollama.com/download。
- 安装 Docker Desktop——这是官方推荐、对新手最省事的安装方式（据 Open WebUI 官方文档 Quick Start）。Windows 和 Mac 都到 Docker 官网下载 Docker Desktop：docker.com/products/docker-desktop，双击安装、一路下一步即可。Windows 上安装程序会自动提示启用 WSL2 组件，按提示重启电脑就行。安装后启动 Docker Desktop，等左下角鲸鱼图标变绿即就绪。
- 硬件方面，Open WebUI 本体占用很小，真正吃配置的还是 Ollama 跑的模型。各档位显卡/内存能跑多大模型、笔记本和迷你主机怎么选，详细对照见《本地部署AI完全指南》→ https://pay.66buff.com/buy/2。
不想装 Docker？官方也提供 pip 方式：
pip install open-webui后执行open-webui serve，访问http://localhost:8080；但要求 Python 3.11 或 3.12（3.13 暂不支持），适合有经验的用户，新手建议走 Docker（据官方文档）。此外官方还推出了免 Docker 的桌面版，见 open-webui/desktop。
二、Docker 安装 Open WebUI（Windows/Mac 通用）
打开终端（Windows 用 PowerShell 或命令提示符，Mac 用"终端"App），确认 Docker Desktop 已启动，然后复制执行下面这条官方命令（据 Open WebUI GitHub 官方 README）：
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各参数含义（据官方文档 Quick Start）：
| 参数 | 作用 |
|---|---|
-p 3000:8080 | 把网页界面映射到电脑的 3000 端口；若 3000 被占用，改左边的数字即可 |
--add-host=host.docker.internal:host-gateway | 让容器能访问宿主机上运行的 Ollama，连接本地模型的关键，别漏 |
-v open-webui:/app/backend/data | 数据持久化卷，账号和聊天记录都存这里，升级容器也不丢数据 |
--restart always | 电脑重启后容器自动恢复运行 |
ghcr.io/open-webui/open-webui:main | 官方镜像（GitHub 容器仓库）；:main 标签内置离线所需的全部组件 |
首次运行会自动拉取镜像（数 GB，:main 镜像内置了文档向量化和语音转文字模型，拉完后断网也能用）。终端输出一长串容器 ID 即表示启动成功，首次启动约需一分钟。
小提示：官方文档还建议追加
-e WEBUI_SECRET_KEY=你的密钥（密钥可用openssl rand -hex 32生成），固定密钥可避免容器重建后被强制登出；不加也能正常使用。另外镜像同时发布在 Docker Hub（openwebui/open-webui），与 GHCR 内容完全相同，拉取慢时可替换镜像名（据 Open WebUI 中文文档）。
三、连接 Ollama 与首次配置
- 打开网页：浏览器访问 `http://localhost:3000`（pip 方式则是
http://localhost:8080）。 - 注册管理员账号：首屏显示 "Get started with Open WebUI"，点 Create Admin Account，填写邮箱和密码注册。注意：第一个注册的账号自动成为管理员（据 Open WebUI 官方文档 Roles 页面）；之后注册的账号默认为普通用户。这是纯本地账号，信息只存在你自己电脑的 Docker 数据卷里，不经过任何云端。如果部署到局域网或公网给多人使用，建议管理员登录后在 头像 → Admin Panel → Settings → General 中关闭注册开关（Enable Signup），自己单机用则无需改动。
- 确认 Ollama 已连上：正常情况下，Open WebUI 会自动通过容器内默认地址
http://host.docker.internal:11434连接本机 Ollama。点聊天框顶部的模型选择器，能看到你用ollama pull下载过的模型，就说明打通了。 - 如果模型列表为空：Ollama 默认只监听 127.0.0.1，部分环境下容器的请求会被拒，需要让它对所有网卡开放（据 Ollama 官方 FAQ）：
- Windows：先右键托盘羊驼图标退出 Ollama；系统搜索"环境变量"→"编辑账户的环境变量"，新建变量 OLLAMA_HOST，值填 0.0.0.0，保存后从开始菜单重新启动 Ollama。
- Mac：终端执行 launchctl setenv OLLAMA_HOST "0.0.0.0:11434"，然后退出并重启菜单栏里的 Ollama 应用。
- 验证：浏览器访问 http://127.0.0.1:11434，看到 "Ollama is running" 即正常；也可在 Open WebUI 的 头像 → Settings → Connections 中把 Ollama 地址填为 http://host.docker.internal:11434 并点击验证。
到这里，你已经拥有一个跑在自己电脑上的"私有 ChatGPT"了。更多本地部署玩法——多账号管理、外网远程访问、知识库进阶、硬件选购对照——见《本地部署AI完全指南》→ https://pay.66buff.com/buy/2。
四、常用功能速览
- 多模型切换：聊天框顶部下拉即可在已下载的 Ollama 模型间切换；在管理员设置的外部连接里还能填入 OpenAI 兼容的 API 地址，把 DeepSeek API 等云端模型也接进来，本地、云端一个界面混用。
- 对话体验：支持 Markdown 渲染、代码高亮、重新生成、对话历史搜索，操作逻辑和 ChatGPT 一致。
- 知识库（RAG）：工作区可新建知识库，上传 PDF、Word、TXT 等文档，
:main镜像内置向量化模型，提问时自动检索文档内容作答——资料问答、合同论文查询全程在本地完成，文档不外传。 - 多设备访问：手机、平板连同一 Wi-Fi，浏览器访问
http://电脑局域网IP:3000即可使用（需按上一节配置OLLAMA_HOST=0.0.0.0并在防火墙放行端口）。
五、常见报错排查
| 报错现象 | 原因与解决办法 |
|---|---|
| 浏览器打不开 localhost:3000 | 先确认 Docker Desktop 已启动、容器在运行（docker ps 能看到 open-webui）；首次启动约需 1 分钟，可执行 docker logs -f open-webui 查看启动日志 |
提示 port is already allocated（端口被占） | 把映射端口左边数字改掉，如 -p 3001:8080，然后访问 http://localhost:3001（据官方文档对 -p 参数的说明） |
| 模型列表为空 / 提示连不上 Ollama | ① 浏览器访问 127.0.0.1:11434 确认 Ollama 在运行；② 按第三节配置 OLLAMA_HOST=0.0.0.0 并重启 Ollama；③ Settings → Connections 中 Ollama 地址填 http://host.docker.internal:11434 重新验证（据 Open WebUI GitHub README Troubleshooting） |
| Windows 上 Docker 启动报 WSL2 错误 | Docker Desktop 依赖 WSL2：以管理员身份打开 PowerShell 执行 wsl --update 后重启电脑，或在安装 Docker 时按提示启用相关组件 |
| 拉取镜像很慢或超时 | 镜像服务器在海外，可换用官方 Docker Hub 镜像名 openwebui/open-webui:main（内容相同，据中文文档），或换网络时段重试；不要使用来路不明的第三方修改版镜像 |
pip 安装后 open-webui 命令找不到 | 需 Python 3.11/3.12（3.13 暂不支持，据官方文档）；注意激活安装时所用的虚拟环境，Windows 下命令位于环境的 Scripts 目录 |
六、FAQ
Q：Open WebUI 和 Ollama 是什么关系？必须两个都装吗？
A：Ollama 是负责运行模型的后端（命令行），Open WebUI 是网页前端，两者配合体验最佳；但 Open WebUI 也支持只接 OpenAI 兼容的云端 API，不装 Ollama 同样能用。
Q：注册账号要联网吗？聊天记录会泄露吗？
A：都不会。账号和对话全部保存在本地 Docker 卷 open-webui 中，平台本身设计为可完全离线运行（据 Open WebUI 官网）。
Q：手机上怎么用？
A：手机和电脑连同一个 Wi-Fi，先查电脑局域网 IP（Windows 执行 ipconfig，Mac 在"系统设置 → Wi-Fi → 详细信息"里看），手机浏览器访问 http://该IP:3000 即可；记得先配置 OLLAMA_HOST=0.0.0.0，并在防火墙放行 3000 和 11434 端口。
Q：完全不想敲命令行不行？
A：可以试试官方桌面版（open-webui/desktop），无需 Docker 和命令行；也可以直接找大山资源站的本地部署定制服务，帮你远程装好调通 → https://pay.66buff.com。
📦 省心资料包 ＋ 一对一服务
- 《本地部署AI完全指南》（19.9元）：从硬件判断、显卡内存对照，到 Ollama / Open WebUI / 知识库 / 外网访问，手把手图文保姆级教程，照着做不踩坑。→ https://pay.66buff.com/buy/2
- 《AI提效指令库：540个高频提示词模板（2026升级版）》（19.9元）：123页、540个可直接复制的模板，本地模型也能套用，办公、写作、编程直接用。→ https://pay.66buff.com/buy/3
不想自己折腾环境，或有 建站 / 小程序 / 支付对接 / 企业私有 AI / RAG 知识库 / 远程代部署 等定制需求，加客服微信「大山资源」一对一咨询（技术工程师本人接单）：
👉 https://u.wechat.com/MGQJue4lhHah8QzEJfkEwwE?s=2
客服二维码：https://pay.66buff.com/kefu.jpg
参考资料
- Open WebUI 官方文档 Quick Start：官方文档
- Open WebUI GitHub 仓库（open-webui/open-webui）：GitHub
- Open WebUI 官网（Star、下载量、版本信息）：官网
- Open WebUI 中文文档快速上手：中文文档
- Open WebUI 角色与管理员账号说明：官方文档
- Ollama 官方 FAQ（环境变量配置）：Ollama FAQ
- Ollama 官网下载：ollama.com/download
- Docker Desktop 官网：Docker
- Open WebUI 桌面版：GitHub
