镜像概述

本镜像为运行Snapcast服务器并集成Spotify支持的Docker容器。Snapcast是一款轻量级音频流同步服务器，可实现多设备间的低延迟音频同步播放；集成Spotify支持后，可直接对接Spotify音乐服务，适用于构建同步音频播放系统。

核心功能与特性

• Snapcast服务器核心功能：支持音频流接收与分发，实现多客户端设备的音频同步播放，延迟可低至毫秒级
• Spotify集成：通过librespot等组件支持Spotify Connect，可直接播放Spotify音乐库内容
• 容器化部署：简化依赖管理，无需手动配置音频驱动或复杂环境，一键启动
• 跨平台兼容：可运行于任何支持Docker的系统（如Linux、Windows、macOS）
• 可配置性：支持自定义端口、音频质量、日志级别等参数，适配不同使用场景

使用场景

• 家庭多房间音频系统：在客厅、卧室等多个房间部署Snapcast客户端，通过本服务器实现Spotify音乐的同步播放
• 个人媒体中心：作为家庭媒体中心的音频核心，与Kodi、Plex等媒体软件配合，同步播放Spotify背景音乐
• 小型活动场景：聚会、展览等场景下，通过多设备同步播放Spotify音乐，提升音频覆盖范围

使用方法与配置说明

快速启动（docker run）

docker run -d \
  --name snapcast-spotify \
  -p 1704:1704 \  # Snapcast服务器端口
  -p 1705:1705 \  # Snapcast控制端口
  -e SPOTIFY_DEVICE_NAME="Snapcast Server" \  # Spotify Connect显示名称
  -e AUDIO_QUALITY="320k" \  # 音频质量（128k/192k/320k）
  djmaze/librespot-snapserver

Docker Compose配置示例

version: '3'
services:
  snapcast-spotify:
    image: djmaze/librespot-snapserver
    container_name: snapcast-spotify
    ports:
      - "1704:1704"  # Snapcast音频流端口
      - "1705:1705"  # Snapcast HTTP控制端口
    environment:
      - SPOTIFY_DEVICE_NAME="Home Audio Server"  # 在Spotify Connect中显示的设备名称
      - LOG_LEVEL="info"  # 日志级别：debug/info/warn/error
      - SNAPCAST_BUFFER="100"  # 同步缓冲时间（毫秒），默认100ms
    volumes:
      - ./snapcast-config:/etc/snapserver  # 持久化配置文件（可选）
    restart: unless-stopped

环境变量说明

配置说明

1. Spotify连接：启动容器后，在Spotify客户端（手机/电脑）的“设备”列表中选择配置的SPOTIFY_DEVICE_NAME设备，即可开始播放音乐
2. 客户端连接：在需要同步播放的设备上安装Snapcast客户端（如snapclient），配置客户端连接至本服务器的SNAPCAST_PORT端口
3. 高级配置：如需自定义音频编码、网络参数等，可通过挂载配置文件卷（如/etc/snapserver/snapserver.conf）进行修改，详细配置项参考GitHub源码

注意事项

• 确保Docker宿主机网络稳定，低延迟网络环境可提升音频同步效果
• 若Spotify连接失败，检查网络防火墙是否放行相关端口，或尝试重启容器刷新认证状态
• 多客户端同步时，建议将客户端设备的系统时间同步至NTP服务器，减少时间偏差导致的不同步问题