From eccaa16dcc6a2238bea5f00928bd3ee57d2e6d8b Mon Sep 17 00:00:00 2001 From: okxlin <61420215+okxlin@users.noreply.github.com> Date: Thu, 30 Jul 2026 09:21:13 +0800 Subject: [PATCH] Document RomM 5.1.0 upgrade requirements --- apps/romm/README.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/apps/romm/README.md b/apps/romm/README.md index e4759c62c..4b90a7838 100644 --- a/apps/romm/README.md +++ b/apps/romm/README.md @@ -28,6 +28,8 @@ RomM 是一个自托管的复古游戏库管理器。它可以扫描游戏文件 1Panel 会在所选服务中创建独立的 RomM 数据库和用户，并将主机、端口、数据库名、用户名和密码注入容器。不要填写数据库服务的 root 或管理员账号作为 RomM 用户。 +从 `5.1.0` 开始，数据库迁移会创建触发器。1Panel 的默认 MariaDB 配置未启用 binary logging，无需额外处理。如果自行启用了 binary logging，请在升级前使用数据库管理员账号设置 `log_bin_trust_function_creators=1`，或向 RomM 数据库用户授予 `BINLOG ADMIN`（MariaDB 10.5+）或 `SUPER` 权限；不要将管理员凭据填入 RomM 安装表单。 + ## 数据持久化 安装表单中的“数据目录”包含： @@ -37,7 +39,7 @@ RomM 是一个自托管的复古游戏库管理器。它可以扫描游戏文件 RomM 需要在部分目录之间创建硬链接，因此本适配将整个 `/romm` 挂载为同一个文件系统。游戏文件应放入 `romm/library/roms/` 下符合官方目录规范的位置。 -升级前建议备份整个数据目录，并通过 1Panel 单独备份所选数据库。卸载应用不会删除绑定目录中的用户数据。 +升级前建议备份整个数据目录，并通过 1Panel 单独备份所选数据库。卸载应用不会删除绑定目录中的用户数据。升级到 `5.1.0` 后，如果反向代理或 CDN 缓存了响应，请清除一次缓存，避免旧版 `index.html` 引用已删除的前端资源而出现空白页面。 ## 元数据服务 @@ -57,7 +59,7 @@ RomM 需要在部分目录之间创建硬链接，因此本适配将整个 `/rom ## 版本说明 -- `4.9.2`：固定的最新稳定版本，适合需要可重复部署的用户。 +- `5.1.0`：固定的最新稳定版本，适合需要可重复部署的用户。 - `latest`：跟随官方最新稳定镜像，升级前应阅读上游发布说明并备份数据。 项目采用 AGPL-3.0 许可证。 @@ -74,6 +76,12 @@ RomM is a self-hosted retro game library manager. It scans and enriches game col - Select a 1Panel-managed MariaDB or PostgreSQL service during installation. - Keep application data and the built-in Valkey cache persistent across upgrades while backing up the selected database separately. +## Upgrade notes + +RomM `5.1.0` migrations create database triggers. The default 1Panel MariaDB configuration has binary logging disabled and needs no extra privileges. If you enabled binary logging, use a database administrator account before upgrading to set `log_bin_trust_function_creators=1`, or grant the RomM database user `BINLOG ADMIN` (MariaDB 10.5+) or `SUPER`. Do not configure RomM itself with database administrator credentials. + +After upgrading to `5.1.0`, purge any reverse-proxy or CDN cache once. A stale cached `index.html` can reference frontend bundles that the new image no longer contains and result in a blank UI. + ## Links - Project: https://github.com/rommapp/romm