Open WebUI：人人可用的高级 AI 对话客户端

• Open WebUI 官网：https://openwebui.com

• 项目主页：https://github.com/open-webui/open-webui

广告：

1. 本站提供外币代付服务（ChatGPT Plus/Team/API、Claude 等代充）

2. 本站提供 API 中转服务：ZetaTechs API（ChatGPT、Claude、Gemini、MidJourney绘图等）

我知道 Open WebUI 这个项目倒也有段时间了，但是之前它叫 Ollama WebUI，而我自己的电脑性能太差，部署了本地模型跑起来很慢，就没考虑过本地部署，也就顺带着忽略了带着 Ollama 名字的这个项目。

但是前几天我看到 1Panel 里面的应用商店里有这个项目，既然一键安装，那我就顺手安装上试试，抱着这样的心态，我打开了这个项目的 Web 界面，才发现这么久以来，自己一直错过了一个好项目。

1. 主要功能

老规矩，先介绍该项目的主要功能和特色：

1. 几乎 1:1 复刻 ChatGPT 网页版界面及功能，包括文档分析和 GPTs。

2. 应用市场：相当于 ChatGPT 的 GPTs Store，包括四类：模型（Models）、提示词（Prompts）、工具（Tools）、函数（Function）。

其中，各类应用均可以自己创建和开发，之后还可以上传共享到 Open WebUI 的应用市场，所有用户也均可免费从应用市场获取网友分享的应用。

二. 前期准备

• 系统：Linux、MacOS、Windows 均可，使用 Docker 安装。注意：使用 OpenAI 官方 API 或者有外网访问需求的用户，推荐使用国外服务器，方便直连 OpenAI 官网和域名解析（服务器在国内需要备案才能解析并绑定域名）；使用第三方 API 服务可本地部署。

• OpenAI API Key（官方或第三方均可），获取方式包括但不限于：【OpenAI 官方】、【本站自营低价 API】

三. Open WebUI 一键部署

本教程采用 docker-compose 安装方法，因为此方法非常简单，复制命令一键运行即可全自动安装好。

这个软件分了两个部分，官方默认给的只有 Open WebUI，另一个 Pipeline 需要单独部署，我把这俩整合在一起了，可以一键部署。

本地部署和服务器部署都可以，我个人更喜欢在服务器上部署。因为现在国内家庭网络很难获取公网IP，而国外服务器便宜的一年一两百，加个几块钱一年的域名，可以随时在外网访问，不受本地部署的局域网限制。

一台服务器也可以部署多个服务，有很多其他的应用都可以部署在公网服务器上，比如密码管理、自动签到等，家里一台电脑 24h 开机，一年电费就不少了，这种轻度但是需要一直开机的服务就可以部署在服务器上。

3.1 Linux 服务器一键部署 Open WebUI

这里以 1Panel 面板为例，如果你使用的是宝塔面板也完全没问题，安装好 Docker 和 Docker-compose 环境即可。1Panel 在安装过程中已经安装好了环境，而宝塔也能在面板里一键安装。

1Panel 的应用商店里也有 Open WebUI，但是还缺一个配套的应用，所以我们还是直接自己另外部署吧。

3.1.1 创建配置文件夹

首先创建一个文件夹，用来放你的配置文件，这个看个人习惯，我一般在根目录下创建一个appdata文件夹，然后再在这个文件夹里创建对应应用名称的文件夹，比如 Open WebUI 这个项目，我就创建open-webui这个文件夹。

3.1.2 创建 docker-compose.yml 文件

第二步是创建一个名为docker-compose.yml的文件，内容如下：

services:
  open-webui:
    build:
      context: .
      args:
        OLLAMA_BASE_URL: '/ollama'
      dockerfile: Dockerfile
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    volumes:
      - ./app/backend/data:/app/backend/data
      - ./data/docs:/data/docs
    ports:
      - 3005:8080
    restart: unless-stopped
    networks:
      - open-webui

  pipelines:
    image: ghcr.io/open-webui/pipelines:main
    container_name: open-webui-pipelines
    restart: always
    ports:
      - "9099:9099"
    volumes:
      - ./app/pipelines:/app/pipelines
    extra_hosts:
      - "host.docker.internal:host-gateway"
    networks:
      - open-webui

networks:
  open-webui:

3.1.3 一键部署

最后一键部署就行了，非常简单，需要输入的命令如下：

docker-compose up -d

具体操作：点击文件目录下方的【终端】按钮，在命令行界面输入上方的命令，按Enter执行即可自动下载 Docker 镜像并安装。

安装过程为全自动，Open-WebUI 的镜像比较大，总共有 6.5GB 左右，会耗费较长时间。

安装完成会提示你容器已启动（Started）：

如果端口被占用或者其他原因，会在这里发出报错内容，看不懂可以发给 AI 帮你解答，或者加本站的【交流群】咨询。

3.1.4 程序启动

显示 Started 说明 Open WebUI 已经启动了，我们打开左侧菜单栏的【容器】页面，找到对应的应用：

这里安装了两个容器，我们需要访问的是open-webui这个容器的 web 界面。

如果点击后系统提示你绑定服务器IP，就按系统提示操作。

3.2 Windows/MacOS 一键部署 Open WebUI

Windows 和 MacOS 上的安装方法相同，都是安装 Docker Hub 官方应用：【下载地址】（需要魔法）

我这没有 MacOS，没法演示，但是操作思路是一样的。

选择下载和安装跟你电脑对应的版本即可，需要注意的是，Windows 电脑要先在【任务管理器】—【CPU】—中确认【虚拟化】是否已经开启。

如果显示已禁用，可以在BIOS中开启，笔记本和台式电脑都可以开，具体操作步骤请网上搜索关键词：电脑/主板型号 + BIOS开启CPU虚拟化。

3.2.1 下载及安装 Docker Desktop

打开 Docker Hub 官方应用【下载地址】（需要魔法），下载对应版本后即可直接安装：

3.2.2 创建 docker-compose.yml 文件

第二步和 Linux 安装一样，首先创建一个文件夹，用来放你的配置文件，这个看个人习惯，我一般在根目录（可以放在 D 盘）下创建一个appdata文件夹，然后再在这个文件夹里创建对应应用名称的文件夹，比如 Open WebUI 这个项目，我就创建open-webui这个文件夹。

然后创建一个名为docker-compose.yml的文件，内容如下：

services:
  open-webui:
    build:
      context: .
      args:
        OLLAMA_BASE_URL: '/ollama'
      dockerfile: Dockerfile
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    volumes:
      - ./app/backend/data:/app/backend/data
      - ./data/docs:/data/docs
    ports:
      - 3005:8080
    restart: unless-stopped
    networks:
      - open-webui

  pipelines:
    image: ghcr.io/open-webui/pipelines:main
    container_name: open-webui-pipelines
    restart: always
    ports:
      - "9099:9099"
    volumes:
      - ./app/pipelines:/app/pipelines
    extra_hosts:
      - "host.docker.internal:host-gateway"
    networks:
      - open-webui

networks:
  open-webui:

3.2.3 一键部署

最后一键部署就行了，非常简单，需要输入的命令如下（分两次输入）：

cd C:\appdata\open-webui # 后面的路径换成存放 yml 文件的路径

docker-compose up -d

具体操作：开始菜单右键，打开【Windows PowerShell】或【Windows 终端】，在命令行界面输入上方的命令，按Enter执行即可自动下载 Docker 镜像并安装。

安装过程为全自动，Open-WebUI 的镜像比较大，总共有 6.5GB 左右，会耗费较长时间。

安装过程有点长，大家可以打开我的 B站 和 Youtube 主页，看看视频点点赞，别盯着屏幕看。

至此，Open WebUI 就安装完成了，接下来是使用教程。

四. Open WebUI 使用教程

4.1 初始化

刚安装完成，打开首页需要手动注册一个账号，第一个注册的账号为管理员账号。

4.2 API 接口配置

无论你是使用 OpenAI 官方接口，还是第三方中转站的接口，都需要单独设置接口地址，而且还不止一个地方要设置，这一点还挺麻烦的，同一个参数要在好几个地方重复填。

打开管理员面板，然后一个个操作填写就行，每个页面设置完了记得保存。

网络搜索引擎选duckduckgo和jina无需额外设置。

pipeline 的地址根据容器名，按照下面的格式填：

http://open-webui-pipelines:9099
或
http://pipelines:9099

第一步设置好后即可使用对话功能，其他的均为可选操作。

4.3 GPTs、插件、函数调用

Open WebUI 的对话内容保存在服务器上，登录后即可访问所有历史对话。

但是这还不是它的特色，更厉害的一个地方是，它有自己的应用市场，和 ChatGPT 的 GPTs Store 一样，并且是免费无门槛开放，gpt-3.5-turbo 这些入门模型也能够使用。

模型、提示词、工具（插件）和函数的模板获取方法相同，这里以模型为例。

4.4 文档分析

Open WebUI 还有一个特色功能，就是文档分析，文档分析需要用到向量模型。

软件内置了向量模型，本地运算需要耗费性能，如果你的服务器的性能很低，可以用 API 调用在线的向量模型，设置方法在 4.2 ③。

4.5 语音对话

还有一个比较有特色的功能是语音对话，跟 ChatGPT 官方 APP 的对话一样，Open WebUI 把它做到了网页上。

设置好语音结束自动发送、自动文字转语音后，就和 ChatGPT 官方 APP 的语音对话体验差不多了，具体效果取决于你的网络。

语音的模型也是可以选择用本地还是 OpenAI 的在线 TTS 模型。

OpenAI TTS 可选音色：alloy、echo、fable、onyx、nova、shimmer

4.6 添加为手机应用

Open WebUI 支持 Progressive Web App (PWA) ，也就是说我们可以把它的网页添加为手机应用形式打开。

以 iOS 为例，Safari 打开网页，点击共享按钮，选择添加到主屏幕，即可固定为手机 APP：

4.7 其他功能

Open WebUI 可选项非常多，包括 ChatGPT 有的自定义指令、记忆功能等，都是免费的。

过多的这里就不赘述了，它的中文化界面做的很好，各项功能描述的也清晰明了，各位可自行探索。

各位读者或观众有什么不懂的可以加QQ交流群：933145038