open-webui/README.zh.md

Open WebUI

Open WebUI 是 AI 的家：一个可扩展、易于使用的自托管平台，支持完全离线运行。通过 Ollama 连接本地模型，或使用兼容 OpenAI 的 API 连接本地和云端模型。

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

探索 Open WebUI →

安装

Python

需要 Python 3.12。

pip install open-webui
open-webui serve

然后打开 http://localhost:8080。

Docker

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

然后打开 http://localhost:3000。

镜像标签	内容
:main	包含本地 AI 依赖的标准镜像
:slim	轻量镜像，通过外部服务处理嵌入、文档提取和语音
:cuda	支持 CUDA 加速的 Open WebUI
:ollama	内置 Ollama 的 Open WebUI
:dev	最新开发版本

根据需要，在 docker run 的镜像名称前添加以下选项：

选项	用途
-e OLLAMA_BASE_URL=http://your-ollama-server:11434	连接另一台服务器上的 Ollama
-e OPENAI_API_KEY=your_secret_key	设置 OpenAI API 密钥
-e HF_HUB_OFFLINE=1	禁用 Hugging Face 模型下载，以便离线使用
--gpus all	为 :cuda 或 :ollama 启用 Nvidia GPU 访问；需要 Nvidia Container Toolkit

安装步骤和配置选项请参阅 Docker 安装指南。

桌面应用

下载原生桌面应用，支持 macOS、Windows 和 Linux。

阅读文档 →

生态系统

• Open Terminal / Terminals (Enterprise): 为 Open WebUI 提供执行能力，使其成为完整的智能体运行框架，并通过企业级编排为每位用户管理独立工作空间。
• Knowledge Base Sync (oikb): 通过增量同步，将文件夹、代码仓库、存储桶和 Wiki 镜像到 Open WebUI 知识库。
• Open WebUI Computer: 在任意浏览器中使用你的电脑：文件、编辑器、终端、Git 和可选的 AI 智能体，均在你的真实机器上运行。

详情请参阅生态系统文档。

故障排查与更新

连接问题请参阅故障排查指南，更新安装请参阅更新指南。

文档

配置和使用方法请参阅文档，计划中的工作请参阅路线图。

Docker Compose、Kubernetes 及其他部署方式请参阅安装文档。

支持

提交 Issue 或发起讨论。

也可以在 Reddit、X 和 Discord 找到我们。

安全

请通过 GitHub 安全公告私下报告漏洞。安全报告仅通过 GitHub 接收。

Star 历史

许可证

包含采用 Open WebUI License 的代码，该许可证要求保留 Open WebUI 品牌标识；此前的贡献仍适用各自的原始许可证。条款和历史请参阅 LICENSE 和 LICENSE_HISTORY。

企业版 · 招聘 · 赞助

由 Timothy Jaeryang Baek 创建。