跳到主要内容

🔄 更新 Open WebUI

为什么我的 Open WebUI 没有更新？​

要将本地 Docker 安装的 Open WebUI 更新为最新版本，可以使用 Watchtower 或手动更新容器。按照以下步骤之一对现有的 Open WebUI 镜像进行更新。

手动更新​

  1. 停止并移除当前容器：

    这将停止正在运行的容器并将其移除，但不会删除存储在 Docker 卷中的数据。（如果您的容器名称不同，请在整个更新过程中将open-webui替换为您的容器名称。）

docker rm -f open-webui

  1. 拉取最新的 Docker 镜像：

    这将更新 Docker 镜像，但不会更新正在运行的容器或其数据。

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

**删除 Docker 卷中现有数据（除非绝对必要，否则不建议！）**未必要时可跳过此步骤，直接进入最后一步：

如果需要从头开始，可以删除 Docker 卷中现有的数据。请小心操作，因为这将删除所有聊天历史和其他数据。

数据存储在名为 open-webui 的 Docker 卷中。可以用以下命令删除：

docker volume rm open-webui

  1. 使用更新后的镜像和现有卷重新启动容器：

    如果未删除现有数据，这将使用更新后的镜像和现有数据启动容器。如果删除了现有数据，这将使用更新后的镜像和一个新的空卷启动容器。对于 Nvidia GPU 支持，在 docker run 命令中添加 --gpus all 参数

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

每次更新后都被登出？​

如果发现每次更新后都被登出，请确保环境变量中已设置 WEBUI_SECRET_KEY。如果此密钥未被一致定义，您的验证会话可能会在更新后失效。

要持久设置 WEBUI_SECRET_KEY，可以在运行 Docker 容器时包含这个变量：

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

或者，如果使用 docker-compose，可以将其添加到 environment 部分：

version: '3'
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    environment:
      - WEBUI_SECRET_KEY=your_secret_key

有关环境变量设置的更多详细信息，请查阅 Open WebUI 安全变量文档。

使用 Watchtower 自动更新 Open WebUI​

您可以使用 Watchtower 来自动更新 Open WebUI。以下是三种选项：

选项 1：一次性更新​

您可以运行 Watchtower 进行一次性更新，以停止当前容器、拉取最新镜像，并使用更新后的镜像和现有卷启动新容器（对于 Nvidia GPU 支持，在 docker run 命令中添加 --gpus all 参数）：

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

选项 2：运行 Watchtower 作为独立容器​

您可以运行 Watchtower 作为一个独立容器，用于监控和更新您的 Open WebUI 容器：

docker run -d --name watchtower \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower -i 300 open-webui

此命令将在分离模式下启动 Watchtower，每 5 分钟监控一次 Open WebUI 容器的更新。

选项 3：在 docker-compose.yml 文件中集成 Watchtower​

您也可以在 docker-compose.yml 文件中集成 Watchtower，以实现 Open WebUI 的自动更新（对于 Nvidia GPU 支持，在 docker run 命令中添加 --gpus all 参数）：

version: '3'
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data

  watchtower:
    image: containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --interval 300 open-webui
    depends_on:
      - open-webui

volumes:
  open-webui:

在此示例中，Watchtower 与 docker-compose.yml 文件集成，可每 5 分钟监控一次 Open WebUI 容器的更新。

Docker 卷中的持久数据​

数据存储在名为 open-webui 的 Docker 卷中。此卷的路径无法直接访问，但可以使用以下命令检查该卷：

docker volume inspect open-webui

这将显示卷的详细信息，包括挂载点，通常位于 /var/lib/docker/volumes/open-webui/_data。

在 Windows 10 + WSL 2 上，Docker 卷位于以下位置（在 Windows 文件资源管理器中输入）：

  • \\wsl$\docker-desktop\mnt\docker-desktop-disk\data\docker\volumes

对于旧版本的 Docker（Docker v26.1.4 之前）：

  • \\wsl$\docker-desktop-data\data\docker\volumes
  • \\wsl$\docker-desktop-data\version-pack-data\community\docker\volumes

（Windows 答案归功于 StackOverflow 用户 sarye-haddadi；原始 SO 帖子的链接）