Open WebUI 自托管指南：本地 LLM 的 ChatGPT 界面，支持 Ollama 和 OpenAI 接口

本地跑起来了 Llama 3、Qwen 3、Gemma 3，然后发现还是在终端里敲 ollama run 交互。Open WebUI 就是给这种情况准备的：一个 Web 界面，把本地模型和云端 API 接进来，用起来和 ChatGPT 没太大区别。

什么是 Open WebUI？

Open WebUI 是一款可离线运行的开源 AI 平台，界面参照 ChatGPT 设计，后端支持 Ollama、OpenAI 接口及任何 OpenAI 兼容的第三方服务。GitHub Star 超过 13 万。

• 协议：Open WebUI License（需保留品牌标识）

• 仓库：github.com/open-webui/open-webui

• 文档：docs.openwebui.com

核心功能

• 多后端接入：同时连接 Ollama 本地推理、OpenAI API、Anthropic、vLLM，以及任何 OpenAI 格式兼容接口，对话途中可自由切换模型。

• 本地 RAG 知识库：上传 PDF、网页、文本等文档建立私有知识库，支持 9 种向量数据库后端，回答时自动检索相关片段。

• Web 实时搜索：接入 Brave、SearXNG、Google 等 15+ 搜索引擎，模型可在回答时主动获取最新网络信息。

• 多用户与权限控制：内置 RBAC 角色权限系统，支持 SSO/OIDC/LDAP 集成，适合团队和企业统一管理 AI 访问权限。

• 语音与图像：支持多种 STT/TTS 服务商的语音对话，以及通过 DALL-E、ComfyUI、AUTOMATIC1111 生成图像。

• Open Terminal：在聊天窗口内直接执行代码、浏览文件，提供真实的计算环境。

• Plugin 与 Pipeline：通过 Python 函数、MCP 协议和 OpenAPI 集成扩展，支持自定义处理链。

• PWA 支持：移动端可作为 Progressive Web App 安装，无需原生 App。

可以解决什么问题

• 本地模型可视化界面：Ollama 部署后用完整的 Web UI 管理对话历史、文件上传、模型切换，不必在终端交互。

• 团队内部 AI 助手：RBAC 多用户管理，统一接入内外部模型，汇总用量数据。

• 私有文档问答：把内部技术手册、合同文档喂进知识库，直接在界面提问，数据不离开自己的服务器。

• 多模型横向对比：同一个界面切换不同模型，快速对比回答质量。

与同类工具对比

使用 Docker Compose 部署

创建 docker-compose.yml，写入以下内容：

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    volumes:
      - ./data:/app/backend/data
    ports:
      - "3000:8080"
    restart: unless-stopped

如需同时运行 Ollama，使用捆绑镜像：

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:ollama
    container_name: open-webui
    volumes:
      - ./ollama:/root/.ollama
      - ./data:/app/backend/data
    ports:
      - "3000:8080"
    restart: unless-stopped

执行 docker compose up -d 启动后，访问 http://<server-ip>:3000，首次进入需注册管理员账号。

在 1Panel 上的一键部署

1Panel 应用商店已上架 Open WebUI。打开 1Panel 控制台 → 应用商店 → 搜索 "Open WebUI" → 点击安装，配置端口和数据目录后提交即可，不用手写 Compose，后续升级也在面板里点一下。

👇 1Panel 官方地址

安装 1Panel

以 root 用户身份运行以下一键安装脚本，自动完成 1Panel 的下载和安装：

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

📖 详细安装说明：请参考 1Panel 官方安装文档

安装 Open WebUI

登录 1Panel，进入应用商店，搜索 Open WebUI，点击安装，配置端口（默认 3000）和数据挂载路径，勾选端口外部访问后提交即可。

安装完成后在已安装页面点击跳转，进入 Open WebUI，首次访问需注册管理员账号。

参考链接

• Open WebUI 官方文档

• GitHub · open-webui/open-webui

• Ollama 官网