andrewmackrodt/dolphin-emu-x11

andrewmackrodt/docker-dolphin-emu-x11

镜像概述和主要用途

Dolphin 是一款针对任天堂GameCube和Wii游戏机的模拟器，允许PC玩家以全高清（1080p）画质运行这两款主机的游戏，并提供多项增强功能，包括全PC控制器兼容、加速运行、网络多人游戏等。本Docker镜像基于Ubuntu 22.04构建，包含Dolphin模拟器的每日构建版本及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驱动。

使用场景和适用范围

适用于希望在PC上通过Docker容器便捷运行GameCube和Wii游戏的用户，尤其适合需要隔离运行环境、简化部署流程或进行版本管理的场景。支持本地控制器、蓝牙设备连接，可满足游戏爱好者在不同系统环境下的模拟需求。

使用方法和配置说明

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 /" \
  )

# 获取XDG运行时目录
XDG_RUNTIME_DIR="${XDG_RUNTIME_DIR:-/run/user/$(id -u)}"

# 创建容器
docker create \
  --name dolphin-emu \
  --security-opt apparmor:unconfined \
  --net host \
  --shm-size 128M \
  --device /dev/input \
  --device /dev/snd \
  $GPU_DEVICES \
  -v $HOME/.dolphin-emu/Config:/config \
  -v $HOME/.dolphin-emu:/data \
  -v $HOME/Games/GameCube:/gc:ro \
  -v $HOME/Games/Wii:/wii:ro \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  -e DISPLAY=unix$DISPLAY \
  -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 $XDG_RUNTIME_DIR:/run/user/$(id -u)/pulse:ro \
  -v $XDG_RUNTIME_DIR/bus:$XDG_RUNTIME_DIR/bus:ro \
  -v /var/lib/dbus/machine-id:/var/lib/dbus/machine-id:ro \
  -v /run/dbus:/run/dbus:ro \
  -v /run/udev/data:/run/udev/data:ro \
  -v /etc/localtime:/etc/localtime:ro \
  andrewmackrodt/dolphin-emu-x11

参数说明