Open WebUI

Overview

Open WebUI（原名 Ollama WebUI）是一个开源的大语言模型 Web 界面项目，通过部署它可以得到一个纯本地运行的基于浏览器访问的 Web 服务。它提供了可扩展、功能丰富、用户友好的自托管 AI Web 界面，支持各种大型语言模型（LLM）运行器，可以通过配置形式便捷地集成 Ollama、OpenAI 等提供的 API。

Aliases

Open WebUI
OpenWebUI
open-webui

Key Facts

Docker 镜像: ghcr.io/open-webui/open-webui:main
默认端口: 8080
核心功能: 聊天机器人、本地知识库（RAG）、图像生成、联网搜索

Core Features

多模型支持: 通过 Ollama API 或 OpenAI API 接入多种 LLM
RAG 本地知识库: 使用嵌入模型（如 bge-m3）构建本地知识库
联网搜索: 支持 Bing、博查等搜索引擎接入
图像生成: 集成图像生成能力
跨域访问: 通过 CORS_ALLOW_ORIGIN=* 支持跨域 API 调用

Docker Compose 部署示例

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    environment:
      - OLLAMA_API_BASE_URL=http://ollama:11434/api
      - WEBUI_NAME="My LLM Service"
      - ENABLE_OPENAI_API=false
      - CORS_ALLOW_ORIGIN=*
      - ENABLE_IMAGE_GENERATION=true
      - DEFAULT_MODELS=deepseek-r1:8b
      - RAG_EMBEDDING_MODEL=bge-m3
    ports:
      - 8080:8080
    volumes:
      - ./open_webui_data:/app/backend/data

前提条件

已安装 Docker
已部署 Ollama 并拉取模型（deepseek-r1:8b 和 bge-m3）

联网搜索配置

操作路径：设置 → 联网搜索 → 启用联网搜索 支持的搜索引擎：

Bing
博查（https://aq6ky2b8nql.feishu.cn/wiki/XgeXwsn7oiDEC0kH6O3cUKtknSR）

注意：如不需要联网搜索功能，请勿开启以保护隐私数据。

Ollama：Open WebUI 通过 Ollama API 接入 LLM 服务
DeepSeek：Open WebUI 的推荐默认模型之一
RAG：Open WebUI 使用 RAG 技术构建本地知识库

Connection to Hermes Agent

Open WebUI 可以作为 Hermes Agent 的 Web 前端，通过 API Server 接入。配置方法见 open-webui-hermes-agent。

核心步骤：

启用 Hermes Agent API Server：API_SERVER_ENABLED=true，API_SERVER_KEY=your-secret-key
Docker 启动 Open WebUI，配置 OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1
在 Open WebUI Admin Settings → Connections → OpenAI API 添加连接

2.7 KiB Raw Blame History Unescape Escape