saiyato/snapclient

SnapClient Docker镜像

镜像概述和主要用途

SnapClient是SnapCast多房间音频同步系统的客户端组件，用于接收服务器音频流并实现多设备间的精确同步播放。本Docker镜像将SnapClient容器化，采用轻量级Alpine作为基础镜像，支持ARM32v6/7、ARM64v8、AMD64和i386等多种架构，旨在提供高效、低资源占用的多房间音频解决方案。它不是独立播放器，而是将现有音频系统扩展为类Sonos的多房间同步播放系统。

核心功能和特性

• 多房间同步播放：所有客户端与SnapServer时间同步，实现完美同步的音频播放
• 轻量级设计：基于Alpine基础镜像，相比传统Raspbian镜像体积更小，资源占用更低
• 多架构支持：提供ARM32v6、ARM32v7、ARM64v8、AMD64和i386架构镜像，适配多种设备
• 安全运行模式：无需使用--privileged特权模式，通过设备挂载实现音频访问
• 灵活的音频输出：支持ALSA、HifiBerry、BossDAC等多种声卡设备
• 可选PulseAudio支持：通过-with-pulse标签获取带PulseAudio支持的版本

使用场景和适用范围

• 家庭多房间音频系统构建
• 智能家居音频解决方案
• 与MPD或Mopidy等音乐播放器配合使用
• 需要跨设备同步音频播放的场景
• 资源受限的嵌入式设备（如树莓派）音频应用

详细使用方法和配置说明

前提条件

• 已安装Docker环境
• 可访问的SnapServer服务
• 主机音频设备权限

查看可用声卡

在运行容器前，可先查看系统可用的声卡设备：

bash
# 通过SnapClient查看
docker run --rm --device /dev/snd saiyato/snapclient -l

# 或通过aplay命令查看（需主机安装alsa-utils）
aplay -l

BossDAC声卡示例输出

0: null
Discard all samples (playback) or generate zero samples (capture)

1: default:CARD=ALSA
bcm2835 ALSA, bcm2835 ALSA
Default Audio Device

3: default:CARD=BossDAC
BossDAC,
Default Audio Device

HifiBerry声卡示例输出

**** List of PLAYBACK Hardware Devices ****
card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
card 1: sndrpihifiberry [snd_rpi_hifiberry_dac], device 0: HifiBerry DAC HiFi pcm5102a-hifi-0

基本运行命令

临时运行（退出后自动清理容器）

bash
docker run \
--rm \
--name snapclient \
--device /dev/snd \
saiyato/snapclient \
-h 192.168.1.10 \  # SnapServer服务器IP
-s BossDAC         # 指定声卡（可选，默认使用系统默认设备）

后台运行（守护进程模式）

bash
docker run \
--rm \
-d \
--name snapclient \
--device /dev/snd \
saiyato/snapclient \
-h 192.168.1.10 \
-s sndrpihifiberry

参数说明

• --device /dev/snd: 挂载主机音频设备
• -h <IP>: 指定SnapServer服务器IP地址
• -s <card_name>: 指定使用的声卡名称（可选）
• -d: 后台运行容器
• --rm: 容器退出后自动删除

构建和推送镜像（高级用户）

手动构建镜像

1. 克隆仓库
2. 使bash脚本可执行：chmod +x *.sh
3. 安装Docker Desktop
4. 执行构建脚本：

bash
./build-multiarch.sh -t <自定义标签> -f <Dockerfile>
# 示例: ./build-multiarch.sh -t saiyato/snapclient:arm32v7 -f Dockerfile.arm32v7

推送至Docker Hub

1. 完成上述构建步骤
2. 登录Docker：docker login
3. 执行推送脚本：

bash
./push_to_dockerhub.sh -i <镜像名称>
# 示例: ./push_to_dockerhub.sh -i saiyato/snapclient

镜像标签说明

• latest: 自动选择适合当前架构的最新版本（无PulseAudio支持）
• latest-with-pulse: 带PulseAudio支持的最新版本
• 架构特定标签: arm32v6, arm32v7, arm64v8, amd64, i386
• 架构+PulseAudio标签: 如arm32v7-with-pulse

状态信息

!Docker Cloud Build Status
!Docker Pulls

各架构镜像大小

• ARM32v6: !Docker Image Size (tag)
• ARM32v7: !Docker Image Size (tag)
• ARM64v8: !Docker Image Size (tag)
• AMD64: !Docker Image Size (tag)
• i386: !Docker Image Size (tag)

注意：Raspbian基础镜像已停止维护，推荐使用Alpine基础镜像，体积更小且兼容Debian系统。