mikebrady/shairport-sync

Shairport Sync

概述

Shairport Sync 是一款 AirPlay 2 音频播放器。其“经典”版本提供经典 AirPlay（即“AirPlay 1”）功能，类似于早期版本的 Shairport Sync。更多信息请访问其 https://github.com/mikebrady/shairport-sync。

快速试用

假设您的 Linux 系统已安装 Docker，可在终端窗口输入以下命令试用 Shairport Sync（无需输入 `# Shairport Sync

概述

Shairport Sync 是一款 AirPlay 2 音频播放器。其“经典”版本提供经典 AirPlay（即“AirPlay 1”）功能，类似于早期版本的 Shairport Sync。更多信息请访问其 https://github.com/mikebrady/shairport-sync。

快速试用

假设您的 Linux 系统已安装 Docker，可在终端窗口输入以下命令试用 Shairport Sync（无需输入 ，它是命令行提示符）：

$ docker run --rm --cap-add=SYS_NICE --net host --device /dev/snd mikebrady/shairport-sync:latest

（若要试用 development 版本，请将上述命令中的 latest 替换为 development。）

首次运行时，系统会先下载 Docker 镜像，输出类似以下内容：

Unable to find image 'mikebrady/shairport-sync:latest' locally
latest: Pulling from mikebrady/shairport-sync:latest
d62bb7eb03b5: Pull complete 
870e870d46ff: Pull complete 
0c12ec19e4f3: Pull complete 
6df3ea12d3a5: Pull complete 
Digest: sha256:5a59bde7b859cdfbe70a1e8d746464c77a402ef88010146fe6aa189dc0f3f0da
Status: Downloaded newer image for mikebrady/shairport-sync:latest

下载完成后，容器会运行直至您停止它。后续运行时无需再次下载镜像，将直接启动。

运行期间，您的 AirPlay 设备（如 iPhone）应能发现新的 AirPlay 目标，名称为系统主机名。连接后播放音频，声音将通过系统默认音频设备输出。您可能需要调整 AirPlay 设备和系统的音量。

若系统启用防火墙（如 Fedora 默认启用防火墙），可能会干扰 AirPlay 功能。测试时可考虑暂时关闭防火墙。所需开放的端口列表见 https://github.com/mikebrady/shairport-sync/blob/master/TROUBLESHOOTING.md#ufw-firewall-blocking-ports-commonly-includes-raspberry-pi，但可能不完整。

基本用法

$ docker run --cap-add=SYS_NICE -d --restart unless-stopped --net host --device /dev/snd \
    mikebrady/shairport-sync

上述命令将以守护进程模式运行最新版本的 Shairport Sync，访问计算机的 ALSA 音频架构，将音频发送至默认输出设备，但不控制设备可能有的内置硬件混音器（即音量控制）。AirPlay 服务名称为主机名首字母大写形式，例如 Ubuntu。

以下命令运行最新版本的“经典”Shairport Sync，使用旧版“经典”AirPlay（即“AirPlay 1”）协议：

$ docker run --cap-add=SYS_NICE -d --restart unless-stopped --net host --device /dev/snd \
    mikebrady/shairport-sync:classic

选项

添加到上述命令的任何选项都将传递给 Shairport Sync——更多选项详情请访问 https://github.com/mikebrady/shairport-sync。示例如下：

$ docker run --cap-add=SYS_NICE -d --restart unless-stopped --net host --device /dev/snd \
    mikebrady/shairport-sync -a DenSystem -- -d hw:0 -c PCM

此命令将音频发送至 ALSA 硬件设备 hw:0，使用设备名为 PCM 的混音器控制输出音量，服务在网络中显示为 DenSystem。

配置文件

编辑容器内的配置文件 /etc/shairport-sync.conf，或使用 -v 选项将外部 shairport-sync.conf 文件挂载至容器内 /etc/shairport-sync.conf，以获取完整配置选项。

标签

• latest 和 classic：分别为 Shairport Sync 和经典版 Shairport Sync 的最新发布版本。
• rolling 和 rolling-classic：包含 master 分支的最新更新，可能尚未纳入正式发布。
• development 和 development-classic：development 分支的最新构建，可能稳定性较低且更新频繁。
• 版本号标签（如 4.1、4.1-classic）：对应各正式发布版本。

完整标签列表见“Tags”选项卡。

主机防火墙

若主机运行防火墙（如桌面版 Fedora 默认启用防火墙），需开放 Shairport Sync 所需端口。有关 ufw 防火墙的讨论（端口列表适用于所有防火墙）见 https://github.com/mikebrady/shairport-sync/blob/master/TROUBLESHOOTING.md#ufw-firewall-blocking-ports-commonly-includes-raspberry-pi。

探索工具

工具 dacquery 可列出适合 Shairport Sync 的音频设备，其 Docker 镜像见 https://hub.docker.com/r/mikebrady/dacquery。

高级用法

除作为守护进程运行外，也可在命令行直接运行 Docker 镜像。注意，命令末尾的选项将传递给 shairport-sync。

例如，获取帮助文本：

$ docker run --rm --cap-add=SYS_NICE --net host --device /dev/snd mikebrady/shairport-sync:latest --help

--help 命令将传递给 shairport-sync，输出其帮助文本（含 Docker 系统部分消息）。输出后，Shairport Sync 及整个镜像将停止运行。

再如，运行 Shairport Sync 并在播放音频时在命令行显示统计信息：

docker run --rm --cap-add=SYS_NICE --net host --device /dev/snd docker.xuanyuan.run/mikebrady/shairport-sync:latest --statistics

播放开始后，将显示 Shairport Sync 的播放统计信息（含 Docker 系统部分消息），此时 Shairport Sync 将持续运行。

更多信息

更多详情见 https://github.com/mikebrady/shairport-sync。