使用 Home Assistant 将米家设备接入 HomeKit 教程 cover

使用 Home Assistant 将米家设备接入 HomeKit 教程

Siri,关灯~

本教程帮助你把常用的米家设备都接入HomeKit,这样就可以通过Siri来控制住处中的智能设备。

具体原理是:使用树莓派安装 Home Assistant,通过 Home Assistant 的小米官方集成连接米家设备。通过 Home Assistant 中的 HomeKit Bridge 集成,将米家设备桥接到 Apple HomeKit。这样就可以通过Apple的家庭应用和Siri来控制这些设备,即使它们不支持HomeKit。

目录

我的树莓派配置

Raspberry Pi 5 4gb
OS: Raspberry Pi OS Lite
Kernel: Linux 6.12.20+rpt-rpi-2712 #1 SMP PREEMPT Debian 1:6.12.20-1+rpt1~bpo12+1 (2025-03-19) aarch64 GNU/Linux

1. 安装 Home Assistant

Home Assistant 支持多种安装方式,大致有三种方法:

  1. 安装 Home Assistant OS 操作系统
  2. 通过 Docker 容器安装
  3. 直接安装 Home Assistant Core(逐步弃用,从 Home Assistant 2025.6 版本开始,此安装方式将进入为期六个月的弃用期。)

Home Assistant 官方已提出计划逐步停止对 Home Assistant Core 安装方式的官方支持。建议采用第一种或者第二种方法。

为了便于管理,我选择使用 Docker Compose 来安装 Home Assistant。参考官方教程docker-compose.yml 如下:

~/docker/homeassistant/docker-compose.yml
services:
homeassistant:
container_name: homeassistant
image: ghcr.io/home-assistant/home-assistant:stable
volumes:
- ./config:/config
- /etc/localtime:/etc/localtime:ro
- /run/dbus:/run/dbus:ro
restart: unless-stopped
privileged: true
network_mode: host

安装完成后,通过浏览器访问树莓派的 IP 地址加 8123 端口 (例如 http://树莓派IP:8123)。首次访问会进入 Home Assistant 初始化向导,按照提示设置管理员账户和密码。

image.png

2. 安装与配置 Home Assistant 社区商店

2.1 安装 HACS

配置完 Home Assistant 后,我们需要安装 HACS(Home Assistant Community Store)。你可以将其理解为 Home Assistant 的应用商店,通过 HACS 我们能够安装第三方集成来增强 Home Assistant 的功能。后续我们需要通过 HACS 来安装小米官方的 Home Assistant 集成。

参考 HACS安装指南,我们需要进入容器内部执行安装脚本。

docker exec -it homeassistant bash
wget -O - https://get.hacs.xyz | bash -

安装成功后,退出容器,然后重启容器。这一步骤很重要,配置HACS前必须重启Home Assistant。

~/docker/homeassistant/
exit
docker compose restart

2.2 配置 HACS

接下来我们需要初始化 HACS,你可以参考此教程或按照下图步骤配置。注意,你需要提前注册一个 Github 账号。

在“设置”中打开“设备与服务”

image.png

点击“添加集成”,搜索并选择“HACS”

image.png

根据指引逐步操作,打开提示中的网址,登录 GitHub,输入授权码。

image.png
image.png
image.png

看到下图界面,就说明 HACS 以及安装成功了。

image.png

指派设备可以先选“跳过并完成”。

image.png

3. 将米家设备接入 HomeAssistant

3.1 安装 Home Assistant 米家官方集成

小米在2024年年底推出了官方的 Home Assistant 集成 (Xiaomi Home)。经过多个版本迭代,目前已趋于稳定可用。这意味着我们多了一个官方选择,而不必像以往主要依赖社区维护的 “Xiaomi Miot Auto” 集成 。当然,你依然可以选择使用“Xiaomi Miot Auto”集成,对于某些特定设备或追求稳定性的场景,它可能仍有优势。你可以参考我写的另一篇教程:https://wulu.zone/posts/mi-iot-homekit

接下来,我们安装米家官方集成以将米家设备接入HomeAssistant。

进入 HACS 页面,找到“Xiaomi Home”。

image.png

点“下载”,然后确认下载。

image.png

同样地,安装完集成之后需要重启 HomeAssistant。

~/docker/homeassistant/
docker compose restart

3.2 配置 Xiaomi Home

接下来,我们配置 Xiaomi Home 将米家设备接入 Home Assistant。注意,配置 Xiaomi Home 前需要重启 HomeAssistant。

点击“设置”,选择“设备与服务”

image.png

点击“添加集成”,搜索并选择“Xiaomi Home”

image.png
image.png

登录小米账号以获取设备信息。

image.png
image.png

在登录认证过程中,如果遇到类似下图的错误提示,通常是因为集成默认使用 homeassistant.local:8123作为OAuth2 认证跳转地址。你可以通过修改路由器或者本地 host,将 homeassistant.local 指向你安装了 Home Assistant 的设备。也可以直接在地址栏修改地址,将homeassistant.local改为对应设备的 IP, 然后刷新网页完成认证。

认证成功后,该页面会自动关闭跳转回 Home Assistant,之后按照指引完成剩余的设备添加步骤即可。

image.png

4. 桥接米家设备到 HomeKit

接下来,我们通过 HomeKit Bridge 将 Home Assistant 中设备桥接到 HomeKit。

4.1 在 Home Assistant 中添加 HomeKit Bridge 集成

首先,我们要添加 HomeKit Bridge 集成。点击“设置”,进入“设备与服务”页面。

image.png

搜索“homekit”,点击“Apple”

image.png

点击添加“HomeKit Bridge” 集成,按照指引完成添加。

image.png

需要注意的是,如果你希望桥接传感器类型的设备(如温湿度传感器),确保在“要包含的域”中勾选“Sensor”选项,这个选项默认是未勾选的。

image.png

4.2 在 HomeKit Bridge 中禁用不必要的实体

HomeKit Bridge 会自动识别 Home Assistant 中的设备。在将其同步到 Apple 家庭 App 之前,建议先检查并禁用一些不需要桥接的实体。

否则可能会出现以下情况:例如,当将小米智能插座添加到 HomeKit 时,插座会被识别为三个设备,除了开关之外,其中插座的指示灯被识别为灯具,插座温度也被误认为环境温度传感器。这可能不是我们期望看到的结果。

在 HomeKit Bridge 的详情页面,点击“配置”

image.png
image.png

在“排除的实体”列表中,依次添加要排除的实体

image.png

4.3 将 HomeKit Bridge 添加到苹果家庭

最后,将配置好的 HomeKit Bridge 添加到你的 Apple 家庭 App 中。点击界面左下角的通知按钮,查看 homekit 的配对二维码。

image.png
image.png

打开“家庭”应用,点击左上角的“+”号,选择“添加配件”。扫描上个步骤的得到的二维码,点击“添加到家庭”。在加入过程中,可能会提示“未认证设备”,点击“仍要添加”。然后完成剩余步骤,逐个添加设备。完成后,你就能用 Siri 控制你的智能设备了。

5. 常见问题

Siri 回复设备没有回应?

通过上述方法添加设备后,只能在同一局域网内控制该设备。如果出现这种情况,请检查手机是否连接到家庭网络,并进一步确认 Home Assistant 服务状态是否正常。

如何通过 Siri 在局域网外控制家里的设备?

你需要有一个家庭中枢,比如 HomePod 或者 Apple TV。

更新小米集成相关问题

小米官方的 Home Assistant 集成现在还处于早期开发阶段,版本更新时可能会存在破坏性更新。更新前要注意查看更新说明。

其他问题

其他问题?欢迎在评论区留言讨论!

参考链接