andrewmackrodt/docker-chromium-x11

Chromium是一个开源浏览器项目，旨在为所有互联网用户构建更安全、更快、更稳定的网页体验。本镜像基于Ubuntu 22.04和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驱动的推荐方法。参见此处获取在主机上生成所需文件的示例。也可通过nvidia-docker实现。

使用场景与适用范围

适用于需要在Docker环境中运行Chromium浏览器的场景，尤其适合需要硬件加速图形渲染、音频输出或游戏控制器支持的用户，可用于开发测试、网页兼容性验证或需要隔离浏览器环境的应用。

使用方法与配置说明

Docker部署示例

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

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

# 创建容器
docker create \
  --name chromium \
  --cap-add SYS_ADMIN \
  --security-opt apparmor:unconfined \
  --net host \
  --device /dev/input \
  --device /dev/snd \
  $GPU_DEVICES \
  -v $HOME/Downloads:/downloads \
  -v $HOME/.config/chromium:/data \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  -e DISPLAY=unix$DISPLAY \
  -e LANG=${LANG:-en_US.UTF-8} \
  -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
  -v /dev/shm:/dev/shm \
  -v $HOME/.config/pulse:/home/ubuntu/.config/pulse:ro \
  -v /etc/machine-id:/etc/machine-id:ro \
  -v $XDG_RUNTIME_DIR/pulse:$XDG_RUNTIME_DIR/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/chromium-x11

配置参数说明

关键配置说明

• GPU设备传递：通过GPU_DEVICES变量自动检测并传递NVIDIA或DRI设备，确保图形加速正常工作。
• 音频配置：挂载PulseAudio相关目录和文件，实现容器内音频输出。
• 数据持久化：通过-v $HOME/.config/chromium:/data挂载本地Chromium配置目录，保留用户数据和设置。
• 权限设置：通过PUID和PGID指定容器内用户ID和组ID，避免权限问题。