open-webui

Open WebUI 是一个自托管的 AI 平台，定位为“AI 的家”，可完全离线运行，支持 Ollama 和 OpenAI 兼容 API，为用户提供跨本地与云端模型的统一界面。

主要能力

模型与 API 集成

支持连接任何 OpenAI 兼容 API 与本地 Ollama 模型，可将 API URL 指向 LMStudio、GroqCloud、Mistral、OpenRouter、vLLM 等，自由混合搭配不同提供商。

权限与管理

提供细粒度 RBAC 与用户组，管理员可定义角色、组和权限，默认安全，并可为不同组定制体验。

插件与扩展

支持 Filters、Actions、Pipes、Tools、Skills 等插件扩展，可通过 MCP、MCPO、OpenAPI 工具服务器连接外部服务，构建自定义集成、限流、审批流、数据连接等。

模型与智能体

可将任意基础模型包装为带自定义指令、工具和知识的专用智能体，支持动态变量、按用户/组访问控制，并可通过 Open WebUI Community 导入社区预设。

终端与文件系统执行

Open Terminal 为智能体提供终端和文件系统以执行多步任务，可分析数据、运行脚本、修复错误并在对话中直接产出文件。Terminals（Enterprise）支持按用户隔离环境、资源限制和自动生命周期管理。

笔记、频道与记忆

Notes 提供独立工作区，可用富编辑器起草，并用 AI 重写选中文本，还可将笔记附加到任意对话。Channels 是团队与 AI 模型协作的实时共享空间，支持线程、反应、置顶和访问控制。持久记忆让 AI 跨对话记住用户事实并延续上下文。

工作流与自动化

实时展示 AI 构建和完成清单的过程，可在 AI 响应时排队消息并自动发送。内置个人与共享日历，支持月/周/日视图、重复事件、颜色编码、参与者和提醒，模型可通过原生函数调用对话式管理日程。Automations 支持按重复计划运行提示，运行记录显示在日历中并链接回生成的对话。

交互与多媒体

响应式设计与 PWA 支持桌面、笔记本和移动端，在 localhost 上可离线访问。全面支持 Markdown 和 LaTeX。集成语音和视频通话，支持多种语音转文字提供商（本地 Whisper、OpenAI、Deepgram、Azure）和文字转语音引擎（Azure、ElevenLabs、OpenAI、Transformers、WebAPI）。

存储与数据

内置键值存储 API 用于持久化 artifact，支持个人和共享数据范围的日志、追踪器、排行榜等工具。

本地 RAG 与搜索

检索增强生成由 9 种向量数据库和多种内容提取引擎（Tika、Docling、Document Intelligence、Mistral OCR、PaddleOCR-vl、外部加载器）支持，支持混合搜索（BM25 + 向量）并带重排序和全上下文模式。可通过 # 命令将文档加载到对话或从库中拉取。网络搜索支持数十种提供商，包括 SearXNG、Google PSE、Brave Search、Kagi、Mojeek、Tavily、Perplexity、Firecrawl、serpstack、serper、Serply、DuckDuckGo、SearchApi、SerpApi、Bing、Jina、Exa、Sougou、Azure AI Search 和 Ollama Cloud，并将结果直接注入对话。

图片生成与编辑

支持 OpenAI DALL·E、Gemini、ComfyUI（本地）、AUTOMATIC1111（本地）等多种引擎创建和编辑图片，支持生成和基于提示的编辑。

多模型与分析

可同时对话多个模型，并行发挥各自优势。管理仪表板跟踪用户和模型的消息量、token 消耗和成本，内置竞技场、A/B 测试和 ELO 排行榜评估模型。

数据库与存储

可选择 SQLite（支持可选加密）或 PostgreSQL，文件可存储于本地、S3、Google Cloud Storage 或 Azure Blob Storage。支持 9 种向量数据库：ChromaDB、PGVector、Qdrant、Milvus、Elasticsearch、OpenSearch、Pinecone、S3Vector 和 Oracle 23ai。

企业功能

完整 LDAP/Active Directory 集成，通过可信标头和 OAuth 提供商实现 SSO，支持 SCIM 2.0 自动化配置（Okta、Azure AD、Google Workspace 等）。原生支持 Google Drive 和 OneDrive/SharePoint 文件选择。内置 OpenTelemetry 支持追踪、指标和日志。基于 Redis 的会话管理和 WebSocket 支持多 worker、多节点负载均衡部署。多语言 i18n 支持。

安装方式

Python pip 安装

需使用 Python 3.11 以避免兼容性问题：

pip install open-webui

启动：

open-webui serve

访问 http://localhost:8080

Docker 快速开始

使用 Docker 安装时务必包含 -v open-webui:/app/backend/data 以正确挂载数据库并防止数据丢失。如需包含 Ollama 或 CUDA 加速，推荐使用带 :cuda 或 :ollama 标签的官方镜像。启用 CUDA 需在 Linux/WSL 系统上安装 Nvidia CUDA 容器工具包。

默认配置（Ollama 在本机）：

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

Ollama 在其他服务器：

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Nvidia 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

仅使用 OpenAI API：

docker run -d -p 3000:8080 -e OPENAI_API_KEY=your_secret_key -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

捆绑 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

捆绑 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

安装后访问 http://localhost:3000。其他安装方式包括非 Docker 原生安装、Docker Compose、Kustomize 和 Helm。

故障排查

若出现连接问题，通常是由于 WebUI Docker 容器无法在容器内访问 127.0.0.1:11434（host.docker.internal:11434）的 Ollama 服务器，可在 docker 命令中使用 --network=host 标志解决，端口会从 3000 变为 8080，即 http://localhost:8080。

更新与开发分支

更新指南见官方文档。:dev 分支包含最新不稳定功能和变更，可能存在 bug 或不完整功能，使用风险自负。在离线环境中运行 Open WebUI 时，可设置 HF_HUB_OFFLINE 环境变量为 1 以防止从互联网下载模型。

生态系统

Open WebUI 是核心，周边有配套应用和基础设施：Open WebUI Computer 是独立、移动优先的计算机与编码智能体，在自有机器上运行，文件、终端和 git 可在浏览器标签中访问，也可作为模型连接进 Open WebUI，或从 Telegram、WhatsApp 等访问。Open Terminal 和 Terminals（Enterprise）是自托管计算环境，为 AI 提供编写代码、运行、读取输出、修复错误和迭代的场所，Terminals 提供按用户隔离的容器、独立凭据、资源限制和网络规则，在 Docker 或 Kubernetes 上自动生命周期管理。oikb 可从 45+ 来源（GitHub、Confluence、ServiceNow、Salesforce、Jira、Slack、SharePoint、Notion 等）同步知识库。原生桌面应用支持 macOS、Windows 和 Linux，提供系统级 Spotlight 聊天栏、截图捕获、按键说话语音，并可通过内置 llama.cpp 引擎实现完全本地推理。

许可证

本项目包含多许可证下的代码，当前代码库包括 Open WebUI License 下的组件（附加保留“Open WebUI”品牌的要求），以及先前贡献者在其各自许可下的贡献。