Romm项目离线核心模拟器配置指南

在Romm项目中实现完全离线运行的核心需求，是通过本地化部署模拟器核心文件来实现的。本文将详细介绍如何通过容器化部署方式配置本地模拟器核心。

技术背景

现代网页模拟器通常依赖WebAssembly（WASM）格式的核心文件来执行游戏模拟。这些核心文件默认会从CDN动态加载，但在离线环境中需要预先下载并配置到本地。

实现步骤

1. 创建本地存储目录 在docker-compose.yaml同级目录下创建emulatorjs文件夹，用于存放核心文件。

2. 获取核心文件包 需要下载EmulatorJS的最新发布包（当前推荐版本4.1.1），解压后将内容放置于emulatorjs目录中。

3. 配置容器挂载 在docker-compose.yaml文件的romm服务volumes配置段添加以下挂载项：

   - ./emulatorjs/data/cores:/var/www/html/assets/emulatorjs/cores:ro
   

   这个配置将本地核心文件目录映射到容器内的标准路径，ro参数表示只读挂载。

注意事项

1. 版本固化问题 此方案会将模拟器核心锁定在下载时的版本，无法自动获取更新。

2. 兼容性考虑 不同版本的Romm可能对核心文件有特定要求，建议保持Romm和核心文件的版本同步更新。

3. 性能影响 本地核心加载可能比CDN加载稍慢，特别是在机械硬盘环境下。

进阶建议

对于需要严格离线环境的生产部署，建议：

• 定期手动更新核心文件包
• 建立版本管理机制
• 考虑使用内部镜像仓库存储核心文件

通过以上配置，用户可以在完全离线的环境中使用Romm项目的全部模拟器功能，满足特殊网络环境下的使用需求。