Shairport Sync 在 HomeKit 中显示"无响应"问题的分析与解决方案

Shairport Sync 是一个开源的 AirPlay 音频接收器实现，允许用户将非苹果设备变成 AirPlay 接收器。然而，许多用户在使用过程中遇到了一个常见问题：当将 Shairport Sync 设备添加到 HomeKit 后，设备状态很快就会显示为"无响应"，尽管音频播放和控制功能实际上仍然正常工作。

问题现象

用户报告的主要症状包括：

1. 设备在 HomeKit 中显示为"无响应"状态
2. 专辑封面和媒体控制功能仍然可用
3. 音频播放本身不受影响
4. Siri 无法控制设备（播放/暂停等）

根本原因分析

经过社区讨论和用户反馈，这个问题主要与 IPv6 网络配置有关。当设备启用了 IPv6 时，HomeKit 可能会错误地判断设备状态。Avahi 服务日志中通常会显示与 IPv6 地址相关的问题。

解决方案

禁用 IPv6

目前最有效的解决方案是彻底禁用 Raspberry Pi 上的 IPv6 功能：

1. 编辑 /etc/sysctl.conf 文件
2. 添加以下内容：

net.ipv6.conf.all.disable_ipv6 = 1
net.ipv6.conf.default.disable_ipv6 = 1
net.ipv6.conf.lo.disable_ipv6 = 1

3. 保存文件并执行 sudo sysctl -p 使更改生效
4. 验证 IPv6 是否已禁用：cat /proc/sys/net/ipv6/conf/all/disable_ipv6 应返回"1"

重新添加设备

禁用 IPv6 后，需要：

1. 从 HomeKit 中移除 Shairport Sync 设备
2. 重新添加设备到 HomeKit
3. 重启相关设备（包括 Apple TV/HomePod 等家庭中枢）

系统要求与兼容性

解决方案已在以下环境中验证有效：

• Raspberry Pi 3B/4B 设备
• Debian/Raspbian 操作系统
• Apple TV 4K 和 HomePod mini 作为家庭中枢
• iOS/tvOS 18.x 系统

注意事项

1. 某些用户在系统更新后可能需要重新添加设备
2. 确保家庭中枢设备（Apple TV/HomePod）运行最新系统
3. 所有设备应连接到同一 WiFi 网络
4. 禁用 IPv6 后需要完全重启网络相关服务

替代方案

对于无法彻底禁用 IPv6 的环境，可以尝试：

1. 更新到最新版本的 Shairport Sync
2. 检查并优化网络配置
3. 确保 mDNS/Avahi 服务正常运行

这个问题虽然不影响核心音频功能，但会影响 HomeKit 集成的用户体验。通过上述解决方案，大多数用户能够恢复完整的 HomeKit 控制功能。