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 存取；未加固認證前請勿連接埠轉發到公網。