andrewmackrodt/redream-x11

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版本支持的当前版本。容器启动时会检查主机驱动版本，若存在版本不匹配，将尝试在容器内安装正确驱动，除非满足以下任一条件：

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

推荐通过第一种方式（挂载主机驱动库）为容器添加NVIDIA驱动支持。有关在主机上生成所需文件的示例，请参见https://gist.github.com/andrewmackrodt/e5f9eaf63c9296db73901796bc46a3f8。也可通过https://github.com/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

参数说明