LiveKit Egress容器中Headless Chrome无法识别NVIDIA GPU

问题背景 #

在搭载NVIDIA T4 GPU的EC2 g4dn.xlarge实例（Ubuntu 22.04宿主机）上，尝试通过LiveKit Egress串流WebGL游戏时遇到问题：宿主机独立运行的Headless Chrome可正常识别GPU，WebGL游戏运行流畅，但LiveKit Egress容器内的Headless Chrome始终使用ANGLE (Mesa, Ilvmpipe)软件渲染，无法调用底层NVIDIA T4 GPU。

已完成的前置操作：

• 安装并配置NVIDIA Container Toolkit，验证Docker可正常调用GPU
• 修改docker-compose.yaml，为egress服务添加GPU相关环境变量及资源配置，容器内执行nvidia-smi可正常显示GPU信息
• 在容器内启动google-chrome-stable（版本125.0.6422.141）时添加GPU启用参数，但webglreport仍显示使用软件渲染
• 为Egress Dockerfile添加相关依赖包，问题未解决

排查与解决步骤 #

1. 修正Headless Chrome启动参数 #

Headless Chrome需要明确指定GPU适配参数才能跳过软件渲染路径，启动时使用以下完整参数：

google-chrome-stable \
  --headless=new \
  --disable-gpu-sandbox \
  --use-gl=egl \
  --enable-gpu-rasterization \
  --enable-native-gpu-memory-buffers \
  --disable-software-rasterizer \
  --no-sandbox \
  --disable-dev-shm-usage

关键参数说明：

• --use-gl=egl：强制使用EGL后端，适配容器化GPU环境
• --disable-software-rasterizer：直接禁用软件渲染，避免 fallback 到Ilvmpipe
• --disable-gpu-sandbox：解除容器内GPU沙箱限制，允许Chrome直接访问GPU资源

2. 补齐容器内GPU依赖库 #

虽然nvidia-smi正常，但Chrome依赖的NVIDIA图形库可能缺失，执行以下命令安装匹配版本的GL库：

apt update && apt install -y libnvidia-gl-535

注意：libnvidia-gl版本需与宿主机NVIDIA驱动版本一致，可通过宿主机nvidia-smi查看驱动版本

安装完成后，验证GL渲染器：

glxinfo | grep "OpenGL renderer"

正常输出应包含NVIDIA Tesla T4

3. 完善容器GPU资源配置 #

确保docker-compose.yaml中Egress服务的GPU配置完整，示例配置：

services:
  egress:
    image: livekit/egress:latest
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]
    environment:
      - NVIDIA_VISIBLE_DEVICES=all
      - NVIDIA_DRIVER_CAPABILITIES=compute,utility,graphics
    volumes:
      - /dev/shm:/dev/shm

重点：NVIDIA_DRIVER_CAPABILITIES必须包含graphics，否则容器无法获取GPU图形渲染权限

4. 验证Chrome GPU识别状态 #

启动Chrome后，通过远程调试或curl访问chrome://gpu页面，检查以下核心项：

• Graphics Feature Status中WebGL、WebGL 2需标记为Hardware accelerated
• GPU 0信息需显示为NVIDIA Tesla T4

5. 调整LiveKit Egress内部Chrome启动逻辑 #

如果LiveKit Egress是通过内置逻辑启动Chrome，需修改其配置文件：

• 找到Egress配置中Chrome启动参数的配置项，添加上述GPU强制启用参数
• 确保Egress未覆盖容器内的NVIDIA_*环境变量

内容的提问来源于stack exchange，提问作者Qile