benoitmartin/chromium

Chromium 镜像文档

镜像概述和主要用途

本镜像是基于Alpine Linux的Chromium浏览器容器化实现，提供完整的硬件（声音和视频）加速支持。通过X11 socket转发技术直接与主机显示系统通信，无需依赖VNC或SSH等复杂转发方式，简化了容器中Chromium的部署和使用流程。

核心功能和特性

• 硬件加速：支持声音和视频的完整硬件加速，提升媒体播放性能
• X11 socket转发：直接通过X11 socket实现显示输出，避免VNC/SSH转发的复杂性
• 数据持久化：支持Chromium配置数据目录挂载，保持用户数据和浏览设置
• 设备直通：支持声卡（/dev/snd）和DRI设备（/dev/dri）直通，确保硬件资源访问

使用场景和适用范围

适用于需要在容器环境中运行Chromium浏览器，并需利用主机硬件资源（如GPU加速、声卡）和本地显示系统的场景，包括：

• 容器化网页浏览和媒体播放
• 开发环境中的网页兼容性测试
• 需要隔离运行但依赖本地硬件加速的Chromium应用

使用方法和配置说明

基本运行命令

使用以下命令启动Chromium容器：

bash
docker run --rm -it --net host \
           -e DISPLAY=unix$DISPLAY \
           -e ALSA_CARD=1 \
           -v ~/.Xauthority:/root/.Xauthority \
           -v /tmp/.X11-unix:/tmp/.X11-unix \
           -v /var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket \
           -v $HOME/.config/chromium/:/data \
           -v $HOME/Downloads:/home/chromium/Downloads \
           --device /dev/snd \
           --device /dev/dri \
           --name chromium \
           benoitmartin/chromium

配置参数说明

声卡配置

通过ALSA_CARD环境变量指定要使用的声卡设备索引：

查看可用声卡索引：

bash
cat /proc/asound/cards
# 或
aplay -l

更多ALSA配置信息可参考：Arch Linux ALSA 文档

注意事项

1. 用户组权限检查：

   • 确保主机的audio组GID为29，video组GID为44，以保证容器内权限正确

2. 数据目录预创建：

   • 必须在运行容器前手动创建Chromium数据目录，否则容器会以root权限创建该目录，导致容器内chromium用户无法读写。创建命令示例：

   bash
   if [ ! -d "$HOME/.config/chromium/" ]; then
       mkdir -p $HOME/.config/chromium/
   fi