RomM 自托管 ROM 管理完整指南：扫描 400+ 平台游戏，浏览器直接开玩

RomM 自托管 ROM 管理完整指南：扫描 400+ 平台游戏，浏览器直接开玩

【免费下载链接】rommA beautiful, powerful, self-hosted ROM manager and player.项目地址: https://gitcode.com/GitHub_Trending/rom/romm

硬盘里躺着几百个 ROM，却没封面、没简介，每次想玩还得手动翻文件夹、开模拟器。RomM 是一款自托管的 ROM 管理器，能扫描整个游戏库、自动补齐资料，还能在浏览器里直接开局——一条 Docker 命令就能跑起来。

拿到手就能用的四件事

• 10 分钟内让几十 GB 的 ROM 文件夹变成带封面、简介、评分的游戏库
• 不用装任何模拟器，浏览器点开即玩，手机电脑存档互通
• 400 多个游戏平台开箱识别，从 N64 到 PS1 都能扫
• 封面、截图、成就进度自动抓取，缺什么补什么

为什么选它：一个库把扫描、补资料和游玩全包了

RomM 干的是三件别人各干一半的活。先是扫描：它遍历你的 ROM 文件夹，按文件夹名认出平台，给每个游戏算出指纹；再是补资料：对接 IGDB、Screenscraper、MobyGames 等十几个数据源，把封面、简介、发行年份填进数据库；最后才是游玩：内置 EmulatorJS 核心，浏览器里直接跑游戏，存档还能在多台设备间同步。

它和"下载即玩"的在线模拟器区别在于——数据全部在你自己的服务器上，400 多个平台的目录结构它都认得，多盘游戏、MOD、汉化补丁也能归到同一款游戏名下。

三分钟跑起来：克隆仓库、改两个路径、启动容器

先拿到部署文件：

git clone https://gitcode.com/GitHub_Trending/rom/romm

打开仓库里的 examples/docker-compose.example.yml，做两处修改：把/path/to/library换成你 ROM 文件夹的真实路径，给MARIADB_PASSWORD和ROMM_AUTH_SECRET_KEY填上值（后者用openssl rand -hex 32生成一串）。卷挂载长这样：

volumes: - /path/to/library:/romm/library - /path/to/assets:/romm/assets - /path/to/config:/romm/config

library是你的游戏目录，assets存上传的存档和固件，config放配置文件。然后在仓库目录里执行：

docker compose -f examples/docker-compose.example.yml up -d

浏览器打开http://服务器IP，注册第一个账号（自动成为管理员），在扫描页发起一次全库扫描。几十分钟后回去，你的 ROM 堆已经变成一排排带封面的游戏墙了。

关键配置：四个最影响体验的开关

平台名映射：你文件夹叫ps1、它认psx，扫描就会漏。在 examples/config.example.yml 的system.platforms里加一行ps1: psx，把"你的文件夹名"映射成"标准平台名"即可，Batocera、ES-DE 的目录结构则默认就认识。

元数据优先级：多个数据源都有资料时听谁的，由scan.priority.metadata的列表顺序决定，默认 IGDB 排最前。想让 Screenscraper 的封面优先，把ss挪到igdb前面，重新扫描即生效。

数据源密钥：SCREENSCRAPER_USER、STEAMGRIDDB_API_KEY这些环境变量填了就能解锁更多封面和成就数据；一个都不填也能跑，走 IGDB 和 Hasheous 的免费通道。

浏览器玩与存档：点击游戏卡片上的 Play 按钮就进浏览器模拟器，核心由 RomM 按平台自动推荐。存档默认强制写入浏览器本地（Player.vue 里save-state-location: browser），再配合它的服务器端存档同步，你在家存一半、出门用手机接着玩，冲突时它会自动合并。

排障速查：三种最常见的翻车现场

现象：页面能打开，扫描后游戏是零→ 原因：/path/to/library没指对真实目录，或平台文件夹名没被识别 → 解法：核对挂载路径是否指向 ROM 的上一级目录，把不认识的文件夹名写进system.platforms做映射后重新扫描。

现象：某平台游戏点开提示没有可用核心→ 原因：该平台的文件夹名映射错了，RomM 把游戏认成了不支持浏览游玩的平台 → 解法：修正system.platforms映射，让平台落在 EmulatorJS 支持的列表内。

现象：游戏有封面缺简介，或干脆全是灰图→ 原因：扫描时数据源密钥没配、或者那次扫描在中途被跳过 → 解法：补上对应环境变量重启容器，然后在扫描页只对缺失平台发起增量扫描。

起步之后还能去哪

RomM 解决的是"ROM 堆成山、玩不了也找不到"的老毛病，从克隆到开玩不过十分钟。接下来可以试试：给掌机装上官方客户端 Argosy 和 Grout 实现随身联机库、用内置 ROM 补丁器给游戏打汉化补丁、或者把 gamelist 导出回 Batocera 让电视盒子也读同一套数据。

【免费下载链接】rommA beautiful, powerful, self-hosted ROM manager and player.项目地址: https://gitcode.com/GitHub_Trending/rom/romm