Homebridge在macOS 15.1系统下的适配问题与解决方案

背景分析

近期有用户反馈在将Mac mini M1设备升级至macOS 15.1（Sequoia）系统后，出现了Homebridge桥接设备无法被HomeKit识别的情况。该问题主要表现为：

1. 升级系统后原有配件失去连接
2. 重新添加桥接时提示"配件未找到"
3. 多终端尝试无效但插件日志显示运行正常

问题根源

经技术社区验证，这是由于macOS 15.0及以上版本对网络权限管理策略进行了重大调整：

• 系统新增了严格的本地网络访问控制
• 默认阻止未经明确授权的mDNS广播
• 影响了Homebridge的Bonjour服务发现机制

解决方案

核心修复步骤

1. 打开系统设置 → 隐私与安全性
2. 进入"本地网络"权限管理界面
3. 为以下应用授予网络访问权限：
   • Homebridge服务进程
   • Node.js运行时环境
4. 重启系统服务

补充建议

1. 建议使用hb-service方式安装的用户执行服务重载：

sudo hb-service restart

2. 对于手动启动的用户，需确保终端应用也具有本地网络权限

技术原理

该问题的本质是macOS 15引入的隐私保护机制与家庭自动化系统服务发现协议（mDNS/Bonjour）之间的兼容性问题。Homebridge依赖这些协议实现：

• 设备自动发现
• 服务广播
• 跨网络通信

预防措施

1. 重大系统更新前建议：
   • 备份Homebridge配置
   • 查阅项目文档的兼容性说明
2. 保持Homebridge核心和插件更新
3. 定期验证网络权限设置

后续观察

用户反馈在按照建议调整网络权限后，Govee灯具等设备已恢复正常接入。这验证了该解决方案的有效性，也提醒用户在macOS系统升级时需注意此类权限变更可能带来的影响。

延伸阅读

建议所有macOS用户在进行系统升级时，特别关注以下可能受影响的智能家居组件：

• 基于mDNS的服务发现
• 本地网络通信类插件
• 需要持续后台运行的桥接服务