Open WebUI 完全指南：本地 Ollama + 云端免费 API 同池，隐私优先的统一调用

一句话总结：Open WebUI（原 Ollama WebUI）是开源的 ChatGPT 风格前端，把本地 Ollama 模型与云端 OpenAI/Claude/Gemini/DeepSeek/Groq/OpenRouter 收敛到同一界面，支持 RAG、工具调用与团队共享，隐私优先，Docker 一键部署。

为什么选 Open WebUI？

• 本地 + 云端同池：左侧模型列表同时显示 llama3.1:8b (local) 与 gpt-4o-mini (cloud)，一键切换，无需两个客户端。
• 隐私优先：对话与文档存本地，云端仅在选云模型时才出网，适合合规场景。
• RAG 内置：支持 PDF/URL 导入，向量库（Chroma/Qdrant）+ 混合检索，回答附引用。
• 工具调用：支持函数调用与内置工具（搜索、代码执行、网页抓取）。
• 团队就绪：用户管理、模型权限、共享对话，Docker Compose 一键起全栈。

部署

# 仅 WebUI（连现有 Ollama）
docker run -d -p 3000:8080 \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

# 全栈（含 Ollama）
docker run -d -p 3000:8080 \
  --gpus all -v ollama:/root/.ollama -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:ollama

接入云端免费 API（统一调用核心）

管理面板 → 设置 → 连接 → OpenAI 兼容 → 添加：https://api.openai.com/v1 / https://api.deepseek.com/v1 / https://openrouter.ai/api/v1，填 Key，拉取模型。之后模型下拉同时出现本地与云端模型，无缝切换。

技巧：把 Base URL 填 OneAPI http://oneapi:3000/v1，Open WebUI 侧一个 Key 即可切所有云模型，复用网关的限流与计费。

统一调用实战

隐私分级

• 敏感文档问答选 llama3.1:8b (local)，全程不出网；
• 通用创作切 deepseek-chat / gemini-2.0-flash 云端，质量更高。

RAG 问答

工作空间 → 文档 → 上传 PDF → 新建对话 @文档，回答附页码引用，适合把免费 API 的长文档先本地索引。

模型对比

同一 prompt 分别发给 qwen3:8b (local) 与 gpt-4o-mini (cloud)，对比延迟与质量，决定免费/付费路由策略。

与 Cherry Studio / Lobe Chat / OneAPI 对比

最佳实践

• 本地优先：默认用 Ollama 8B，复杂任务再切云端大模型，省额度。
• 知识库分层：按项目建 Collection，权限按用户组隔离。
• OneAPI 联动：云端 Base URL 统一指向 OneAPI，网关层做熔断与可观测。

总结

• 想隐私 + 免费：Open WebUI + Ollama 本地模型零成本，敏感数据不出网。
• 想统一界面：本地与云端模型同一列表，一键切换。
• 想团队共享：Docker + 用户管理，开箱即团队 AI 门户。

下一篇：LiteLLM Proxy 完全指南（Python 100+ 模型统一网关，OpenAI 兼容 + 负载均衡）。

🚀 立即开始：免费 API 一键调用

想要无需逐一注册、统一鉴权调用以上全部免费模型？Apishare.cc 提供统一 API Key，一个 Key 调用 100+ 模型，免费模型零成本直连。

👉 立即注册 Apishare.cc → 获取你的统一 API Key

📊 想看更多免费模型排行？查看 2026年9月 免费 LLM API 综合实力榜单 →

免费 API 聚合平台说明

本文涉及的模型均由 APIShare 免费 API 聚合平台 统一接入，一份 Key 调用全站模型。

• 完整模型目录：APIShare 免费 API 目录
• 注册即送免费额度：注册领取 API Key