README

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



!GitHub stars
!GitHub forks
!GitHub watchers
!GitHub repo size
!GitHub language count
!GitHub top language
!GitHub last commit



探索 Open WebUI →

 安装

 Python

需要 Python 3.12。

bash
pip install open-webui
open-webui serve


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

 Docker

bash
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 创建。

Top issues

Discussions

Latest release

Fixed

- 🔓 Chat over plain HTTP. Opening Open WebUI over plain HTTP at a LAN or Docker address now loads new and existing chats instead of staying on a spinner with "crypto.randomUUID is not a function". 33919
- 📝 Comments and Markdown editing over plain HTTP. Creating, replying to and editing comments, and editing Markdown files containing rendered blocks such as Mermaid diagrams or callouts, no longer fail with the same UUID error. Commit
- 🎛️ Side Chat permission switch. The Allow Side Chat switch is now visible even when Temporary Chat is off, so administrators can configure the two permis