ssankur/shairport-sync

Shairport Sync 4.3.7 Classic (含LADSPA CAPS插件) Docker镜像文档

镜像概述

本镜像基于mikebrady/shairport-sync:classic构建，集成了Shairport Sync 4.3.7 Classic版本核心功能，并通过Alpine Linux社区仓库额外安装了LADSPA CAPS (C* Audio Plug-in Suite)音频插件。Shairport Sync是一款开源AirPlay音频接收器，支持接收AirPlay协议音频流；CAPS插件提供多种LADSPA标准音频效果处理功能，可增强音频处理能力。

核心功能与特性

基础功能

• AirPlay音频接收：兼容AirPlay 1协议，可接收来自iOS设备、macOS等的音频流
• 低延迟音频传输：支持实时音频播放，延迟控制功能
• 多设备同步：可与其他Shairport Sync实例实现音频同步播放（需网络支持）

扩展特性

• LADSPA CAPS插件支持：集成CAPS音频插件集，提供均衡器、压缩器、混响、失真等音频效果处理
• Alpine基础：基于Alpine Linux构建，镜像体积小，运行效率高
• 原生兼容性：保留基础镜像mikebrady/shairport-sync:classic的全部配置接口与功能

使用场景

• 家庭音频系统：构建支持AirPlay的自定义音频播放节点，通过CAPS插件优化音质
• 多媒体中心：作为HTPC或智能家居系统的音频接收组件，实现多房间音频同步
• 音频开发测试：快速部署包含音频效果处理的AirPlay测试环境
• 专业音频设备：在嵌入式系统或专用硬件中提供AirPlay接收与效果处理一体化方案

使用方法

前置要求

• Docker引擎 18.06+
• 网络环境需支持多播（mDNS）以实现AirPlay设备发现
• 音频输出设备（物理声卡或虚拟音频设备）

Docker Run示例

基础运行命令（使用主机网络以确保mDNS和音频正常工作）：

bash
docker run -d \
  --name shairport-sync-caps \
  --net=host \
  --device /dev/snd \
  -e TZ=Asia/Shanghai \
  docker.xuanyuan.run/your-image-tag \
  -n "AirPlay Speaker with CAPS" \
  --metadata-enable=yes \
  --playback-delay=200

参数说明

• --net=host：使用主机网络模式，确保AirPlay发现和音频流传输正常
• --device /dev/snd：挂载声卡设备，实现音频输出
• -e TZ=Asia/Shanghai：设置时区（可选）
• -n "AirPlay Speaker with CAPS"：设置AirPlay设备名称
• --metadata-enable=yes：启用元数据显示（歌曲信息等）
• --playback-delay=200：设置播放延迟（毫秒），根据网络环境调整

配置说明

基础配置

本镜像继承mikebrady/shairport-sync:classic的全部配置方式，支持通过命令行参数或配置文件进行配置：

• 命令行参数：直接在docker run命令中追加Shairport Sync参数（如上述示例）
• 配置文件：通过-v /path/to/shairport-sync.conf:/etc/shairport-sync.conf挂载自定义配置文件

LADSPA CAPS插件配置

要使用CAPS插件，需在配置中指定插件路径及参数。示例配置片段（shairport-sync.conf）：

ini
ladspa = {
  enabled = "yes";
  plugin = "/usr/lib/ladspa/caps.so";  # CAPS插件路径
  label = "caps_reverb";  # 插件标签（如混响效果）
  control_port_0 = 0.5;  # 控制参数1（根据插件调整）
  control_port_1 = 0.3;  # 控制参数2（根据插件调整）
};

插件标签及参数说明可参考CAPS插件文档：[***]

注意事项

• 网络模式：推荐使用--net=host以避免AirPlay发现问题，桥接模式需手动映射UDP端口（5353、3689等）
• 音频权限：确保容器对音频设备有访问权限，必要时添加--user root或调整宿主机设备权限
• 插件路径：CAPS插件默认安装路径为/usr/lib/ladspa/caps.so，可通过docker exec进入容器验证路径

镜像构建信息

• 基础镜像：mikebrady/shairport-sync:classic（Shairport Sync 4.3.7 Classic）
• 额外安装包：caps（LADSPA CAPS插件，来自Alpine Linux latest-stable/community仓库）
• 构建命令：

  dockerfile
  FROM mikebrady/shairport-sync:classic
  RUN apk add --no-cache -X http://dl-cdn.alpinelinux.org/alpine/latest-stable/community caps