把米家/涂鸦设备接入 Apple HomeKit：Homebridge 桥接与本地控制实战

摘要

手里有不少米家、涂鸦的便宜智能设备，却想用 iPhone 的"家庭"App 统一控制？只要它们支持局域网协议，就能通过 Homebridge 桥接进 Apple HomeKit，实现 Siri 语音、自动化和小组件控制，而且全部走本地网络，不依赖厂商云。

为什么不用 Matter 直连

Matter 是最新的统一协议，但前提是设备本身支持 Matter。现实里大量老款米家插座、涂鸦灯、Yeelight 并不支持 Matter，它们走的是厂商私有局域网协议（米家 miot、涂鸦 tuya-local）。Homebridge 的价值正在于此：它用插件模拟出一个"HomeKit 配件"，再把指令翻译成厂商协议下发，让老设备也能进苹果生态。

Homebridge 是什么

Homebridge 是一个 Node.js 写的轻量桥接服务，核心是一个"配件平台"，通过 npm 插件（如 homebridge-mi-automation、homebridge-tuya-web、homebridge-yeelight）把第三方设备暴露成 HomeKit 配件。它运行在树莓派、NAS 或任意常开主机上，监听 51826 端口，iPhone 在同一局域网内扫码即可添加。

部署步骤

在常开机设备上安装 Node.js（建议 18+），再用 npm 全局安装：

sudo npm install -g --unsafe-perm homebridge

启动一次生成配置文件：

homebridge

首次运行会在 ~/.homebridge 生成 config.json。

安装对应厂商插件，以米家为例：

sudo npm install -g homebridge-mi-automation

涂鸦设备可用 homebridge-tuya-web（需从厂商 App 获取设备 ID 与本地密钥）。

在 config.json 的 platforms 数组里登记插件及凭证，例如米家需要你的小米账号 token 或设备 IP。
用 pm2 常驻运行，避免进程退出：

pm2 start homebridge
pm2 save

获取设备凭证的注意点

米家设备：部分插件支持账号登录自动发现；更稳的是用 miot 命令行抓取设备 token，或从安卓备份提取。
涂鸦设备：在涂鸦智能 App 里开启"局域网控制"，记下设备 ID，再用提权方式拿到本地密钥。
如果拿不到密钥，可改用支持云端 API 的插件，但那样会走厂商云，失去本地控制的优势。

加入家庭 App

打开 iPhone"家庭"App → 添加配件 → 扫描 Homebridge 启动日志里的八位配对码（或 config.json 里的 pin）。添加后，桥接下的所有子设备会作为独立配件出现，可分组、加房间、设自动化。

稳定性与避坑

固定 IP：运行 Homebridge 的主机务必绑定静态 IP，否则路由器重拨后桥接失联。
mDNS 互通：HomeKit 依赖 mDNS 发现，跨 VLAN 时需开启 mDNS 反射（见本站家庭网络 VLAN 一文），否则手机在家庭 VLAN、设备在家电 VLAN 会搜不到。
单桥上限：一个 Homebridge 实例最多约 150 个配件，设备多时建议拆多个实例或迁移到 Home Assistant 的 HomeKit 插件。
升级顺序：先更插件再更核心，避免 API 不兼容导致整桥崩溃。

与 Home Assistant 的取舍

如果你已经在用 Home Assistant（见本站 Matter 接入一文），可以直接用 HA 的 HomeKit Bridge 集成，省去单独维护 Homebridge；但若只想轻量把少量老设备接进苹果生态，Homebridge 更轻、占用更低。两者也可并存：HA 桥接 Matter 设备，Homebridge 桥接遗留私有协议设备。

小结

Homebridge 是把"非 Matter 老设备"拉进 Apple 生态最成熟的方案。只要设备支持局域网协议、你能拿到本地凭证，就能实现纯本地、可 Siri、可自动化的控制。建议从一两个插座、一盏灯起步，跑通流程后再批量接入。