为quay.io Chrome镜像添加PulseAudio实现录屏音频支持

1. 给quay.io/browser/google-chrome-stable镜像添加PulseAudio支持 #

原镜像未预装PulseAudio，直接基于它构建自定义镜像即可，步骤如下：

编写自定义Dockerfile #

FROM quay.io/browser/google-chrome-stable:133.0.6943.98-6

# 安装PulseAudio核心依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    pulseaudio libpulse0 \
    && rm -rf /var/lib/apt/lists/*

# 设置PulseAudio通信所需的环境变量
ENV PULSE_SERVER=unix:/tmp/pulse/native
ENV PULSE_COOKIE=/tmp/pulse/cookie

# 创建共享套接字目录并开放权限，避免容器间权限冲突
RUN mkdir -p /tmp/pulse && chmod 777 /tmp/pulse

# 调整Chrome启动参数，强制走PulseAudio输出
CMD ["google-chrome-stable", "--headless=new", "--no-sandbox", "--use-fake-ui-for-media-stream", "--enable-features=AudioServiceOutOfProcess", "--alsa-output-device=pulse"]

构建镜像：docker build -t chrome-with-pulseaudio .

2. 无头Chrome配置PulseAudio的注意事项&最佳实践 #

• 权限必须放开：PulseAudio通过Unix套接字通信，共享目录需设为777权限，或让Chrome容器的UID与PulseAudio服务器的UID一致，否则会出现连接失败
• 处理沙箱冲突：Chrome沙箱会限制音频服务访问，无头模式下必须添加--no-sandbox参数；若需保留沙箱，可尝试--enable-audio-service-sandbox（部分版本支持）
• 跳过权限弹窗：必须添加--use-fake-ui-for-media-stream，否则Chrome会弹出音频权限请求，无头模式下无法处理，直接导致音频输出失败
• 测试连通性：在Chrome容器内安装alsa-utils，执行paplay /usr/share/sounds/alsa/Front_Center.wav测试音频播放，快速排查问题
• 禁用空闲超时：若使用独立Pulse容器，需将exit-idle-time设为-1，避免空闲时服务器自动退出导致Chrome音频中断

3. PulseAudio服务器：独立容器还是集成到Chrome？ #

两种方案均可行，可根据场景选择：

方案1：集成到Chrome容器（适合单实例场景） #

• 优点：配置简单，无需处理跨容器通信，直接启动即可使用
• 缺点：容器体积增大（新增PulseAudio依赖），音频服务与Chrome耦合，无法为多个Chrome实例共享

方案2：独立PulseAudio容器（适合多实例或统一管理） #

• 优点：支持多个Chrome容器共享一个音频服务，方便统一将音频输出到FFmpeg或其他服务
• 用Docker Compose实现的参考配置：

目录结构

./
├── chrome/
│   └── Dockerfile  # 上述带Pulse的Chrome镜像配置
├── pulseaudio/
│   └── Dockerfile
└── docker-compose.yml

pulseaudio/Dockerfile

FROM debian:bookworm-slim

RUN apt-get update && apt-get install -y --no-install-recommends \
    pulseaudio \
    && rm -rf /var/lib/apt/lists/*

# 创建普通用户运行Pulse，规避root权限风险
RUN useradd -m pulse
USER pulse

# 配置允许匿名Unix套接字连接，关闭空闲超时
RUN echo "load-module module-native-protocol-unix auth-anonymous=1 socket=/tmp/pulse/native" >> /etc/pulse/default.pa
RUN echo "exit-idle-time=-1" >> /etc/pulse/daemon.conf

docker-compose.yml

version: '3.8'

services:
  pulseaudio:
    build: ./pulseaudio
    volumes:
      - pulse-socket:/tmp/pulse
      - pulse-cookie:/home/pulse/.config/pulse
    command: pulseaudio -nF /etc/pulse/default.pa --exit-idle-time=-1

  chrome:
    build: ./chrome
    volumes:
      - pulse-socket:/tmp/pulse
      - pulse-cookie:/tmp/pulse/cookie
    environment:
      - PULSE_SERVER=unix:/tmp/pulse/native
      - PULSE_COOKIE=/tmp/pulse/cookie
    depends_on:
      - pulseaudio
    # 可添加自定义Chrome启动参数，如访问指定页面
    # command: ["google-chrome-stable", "--headless=new", "--no-sandbox", "--use-fake-ui-for-media-stream", "--enable-features=AudioServiceOutOfProcess", "--alsa-output-device=pulse", "https://example.com"]

  ffmpeg:
    image: jrottenberg/ffmpeg:4.4-alpine
    volumes:
      - pulse-socket:/tmp/pulse
    environment:
      - PULSE_SERVER=unix:/tmp/pulse/native
    # 替换为你的流地址或输出文件路径
    command: ffmpeg -f pulse -i default -f x11grab -i xvfb:0.0 -c:v libx264 -c:a aac -f flv rtmp://your-stream-server/live/stream-key
    depends_on:
      - chrome

volumes:
  pulse-socket:
  pulse-cookie:

启动服务：docker-compose up -d

内容的提问来源于stack exchange，提问作者Ahmed Seddik Bouchiba