教程/NAS/正文

NAS部署Home Assistant将米家智能设备接入Apple Homekit

置顶原创
2025/12/26阅读时间 5 分钟

Home Assistant 是什么?‌
‌Home Assistant‌ 是一款‌开源智能家居中枢系统‌,旨在将不同品牌的智能设备统一管理,并实现本地化、隐私优先的自动化控制。

通过小米官方发布的Home Assistant集成,可以将米家平台的大部分设备接入 Home Assistant,再经由Home Assistant,即可将米家设备接入到Apple Homekit。

以下是它的核心特点:

1. 核心定位‌

  • ‌本地化中枢‌:数据存储在用户自己的设备(如树莓派、NAS、服务器)上,减少对云服务的依赖,提升隐私性和响应速度。

  • ‌跨平台整合‌:支持接入‌米家、HomeKit、Google Home、Alexa、Zigbee/Z-Wave‌等上千种设备,打破品牌壁垒。

2. 核心功能‌

  • ‌多品牌设备兼容‌
    通过插件(Integrations)接入不同协议设备,例如:

    • 米家(通过官方插件Xiaomi Home‌)

    • HomeKit(原生支持或反向接入非HomeKit设备)

    • Zigbee/Z-Wave(需搭配USB网关)。

  • ‌自动化与场景‌
    自由设置触发条件(如“人体传感器触发→开灯”),支持复杂逻辑(延时、循环、条件判断)。

  • ‌个性化仪表盘‌
    用Lovelace UI自定义控制界面,适配手机、平板、电脑。

  • ‌语音控制‌
    可对接Siri(通过HomeKit)、Google Assistant、Alexa。

教程开始

以群晖为例,打开File Station,在docker文件夹中创建Home Assistant文件夹,并在其下创建config文件夹

图形用户界面, 应用程序

打开Container Manager,选择项目,点击新增,填写项目名称,设置路径,来源选择创建docker-compose.yml,将下面代码复制到代码框中(或者前往公众号yaml库下载compose文档,来源中选择上传docker-compose.yml),将volumes部分中‘/PATH_TO_YOUR_CONFIG’改为上面创建的config文件夹的实际路径(右击文件夹-属性-位置处查看),点击下一步-下一步,勾选创建项目后立即启动,点击完成。

version: "3.7"
services:
autobrr:
container_name: autobrr
image: ghcr.io/autobrr/autobrr:latest
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
user: 1000:1000
volumes:
- /volume2/docker/autobrr/config:/config
ports:
- 7474:7474

图形用户界面, 文本, 应用程序

图形用户界面, 文本, 应用程序

容器安装完成后,在浏览器输入群晖地址:8123,即可打开Home Assistant管理页面,点击创建我的只能家居

图形用户界面, 应用程序

输入用户名和密码创建账户

图形用户界面, 应用程序, Teams

接下来设置家的位置和地区,点击下一步,直到完成,即可成功登录Home Assistant管理页面

图形用户界面, 文本, 应用程序, Word

接下来安装小米官方插件,从下面链接下载xiaomi_home.zip,在上面创建的config文件夹中,创建文件夹custom_components,并将下载的xiaomi_home.zip上传到该文件夹中,右击-解压缩-解压缩小xiaomi_home,删除xiaomi_home.zip,返回Home Assistant管理页面,重启Home Assistant系统,小米插件就安装完成了。

https://github.com/XiaoMi/ha\_xiaomi\_home/releases

图形用户界面, 应用程序

打开Home Assistant管理页面,点击设置-集成-添加集成

图形用户界面, 应用程序, Teams

选择Xiaomi Home

图形用户界面, 文本, 应用程序

点击下一步

图形用户界面, 文本, 应用程序, 信件, 电子邮件

选择地区和语言,点击下一步

图形用户界面, 文本, 应用程序, 电子邮件

点击后跳转进行登录

图形用户界面, 文本, 应用程序

登录成功后会自动跳转会Home Assistant(回调地址是http://homeassistant.local:8123,如果跳转失败,可将homeassistant.local部分改成群晖的IP地址),选择导入的家庭,下一步

图形用户界面, 文本, 应用程序, 电子邮件

点击跳过并完成

图形用户界面, 文本, 应用程序, 电子邮件

我们就将米家设备添加到Home Assistant中了

图形用户界面

接下来继续添加Homekit集成,搜索apple,点击Apple

图形用户界面, 应用程序

选择HomeKit Bridge

图形用户界面, 文本, 应用程序

按需选择,点击提交

图形用户界面, 文本, 应用程序, 电子邮件

文本

点击完成

图形用户界面, 应用程序

打开左下角通知,即可看到HomeKit配对二维码,打开手机中家庭(Home)APP,扫描二维码即可完成配对。

图形用户界面, 文本, 应用程序

点击仍然添加

图形用户界面, 文本, 聊天或短信

接下来按照提示继续添加设备,我们就可以将米家中的设备添加到Apple HomeKit中了。

version: "3.7"
services:
  autobrr:
    container_name: autobrr
    image: ghcr.io/autobrr/autobrr:latest
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
    user: 1000:1000
    volumes:
      - /volume2/docker/autobrr/config:/config
    ports:
      - 7474:7474
image: ghcr.io/autobrr/autobrr:latest