打造专属复古游戏主机：深度拆解 Batocera 镜像定制全流程

你有没有遇到过这样的场景？——朋友来家里做客，兴致勃勃想玩一局《魂斗罗》，结果你得先插卡、开机、等系统加载十几秒，再手动进菜单、翻找平台、选游戏……一顿操作下来，热情都凉了一半。

而另一边，某些展览馆里的街机设备，通电即自动进入主界面，甚至直接开始演示经典片段。为什么差距这么大？

答案就藏在镜像级定制里。

今天我们要聊的，不是怎么装游戏、换主题这种“用户层”操作，而是真正深入到底层——如何从源码出发，构建一个开箱即用、秒进游戏、风格统一、稳定可靠的 Batocera 定制镜像。这不仅是极客玩家的进阶玩法，更是批量部署、商业改造的核心技术能力。

为什么标准版 Batocera 不够用？

Batocera 是目前最受欢迎的开源复古游戏系统之一，基于 Linux + Buildroot 构建，支持树莓派、x86 等多种硬件平台，自带 EmulationStation 前端和大量模拟器，开箱可用。

但它的“通用性”也正是其局限所在：

• 每次首次启动都要扫描 ROM，耗时几十秒；
• 缺少预设配置，音频/视频输出常需手动调整；
• 主题千篇一律，无法体现个性化或品牌调性；
• 无法实现“通电自动运行指定游戏”这类自动化需求。

当你想做一个送给孩子的专用游戏机、展厅中的互动装置，或是文创店里的收费体验终端时，这些“默认行为”就成了阻碍。

于是，镜像定制成了解决问题的关键路径。

核心思路：把“设置”变成“出厂配置”

真正的高级定制，并不是装完系统再去改一堆文件。
而是：在镜像生成阶段，就把所有个性化内容“固化”进去。

这就像是手机厂商发布定制 ROM —— 用户拿到手的就是最终形态，无需任何额外操作。

要实现这一点，必须掌握四个核心技术模块：

1. Buildroot：构建系统的“总控台”
2. EmulationStation：决定第一眼印象的前端引擎
3. autostart.sh：掌控启动流程的自动化脚本
4. OverlayFS：隔离系统与数据的双层文件结构

我们逐个击破。

1. Buildroot：你的嵌入式系统“生产线”

它是什么？

你可以把Buildroot想象成一条自动化装配线。输入的是代码源码（内核、BusyBox、SDL、RetroArch……），输出的是可以直接烧录到 SD 卡的完整.img镜像。

Batocera 正是基于 Buildroot 实现跨平台编译与系统打包。它不像 Yocto 那样复杂，学习成本低，特别适合单一用途系统（比如一台只用来打游戏的主机）。

我们能做什么？

通过修改 Buildroot 的外部扩展包（buildroot-external），我们可以：

• 添加自定义驱动（如特殊 WiFi 模块）
• 预装字体、音效、启动动画
• 注入自己的脚本工具链
• 精简不需要的模拟器以减小体积

举个实际例子：你想让系统自带一个分辨率切换脚本，可以在external.mk中这样写：

define CUSTOM_BOOT_SCRIPTS_INSTALL_TARGET_CMDS mkdir -p $(TARGET_DIR)/opt/bootscripts $(INSTALL) -D -m 0755 $(LOCAL_DOWNLOADS)/set-resolution.sh \ $(TARGET_DIR)/opt/bootscripts/set-resolution.sh $(INSTALL) -D -m 0755 $(LOCAL_DOWNLOADS)/start-game.sh \ $(TARGET_DIR)/opt/bootscripts/start-game.sh endef $(eval $(generic-package))

这段 Makefile 的作用很简单：在构建过程中，将本地准备好的两个 shell 脚本复制到目标系统的/opt/bootscripts/目录下。

它们不会立刻执行，但已经“埋”进了镜像里，后续随时可以调用。

✅关键提示：所有自定义内容应尽量放在rootfs-overlay/下对应路径，这是 Buildroot 提供的标准注入点。

2. EmulationStation：不只是菜单，更是用户体验的第一战场

它是怎么工作的？

EmulationStation 是 Batocera 的图形前端，负责展示游戏列表、播放封面、处理控制器输入。它启动时会去读取/userdata/roms/<platform>/gamelist.xml文件，获取每款游戏的名称、发行年份、截图等元数据。

更重要的是，它的界面完全可定制。

如何打造专属视觉风格？

主题文件存放在/userdata/system/themes/[your-theme-name]/，核心是theme.xml这个布局描述文件。

比如你想让主界面背景是一张高清图，标题居中显示，下方轮播游戏预告片，可以这样写：

<view name="detailed"> <image name="background"> <path>./bg/mainmenu.jpg</path> <zIndex>0</zIndex> </image> <text name="title"> <fontPath>./fonts/OpenSans-Bold.ttf</fontPath> <color>FFFFFFFF</color> <horizontalAlign>center</horizontalAlign> <verticalAlign>top</verticalAlign> <zIndex>2</zIndex> </text> <video name="marquee"> <showSnapshotNoVideo>true</showSnapshotNoVideo> <delay>2</delay> <zIndex>1</zIndex> </video> </view>

别小看这个 XML —— 它决定了整个系统的“气质”。你可以加入公司 Logo、版权页、动态粒子效果，甚至做成怀旧 CRT 显示器风格。

💡实战技巧：使用 H.264 编码的 MP4 视频作为背景动画，在树莓派上也能流畅播放；避免使用 WebM 或高码率 AVI。

3. autostart.sh：让系统“自己动起来”的魔法开关

为什么它如此重要？

很多用户想要的效果是：“插电 → 自动进游戏”，而不是先进 EmulationStation 再手动点。

这就需要用到autostart.sh—— Batocera 提供的一个用户级启动脚本接口，位于/userdata/scripts/autostart.sh。

只要这个脚本存在且有执行权限，系统会在初始化完成后自动运行它。

怎么用？来看一个真实案例

假设你想让设备开机后自动以 1080p 分辨率运行《超级马里奥》，脚本可以这么写：

#!/bin/bash # 设置分辨率为 1920x1080 @ 60Hz batocera-resolution setMode "1920x1080" "60" > /dev/null 2>&1 # 播放自定义开机动画 es-switch-splash /userdata/splash/custom-boot.mp4 # 等待前端完全加载 sleep 5 # 关闭屏幕保护与节能 xset s off xset -dpms # 直接启动 NES 游戏 /opt/retroarch/bin/retroarch \ -L /usr/lib/libretro/fceumm_libretro.so \ --config /userdata/system/configs/retroarch/retroarch.cfg \ "/userdata/roms/nes/Super Mario Bros.nes" & # 防止脚本退出导致中断 wait

这个脚本干了四件事：
1. 固定显示模式，避免电视兼容问题；
2. 替换默认启动动画为品牌视频；
3. 屏蔽系统休眠，防止中途黑屏；
4. 绕过 EmulationStation，直启 RetroArch 加载游戏。

适用于儿童专用机、礼品机、展览互动终端等“零交互”场景。

⚠️坑点提醒：一定要加sleep等待系统就绪，否则可能因 DISPLAY 环境未准备好而导致失败。

4. OverlayFS：系统稳定与灵活定制的平衡术

双层文件系统的秘密

Batocera 使用Overlay 文件系统技术，实现了“只读基础层 + 可写上层”的架构：

• 底层（lowerdir）：squashfs 格式的只读镜像，包含操作系统本身；
• 上层（upperdir）：ext4 分区，挂载为/userdata，保存用户数据；
• 合并后呈现为统一的根目录/。

所有修改（新建、删除、重命名）都会被重定向到上层，原始系统不受影响。

对定制的意义是什么？

这意味着你可以放心地往/userdata里塞东西：

• BIOS 文件
• ROM 游戏
• gamelist.xml
• 主题包
• 自动化脚本

即使将来官方发布新版本，你仍然可以通过 OTA 更新系统层，而保留原有的游戏和配置。

✅最佳实践建议：所有自定义资源都应放入/userdata，不要触碰只读层。这样既能保证更新兼容性，又便于后期克隆迁移。

实战流程：一步步构建你的专属镜像

现在我们把上面的知识串起来，走一遍完整的定制流程。

第一步：环境准备

推荐使用 Ubuntu 20.04 或更高版本作为编译主机：

sudo apt update sudo apt install git make gcc bc build-essential libncurses-dev

第二步：拉取源码

git clone https://github.com/batocera-linux/batocera-linux.git cd batocera-linux

根据目标平台选择配置，例如树莓派 4：

make rpi4_defconfig

或者 x86_64 平台：

make x86_64_defconfig

第三步：添加自定义内容

进入buildroot-external目录，创建 overlay 结构：

rootfs-overlay/ └── userdata/ ├── roms/ ├── bios/ ├── system/ │ └── themes/ │ └── my-theme/ ├── scripts/ │ └── autostart.sh └── splash/ └── custom-boot.mp4

把你准备好的游戏、BIOS、主题、脚本全部放进去。

🔐法律提醒：ROM 和 BIOS 版权敏感，请仅用于个人备份用途，勿公开分发。

第四步：编译生成镜像

make clean make

等待数小时（取决于机器性能），最终会在output/images/生成压缩镜像文件，如batocera-rpi4.img.gz。

第五步：烧录测试

使用 BalenaEtcher 或 Raspberry Pi Imager 将镜像写入 SD 卡，在目标设备上启动验证功能是否正常。

第六步：批量部署

一旦确认无误，可以用dd命令制作母盘，然后快速克隆给其他设备：

# 制作镜像备份 sudo dd if=/dev/sdX of=custom-batocera.img bs=4M status=progress # 克隆到多张卡 sudo dd if=custom-batocera.img of=/dev/sdY bs=4M status=progress

常见痛点与解决方案对照表

设计原则：不只是技术，更是工程思维

成功的定制项目，除了懂技术，还要有良好的工程习惯：

• 安全性：关闭 SSH 密码登录，移除调试账户；
• 性能优化：启用 zramswap，提升内存效率；
• 可维护性：记录每次构建的 commit hash 与变更日志；
• 兼容性测试：至少在三种不同品牌 TF 卡上验证稳定性；
• 版权合规：明确告知用户不得传播受版权保护的内容。

写在最后：从“玩家”到“创造者”

当你第一次亲手做出一个通电即自动运行《街头霸王II》的定制镜像时，那种成就感远超通关任何游戏。

因为这一刻，你不再只是一个使用者，而是一个系统设计者。

无论是给孩子打造一台专属童年回忆机，还是为文创空间设计一套沉浸式互动展项，亦或是为客户提供标准化街机改造方案——掌握镜像定制技术，意味着你能交付更完整、更专业、更具价值的产品。

而这套方法论，也不局限于 Batocera。只要是基于 Buildroot 的嵌入式系统，都可以借鉴这套“源码定制 + 资源预置 + 自动化控制”的模式。

如果你正在尝试构建自己的batocera游戏整合包，欢迎在评论区分享你的主题设计、启动逻辑或踩过的坑。我们一起，把复古的魅力，带到更多人的生活中去。