Open WebUI Docker 升级指南：使用 Docker Compose 无损更新
随着大模型生态的快速发展，Open WebUI 的更新频率非常高，不断带来新功能和更好的体验。如果你是通过 Docker 部署的 Open WebUI，升级过程其实非常简单。
升级的核心逻辑是：拉取最新的官方镜像，然后用新镜像替换掉旧的容器。由于我们的数据（如聊天记录、用户设置、数据库）通常保存在挂载的本地目录或 Docker 数据卷中，因此升级容器本身不会丢失任何数据。
本文将详细介绍如何使用 Docker Compose 优雅、安全地升级 Open WebUI。
🛠️ 升级步骤 (Docker Compose)
如果你是通过 docker-compose.yml 文件部署的 Open WebUI，请按照以下步骤操作。
1. 进入项目目录
首先，通过 SSH 连接到你的服务器，并进入 Open WebUI 的 docker-compose 配置文件所在目录（请根据你的实际安装路径修改）：
“`bash
cd /opt/docker/app/OpenWebUI
假设你的数据目录名为 data，将其备份并加上当前日期后缀
cp -r ./data ./data_backup_$(date +%Y%m%d)
推荐使用新版 Docker Compose 插件命令
docker compose pull
如果你的系统较老，使用的是独立安装的旧版程序，请使用：
docker-compose pull
docker compose up -d
旧版命令为：docker-compose up -d
5. 清理旧镜像（释放磁盘空间）
升级完成后，之前使用的旧版本镜像会变成“悬空镜像”（dangling images），占用磁盘空间。建议执行以下命令进行清理：
docker image prune -f
⚠️ 升级后注意事项
升级完成后，请务必注意以下几点，以确保系统正常运行：
💡 浏览器强制刷新 升级完成后，前端页面可能会有较大的 UI 或逻辑更新。请在浏览器中打开 Open WebUI 页面，并按下
Ctrl + F5（Windows）或Cmd + Shift + R（Mac）进行强制刷新，清除浏览器缓存，否则可能会遇到页面白屏、按钮失效或样式错乱的问题。
📝 检查更新日志 (Release Notes) 如果跨度了几个大版本，建议去 Open WebUI 的官方 GitHub Releases 页面查看一下更新日志。确认是否有需要手动修改配置的“破坏性更新”（Breaking Changes），或者是否有新增的环境变量需要在
docker-compose.yml中配置。
⏳ 耐心等待数据库自动迁移 Open WebUI 在启动新容器时，会自动检测数据库结构并执行必要的迁移（Migration）。第一次启动新版本时，加载时间可能会比平时稍长。在此期间，千万不要强行重启容器，以免导致数据库损坏。
🔗 检查 Ollama 兼容性 如果你使用的是本地 Ollama 服务，建议顺便检查一下 Ollama 是否也需要升级（可通过
ollama --version查看）。保持 Open WebUI 和 Ollama 都在较新的版本，可以避免 API 不兼容或新模型无法识别的问题。