项目介绍
Open WebUI 将本地模型或远程 API 接入统一对话界面。前端自托管并不意味着所有推理都留在本机,实际数据流向由所连接的模型服务决定。
界面管理会话、模型选择与用户,模型服务负责推理,文档检索和工具则作为扩展能力接入。把这些环节分开配置更容易追踪数据流向。
适合统一使用本地 Ollama 与远程模型。多用户场景先明确注册方式、模型可见范围和管理权限,再开放访问。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 多模型对话 | 选择已连接服务 |
| 会话管理 | 组织与导出聊天记录 |
| 文档检索 | 按配置将资料加入问答 |
| 用户权限 | 控制功能与模型范围 |
| 工具扩展 | 按需添加函数和服务 |
功能示意

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

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | AI 与开发 |
| 项目仓库 | open-webui/open-webui |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 建立持久化数据目录并启动前端,在可信内网完成首个管理员初始化。
- 在管理设置连接 Ollama 或 OpenAI 兼容 API,先测试一轮短对话,再添加文档或工具。
- 检查账号注册、权限与导出功能,外部访问前配置 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。只回退镜像不一定能回退已经迁移过的数据库。