saiyato/snapserver

SnapCast

镜像概述和主要用途

SnapCast是一款多房间客户端-服务器音频播放器，通过时间同步技术使所有客户端与服务器保持完美的音频同步。它并非独立播放器，而是一种扩展工具，可将现有音频播放器转变为类Sonos的多房间解决方案。本镜像为SnapCast的服务器组件（SnapServer）的Docker化版本，基于Alpine最小镜像构建，支持ARM等多种架构，二进制文件从源码编译而非使用预构建包。

核心功能和特性

• 轻量级基础：基于{arch}/alpine:latest最小镜像，降低资源占用
• 源码构建：二进制文件从源码编译，确保最新功能和兼容性
• 多架构支持：提供arm32v6、arm32v7、arm64v8、amd64和i386架构镜像
• 时间同步：所有客户端与服务器精确时间同步，实现无延迟音频播放
• 灵活输入：服务器音频输入为命名管道/tmp/snapfifo，支持多种音频源接入

使用场景和适用范围

• 家庭或办公环境中的多房间音频同步播放需求
• 需要将MPD、Mopidy等现有音频播放器扩展为多房间系统的场景
• 基于ARM架构设备（如树莓派）或x86架构设备的Docker环境部署

详细使用方法和配置说明

构建容器（可选）

如需自行构建镜像，可按以下步骤操作：

1. 克隆仓库：git clone https://github.com/Saiyato/snapserver_docker
2. 使构建脚本可执行：chmod +x *.sh
3. 安装Docker Desktop
4. 执行构建命令：

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

如需上传到个人Docker Hub仓库：

1. 完成上述构建步骤
2. 登录Docker：docker login
3. 执行上传命令：

   bash
   ./push_to_dockerhub.sh -i <镜像名>
   # 示例：./push_to_dockerhub.sh -i saiyato/snapserver
   

   上传脚本会自动查找并推送arm32v6、arm32v7、arm64v8、amd64和i386架构的镜像标签

运行容器要求

• 挂载命名管道：需将宿主机的/tmp/snapfifo挂载到容器内同路径，作为音频输入源
• 端口映射：需开放以下端口
  • 1704：音频流传输
  • 1705：TCP控制协议
  • 1780：HTTP控制接口
• 流定义参数：语法格式为pipe://{fifo路径}?{名称}&{模式}&{采样格式}

配置覆盖

可通过挂载自定义配置文件覆盖默认设置：

bash
-v /path/to/your/snapserver.conf:/etc/snapserver.conf

默认配置创建名为"SnapServer"的单个流，更多配置选项详见https://github.com/badaix/snapcast#configuration

Docker部署示例

1. 使用host网络（推荐）

bash
docker run \
--rm \
--network host \
--name snapserver \
-v /tmp/snapfifo:/tmp/snapfifo \
saiyato/snapserver:{arch} \
--stream.stream  pipe:///tmp/snapfifo?name={stream_name}&mode=read&sampleformat=44100:16:2

替换{arch}为实际架构（如arm32v7、amd64），{stream_name}为自定义流名称

2. 指定独立IP和端口映射

bash
docker run \
--rm \
--name snapserver \
-v /tmp/snapfifo:/tmp/snapfifo \
-p 1704:1704 \
-p 1705:1705 \
-p 1780:1780 \
saiyato/snapserver:{arch} \
--stream.stream  pipe:///tmp/snapfifo?name={stream_name}&mode=read&sampleformat=44100:16:2

3. Docker Compose配置

yaml
version: "3"

services:
  snapserver:
    image: saiyato/snapserver:{arch}
    container_name: snapserver
    restart: unless-stopped
    network_mode: host
    volumes:
      - /tmp/snapfifo:/tmp/snapfifo
    command: --stream.stream  pipe:///tmp/snapfifo?name={stream_name}&mode=read&sampleformat=44100:16:2

测试验证

1. 使用SnapDroid（应用商店下载）等客户端连接服务器
2. 向命名管道输入测试音频：

   bash
   sudo cat /dev/urandom > /tmp/snapfifo
   

3. 客户端应能接收到并播放同步的测试音频

镜像状态

• 总体构建状态：!Docker Cloud Build Status
• 拉取次数：!Docker Pulls
• ARM32v6镜像大小：!Docker Image Size (tag)
• ARM32v7镜像大小：!Docker Image Size (tag)
• ARM64v8镜像大小：!Docker Image Size (tag)
• i386镜像大小：!Docker Image Size (tag)
• AMD64镜像大小：!Docker Image Size (tag)