跳到主要内容

🔄 更新 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 帖子的链接