woahbase/alpine-pulseaudio

Alpine-PulseAudio

基于Alpine Linux的PulseAudio + Bluez容器

此镜像将PulseAudio网络声音服务器容器化，用于在本地网络中搭建中央声音服务，同时运行Bluez蓝牙守护进程以支持蓝牙音箱或音源。包含Pulsemixer工具，可通过命令行管理PulseAudio。

基于集成s6 init系统的alpine-s6镜像构建，支持以下架构：

• armhf（嵌入binfmt_misc支持，可在x64环境运行）
• x86_64（标记为latest）

获取镜像

从Docker Hub拉取对应架构的镜像：

bash
docker pull docker.xuanyuan.run/woahbase/alpine-pulseaudio:x86_64

核心功能

1. 网络声音服务：提供本地网络内的中央声音转发与管理
2. 蓝牙支持：集成Bluez守护进程，兼容蓝牙音频设备
3. CLI管理：通过Pulsemixer实现命令行音频控制
4. 多架构兼容：支持x86_64和armhf平台部署
5. 灵活配置：可自定义PulseAudio/蓝牙配置与持久化数据

使用场景

• 家庭网络声音中心：多设备共享同一音频输出
• 蓝牙设备管理：统一管理多台蓝牙音箱或音源
• 嵌入式设备音频服务：在树莓派等arm设备上搭建轻量音频服务器

配置说明

• PulseAudio配置：挂载/etc/pulse目录自定义声卡设置
• 蓝牙配置：挂载/etc/bluetooth与/var/lib/bluetooth持久化配对设备
• 端口映射：开放4713端口以允许客户端连接
• 环境变量：设置DISABLEBLUETOOTH=true可禁用蓝牙服务
• 权限设置：通过PUID/PGID指定运行用户，避免权限问题

部署示例

多架构支持（非x86_64环境）

bash
docker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset

启动容器

bash
docker run --rm -it \
  --name docker_pulseaudio --hostname pulseaudio \
  -c 256 -m 256m \
  -e PGID=1000 -e PUID=1000 \
  -p 4713:4713 \
  --net=host \
  --cap-add NET_ADMIN \
  --device /dev/snd \
  --device /dev/bus/usb \
  -v ./config/pulse:/etc/pulse \ # 可选：自定义PulseAudio配置
  -v ./config/bluetooth:/var/lib/bluetooth \ # 可选：持久化蓝牙设备
  -v /var/run/dbus:/var/run/dbus \
  -v /etc/localtime:/etc/localtime:ro \
  woahbase/alpine-pulseaudio:x86_64

停止/重启容器

bash
# 停止
docker stop -t 2 docker_pulseaudio
# 重启
docker restart docker_pulseaudio

开发与维护

构建镜像（x86_64为例）

bash
git clone https://github.com/woahbase/alpine-pulseaudio
cd alpine-pulseaudio
docker build --rm --compress \
  -f ./Dockerfile_x86_64 \
  --build-arg ARCH=x86_64 \
  -t woahbase/alpine-pulseaudio:x86_64 .

维护信息

• 源码：https://github.com/woahbase/alpine-pulseaudio
• 镜像：https://hub.docker.com/r/woahbase/alpine-pulseaudio
• 维护者：WOAHBase