在绿联NAS上搭建 Open WebUI 部署阿里通义千问大语言模型

2025/02/08

1、应用简介

Open WebUI 是一个可扩展、功能强大且用户友好的自托管 Web 界面，旨在完全离线运行。它适合开发者、研究人员以及对隐私敏感的个人或团队，支持多种 LLM 运行框架，包括 Ollama 和 OpenAI 兼容的 API。更多详情请查阅 Open WebUI 官方文档。

1.1 Open WebUI 的主要特点

轻松设置：支持 Docker 和 Kubernetes 安装，提供便捷的映像管理。
API 集成：兼容 Ollama 和 OpenAI API，自定义 API URL，适配多个 LLM 服务如 LMStudio 和 OpenRouter。
精细权限管理：支持角色与权限分组，确保用户安全并优化管理体验。
响应式设计：适配台式机、笔记本和移动设备，支持 PWA 离线使用。
Markdown 和 LaTeX 支持：丰富的格式功能，提升交互体验。
免提语音/视频通话：支持动态实时对话。
模型生成器：通过界面轻松创建和自定义模型。
原生 Python 调用：集成代码编辑器，轻松扩展 LLM 功能。
RAG 集成：支持文档交互和检索增强生成。
网页搜索与浏览：整合搜索引擎结果和网页内容到对话中。
图像生成：支持 AUTOMATIC1111 API 和 OpenAI DALL-E 等。
多模型对话：并行利用多个模型提升交互效率。
基于角色的访问控制（RBAC）：确保模型和数据的安全访问。
多语言支持：支持多种语言，欢迎用户贡献翻译。
插件与 Pipelines 集成：支持自定义逻辑和功能扩展。
持续更新：定期发布新功能和修复。

2、使用 Docker Compose 部署容器

在 UGOS Pro 系统上，推荐使用项目 Docker Compose 快速部署容器，适合需同时管理多个容器的场景，这种方法简化了容器的部署与管理工作。以下是使用 Docker Compose 部署 Open WebUI 的详细步骤。

点击了解：什么是项目（Docker Compose）？

2.1 进入 Docker 项目界面

在 UGOS Pro 系统中，打开 Docker 应用，点击【项目】 > 【创建】，启动项目创建向导。

2.2 配置 Docker Compose 文件

在项目创建向导中，上传以下 Open WebUI 的 Docker Compose 配置文件：

services:
  open-webui:
    container_name: open-webui
    image: ghcr.io/open-webui/open-webui:ollama # 镜像名
    restart: always # 重启策略
    ports:
      - 3000:8080 # Web 服务访问端口
    volumes:
      - ./ollama:/root/.ollama # 存储与 ollama 相关的数据
      - ./open-webui:/app/backend/data # 存储 Web UI 的后台数据

2.3 参数说明

image：指定使用的 Docker 镜像版本（此处为 ollama）。

restart：容器重启策略，always表示当容器停止或崩溃时自动重启。

ports：Web 服务访问端口，将 NAS 的 3000 端口映射到容器的 8080 端口。

volumes：映射 NAS 文件目录到容器路径。

./ollama:/root/.ollama：NAS 存储空间目录 ./ollama 映射到容器内部路径 /root/.ollama，用来存储与 ollama 相关的数据，冒号前面是 NAS 的存储空间内存放路径。

./open-webui:/app/backend/data：NAS 存储空间目录 ./open-webui 映射到容器内部路径 /app/backend/data，用来存储 Web UI 的后台数据文件。

注意：

./ 表示当前 Docker Compose 文件所在的目录；
冒号前是 NAS 的存储路径，冒号后是容器内的映射路径。

2.4 部署项目

上传配置文件后，点击【立即部署】，系统会自动拉取镜像并启动容器。

部署完成后，通过浏览器访问以下地址进入 Open WebUI 界面：

http://<NAS_IP>:3000

请将 <NAS_IP> 替换为 NAS 的实际 IP 地址，例如：http://192.168.22.153:3000。

镜像下载失败处理方法：

Docker 镜像加速器：建议配置加速器以提高下载速度，特别是在中国内地的网络环境下。参考《Docker配置镜像加速和镜像源》了解如何设置。

代理设置：在某些情况下，您可能需要配置 HTTP/HTTPS 代理来辅助下载，详见《Docker通过设置代理下载镜像》。

3、使用指南

要访问 Open WebUI 的 Web 界面，请按照以下步骤操作：

打开浏览器，访问部署地址，进入登录页面。

初次访问需创建管理员账号，设置用户名、邮箱及密码。

使用新建的账号登录。

注意：部署后刚访问页面可能会提示内部错误或拒绝连接，请等待几分钟加载页面。

3.1 界面空白问题的解决方案

初次登录 Open WebUI 时您会遇到界面空白的情况。这是因为系统在后台等待 OpenAI 模型的返回数据时产生了延迟。如果您不希望等待加载过程，可以通过关闭 OpenAI API 来解决该问题。请注意，关闭 OpenAI API 需要在首次加载界面成功后进行。

解决步骤：

首次登录时，系统会尝试连接 OpenAI 模型并加载相关数据，可能会出现短暂的空白界面。请耐心等待直到加载成功。
登录并加载完成后，进入管理员面板。
在管理员面板中，点击左侧菜单中的设置。
在设置页面中，选择外部连接选项。
在“外部连接”设置页面，您会看到 OpenAI API 的配置项。
将 OpenAI API 选项关闭。关闭后下次 Open WebUI 将不会再等待 OpenAI 模型的返回数据。

您还可以通过查看相关日志文件来判断加载过程是否正常进行。具体操作是：

进入 UGOS Pro 的 Docker 应用。
点击【容器】 > 选中 Open WebUI 容器 > 点击【日志】。
查看日志中是否有模型加载的进度信息，如 "get_all_models" 或"Loading models"等相关提示。如果日志显示正常加载，请稍等几分钟后刷新界面；若出现错误提示，可根据日志信息排查问题。