跳至主要内容

⏱️ 快速開始

Sponsored by n8n
n8n
Does your interface have a backend yet? Try n8n
關於用戶角色和隱私的重要提示:
  • 管理員建立: 在 Open WebUI 上創建的第一個帳戶將獲得管理員權限,可以控制用戶管理和系統設置。
  • 用戶註冊: 之後的註冊用戶默認處於待定狀態,需要管理員批准才能訪問。
  • 隱私與數據安全: 所有數據(包括登錄資料)都將本地存儲在您的設備上。Open WebUI 確保嚴格保密無外部請求,以增強隱私和安全性。
    • 所有模型默認為私有。 模型必須通過群組顯式共享或設為公開。如果將模型分配給群組,只有該群組的成員可以看到它。如果將模型設置為公開,則實例中的任何人都可以看到。

請在下面選擇您偏好的安裝方法:

  • Docker: 官方支持,並建議大多數用戶使用
  • Python: 適合資源有限的環境或需要手動設置的用戶
  • Kubernetes: 適合需要擴展和編排的企業部署

使用 Docker 🐳 快速開始

按照以下步驟使用 Docker 安裝 Open WebUI。

步驟 1:拉取 Open WebUI 映像

首先從 GitHub 容器註冊表拉取最新的 Open WebUI Docker 映像。

docker pull ghcr.io/open-webui/open-webui:main

步驟 2:運行容器

使用默認設置運行容器。此命令包括卷映射以確保持久數據存儲。

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

重要標誌

  • 卷映射 (-v open-webui:/app/backend/data):確保您的數據持久存儲。這可以防止容器重新啟動時數據丟失。
  • 端口映射 (-p 3000:8080):在您的本地機器的 3000 端口上公開 WebUI。

使用 GPU 支援

對於 Nvidia GPU 支援,將 --gpus all 添加到 docker run 命令中:

docker run -d -p 3000:8080 --gpus all -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:cuda

單用戶模式(禁用登錄)

為了在單用戶設置中跳過登錄頁面,將 WEBUI_AUTH 環境變數設置為 False

docker run -d -p 3000:8080 -e WEBUI_AUTH=False -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
注意

進行此更改後,您無法在單用戶模式和多帳號模式之間切換。

高級配置:連接到不同服務器上的 Ollama

要將 Open WebUI 連接到位於其他主機上的 Ollama 服務器,請添加 OLLAMA_BASE_URL 環境變數:

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

訪問 WebUI

運行容器後,訪問 Open WebUI:

http://localhost:3000

有關每個 Docker 標誌的詳細幫助,請參閱 Docker 的文檔

更新

要將本地的 Docker 安裝更新到最新版本,您可以選擇使用 Watchtower 或手動更新容器。

選擇 1:使用 Watchtower

使用 Watchtower,您可以自動化更新過程:

docker run --rm --volume /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --run-once open-webui

(如果您的容器名稱不同,請將 open-webui 替換為您的容器名稱。)

選擇 2:手動更新

  1. 停止並移除當前的容器:

    docker rm -f open-webui
  2. 拉取最新版本:

    docker pull ghcr.io/open-webui/open-webui:main
  3. 再次啟動容器:

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

兩種方法都可以讓您的 Docker 實例更新並運行最新版本。

下一步

安裝完成後,訪問:

您現在可以開始使用 Open WebUI!

配合 Ollama 使用 Open WebUI

如果您與 Ollama 一起使用 Open WebUI,請務必查看我們的 Ollama 開始指引,了解如何通過 Open WebUI 管理 Ollama 實例。

加入社區

需要幫助?有疑問?加入我們的社區: