实战演示：构建支持联网功能的 Batocera 整合包
你有没有过这样的经历？手头一堆经典游戏 ROM，想往 Batocera 主机里拷贝，结果发现必须拔下 SD 卡、插到电脑上，复制完再插回去——稍有不慎还可能损坏文件系统。更别提多人联机时，两台设备进度不同步、存档无法共享的尴尬了。
这根本不像“智能娱乐中心”，倒像是上世纪的老古董。
但其实，Batocera 本可以更聪明。
作为一款基于 Linux 的轻量级复古游戏系统，Batocera 不仅能流畅运行从 FC 到 PS2 的各类模拟器，其底层架构也完全具备成为“家庭局域网游戏中枢”的潜力。关键就在于：让系统真正“联网”起来。
本文将带你一步步构建一个开箱即用、自带完整网络服务能力的 Batocera 游戏整合包。我们不只讲怎么配 Wi-Fi，而是要让它具备：
- 开机自动连网
- 手机/电脑无线拖拽传 ROM
- 远程调试与批量管理
- 多人协作游戏的基础支持
最终目标是：从此不再需要拆卡、不再依赖物理访问，一切操作都在局域网内完成。
为什么你需要一个“联网版”整合包？
先说清楚，这不是为了炫技。
传统 Batocera 安装方式的问题非常现实：
- ROM 添加麻烦：每次新增游戏都要重插存储介质；
- 缺乏远程维护能力：设备放在电视柜深处，出问题只能重启硬来；
- 多主机难以协同：家里两台机器，各自为政，更新靠手动同步；
- 无法实现云存档或在线排行榜等进阶功能。
而这些问题的本质，都是因为系统被当作“孤立终端”使用，而非“网络节点”。
一旦加入联网能力，整个使用逻辑就变了：
想加新游戏？直接在 Windows 资源管理器里打开
\\batoceralocal\roms，把 ISO 文件拖进去就行。
系统异常？SSH 登录进去查日志、杀进程、改配置，全程不用碰主机。
双人合作打《魂斗罗》？两台手柄接入后，通过局域网时间同步和共享资源池，体验无缝衔接。
这才是现代嵌入式系统的正确打开方式。
核心组件一：让设备自己“找网”——NetworkManager 深度配置
Batocera 并非没有网络支持，但它默认的行为往往是“等待用户交互”。我们要做的，是让它变成“主动连接者”。
为什么选 NetworkManager？
Batocera 底层基于 Debian 或 Alpine，使用的是标准 Linux 网络栈。其中NetworkManager是最合适的动态管理工具，原因如下：
- 支持热插拔检测（比如 USB Wi-Fi 插入）
- 自动处理 DHCP、静态 IP、DNS
- 提供命令行接口
nmcli，便于脚本控制 - 配置文件结构清晰，适合预置打包
更重要的是，它支持.nmconnection文件驱动的声明式配置——这意味着我们可以提前写好网络策略，烧录进镜像，实现“开机即联网”。
实战：预置 Wi-Fi 连接配置
假设你的家庭网络 SSID 是HomeWiFi，密码为password123，加密方式为 WPA2-PSK。我们可以通过创建如下配置文件，让 Batocera 启动时自动连接：
# /etc/NetworkManager/system-connections/HomeWiFi.nmconnection [connection] id=HomeWiFi uuid=8a4f5b6c-9d2e-41cf-a03b-1e8f9a7b5c6d type=wifi interface-name=wlan0 [wifi] mode=infrastructure ssid=HomeWiFi mac-address-blacklist= [wifi-security] auth-alg=open key-mgmt=wpa-psk psk=password123 [ipv4] method=auto dns-search= may-fail=false [ipv6] method=ignore把这个文件放入镜像的对应路径，并确保权限正确：
chmod 600 /etc/NetworkManager/system-connections/*.nmconnection chown root:root /etc/NetworkManager/system-connections/*⚠️安全提醒：生产环境中不应明文保存密码。你可以改为首次启动时运行脚本，引导用户输入 Wi-Fi 密码并生成加密后的 PSK 值（可用
wpa_passphrase SSID PASSWORD生成）。
高级技巧：双频回切 + 备用网络
如果你的路由器支持 2.4GHz 和 5GHz 双频段，可以分别配置两个.nmconnection文件，并设置优先级：
[connection] ... priority=100 # 数值越高优先级越高当主网络断开时，NetworkManager 会自动尝试连接次优网络，极大提升稳定性。
核心组件二：无线传 ROM —— Samba 共享实战
解决了“上网”问题，下一步就是“让人能访问它”。
最实用的功能之一：通过局域网直接向 Batocera 拷贝游戏文件。
Windows 用户只需在资源管理器地址栏输入\\batoceralocal，就能看到共享目录；Mac/Linux 用户也能轻松挂载smb://batoceralocal。
这一切靠的就是Samba。
Samba 在 Batocera 中的角色
Samba 实现了 SMB/CIFS 协议，使得 Linux 系统能够与 Windows 设备无缝通信。在我们的整合包中，它的核心任务是：
- 将
/userdata/roms目录暴露给局域网 - 允许访客读写（家庭环境友好）
- 控制权限，避免误删关键文件
配置文件详解
# /etc/samba/smb.conf [global] workgroup = WORKGROUP netbios name = BATOCERA server string = Batocera Gaming System security = user map to guest = Bad User log file = /var/log/samba/%m.log max log size = 50 [ROMs] path = /userdata/roms read only = no guest ok = yes browsable = yes create mask = 0664 directory mask = 0775重点说明几个关键选项：
guest ok = yes：允许匿名访问，无需输入用户名密码，适合家庭内部信任网络；read only = no：允许写入，才能拖放上传；create mask和directory mask：设定新建文件和目录的默认权限，保证其他服务可读；netbios name：决定了你在局域网中看到的名字，建议设为易识别的名称。
测试与验证
重启 Samba 服务后，在任意局域网设备上执行：
smbclient -L //batoceralocal -U%你应该能看到名为 “ROMs” 的共享目录。接着可以直接挂载或通过图形界面访问。
💡 提示：如果无法解析
batoceralocal，请确认局域网内 mDNS 服务正常（如 Avahi）。也可直接使用 IP 地址访问，例如\\192.168.1.100。
核心组件三：远程调试利器 —— SSH 按需启用
出于安全考虑，Batocera 默认禁用 SSH。但我们可以通过一个巧妙机制实现“按需开启”——既保障日常安全，又保留维护入口。
如何临时启用 SSH？
Batocera 提供了一个“触发文件”机制：只要在特定路径创建一个空文件，系统就会自动启动 SSH 服务。
touch /userdata/system/ssh.enabled随后重启，系统便会加载 OpenSSH 守护进程，监听 22 端口。
你可以通过以下命令验证：
ssh batocera@your-batocera-ip默认密码通常是linux（具体以版本为准），登录后即可执行 shell 命令、查看日志、管理文件。
安全加固建议
虽然方便，但长期开放 SSH 存在风险。以下是几点最佳实践：
- 限制访问来源：配合防火墙规则，只允许特定 IP 访问 22 端口；
- 使用密钥认证替代密码：生成公私钥对，将公钥放入
/home/batocera/.ssh/authorized_keys； - 定期关闭服务：维护完成后删除
ssh.enabled文件并重启； - 启用失败锁定：结合
fail2ban防止暴力破解（需额外集成）。
自动化运维场景
有了 SSH，很多原本繁琐的操作变得简单：
- 使用
scp批量上传 ROM：bash scp *.zip batocera@192.168.1.100:/userdata/roms/neogeo/ - 使用
rsync同步存档：bash rsync -avz saves/ batocera@192.168.1.100:/userdata/saves/ - 编写脚本批量更新配置，适用于多个设备部署。
核心组件四：开机自启脚本 —— init.d 的魔法
前面所有服务都配置好了，但如果不能自动化串联起来，依然不够“智能”。
这时候就需要init.d 脚本机制出场了。
Batocera 支持在/userdata/scripts/init.d/目录下放置开机自启脚本。这些脚本会在系统初始化阶段按字母顺序执行，非常适合用于组合复杂逻辑。
示例：等待网络就绪后再挂载 NAS
设想你有一台 NAS，上面存放了大量 ROM。你想让 Batocera 启动后自动挂载这个共享目录，扩展本地存储。
但要注意：网络还没通的时候去挂载，必然失败。
解决方案：编写一个带重试机制的 init.d 脚本。
#!/bin/bash # /userdata/scripts/init.d/01-mount-nas.sh LOG="/var/log/batocera-mount.log" exec >> "$LOG" 2>&1 echo "$(date): Starting NAS mount script..." # 等待网络连通 echo "Waiting for network..." while ! ping -c1 -W3 google.com &>/dev/null; do sleep 2 done echo "Network is up." # 创建挂载点 mkdir -p /userdata/roms_nas # 挂载 CIFS 共享 mount -t cifs //nas.local/roms /userdata/roms_nas \ -o username=guest,password=,uid=1000,gid=1000,iocharset=utf8,noperm \ && echo "NAS mounted successfully." || echo "Failed to mount NAS." # 可选：软链接部分目录到主 roms 文件夹 ln -sf /userdata/roms_nas/ps2/* /userdata/roms/ps2/ 2>/dev/null || true记得赋予执行权限：
chmod +x /userdata/scripts/init.d/01-mount-nas.sh这样，每次开机都会自动尝试挂载远程存储，真正实现“无限 ROM 扩展”。
架构总览：你的游戏主机，现在是个“服务节点”
经过以上四个模块的整合，我们的 Batocera 不再是一个封闭的游戏盒子，而是一个具备完整网络服务能力的嵌入式系统。
它的典型工作流程如下：
- 上电启动，内核加载；
- NetworkManager 自动连接 Wi-Fi 或获取有线 IP；
- init.d 脚本运行，等待网络就绪，挂载远程存储、同步时间；
- Samba 服务启动，共享
/userdata/roms； - SSH 根据标志位决定是否开启；
- EmulationStation 前端启动，用户开始游戏；
- 局域网内其他设备可通过 SMB、SSH、WebUI 与其交互。
整个过程无需人工干预，完全自动化。
解决哪些实际痛点？
| 传统问题 | 我们的解决方案 |
|---|---|
| 拷贝 ROM 要拆卡 | Samba 共享，支持无线拖拽 |
| 无法远程查看状态 | WebUI + SSH 提供可观测性 |
| 多设备存档不一致 | 结合 NFS/rsync 实现自动同步 |
| 网络不稳定导致断连 | NetworkManager 支持自动重连与多SSID切换 |
甚至还可以进一步拓展：
- 在 init.d 脚本中加入 NTP 时间同步，确保多人游戏帧率一致；
- 使用 inotify 监控 ROM 目录变化，自动刷新 EmulationStation 游戏列表；
- 集成 Dropbox 或 Syncthing，实现跨地域存档同步。
构建建议与工程最佳实践
当你真正动手制作这样一个整合包时，请牢记以下原则：
✅ 最小化原则
只启用必要的服务。例如，在纯家庭环境中可关闭 SSH；若无 Windows 设备，也可不装 Samba。
✅ 安全优先
- 避免明文存储 Wi-Fi 密码；
- 关闭不必要的端口；
- 对外暴露的服务（如 Samba）应设置合理权限；
- 固件定期更新，防止已知漏洞被利用。
✅ 配置参数化
不要把网络名、IP、共享路径写死在脚本里。可以用环境变量或外部配置文件管理，便于批量定制不同用户的镜像。
✅ 日志可追溯
关键操作要有日志记录。建议统一输出到/var/log/下的独立文件，方便排错。
✅ 版本可控
使用 Git 管理你的整合包变更历史。哪怕只是一个脚本修改，也要留下痕迹，支持回滚。
写在最后：从“游戏系统”到“娱乐中枢”
我们今天做的，不只是给 Batocera 加个 Wi-Fi 或开个共享文件夹。
我们在重新定义它的角色：从一个孤立的模拟器前端，进化为家庭局域网中的互动娱乐节点。
未来你能做什么？
- 接入 WebSocket，实现在手机浏览器中实时观看游戏画面；
- 用 Docker 封装不同模拟器，动态加载；
- 结合 AI 工具自动生成游戏封面、简介、分类；
- 搭建局域网聊天室，朋友来了自动推送欢迎消息……
技术从来不是终点，而是通往更好体验的桥梁。
而你现在掌握的方法论，已经足以支撑你走出第一步。
如果你正在打造自己的 Batocera 发行版，或者想为社区贡献一个通用联网模板，欢迎在评论区分享你的想法。让我们一起，把复古的乐趣，带进现代生活。
