SaaS 聊天订阅费用不断累积——ChatGPT Plus、Claude Pro 与团队席位可能超过每月每用户 20–30 美元，而你的提示词与上传文件却存放在他人服务器上。Open WebUI（MIT 协议，截至 2026 年 6 月 GitHub 11 万+ Star）提供媲美 ChatGPT 的精美 Web 界面，运行在你的 Mac 上：连接 Ollama 免费本地模型，或路由至 OpenAI 兼容 API（OpenRouter、DeepSeek、Groq），UI 与文档库仍在你掌控之中。
对想要隐私 + RAG 却不想手写 LangChain 的新手，Open WebUI 内置检索增强生成：将 PDF 与 Markdown 上传至文档库，在提问前用聊天框的# 命令引用文件。本指南演示 macOS 上一条 Docker 命令安装、首次拉取模型与最小知识库工作流——无 NodeMac 定价推销，路径均来自官方文档。
Open WebUI 与 Ollama 如何协同
Open WebUI 是浏览器界面层；Ollama（或远程 OpenAI 兼容端点）是推理引擎。持久化状态保存在挂载于 /app/backend/data 的 Docker 卷中。
Browser → http://localhost:3000 (or :8080 with --network=host)
→ Open WebUI container (FastAPI + Svelte UI)
→ Ollama at host.docker.internal:11434 OR OPENAI_API_BASE_URL
→ Vector DB (default embedded) + uploaded docs in data volume
→ RAG: user types "#" + selects document collection before prompt| 组件 | 默认位置 / 配置 | 作用 |
|---|---|---|
| Web UI | 主机端口 3000 映射容器 8080 | 聊天、管理、模型选择 |
| Ollama | 主机 11434 或 :ollama 镜像内置 | 拉取/运行 llama3、qwen2.5 等 |
| 文档库 | Admin → Documents / Workspace | PDF、TXT、MD 用于 RAG |
| RAG 触发 | 聊天输入 # | 为单轮对话挂载知识 |
| 数据卷 | -v open-webui:/app/backend/data | 必需—存储数据库与上传文件 |
Quotable: 上游警告：省略 open-webui 命名卷 会在重建容器时清空用户、聊天记录与上传文档——务必挂载 -v open-webui:/app/backend/data。
来源： Open WebUI README and getting-started docs.
ChatGPT Plus 对比自托管 Open WebUI
| 维度 | ChatGPT Plus（约 $20/月） | Open WebUI + Ollama（本地） |
|---|---|---|
| 数据驻留 | OpenAI 服务器 | 你的 Mac / Docker 卷 |
| 文档 RAG | GPT 商店 / 有限上传 | 完整文档库 + 每轮 # |
| 模型选择 | 仅 OpenAI 模型 | 任意 Ollama 模型 + API 后端 |
| 离线使用 | 否 | 是（需先 pull 本地模型） |
| 首次配置时间 | 0 分钟 | 约 15–30 分钟 |
| 持续成本 | 订阅制 | 电费 + 可选 API 密钥 |
若只需偶尔 GPT-4o 级质量，可将 Open WebUI 指向便宜的 OpenAI 兼容 API，跳过重型本地模型。若要零云端推理，请用 bundled :ollama 镜像与 llama3.2:3b（16 GB Mac）——基准内存见 Apple Mac mini 规格。
macOS 分步操作手册
- 安装 Docker Desktop — Open WebUI 推荐给 Mac 新手的方案。为 7B+ 模型向 Docker 分配 8 GB+ 内存。
- 选择安装方式 — 三种常见模式：
# A) Open WebUI only — Ollama already running on Mac (brew install ollama && ollama serve)
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
# B) Bundled Open WebUI + Ollama (simplest one-container start)
docker run -d -p 3000:8080 -v ollama:/root/.ollama -v open-webui:/app/backend/data \
--name open-webui --restart always ghcr.io/open-webui/open-webui:ollama
# C) Connection issues? Use host networking (note port becomes 8080)
docker run -d --network=host -v open-webui:/app/backend/data \
-e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui --restart always \
ghcr.io/open-webui/open-webui:main- 打开 UI — 访问 http://localhost:3000（
--network=host时为 8080）。创建首个管理员账号——私有安装中首位用户注册后关闭公开注册。 - 拉取入门模型 — 若使用独立 Ollama，另开终端：
ollama pull llama3.2:3b
# or for Chinese/English mix: ollama pull qwen2.5:7bbundled :ollama 镜像：Admin → Settings → Models，或 docker exec -it open-webui ollama pull llama3.2:3b。
- 在聊天中选择模型 — 顶栏选
llama3.2:3b，发送测试提示确认 Ollama 连通。 - 构建文档库（RAG） — Admin → Documents：上传 PDF、
.md、.txt，等待嵌入完成。 - 用
#查询 — 新聊天输入#，选集合或文件，再提问。Open WebUI 将检索片段注入提示词。 - 可选：OpenAI 兼容 API — Settings → Connections：配置 DeepSeek、OpenRouter 等 base URL 与 API Key，保留同一 UI 与文档库。国内用户常用 DeepSeek 兼容端点——数据仍经该提供商，除非仅用本地 Ollama。
替代（pip）：pip install open-webui && open-webui serve 在 http://localhost:8080 运行，无需 Docker——上游要求 Python 3.11。
故障排查
「Open WebUI: Server Connection Error」（Ollama 不可达）
现象：模型列表为空；错误提及容器内 127.0.0.1:11434。
修复：Mac 上 Docker 无法通过裸 localhost 访问主机 Ollama。用 --add-host=host.docker.internal:host-gateway（模式 A）或 --network=host（模式 C）。主机执行 curl http://127.0.0.1:11434/api/tags 应显示模型。
安装后端口错误
现象：浏览器无法连接。
修复：默认映射使用主机 3000；--network=host 为 8080；pip 亦为 8080。URL 须与命令一致。
文档已上传但 # 无结果
现象：RAG 挂载成功但回答忽略文件内容。
修复：确认嵌入完成（文档无错误标记）。换较小 PDF 重试。Admin → Settings → Documents / RAG：确保集合包含在聊天且模型上下文足够。
重建容器后聊天记录全丢
现象：docker rm 后像全新安装。
修复：未挂载或删除了 open-webui 卷。务必 -v open-webui:/app/backend/data。检查 docker volume inspect open-webui。
延伸阅读
将 Open WebUI 文档库与 OpenHuman Mac mini M4 指南 的 OAuth 个人记忆配合，或在同一常开 Mac mini 上用 Understand-Anything 知识图谱 扫描代码库。
在 Open WebUI 中固定 OpenAI 模型时，可对照
GPT-5.6 iris-alpha Codex 泄露追踪
—在 system card 写明前请钉死 gpt-5.5。
在 Mac 上关注 Apple Intelligence？阅读 WWDC 2026「All systems glow」Siri 独立 App 爆料解读 —证据矩阵、8 步准备清单、5 个 FAQ。
常见问题
Open WebUI 和 OpenAI 的 ChatGPT 是一回事吗？
不是。Open WebUI 是开源自托管 UI，可连接 Ollama、OpenAI API 或其他兼容后端。它模仿 ChatGPT 的对话体验，但运行在你自己的基础设施上——模型、用户与文档存储均由你掌控。
Mac mini M4 需要独立 GPU 吗？
运行 3b–7b 量化小模型在 Apple Silicon 上不需要独立 GPU——Ollama 使用统一内存。16 GB 内存可流畅运行 llama3.2:3b；若 7b 模型与文档嵌入并发，建议 24 GB。NVIDIA :cuda 镜像面向 Linux/NVIDIA 主机，不适用于 Mac Docker。
能完全离线使用吗？
可以——在 ollama pull 模型后且不连接云端 API 即可。离线环境可按上游 README 设置 HF_HUB_OFFLINE=1 阻止 HuggingFace 下载。
RAG 和在 ChatGPT 里上传文件有何不同？
Open WebUI 将文件存入你的文档库，支持 ChromaDB、PGVector 等向量后端。# 命令可在每条消息中挂载特定集合——适合多项目知识库，无需每次会话重新上传。
Docker 在笔记本上太重怎么办？
可在常开的 Mac mini 上用 pip install，或 SSH 到专用主机运行 Docker。UI 支持 PWA——局域网可通过 http://你的-mac-ip:3000 访问；未加固认证前请勿端口转发到公网。