home-assistant-config与HomeKit集成指南：让苹果设备也能控制你的智能家居

费念念Ross

865人浏览 · 2026-05-07 09:08:41

费念念Ross · 2026-05-07 09:08:41 发布

home-assistant-config与HomeKit集成指南：让苹果设备也能控制你的智能家居

【免费下载链接】home-assistant-config :house: My Home Assistant configuration, a bit different that others :) Be sure to :star2: this repository for updates! 项目地址: https://gitcode.com/gh_mirrors/ho/home-assistant-config

home-assistant-config是一个功能丰富的智能家居配置项目，通过与HomeKit集成，能让你的苹果设备轻松控制各类智能设备，实现更便捷的智能家居体验。本指南将详细介绍如何完成集成配置，让你快速上手使用。

准备工作：确认Home Assistant环境

在进行HomeKit集成前，需要确保你的Home Assistant已正确安装并运行。该项目的核心配置文件为configuration.yaml，所有集成设置都将在这里进行配置。同时，确保你的苹果设备（iPhone、iPad或Mac）已登录iCloud账号，并且与Home Assistant处于同一局域网内。

配置HomeKit集成：简单三步完成设置

第一步：启用HomeKit集成组件

打开configuration.yaml文件，添加HomeKit集成配置。在文件中找到或创建集成配置区域，添加以下内容：

homekit:
  filter:
    include_domains:
      - light
      - switch
      - climate
  entity_config:
    light.living_room:
      name: 客厅灯光
    switch.air_conditioner:
      name: 空调开关

这段配置会将指定类型的智能设备（灯光、开关、空调）暴露给HomeKit，并为设备设置在苹果家庭应用中显示的名称。

第二步：重启Home Assistant服务

配置完成后，需要重启Home Assistant服务使设置生效。你可以通过Home Assistant的Web界面进行重启，也可以在项目根目录执行以下命令：

hass --script check_config  # 检查配置文件是否有错误
# 如果配置无误，重启Home Assistant服务

重启完成后，HomeKit集成组件将开始运行，并生成配对二维码。

第三步：在苹果设备上完成配对

打开苹果设备上的“家庭”应用，点击右上角的“+”号，选择“添加配件”，然后扫描Home Assistant界面上显示的HomeKit配对二维码。配对成功后，你的智能设备将出现在家庭应用中，就可以用Siri或手动操作来控制它们了。

高级设置：自定义设备和场景

自定义设备名称和类型

通过configuration.yaml中的entity_config部分，你可以为每个设备自定义名称和类型。例如：

homekit:
  entity_config:
    light.kitchen:
      name: 厨房主灯
      type: light
    sensor.temperature:
      name: 室内温度
      type: temperature_sensor