tigerj/shairport-sync

关于

本镜像基于https://github.com/kevineye/docker-shairport-sync%E7%9A%84%E6%BA%90%E7%A0%81%E4%BF%AE%E6%94%B9%E8%80%8C%E6%9D%A5%E3%80%82

简介

https://github.com/mikebrady/shairport-sync%E6%98%AF%E4%B8%80%E6%AC%BEApple AirPlay接收器，可直接接收来自iOS设备、iTunes等的音频。当与iTunes或https://github.com/jasonmc/forked-daapd%E7%AD%89%E5%85%BC%E5%AE%B9%E7%9A%84%E5%A4%9A%E6%88%BF%E9%97%B4%E6%92%AD%E6%94%BE%E5%99%A8%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%E6%97%B6%EF%BC%8C%E5%A4%9A%E4%B8%AAshairport-sync%E5%AE%9E%E4%BE%8B%E5%8F%AF%E7%9B%B8%E4%BA%92%E5%90%8C%E6%AD%A5%EF%BC%8C%E5%B9%B6%E4%B8%8E%E5%85%B6%E4%BB%96AirPlay%E8%AE%BE%E5%A4%87%E4%BF%9D%E6%8C%81%E5%90%8C%E6%AD%A5%E3%80%82

多架构镜像

以下命令引用的https://hub.docker.com/r/tigerj/shairport-sync%E9%95%9C%E5%83%8F%E4%B8%BADocker Manifest List，通过Docker BuildKit构建。运行该镜像时，会根据主机架构自动拉取匹配的版本（如amd64、arm32v7或arm64），因此在树莓派上运行的命令与在传统amd64桌面/笔记本电脑上完全一致。

运行容器

以守护进程模式运行容器：

docker run \
       -d \
       --restart=always \
       --net=host \
       --device /dev/snd \
       -e AIRPLAY_NAME=shairport-sync \
       tigerj/shairport-sync

创建容器（用于后续使用）

创建容器：

docker create \
       --restart=always \
       --name=shairport-sync \
       --net=host \
       --device /dev/snd \
       -e AIRPLAY_NAME="shairport-sync" \
       tigerj/shairport-sync

通过名称启动容器：

docker start shairport-sync

参数说明

• --net host：必须以主机模式运行
• --device /dev/snd：将主机的alsa系统共享给容器，无需--privileged（不同于-v /dev/snd:/dev/snd）
• -e AIRPLAY_NAME=Docker：设置AirPlay设备名称，默认值为"Docker"
• 额外参数将传递给shairplay-sync（可尝试--help查看）

故障排除

配置音频组权限

若要设置系统音量最大值，请确保当前用户属于audio组：

$ groups $USER

若输出中包含audio组则已具备权限；否则执行以下命令（需sudo权限）：

sudo usermod -a -G audio $USER

注意：需重启系统使更改生效。

Linux音量调节

假设已具备音频组权限（见配置音频组权限），可通过alsamixer命令调整Linux音量：

$ alsamixer

该命令会打开音量调节界面，使用上下箭头键设置音量（例如调整至100%）。