Open WebUI

Open WebUI 介绍 - 本地大模型交互平台

一、Open WebUI 是什么？

Open WebUI 是一款开源、可扩展、功能丰富且完全离线运行的自托管 AI 聊天平台，前身为 "Ollama WebUI"，后独立发展。它的核心定位是 "ChatGPT 网页版的私有化平替"，让你无需依赖任何云端服务，通过浏览器就能与本地或远程的大语言模型（LLM）进行高效交互。

简单来说，Ollama 负责在后台运行大模型，而 Open WebUI 则为它提供了一个美观、易用的 Web 图形界面，让操作像 ChatGPT 一样直观。

核心特点：

全链路可控：数据存储、模型调用、交互记录均在本地完成，隐私零泄露
多后端兼容：支持 Ollama（本地）、OpenAI 兼容 API（如 LMStudio、Groq、Mistral 等），可同时连接多个后端自由切换
零门槛使用：界面设计与 ChatGPT 高度相似，无需代码基础，打开浏览器即可上手
完全离线：支持在无网络环境下正常使用本地模型和历史记录

二、核心功能

Open WebUI 不仅仅是聊天界面，它提供了一系列强大的功能：

2.1 多模型管理与切换

同时连接多个后端（Ollama / OpenAI API / 其他兼容服务）
在聊天中随时切换不同模型，对比不同模型的回答效果
并行利用多个模型，同时获取多种角度的响应

2.2 检索增强生成（RAG）

上传 PDF、Word、Excel、PPT 等文档，自动提取文本内容构建知识库
在聊天中用 # 命令引用文档库，让模型基于特定文档回答问题
支持通过 # + URL 直接解析网页内容，将网络信息注入对话

2.3 Web 搜索集成

支持 SearXNG、Google PSE、Brave Search、Bing 等多种搜索引擎
对话时可实时联网搜索，获取最新信息

2.4 模型构建器

基于 Ollama 基础模型直接在 Web 界面上创建自定义模型
自定义角色设定、系统提示词、推理参数（temperature、top_p 等）
通过 Open WebUI Community 导入社区分享的模型配置

2.5 多模态支持

图像生成：集成 AUTOMATIC1111（Stable Diffusion）、ComfyUI、DALL-E 等
语音/视频通话：内置免提语音和视频通话功能，实现动态交互

2.6 企业级管理功能

RBAC 权限控制：细粒度的用户角色和权限管理
用户组管理：支持创建和管理用户组，简化团队协作
审计追踪：记录模型调用和文档操作，支持事后分析与合规审查

2.7 其他特性

响应式设计：完美适配桌面 PC、笔记本、平板和手机
PWA 支持：移动设备上可"安装"为原生应用，支持离线访问
完整 Markdown/LaTeX：支持公式渲染，适合技术文档交流
多语言支持：通过 i18n 国际化支持多种语言（含中文）
管道（Pipelines）框架：模块化插件系统，支持自定义扩展

三、Windows 下安装 Open WebUI

3.1 前置条件

在安装 Open WebUI 之前，需要先安装：

Ollama（或其他 LLM 后端）— 用于运行大模型
Docker Desktop for Windows — Open WebUI 官方推荐安装方式

为什么推荐 Docker？

安装简单，一条命令搞定，无需关心 Python 版本和依赖

环境完全隔离，不影响系统

更新、卸载都非常方便

3.2 安装 Docker Desktop

第 1 步：下载 Docker Desktop

访问官网：https://www.docker.com/products/docker-desktop/

点击 "Download for Windows" 下载安装包。

第 2 步：安装 Docker Desktop

双击安装程序，按提示完成安装。安装过程中会提示启用 WSL 2（Windows Subsystem for Linux），请选择"是"。

安装完成后，Docker Desktop 会自动启动，在系统托盘中显示图标。

第 3 步：验证安装

打开 PowerShell 或 CMD，输入：

docker --version

如果显示版本号，说明安装成功。

国内镜像加速（可选）：
在 Docker Desktop → Settings → Docker Engine 中，添加以下镜像源：
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

3.3 安装 Open WebUI

方式一：Docker 一键安装（推荐）

打开 PowerShell 或 CMD，执行以下命令：

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

命令参数说明：

参数	说明
`-d`	后台运行容器
`-p 3000:8080`	将容器的 8080 端口映射到主机的 3000 端口
`--add-host=host.docker.internal:host-gateway`	使容器能访问主机上的 Ollama 服务
`-v open-webui:/app/backend/data`	数据持久化，容器删除后数据不丢失
`--name open-webui`	指定容器名称
`--restart always`	设置 Docker 启动时自动重启容器

方式二：使用 Docker Compose（推荐用于生产环境）

新建 docker-compose.yml 文件：

version: '3.8'

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    extra_hosts:
      - "host.docker.internal:host-gateway"
    restart: always

volumes:
  open-webui:

在文件所在目录执行：

docker-compose up -d

方式三：内置 Ollama 的 Docker 镜像

如果不想单独安装 Ollama，可以使用内置 Ollama 的镜像：

docker run -d -p 3000:8080 -v open-webui:/app/backend/data -v ollama:/root/.ollama --name open-webui-ollama --restart always ghcr.io/open-webui/open-webui:ollama

使用 :cuda 标签镜像可支持 NVIDIA GPU 加速。

方式四：pip 安装（无需 Docker）

如果不想安装 Docker，也可以直接通过 pip 安装 Open WebUI。这种方式适合 Python 开发者，直接在本地运行。

pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple open-webui

安装完成后，在命令行中启动：

open-webui serve

启动后打开浏览器访问 http://localhost:8080 即可使用。

pip 安装方式不需要 Docker，但需要 Python 3.11+ 环境，且数据存储在本地文件系统中。

3.4 初始化配置

第 1 步：访问界面

打开浏览器，访问：http://localhost:3000

第 2 步：注册管理员账号

首次访问时会进入注册页面，填写用户名、邮箱、密码，创建管理员账号。

这是本地管理员账号，信息完全存储在本地，不会上传到任何远程服务器。

第 3 步：连接 Ollama 后端

登录后进入设置页面，在"连接"或"模型提供商"中：

如果使用 Docker 单独安装的 Open WebUI + 主机上的 Ollama，Ollama 地址填：
```
http://host.docker.internal:11434
```
如果使用内置 Ollama 的镜像（:ollama 标签），则无需额外配置
如果 Ollama 和 Open WebUI 都安装在同一台 Windows 主机上（非 Docker），地址填：
```
http://localhost:11434
```

第 4 步：开始使用

连接成功后，左侧模型列表会显示 Ollama 中已下载的模型。选择一个模型，即可开始对话。

四、基本使用指南

4.1 界面概览

区域	功能
左侧边栏	模型选择、对话历史列表、新建对话
顶部工具栏	切换模型、开启 Web 搜索、管理文档
底部输入框	输入消息，支持 Markdown
右侧面板	工作空间（文档管理、模型构建）

4.2 基本对话

在左侧选择要使用的模型
在底部输入框中输入问题，按 Enter 发送
模型回复会以流式方式实时显示

4.3 使用 RAG（文档问答）

点击右侧面板 → "工作空间" → "文档"
点击"上传文档"，选择 PDF、Word 等文件
在聊天输入框中输入 # 后选择文档库
输入问题，模型会基于文档内容回答

4.4 Web 搜索

在对话开始前，点击顶部工具栏的"Web 搜索"按钮（地球图标），开启后模型的回答会结合实时搜索结果。

4.5 创建自定义模型

点击右侧面板 → "工作空间" → "模型"
点击"创建模型"
选择基础模型、设置系统提示词、调整参数
保存后即可在对话中选择使用

五、常见问题

Q：Open WebUI 和 Ollama 是什么关系？

Ollama 是后端引擎，负责在本地运行大模型；Open WebUI 是前端界面，为 Ollama 提供 Web 图形界面。两者可以配合使用，也可以独立使用（Open WebUI 支持连接其他后端）。

Q：访问 http://localhost:3000 打不开怎么办？

检查 Docker 容器是否正常运行：docker ps。如果没有列出 open-webui 容器，检查 Docker Desktop 是否启动，或重新运行安装命令。

Q：Open WebUI 能连上但看不到模型？

检查 Open WebUI 设置中的 Ollama 连接地址是否正确。如果使用 Docker 安装的 Open WebUI 连接主机上的 Ollama，地址应为 http://host.docker.internal:11434。

Q：如何升级 Open WebUI？

docker stop open-webui
docker rm open-webui
docker pull ghcr.io/open-webui/open-webui:main
# 重新运行安装命令

数据存储在卷中，升级后不会丢失。

Q：Open WebUI 能否多人同时使用？

可以。在同一局域网内，其他人通过 http://你的IP地址:3000 访问，注册账号后即可使用。管理员可以设置权限控制。

Q：如何让局域网其他设备访问？

确保 Windows 防火墙放行了 3000 端口，其他设备通过 http://你的电脑IP:3000 访问。如需外网访问，建议配置反向代理（Nginx/Caddy）并开启 HTTPS。

六、适用场景

场景	说明
个人知识助手	上传技术文档、书籍 PDF，构建个人知识库，随时问答查询
团队协作	多人共享同一平台，管理层访问权限，审计追踪
企业数据安全	数据完全本地化，满足金融、医疗等行业的隐私合规要求
开发测试	快速切换不同模型对比效果，调试 Prompt
教育与科研	支持 LaTeX 公式，适合学术论文辅助写作
内容创作	结合图像生成插件，实现文案 + 配图一体化创作

七、生态集成

Open WebUI Community：https://openwebui.com/ — 分享和下载社区模型配置
Pipelines：模块化插件框架，支持自定义逻辑和 Python 库集成
LangChain：可作为 LangChain 应用的前端界面
n8n：工作流自动化工具，可与 Open WebUI API 集成

八、学习资源

官方网站：https://openwebui.com
GitHub 仓库：https://github.com/open-webui/open-webui
官方文档：https://docs.openwebui.com
Docker 镜像：ghcr.io/open-webui/open-webui:main

posted @ 2026-05-26 13:38 PrintY 阅读(42) 评论(0) 收藏举报

刷新页面返回顶部

PrintY

天再高又如何，踮起脚我就能靠近太阳！