Open WebUI

Open WebUI 是一个可扩展、功能丰富且用户友好的自托管AI平台，专为完全离线运行而设计。 它支持多种LLM运行器，如 Ollama 和 兼容OpenAI的API，并内置了用于RAG的推理引擎，使其成为一个强大的AI部署解决方案。

使用 Docker 快速启动 🐳

如果你的电脑上已经安装了 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

要运行带有 Nvidia GPU 支持的 Open WebUI，请使用以下命令：

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 的 Open WebUI

这种方法使用一个单一的容器镜像，将 Open WebUI 和 Ollama 打包在一起，通过一条命令即可实现简洁的设置。根据你的硬件配置选择合适的命令：

• 带 GPU 支持： 通过以下命令利用 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 版本： 如果你不使用 GPU，请使用以下命令：

  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

这两种命令都能让你快速安装和启动 Open WebUI 和 Ollama，确保你可以迅速开始使用。

安装完成后，你可以在 http://localhost:3000 访问 Open WebUI。尽情享受吧！ 😄

使用开发分支 🌙

注意

:dev 分支包含最新的不稳定功能和更改。使用时请注意，它可能存在漏洞或未完成的功能。

如果你想尝试最新的前沿功能，并且不介意偶尔的不稳定，可以使用 :dev 标签，如下所示：

docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:dev

更新 Open WebUI

要轻松更新 Open WebUI 容器，请按照以下步骤操作：

手动更新

使用 Watchtower 手动更新 Docker 容器：

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

🔧 注意：如果容器名称不同，请将其替换为实际的容器名称。

手动安装

使用 pip 安装

对于使用 Python 包管理器 pip 安装 Open WebUI 的用户，强烈建议使用 uv 或 conda 等 Python 运行时管理工具。这些工具有助于有效管理 Python 环境，避免冲突。

Python 3.11 是开发环境。Python 3.12 看起来可以工作，但尚未经过充分测试。Python 3.13 完全未经测试——使用需自行承担风险。

1. 安装 Open WebUI：

   打开终端并运行以下命令：

   pip install open-webui

2. 启动 Open WebUI：

   安装完成后，使用以下命令启动服务器：

   open-webui serve

更新 Open WebUI

要更新到最新版本，只需运行：

pip install --upgrade open-webui

这种方法会安装所有必要的依赖项并启动 Open WebUI，提供简单高效的设置方式。安装完成后，你可以在 http://localhost:8080 访问 Open WebUI。尽情享受吧！ 😄

其他安装方法

我们还提供了多种其他安装选项，包括非 Docker 原生安装方法、Docker Compose、Kustomize 和 Helm。访问我们的 Open WebUI 文档 或加入我们的 Discord 社区，获取详细的指导。

继续阅读完整的入门指南。

感谢赞助商 🙌

Sponsored by Dave Waring

Follow along as I build my own AI powered digital brain.

Open WebUI

On a mission to build the best open-source AI user interface.

我们非常感谢赞助商们的慷慨支持。他们的贡献帮助我们维护和改进项目，确保我们能够继续为社区提供优质的工作。谢谢你们！