Home Assistant中文版

Home Assistant是一款免费开源的智能家居管理与自动化控制软件，主要用于连接家中的各类智能设备，实现统一管理和场景联动。软件支持多种品牌和通信协议，可以将不同生态下的灯具、门锁、传感器、空调及家庭影音设备连接起来，减少不同设备之间的操作限制。通过手机或网页控制界面，可以随时查看设备状态、调整运行模式，也能根据生活习惯创建自动化任务。例如，设置回家场景后，可以在检测到人员到达时开启灯光和空调;离家时则自动关闭指定电器。软件还支持设备状态记录和历史数据查看，方便了解家庭用电、温度及传感器变化情况。除了常规的远程控制，还能使用手机定位、步数、电池状态等传感器信息作为自动化触发条件，并支持智能手表和车载系统操作。Home Assistant强调本地运行和数据隐私，能够在减少云端依赖的情况下管理家庭设备，也支持本地语音交互和个性化控制面板。无论是简单的灯光控制，还是复杂的全屋自动化场景，都可以根据实际需求进行配置，适合希望打造智能生活环境的家庭使用。

Home Assistant设置教程

如果手机与 Home Assistant 服务器连接在同一个局域网内，应用通常会自动发现服务器。如果服务器已经配置好远程访问，也可以通过远程地址完成连接。

1、欢迎界面：打开 Home Assistant 应用，选择“连接到我的 Home Assistant 服务器”，进入初始设置流程。

2、网络发现：应用会自动扫描当前网络，查找可用的 Home Assistant 服务器，并显示检测到的实例。

3、登录：选择对应的服务器后，输入 Home Assistant 账号和密码，完成身份验证。

4、设备命名：为当前手机设置一个设备名称，该名称会显示在 Home Assistant 中，用于识别手机对应的设备实体，方便后续配置自动化规则和控制操作。

5、位置权限：根据应用提示选择是否授权位置访问权限，以启用位置追踪、自动化场景和连接安全功能。

开启位置共享后，可以设置离家自动关闭暖气等场景。

位置数据保存在家庭环境中，不会发送给第三方。

位置信息还可以帮助应用判断当前网络环境，增强连接安全性。

根据实际需求选择“共享我的位置”或“不共享我的位置”。

6、连接安全级别：如果使用的是未加密的URL地址，例如本地IP地址，需要根据实际使用环境选择连接安全级别。

最安全：仅允许设备在连接家庭网络时使用未加密连接，需要授予位置权限。

较不安全：允许设备从任意网络使用未加密连接，不建议在公共网络环境下使用。

关于不同安全级别的具体区别，可以查看应用中的相关说明。

7、设置您的家庭网络(仅最安全)：如果上一步选择了“最安全”，系统会要求确认家庭网络，以便识别可信任的连接环境。

应用会自动检测当前连接的Wi-Fi网络名称(SSID)，并将其作为家庭网络预填。

Android设备还可以将VPN或以太网连接设置为可信任网络。

完成设置后，应用能够识别设备是否处于家庭网络，从而安全地使用未加密连接。

后续如需添加其他可信任网络，可以进入设置 > 配套应用 > [您的服务器]进行配置。

8、设置完成：确认相关信息后，应用会完成服务器连接，并自动进入 Home Assistant 仪表板，即可开始管理家庭智能设备。

Home Assistant手机版入门指南

系统

iOS版本需要运行iOS 15或更高版本，支持的较早设备包括iPhone 6s及更新机型。

Android版本分为Full和Minimal两种类型，均要求Android 5.0或更高版本。Full版本可通过Google Play商店获取，正常运行需要Google Play服务支持。

Home Assistant服务器需要运行0.104.0或更高版本。

移动应用需要在Home Assistant服务器中启用以下配置集成configuration.yaml：

default_config:

如果由于特殊配置原因关闭了default_config:，则需要确保configuration.yaml文件中至少包含以下内容：

mobile_app:

部分功能还需要启用以下集成：

cloud：用于通过远程UI和云端Webhook建立安全连接，相关功能需要Nabu Casa订阅支持。

ios：用于启用iOS设备的高级通知功能，例如可操作通知和通知类别等。

如果Home Assistant服务器已经正确配置远程访问，就可以在不同网络环境下完成手机应用的连接设置。

如果手机与Home Assistant服务器处于同一个局域网，应用通常会在初次设置时自动发现服务器。

1、下载安装Home Assistant Companion App，安装完成后打开应用，进入手机端初始设置界面。

2、首次启动应用时，系统会自动引导完成Home Assistant服务器连接。按照页面提示逐步操作，并根据实际需要授予手机与服务器通信所需的权限。

其中，位置权限是比较重要的一项设置。

如果拒绝位置访问权限，应用将无法为当前设备创建device_tracker实体，也无法生成部分相关sensor传感器实体。

3、完成第一个设置页面后，点击“继续”，应用便会开始扫描当前网络，查找可用的Home Assistant服务器。

如果检测到服务器，点击对应实例，按照页面提示完成连接和登录。

如果手机没有连接到Home Assistant服务器所在的局域网，可以点击“手动输入地址”，填写用于远程访问服务器的URL地址。建议使用Home Assistant Cloud远程UI，也可以根据实际部署情况选择其他安全的远程访问方式。

4、成功连接并登录Home Assistant服务器后，系统会继续请求部分手机权限，以便将手机传感器和相关功能接入Home Assistant。

这些权限并非全部必需，即使选择拒绝，也可以使用应用的基础浏览和设备控制功能。不过，授予相应权限后，可以解锁更多手机与家庭自动化之间的联动功能。

请求的权限主要包括以下几项：

位置： 允许手机向Home Assistant发送位置信息，系统会创建device_tracker实体，供自动化规则和条件判断使用。例如，可以根据手机是否离开家庭区域，自动执行关闭灯光或调整空调等操作。iOS设备需要按照系统提示提前授权位置权限，Android设备通常会在首次登录过程中请求相关权限。如果拒绝位置访问，device_tracker以及部分相关sensor实体将无法创建。

运动和计步器： iOS设备允许Home Assistant读取手机提供的基础运动和计步信息，生成对应的传感器数据，包括当天步数、上下楼层数量、行走距离和当前活动状态等。该功能仅涉及设备运动芯片提供的相关数据，不会读取健康应用中保存的其他个人健康资料。

通知： 授权后，Home Assistant可以向手机发送家庭设备状态、自动化执行结果以及异常事件提醒。除普通通知外，iOS还支持重要通知权限，可用于接收高优先级消息，即使设备处于静音模式，也可能按照系统设置发出提示音。Android设备支持的通知类型以当前系统和应用版本为准。部分情况下，完成登录后需要重新启动Home Assistant，以便正确注册通知操作。

5、完成权限选择后，应用会根据授权情况建立手机与Home Assistant服务器之间的连接，并自动跳转至应用主界面。

根据当前应用版本的不同，完成设置后可能会先显示“新增功能”页面，浏览相关介绍后即可进入主屏幕。

当Home Assistant主界面正常显示时，说明手机端安装和连接流程已经完成，可以开始查看家庭设备、管理仪表板以及配置自动化功能。

注意：

请确保使用正确的Home Assistant账号和密码完成登录。如果启用了可信任网络限制，需要确认手机当前连接的网络属于已经设置的可信任网络，否则应用可能无法正常使用未加密连接。

软件特色

1、设备兼容广泛

支持多种智能家居品牌和开放通信协议，可以连接灯具、插座、门锁、温控设备及传感器，让不同品牌的设备通过统一界面进行管理。

2、本地控制管理

强调本地运行方式，设备状态、自动化规则和相关数据可以在本地环境中处理，降低对外部云服务的依赖，提升家庭数据管理的自主性。

3、自动化场景设置

可以根据时间、位置、设备状态和传感器数据设置触发条件，让灯光、空调、门锁等设备按照预设规则执行操作，减少手动控制步骤。

软件亮点

1、跨品牌联动

支持Zigbee、Z-Wave、Matter、Thread和蓝牙等协议，可以连接不同品牌的智能设备，实现跨生态的统一控制和场景协作。

2、手机传感控制

能够读取手机位置、步数、电池电量和网络连接状态等信息，将这些数据作为自动化条件，实现离家关灯、回家开启设备等场景。

3、本地语音交互

支持Assist语音助手，可以通过语音指令执行设备控制任务，配合唤醒词检测和本地音频处理，让家庭操作更加方便。

软件功能

1、智能设备控制

通过手机或网页界面查看家庭设备状态，可以控制灯光开关、调整设备参数、管理门锁和影音设备，方便集中处理日常操作。

2、自动化规则管理

支持按照时间、位置变化、传感器反馈或设备状态创建自动化规则，例如门锁开启后点亮玄关灯，离家后关闭指定电器。

3、数据与通知管理

可以查看家庭设备的历史状态和变化趋势，并根据门窗开启、漏水检测或设备异常等情况设置通知，及时了解家庭环境变化。

软件优势

1、开放程度较高

采用开源方式开发，支持多种设备协议和社区扩展内容，可以根据家庭现有设备和实际需求调整功能，减少品牌生态限制。

2、操作渠道丰富

除了手机和平板电脑，还能通过网页、智能手表及车载系统访问相关功能，在不同使用环境下都能查看设备状态和执行控制操作。

3、个性化配置

支持自定义Lovelace仪表盘、桌面小组件以及可视化和YAML自动化编辑方式，可以按照个人使用习惯调整控制页面与场景规则。

用户体验

Home Assistant的使用体验比较灵活，适合拥有多种智能家居设备的家庭。不同品牌的设备可以通过统一界面进行管理，减少频繁切换应用的麻烦。自动化功能是比较实用的部分，可以根据时间、位置和传感器状态设置不同场景，让日常设备控制更加省心。手机传感器、智能手表和车载控制也拓展了操作方式。本地运行的设计有利于加强数据管理，不过初次配置需要一定的设备连接和规则设置知识。整体来看，这是一款自由度较高、适合喜欢研究智能家居和自动化设置的人群使用的软件。

更新日志

v2026.11.2版本

1、优化媒体播放器组件，根据设备支持的功能显示对应控制选项。

2、调整Assist语音功能，改善部分运行速度较慢设备上的唤醒词使用体验。

3、优化语音交互提示，在通过唤醒词或系统助手启动Assist时增加聆听提示音。

4、调整应用组件配置界面，统一相关页面的布局和交互逻辑。

5、优化设备控制磁贴，当实体状态更新失败时同步显示相应错误状态。

6、改进深层链接处理，避免Activity重建时重复执行跳转操作，并优化导航过程中的异常链接处理。

7、修复地理围栏注册问题，完善区域属性检查和注册数量达到上限时的处理逻辑。

8、优化语音录制、Assist页面和相关测试流程，修复部分不稳定的测试问题。

9、改进后台运行和电池优化相关设置，修复部分调试版本中的休眠模式处理问题。

10、增加可配置的单指边缘滑动手势，改善页面操作方式。

11、更新Android相关依赖库及开发工具，提升应用兼容性和运行稳定性。

12、完善端到端测试与错误报告机制，优化整体维护和问题排查流程。