如何更新已安装的Open WebUI？

以下是更新已安装的Open WebUI的分步指南，根据不同的安装方式提供针对性方案：

《对于一个新手来说，这个天大的难题，毕竟对于docker不是很熟悉，为此在所谓的技术博客找了一天，不是收费，就是讲不明白。在B站上没有人讲这个基础的东西，对于程序员来讲这个都是很小的事情。自然没人回去讲。

今天我就把这个分享个大家，希望对小白同学有帮助。》

一、Docker部署环境更新

1. 数据备份（必须）

# 备份配置文件

docker cp openwebui:/app/config.yaml ./config_backup.yaml

# 备份数据库（假设使用挂载卷可跳过）

docker exec openwebui pg_dump -U postgres > webui_db_$(date +%Y%m%d).sql

2. 执行更新

# 拉取最新镜像

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

# 停止并删除旧容器

docker stop openwebui && docker rm openwebui

# 重新部署（保留原有配置）

docker run -d \ --name openwebui \ -p 3000:8080 \ -v openwebui:/app/backend/data \ -v /var/run/docker.sock:/var/run/docker.sock \ --restart always \ ghcr.io/open-webui/open-webui:latest

3. 版本验证

docker exec openwebui cat /app/version.txt

---

二、源码部署环境更新

1. 更新代码库

cd /opt/open-webui

git fetch --all

git checkout v2.1.3 # 替换为目标版本号

2. 依赖更新

# 前端依赖

cd frontend && npm ci #

后端依赖

cd ../backend && poetry install --sync

3. 数据库迁移

poetry run alembic upgrade head 

4. 服务重启

systemctl restart openwebui.service

---

三、Kubernetes部署更新

YAML

# values.yaml 更新策略

image:

repository: ghcr.io/open-webui/open-webui

tag: v2.1.3

pullPolicy: Always

# 执行滚动更新

helm upgrade openwebui ./chart \

--namespace webui \

--set image.tag=v2.1.3 \

--atomic --timeout 600s

---

四、更新后检查清单

1. 配置兼容性
   对比新旧版config.yaml，合并自定义配置项：

   BASH

   diff config_backup.yaml ./openwebui/config.yaml

2. 服务健康检查
   访问诊断端点：

   BASH

   curl http://localhost:3000/api/health | jq .

3. 功能回归测试

   • 用户登录流程
   • 核心业务接口调用
   • 定时任务执行情况

---

五、故障回滚方案

Docker环境回滚

BASH

docker run -d \ --name openwebui_old \ -p 3001:8080 \ -v openwebui:/app/backend/data \ ghcr.io/open-webui/open-webui:v2.0.4

Kubernetes回滚

BASH

kubectl rollout undo deployment/openwebui -n webui

---

注意事项：

1. 生产环境建议先在staging环境验证
2. 大版本升级（如v1.x→v2.x）需检查breaking changes文档
3. 更新后保留旧容器镜像至少48小时：docker image tag ghcr.io/open-webui/open-webui:latest old-webui-backup

通过以上标准化流程，可确保Open WebUI升级过程安全可控。建议配合监控系统观察升级后24小时内的内存/CPU使用率、API响应延迟等关键指标。