Skip to main content

Open WebUI

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

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

Open WebUI Demo

tip

寻找企业计划? – 立即与我们的销售团队交谈！

获得增强功能，包括自定义主题和品牌、服务级别协议 (SLA) 支持、长期支持 (LTS) 版本等更多功能！

Sponsored by Warp
Warp
The intelligent terminal for developers

使用 Docker 快速开始 🐳​

info

Open WebUI 需要 WebSocket 支持才能正常运行。请确保您的网络配置允许 WebSocket 连接。

如果 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。享受吧！😄

使用开发分支 🌙​

warning

: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

🔧 注意：如果您的容器名称不同，请将 open-webui 替换为您的容器名称。

手动安装​

有两种主要方式来安装和运行 Open WebUI：使用 uv 运行时管理器或 Python 的 pip。虽然两种方法都有效，我们强烈推荐使用 uv，因为它简化了环境管理并最小化了潜在冲突。

使用 uv 安装（推荐）​

uv 运行时管理器确保了像 Open WebUI 这样的应用程序的无缝 Python 环境管理。按照以下步骤开始：

1. 安装 uv​

为您的操作系统选择适当的安装命令：

  • macOS/Linux：

    curl -LsSf https://astral.sh/uv/install.sh | sh

  • Windows：

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 运行 Open WebUI​

一旦安装了 uv，运行 Open WebUI 就很简单了。使用下面的命令，确保设置 DATA_DIR 环境变量以避免数据丢失。为每个平台提供了示例路径：

  • macOS/Linux：

    DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

  • Windows：

    $env:DATA_DIR="C:\open-webui\data"; uvx --python 3.11 open-webui@latest serve

使用 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 社区 获取全面指导。

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

赞助商 🙌​

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

致谢 🙏​

我们对提供的慷慨资助支持深表感谢：

MozillaMozilla Builders 2024

GitHubGitHub Accelerator 2024