跳至主要内容

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 Hits Discord

Open WebUI Demo

提示

需要 企業方案? – 立即與我們銷售團隊聯繫！

獲得 增強功能，包括 自訂主題和品牌設計、服務級別協議 (SLA) 支援、長期支援 (LTS) 版本及 更多內容！

Sponsored by n8n
n8n
Does your interface have a backend yet? Try n8n

使用 Docker 🐳 快速開始​

資訊

WebSocket 支援是 Open WebUI 正常運作的必要條件。請確保您的網路配置允許 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。享受使用吧！😄

使用 Dev 分支 🌙​

注意

: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