如何在树莓派5的Docker容器中接入ALSA音频设备

我在树莓派5上运行Docker容器，目标是在容器内访问树莓派的ALSA音频设备。容器外音频功能正常，但在容器内执行aplay someaudio.wav时出现错误：aplay: main:831: audio open error: Unknown error 524。

当前配置文件 #

Dockerfile #

FROM python:3.12.4-slim-bookworm

ARG TARGETARCH

RUN apt update && apt upgrade -y && \
apt install -y wget gcc swig libmariadb-dev libasound2-dev alsa-utils

RUN if [ "$TARGETARCH" == "armhf" ]; then\
apt install build-essentials cmake -y ; \
else \
    apt install build-essential -y ; \
fi

COPY src/app /app

RUN pip install -r /app/requirements.txt

WORKDIR /app
ENTRYPOINT [ "uvicorn", "app:app", "--port", "8000", "--host", "0.0.0.0" ]

docker-compose.yml #

backend:
    image: pythonbasedimage
    volumes:
      - ${PWD}/.env:/app/.env
    devices:
      - "/dev/snd:/dev/snd"
    privileged: true
    ports:
      - "8000:8000"
    deploy:
      resources:
        limits:
          cpus: "0.5"

alsactl info输出 #

#
# Sound card
#
- card: 0
  id: vc4hdmi0
  name: vc4-hdmi-0
  longname: vc4-hdmi-0
  driver_name: vc4-hdmi
  mixer_name:
  components:
  controls_count: 5
  pcm:
    - stream: PLAYBACK
      devices:
        - device: 0
          id: MAI PCM i2s-hifi-0
          name: MAI PCM i2s-hifi-0
          subdevices:
            - subdevice: 0
              name: subdevice #0
alsactl: rawmidi_device_list:105: snd_ctl_rawmidi_next_device

解决方法 #

错误524通常和ALSA设备的权限、共享内存或设备节点映射不全有关，针对树莓派5的vc4-hdmi音频设备，可尝试以下调整：

• 添加共享内存卷映射
  树莓派的ALSA驱动可能需要访问/dev/shm，在docker-compose的volumes节点下补充：

volumes:
  - ${PWD}/.env:/app/.env
  - /dev/shm:/dev/shm

• 补充音频设备节点映射
  除/dev/snd外，还需映射设备路径节点，在docker-compose的devices节点下添加：

devices:
  - "/dev/snd:/dev/snd"
  - "/dev/snd/by-path:/dev/snd/by-path"

• 配置音频组权限
  获取主机上audio组的ID（通常为29），在docker-compose中添加组映射：

group_add:
  - "29"

也可以直接使用主机用户身份运行容器（需确保主机UID/GID环境变量已设置）：

user: "${UID}:${GID}"

• 指定ALSA默认设备
  在容器内配置默认音频设备，可在Dockerfile中添加：

RUN echo 'pcm.!default { type hw; card 0; device 0; }' > /etc/asound.conf
RUN echo 'ctl.!default { type hw; card 0; }' >> /etc/asound.conf

或者通过volumes挂载主机的asound.conf文件到容器对应路径。

• 验证设备识别
  进入容器后先检查设备是否被识别，再测试播放：

docker exec -it <容器名称> aplay -l
docker exec -it <容器名称> aplay someaudio.wav

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