Snapcast Server Docker 镜像文档

镜像概述与主要用途

本镜像为 Snapcast Server 的 Docker 封装。Snapcast Server 是一个轻量级多房间音频同步服务器，核心功能是接收音频流并将其同步分发到多个 Snapcast 客户端，实现多设备间低延迟音频同步播放。

主要用途：构建自定义多房间音频系统，支持多设备（如扬声器、音响）同步播放同一音频源。

核心功能与特性

• 多房间音频同步：通过网络将音频流同步分发到多个客户端，确保各设备播放延迟一致。
• 默认音频流：内置默认配置，自动创建名为 "Snapserver" 的基础音频流，开箱即用。
• 配置灵活性：支持通过挂载自定义配置文件，调整音频流参数、网络设置等。
• Docker 化部署：简化部署流程，通过容器化方式快速搭建服务，减少环境依赖。

使用场景与适用范围

• 家庭多房间音频系统：在客厅、卧室、书房等多个房间部署客户端，实现全屋同步播放音乐、播客等。
• 办公/商业场所背景音：在办公室、店铺等场景，通过多设备同步播放背景音乐或通知。
• 自定义音频流需求：需根据实际场景调整音频编码、采样率等参数的高级用户。

使用方法与配置说明

基本运行命令

通过以下命令启动 Snapcast Server 容器，可根据需求调整挂载目录和端口映射：

docker run --rm -v /tmp/snapcast:/tmp/snapcast -p 1704:1704 -p 1705:1705 ivdata/snapserver

参数说明：

• --rm：容器停止后自动删除，避免残留文件。
• -v /tmp/snapcast:/tmp/snapcast：挂载主机的 /tmp/snapcast 目录到容器内同路径，用于 Snapcast 创建 FIFO（命名管道）文件，实现音频流传输。
• -p 1704:1704 -p 1705:1705：端口映射，容器内部使用 1704 和 1705 端口（不可修改），外部可通过调整主机端口（冒号前数值）自定义访问端口。
• ivdata/snapserver：Docker 镜像名称。

配置说明

默认配置

容器内置默认配置文件，自动创建一个名为 "Snapserver" 的音频流，适用于基础多房间同步场景。

自定义配置

如需调整配置（如添加多音频流、修改网络参数等），可通过挂载自定义配置文件覆盖默认配置：

1. 本地创建 snapserver.conf 配置文件（参考 Snapcast 官方文档 编写）。
2. 启动容器时添加挂载参数：

   docker run --rm -v /tmp/snapcast:/tmp/snapcast -v /path/to/your/snapserver.conf:/etc/snapserver.conf -p 1704:1704 -p 1705:1705 ivdata/snapserver
   

   其中 /path/to/your/snapserver.conf 为本地配置文件路径，容器将使用该文件替换默认的 /etc/snapserver.conf。

镜像更新说明

本镜像通过环境变量指定 Snapcast 版本。当 Snapcast 官方发布新版本时，可通过以下方式更新镜像：

1. 基于最新版本重建镜像（需修改 Dockerfile 中的版本环境变量）。
2. 重建后建议通知镜像维护者，以便更新官方仓库中的镜像版本。