andrewmackrodt/docker-redream-x11

Redream 是一款开发中的Dreamcast模拟器，能够让您以高清方式畅玩喜爱的Dreamcast游戏。本Docker镜像基于Ubuntu 22.04，提供redream的每日构建版本，并集成NVIDIA 525驱动，便于在容器环境中实现高性能运行。

核心功能与特性

OpenGL加速：支持Mesa DRI/GLX和NVIDIA显卡加速†
音频支持：通过PulseAudio提供音频输出
控制器兼容：已测试无线DS4手柄通过蓝牙连接使用

† NVIDIA驱动说明

镜像中预安装了libnvidia-gl-525驱动，这是最新Ubuntu LTS版本支持的当前版本。容器启动时会检查主机驱动版本，若存在版本不匹配，将尝试在容器内安装正确驱动，除非满足以下任一条件：

存在以下任一目录：/usr/local/nvidia/lib、/usr/local/nvidia/lib64 或 /nvidia。此时假设正确的库文件已从主机挂载，这些目录将被添加到 /etc/ld.so.conf.d/nvidia.conf。
已设置环境变量 NVIDIA_SKIP_DOWNLOAD=1。
容器内已安装的驱动版本与主机 /proc/driver/nvidia/version 匹配。

推荐通过第一种方式（挂载主机驱动库）为容器添加NVIDIA驱动支持。有关在主机上生成所需文件的示例，请参见此处。也可通过nvidia-docker实现驱动集成。

使用场景与适用范围

适用于希望在Docker环境中运行Dreamcast游戏的用户，尤其适合需要高清渲染、音频输出和控制器支持的场景。支持Linux主机环境，兼容Mesa和NVIDIA显卡，适合个人游戏娱乐使用。

使用方法

Docker命令示例

bash
# 检测要传递的GPU设备
GPU_DEVICES=$( \
    echo "$( \
        find /dev -maxdepth 1 -regextype posix-extended -iregex '.+/nvidia([0-9]|ctl|-modeset)' \
            | grep --color=never '.' \
          || echo '/dev/dri'\
      )" \
      | sed -E "s/^/--device /" \
  )

# 创建容器
docker create \
  --name redream \
  --net host \
  --device /dev/input \
  --device /dev/snd \
  $GPU_DEVICES \
  -v $HOME/Games/Dreamcast:/games:ro \
  -v $HOME/.redream/vmu:/vmu \
  -v $HOME/.redream/saves:/saves \
  -v $HOME/.redream/config:/config \
  -v $HOME/.redream/bios:/bios \
  -v $HOME/.redream/cache:/cache \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  -e DISPLAY=unix$DISPLAY \
  -e XDG_RUNTIME_DIR=/run/user/$(id -u) \
  -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
  -v /etc/machine-id:/etc/machine-id:ro \
  -v $HOME/.config/pulse:/home/ubuntu/.config/pulse:ro \
  -v /run/user/$(id -u)/pulse:/run/user/$(id -u)/pulse:ro \
  -v /run/udev/data:/run/udev/data:ro \
  -v /etc/localtime:/etc/localtime:ro \
  andrewmackrodt/redream-x11

参数说明

参数	功能说明
`-e PUID=1000`	用户ID，推荐使用：`$(id -u)`获取当前用户ID
`-e PGID=1000`	组ID，推荐使用：`$(id -g)`获取当前组ID
`-e SUDO_NOPASSWD=0`	设置为`1`可允许无密码sudo权限
`-e TZ=UTC`	时区，例如"Asia/Shanghai"（亚洲/上海）
`-v /games`	redream游戏目录（只读挂载）
`-v /vmu`	redream VMU保存文件目录（vmu*.bin）
`-v /saves`	redream存档状态目录
`-v /config`	redream配置文件目录（含redream.cfg、redream.key）
`-v /bios`	redream BIOS文件目录（含boot.bin、flash.bin）
`-v /cache`	redream缓存目录