Django 用户认证 用户 邮箱登录 邮箱注册 ORM or,and,not form.py FORM ModelForm Paginator 分页 HTMl JQuery 定位元素 ajax django切片 restfulapi 跨域 Ubantu Python Mysql Scrapy 爬虫 导出 Python读写 Pycharm 破解 session re sqlit3 生成式 其他 Prism 富文本 CSS Nginx 部署 请求头 抓包 协议 selenium Ubuntu 宝塔 AI Comfy-ui ollama dify open-webui Git docker
基于 Docker 部署安装的 Open WebUI 版本升级方法
张建行 2025年4月9日 08:48 120 文章标签: AI ollama open-webui

前言

大家好,今天给大家分享一篇关于Open WebUI版本升级的实用教程。对于使用Docker部署的Open WebUI用户来说,版本升级不像直接通过Git部署那样简单,需要特别注意数据保留问题。本文将详细介绍如何在Windows和Linux系统下安全升级Open WebUI版本,同时保留原有数据。

一、升级前的准备工作

在开始升级前,请确保:

  1. Docker服务已正常运行
  2. 确认当前Open WebUI容器的名称(默认为open-webui)
  3. 记录下原始部署时的持久化存储路径
  4. 备份重要数据(虽然升级过程不会删除数据,但预防万一总是好的)

二、详细升级步骤

1. 停止并删除当前容器

首先需要停止并删除当前运行的Open WebUI容器,但不会影响存储在Docker卷中的数据。

docker rm -f open-webui

​注意​​:如果您的容器名称不是默认的"open-webui",请替换为您实际的容器名称。

2. 拉取最新的Docker镜像

这一步将从官方仓库获取最新版本的Open WebUI镜像:

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

3. 使用新镜像重新创建容器

使用更新后的镜像重新创建容器,并挂载原有的数据卷:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --restart always --name open-webui ghcr.io/open-webui/open-webui:main

​重要说明​​:

  • 端口映射3000:8080也需要与原始部署保持一致
  • --add-host参数是Windows系统特有的,Linux用户可省略

三、验证升级结果

升级完成后,可以通过以下方式验证:

  1. 访问http://localhost:3000(或您配置的端口)
  2. 检查WebUI界面右下角的版本号
  3. 确认原有数据(如聊天记录、设置等)是否完整保留

四、常见问题解答

​Q1:升级后数据丢失怎么办?​
A:确保使用了正确的持久化存储路径,路径必须与原始部署完全一致。

​Q2:升级后无法访问服务怎么办?​
A:检查Docker容器是否正常运行(docker ps),查看日志(docker logs open-webui)。

​Q3:如何回退到旧版本?​
A:只需重复上述步骤,但在拉取镜像时指定旧版本标签即可。

五、总结

通过以上三个简单步骤,我们就可以安全地升级Docker部署的Open WebUI,同时保留所有用户数据。这种方法在Windows和Linux系统上都适用,是Open WebUI官方推荐的升级方式。