AI 与开发

Open WebUI:自托管模型对话界面

  • 0 次阅读
  • 0 条评论
文章摘要

Open WebUI 将本地模型或远程 API 接入统一对话界面。前端自托管并不意味着所有推理都留在本机,实际数据流向由所连接的模型服务决定。 界面管理会话、模型选择与用户,模型服务负责推理,文档检索和工具则作为扩展能力接入。把这些环节分开配置更容易追踪数据流向。 适合统一使用本地 Ollama 与远程模型。多用户场景先明确注册方式、模型可见范围和管理权限,再开放访问。

项目介绍

Open WebUI 将本地模型或远程 API 接入统一对话界面。前端自托管并不意味着所有推理都留在本机,实际数据流向由所连接的模型服务决定。

界面管理会话、模型选择与用户,模型服务负责推理,文档检索和工具则作为扩展能力接入。把这些环节分开配置更容易追踪数据流向。

适合统一使用本地 Ollama 与远程模型。多用户场景先明确注册方式、模型可见范围和管理权限,再开放访问。

核心功能

功能 作用与使用方式
多模型对话 选择已连接服务
会话管理 组织与导出聊天记录
文档检索 按配置将资料加入问答
用户权限 控制功能与模型范围
工具扩展 按需添加函数和服务

功能示意

Open WebUI 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

Open WebUI 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目 说明
类型 Docker
分类 AI 与开发
项目仓库 open-webui/open-webui
官方入口或文档 直接访问
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 建立持久化数据目录并启动前端,在可信内网完成首个管理员初始化。
  2. 在管理设置连接 Ollama 或 OpenAI 兼容 API,先测试一轮短对话,再添加文档或工具。
  3. 检查账号注册、权限与导出功能,外部访问前配置 HTTPS 和应用鉴权。

首次使用与操作检查

先用一个模型完成短对话,再上传无敏感信息的小文档检查引用。创建普通账号验证其权限和可见内容。

前端正常但模型不可用先查后端地址。开启外部 API、网页检索或工具后,分别检查调用日志,不能默认所有内容都留在本机。

Docker Compose

以下为整理后的配置示例。使用前替换目录、端口和凭据;浮动镜像标签会随上游变更,正式使用时应记录实际镜像摘要。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/open-webui/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/open-webui /volume1/docker/open-webui/data
cd /volume1/docker/open-webui
HALO_PREPARE
cd /volume1/docker/open-webui
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    restart: unless-stopped
    ports:
      - "3000:8080"
    volumes:
      - /volume1/docker/open-webui/data:/app/backend/data

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 示例 main 为浮动标签,正式使用应选择并记录经自己验证的发行版本或镜像摘要。
  • 当前许可与品牌条款要以实际版本为准,不沿用旧文章统一的 Apache-2.0 描述。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

备份 data、模型连接设置和需要保留的会话;模型文件由对应后端另行备份。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

参考资料