linuxserver/mame

linuxserver/mame 镜像文档

概述

linuxserver/mame是基于MAME项目的Docker镜像。MAME（Multiple Arcade Machine Emulator）是一款免费开源的硬件模拟器，旨在通过软件在现代个人计算机上模拟街机游戏、视频游戏机、旧电脑及其他系统的硬件，实现对经典系统的复现和使用。

核心功能与特性

• 免费开源：基于MAME项目，遵循开源许可协议，允许自由使用和修改
• 多系统模拟：支持模拟街机游戏、视频游戏机（如Atari、NES等）、早期个人计算机等多种硬件系统
• Web访问支持：通过指定端口可通过Web界面访问模拟器，简化使用流程
• 配置持久化：支持通过卷挂载保存配置文件，确保配置信息不丢失
• 资源灵活配置：可自定义共享内存大小，优化模拟器运行性能

使用场景

• 复古游戏体验：供复古游戏爱好者在现代设备上运行和体验经典街机、游戏机游戏
• 硬件模拟开发：用于开发或测试针对旧系统硬件的软件程序
• 教育与展示：作为教学工具，展示早期计算机和游戏硬件的工作原理及历史演变

使用方法

Docker Run命令示例

bash
docker run -d \
  --name=mame \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  -v /path/to/mame/assets:/mame:ro \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/mame:latest

参数说明

环境变量

• PUID=1000：运行容器的用户ID，用于权限控制，默认1000
• PGID=1000：运行容器的用户组ID，用于权限控制，默认1000
• TZ=Etc/UTC：容器时区设置，默认Etc/UTC，可根据需求修改（如Asia/Shanghai）

端口映射

• -p 3000:3000：模拟器内部服务端口，用于应用内部通信
• -p 3001:3001：Web访问端口，用于通过浏览器访问应用界面

卷挂载

• -v /path/to/config:/config：配置文件存储卷，用于持久化保存应用配置
• -v /path/to/mame/assets:/mame:ro：MAME资源文件卷（只读），存放模拟器所需的游戏ROM、BIOS等资产文件

其他参数

• --shm-size="1gb"：设置容器共享内存大小，建议设置为1GB以保证运行性能
• --restart unless-stopped：容器重启策略，除非手动停止否则自动重启

访问方法

应用启动后，可通过以下地址访问：
https://yourhost:3001/
（将yourhost替换为实际运行容器的主机IP或域名）