retrom
SHA-256自托管游戏库管理器，专注模拟器游戏，让你随时随地玩自己的 DRM-free 游戏。
自建私人 Steam，管理所有游戏和模拟器。
核心功能
- 自托管，所有游戏文件存在你自己服务器上
- 自动扫描硬盘添加游戏和平台
- 客户端覆盖 Windows、macOS、Linux 和浏览器
- 模拟器配置云端同步，换机无需重新设置
- 自动下载游戏封面和元数据
避坑指南
- •需要自己维护服务器（Docker 或直接运行），不适合完全不想折腾的用户；模拟器配置文件是基于单个客户端保存的（本地模拟器路径），换电脑后需手动调整路径；目前只支持 DRM-free 游戏和 ROM，不能运行正版 Steam 加密游戏。
适用场景
- 拥有一堆 ROM 但管理混乱的用户：用 Retrom 统一管理所有模拟器游戏，封面和元数据自动补齐
- 多设备玩家：在家里电脑上装好模拟器配置，到笔记本上直接同步，无需重复配置
- 想自建私人云游戏库：把游戏存在 NAS 上，通过客户端随时安装游玩
详细介绍
Retrom 是一个自托管的集中式游戏库管理服务。它能扫描你的文件系统，自动识别游戏和平台，并下载元数据和海报。你可以在任意桌面客户端或网页浏览器上安装、卸载和启动游戏。它整合了模拟器游戏库，支持 Steam、GoG（即将支持）等第三方平台，并将模拟器配置保存在服务器上，方便多设备同步。支持 Windows、macOS 和 Linux 客户端，还能在浏览器里直接玩模拟器游戏（基于 EmulatorJS）。就像给自己搭建了一个私人的 Steam 平台。
常见问题与排障 (2)
故障排除容器启动失败，显示错误信息“ENOENT: no such file or directory, scandir /app/web/src/routes”是什么原因？
该错误是良性的，源自一个开发工具，不会影响生产应用程序。尽管有这条日志消息，Web界面仍然可以访问。如果界面无法访问，其原因与此错误无关——请检查网络设置、端口映射或其他日志。
故障排除如何修复通过 Nix 安装 retrom 时的 'ERR_PNPM_NO_OFFLINE_TARBALL' 哈希不匹配问题？
这是由于在更新 pnpm-lock.yaml 后，Nix 包中的 pnpmDeps.hash 过时所致。解决方法：1. 在派生中设置 pnpmDeps.hash 为空字符串。2. 构建派生并等待其因哈希不匹配而失败。3. 从错误信息中复制 'got: sha256-' 的值并填入 pnpmDeps.hash 字段。对于 retrom，应用此修复后运行 nix run github:/JMBeresford/retrom#retrom。
标签
快速上手
安装软件
根据你的发行版安装对应的包（dpkg / rpm / AppImage）
步骤1：下载服务器端（Docker 镜像或自行编译），参考快速入门指南
步骤2：启动服务器，配置扫描目录（你的游戏文件夹）
步骤3：在任意客户端（桌面或浏览器）连接服务器，即可浏览、安装和启动游戏
- 步骤1：下载服务器端（Docker 镜像或自行编译），参考快速入门指南
- 步骤2：启动服务器，配置扫描目录（你的游戏文件夹）
- 步骤3：在任意客户端（桌面或浏览器）连接服务器，即可浏览、安装和启动游戏
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
2e31456eb42e249ee4a73b2bcdeeb564d02b118065c12eaf7ffffcf777bc1b67该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
卸载服务器只需停止容器并删除数据卷；桌面客户端可直接删除，但建议先卸载游戏。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs