🔄 更新 Open WebUI
为什么我的 Open WebUI 没有更新?
要将本地 Docker 安装的 Open WebUI 更新为最新版本,可以使用 Watchtower 或手动更新容器。按照以下步骤之一对现有的 Open WebUI 镜像进行更新。
手动更新
-
停止并移除当前容器:
这将停止正在运行的容器并将其移除,但不会删除存储在 Docker 卷中的数据。(如果您的容器名称不同,请在整个更新过程中将
open-webui
替换为您的容器名称。)
docker rm -f open-webui
-
拉取最新的 Docker 镜像:
这将更新 Docker 镜像,但不会更新正在运行的容器或其数据。
docker pull ghcr.io/open-webui/open-webui:main
**删除 Docker 卷中现有数据(除非绝对必要,否则不建议!)**未必要时可跳过此步骤,直接进入最后一步:
如果需要从头开始,可以删除 Docker 卷中现有的数据。请小心操作,因为这将删除所有聊天历史和其他数据。
数据存储在名为 open-webui
的 Docker 卷中。可以用以下命令删除:
docker volume rm open-webui
-
使用更新后的镜像和现有卷重新启动容器:
如果未删除现有数据,这将使用更新后的镜像和现有数据启动容器。如果删除了现有数据,这将使用更新后的镜像和一个新的空卷启动容器。对于 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 帖子的链接)