gaseous-server
自托管的 ROM 管理与浏览器模拟服务器，让你在网页上直接游玩经典游戏。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自己建一个云端游戏库，浏览器里直接玩经典老游戏。
核心功能
- 自动抓取游戏元数据（封面、简介等）
- 内置浏览器模拟器（基于 EmulatorJS），支持多种平台
- 用户认证系统，支持安全远程访问
- 支持 Docker 部署，安装简单
- 可与 Hasheous 代理配合，无需 IGDB API 密钥
避坑指南
- •从 MySQL 迁移到 MariaDB 必须重建数据库；2. 若暴露到公网，务必启用用户认证，否则存在安全风险；3. 首次扫描 ROM 库较慢。
适用场景
- 个人游戏 ROM 收藏整理与远程游玩
- 家庭或小团体共享复古游戏库
详细介绍
Gaseous Server 是一款自托管的 ROM 管理与浏览器模拟服务器。它能整理你的游戏 ROM 文件，自动从 IGDB（或通过 Hasheous 代理）获取封面、简介等元数据，并提供一个网页界面供你浏览和直接游玩游戏。基于 .NET 开发，集成了 EmulatorJS，可在浏览器中运行 RetroArch 核心，支持大量经典平台。1.7.0 以上版本加入了用户认证，允许安全地暴露到公网，但仍需谨慎。相比同类工具，它的核心优势是把 ROM 库管理和即时浏览器模拟合二为一，无需额外安装模拟器客户端。需要 MariaDB/MySQL 数据库和 ffmpeg。适合个人游戏收藏爱好者搭建自己的“云端游戏机”。
常见问题与排障 (1)
故障排除为什么在添加带有文件路径的新库后，所有库都从 Gaseous UI 中消失了？
当您为新库提供的目录路径已作为文件存在时，就会发生这种情况。Gaseous 内部在启动时会为每个库路径调用 Directory.CreateDirectory()。如果该路径上存在文件，操作将失败并引发 IOException，从而中断所有库的加载，并使它们从 UI 中消失。要解决此问题，请删除冲突的文件（例如 /games/roms/nintendo/snes）或将其移动到其他位置，然后重新启动 Gaseous 服务器容器。重启后，所有库应重新出现，您可以添加包含正确目录路径的库。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：安装 MariaDB 11.1.2+（推荐）或 MySQL 8+，以及 ffmpeg
步骤2：获取 IGDB API 密钥（或配置 Hasheous 代理）
步骤3：使用 Docker 运行 gaseous-server 镜像，或从源码构建运行
- 步骤1：安装 MariaDB 11.1.2+（推荐）或 MySQL 8+，以及 ffmpeg
- 步骤2：获取 IGDB API 密钥（或配置 Hasheous 代理）
- 步骤3：使用 Docker 运行 gaseous-server 镜像，或从源码构建运行
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止服务，删除 Docker 容器/镜像（或删除安装目录），并手动删除数据库（可选）以彻底移除。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ