在AI大模型应用普及的今天，本地化部署大模型成为越来越多人的选择。而Open WebUI作为一款开源、自托管的AI平台，正逐渐成为本地大模型交互的首选界面。

nerror="javascript:errorimg.call(this);">

Open WebUI简介

Open WebUI是一个可扩展、功能丰富且用户友好的自托管AI平台，专为完全离线运行设计。它支持多种LLM（大语言模型）运行器，如Ollama和OpenAI兼容API，并内置了RAG（检索增强生成）推理引擎，使用户能够轻松与本地模型交互，无需依赖互联网。

"Open WebUI is an extensible, feature-rich, and user-friendly self-hosted AI platform designed to operate entirely offline."（Open WebUI是一个可扩展、功能丰富且用户友好的自托管AI平台，设计为完全离线运行。）

Open WebUI优势

1. 无缝集成多种模型运行器

Open WebUI不仅支持Ollama，还能轻松集成OpenAI API、LMStudio、GroqCloud、Mistral、OpenRouter等服务，让你在同一个界面中使用多种模型，无需切换不同平台。

2. 企业级安全与权限管理

• 细粒度权限控制：管理员可创建详细用户角色和权限
• SCIM 2.0支持：与Okta、Azure AD、Google Workspace等身份提供商无缝集成
• 基于角色的访问控制(RBAC)：确保只有授权人员能访问Ollama，管理员可控制模型创建/拉取权限

3. 丰富的交互功能

• 响应式设计：在桌面、笔记本和移动设备上提供一致体验
• PWA移动应用：提供类似原生应用的移动体验，支持离线使用
• Markdown和LaTeX支持：增强LLM交互体验
• 语音/视频通话：集成免提语音和视频通话功能
• 模型构建器：通过Web UI轻松创建Ollama模型
• 本地RAG集成：直接加载文档到聊天中，使用#命令访问
• Web搜索RAG：支持SearXNG、Google PSE、Brave Search等
• 图像生成集成：支持AUTOMATIC1111 API、ComfyUI和OpenAI的DALL-E

4. 开发者友好

• Pipelines插件框架：集成自定义逻辑和Python库
• 本地Python函数调用：增强LLM功能，支持纯Python函数
• 多模型对话：同时与多种模型交互，发挥各自优势

安装部署指南

Open WebUI提供了多种安装方式，以下是最推荐的两种方法：

1. Docker安装（推荐）

Docker是Open WebUI最简单、最稳定的安装方式。以下是几种常用场景的安装命令：

基本安装（无GPU支持）

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

GPU加速支持

docker run -d -p 3000:8080 --gpus all --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:cuda

集成Ollama（推荐）

# GPU支持docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama# CPU支持docker run -d -p 3000:8080 -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

重要提示：-v open-webui:/app/backend/data是必须的，它确保数据库正确挂载，防止数据丢失。

安装完成后，访问http://localhost:3000即可使用。

2. Python pip安装

如果你更喜欢使用Python环境，可以使用pip安装：

# 安装Open WebUIpip install open-webui# 启动服务open-webui serve

默认情况下，Open WebUI将运行在http://localhost:8080。

注意：确保使用Python 3.11，这是官方推荐的版本。Python 3.12可能工作但未经过充分测试，Python 3.13不推荐使用。

nerror="javascript:errorimg.call(this);">

3. 更新Open WebUI

使用Docker时，推荐使用Watchtower自动更新：

# 手动更新docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --run-once open-webui# 自动更新（每5分钟检查一次）docker run -d --name watchtower --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --interval 300 open-webui

高级功能使用示例

1. 使用RAG功能

在聊天中直接加载文档：

• 上传文档到"文档库"
• 在聊天中使用#命令访问文档：#我的文档.txt

2. Web搜索集成

在聊天中使用#命令进行Web搜索：

#https://example.com

或者使用指定的搜索提供商：

#google:最新AI新闻

3. 集成Ollama模型

安装后，Open WebUI会自动检测到Ollama服务。你可以在界面中直接选择模型，无需额外配置。

nerror="javascript:errorimg.call(this);">

4. 使用Pipelines插件

Pipelines是Open WebUI的扩展框架，允许你集成自定义逻辑。例如，设置OpenAI URL为Pipelines的URL，即可使用Pipelines提供的功能。

随着AI技术的不断发展，Open WebUI也在持续进化，为用户提供更强大的功能和更流畅的体验。如果你正在寻找一个强大、易用且开源的本地大模型Web界面，Open WebUI无疑是目前最佳的选择。