issue: After migration from 10.2 to 11.0, docker endlessly restarts (official docker-compose.yaml)

问题场景

用户使用 GitHub 官方提供的 docker-compose.yaml 升级 Open WebUI 镜像标签从 ghcr.io/open-webui/open-webui:10.2 改为 :11.0 后，容器持续自动重启，日志仅输出 WEBUI_SECRET_KEY 加载信息。

报错原文

No WEBUI_SECRET_KEY environment variable set, loading from file.
Loading WEBUI_SECRET_KEY from .webui_secret_key

原因分析

可能原因：Open WebUI 11.0 对 WEBUI_SECRET_KEY 的处理逻辑发生变化——若环境变量未设置或设为空字符串，程序会尝试从 .webui_secret_key 文件读取，但如果数据目录不可写导致无法生成/读取该文件，程序将直接崩溃退出。而 Docker Compose 配置了 restart: unless-stopped，退出后容器被自动重启，形成循环。Issue 中用户提到 WEBUI_SECRET_KEY=（空值）在 10.2 可以工作，但在 11.0 引发重启，印证了该变化。

环境排查

• docker-compose.yaml 中 WEBUI_SECRET_KEY 是否被显式赋值为非空字符串
• 数据目录（通常映射到 /app/backend/data）的宿主机路径是否存在，且容器用户有写入权限
• 尝试设置 GLOBAL_LOG_LEVEL=debug 以获取更多日志信息
• 确认使用的镜像版本为 ghcr.io/open-webui/open-webui:11.0（或具体标签）

解决步骤

1. 检查当前 docker-compose.yaml 中的 WEBUI_SECRET_KEY 字段，确保其值不为空。例如：
   WEBUI_SECRET_KEY=your-strong-random-secret
2. 检查数据卷挂载的宿主机目录权限，确保 Docker 守护进程用户（通常为 root）有读写权限。如权限不足，可执行 chmod 755 /path/to/data 或更改目录所有者。
3. 执行 docker compose pull 拉取最新镜像，然后 docker compose up -d 重新启动。
4. 若容器仍持续重启，运行 docker compose logs -f 查看完整日志，关注是否有文件权限或 alembic 迁移错误。
5. 如怀疑是升级后的迁移问题，可考虑保留数据目录后回退至 10.2 版本重新迁移，再升级至 11.0（Issue 中未提供验证步骤，仅作思路）。

验证方法

执行 docker compose ps 确认容器状态为 Up，且 docker compose logs 中不再出现循环重启日志，能够正常输出 Open WebUI 启动完成信息（如 Uvicorn running on http://0.0.0.0:8080）。

参考来源

open-webui/open-webui #27645

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。