ssankur/librespot

镜像概述

基于Alpine Linux构建的librespot 0.8.0 Docker镜像，集成开源Spotify客户端实现librespot，提供Spotify Connect协议支持，可作为Spotify Connect目标设备接收并播放Spotify音频流。镜像体积轻量，默认配置alsa音频后端，支持自定义参数调整，适用于各类需要Spotify Connect功能的场景。

核心功能与特性

• 轻量级基础：采用Alpine Linux作为基础镜像，镜像体积小，资源占用低，适合嵌入式设备及资源受限环境
• Spotify Connect支持：完整实现Spotify Connect协议，可被Spotify客户端发现并选为音频播放目标
• 默认音频配置：预配置alsa音频后端，开箱支持主流音频设备，无需复杂前置设置
• 参数可扩展性：支持通过命令行参数覆盖默认配置，灵活调整设备名称、音频后端、比特率等核心参数
• 精简依赖：仅包含运行librespot所需的最小依赖（caps、librespot），减少冗余组件

使用场景

• 家庭音频设备：将普通音响系统改造为支持Spotify Connect的智能播放设备
• 嵌入式系统：部署于树莓派、开发板等嵌入式设备，实现轻量化音频接收功能
• DIY音响项目：集成到自定义音响系统中，提供无线Spotify音频播放能力
• 多房间音频组网：通过多实例部署实现多房间同步播放Spotify音频内容

使用方法与配置说明

基本使用

默认配置下，容器以alsa后端启动librespot，需确保主机音频设备可被容器访问：

bash
docker run --device /dev/snd your-image-name

注：--device /dev/snd 参数用于将主机音频设备挂载到容器，确保librespot可访问alsa设备

自定义运行参数

可通过命令行参数覆盖默认CMD，调整librespot配置，例如修改设备名称、比特率等：

bash
# 设置设备名为"Living Room Speaker"，比特率320kbps，初始音量80
docker run --device /dev/snd your-image-name --name "Living Room Speaker" --bitrate 320 --volume 80

常用配置参数

librespot支持丰富的命令行参数，核心参数说明如下：

高级配置示例

自定义音频设备

指定特定alsa音频设备：

bash
docker run --device /dev/snd your-image-name --backend alsa --device "hw:1,0"

使用PulseAudio后端

切换至PulseAudio音频后端（需主机运行PulseAudio并配置网络访问）：

bash
docker run -e PULSE_SERVER=unix:/run/user/1000/pulse/native -v /run/user/1000/pulse:/run/user/1000/pulse your-image-name --backend pulse

持久化设备配置

通过环境变量或挂载配置文件实现持久化参数管理（需自行构建镜像时集成或通过启动脚本实现）。