远程Home-Assistant组件安装与使用指南
远程Home-Assistant组件允许您将多个Home-Assistant实例链接在一起,实现跨实例的数据交互和管理。以下是基于GitHub仓库 custom-components/remote_homeassistant 的配置和使用说明。
1. 目录结构及介绍
该开源项目遵循典型的Python项目结构,其主要目录和文件如下:
- root:
github/workflows
: 包含GitHub Actions的配置文件,用于自动化测试或部署流程。custom_components
: 核心组件存放目录,其中的remote_homeassistant
是本项目的主要实现部分。remote_homeassistant
: 包含所有实现远程连接功能的代码和资源。
icons
: 存放图标文件,可能用于UI界面展示。img
: 图像资源文件夹。gitignore
: 指定了Git应忽略的文件类型或特定文件。LICENSE
: 项目的许可文件,采用Apache-2.0许可证。md
: 可能包含了Markdown格式的文档。README.md
: 主要的项目读我文件,描述了项目功能和基本设置步骤。hacs.json
: 如果支持HACS(Home Assistant Community Store),则定义组件在HACS中的元数据。
2. 启动文件介绍
该项目的核心逻辑并非通过一个单独的“启动文件”执行,而是集成到Home Assistant的配置中。主要的“启动”过程涉及配置Home Assistant以加载此自定义组件。不过,在Home Assistant环境中,组件的激活通常是在配置更新并重启之后自动完成的。具体到这个项目,关键的“启动”配置位于您的Home Assistant的configuration.yaml
文件中,添加远程实例的具体配置会被解释在下一节。
3. 配置文件介绍
主实例配置
要集成remote_homeassistant
组件,首先需在您的主实例的configuration.yaml
文件内加入以下段落:
remote_homeassistant:
instances: # 在这里您需要添加远程实例的详细配置
每个远程实例的具体配置包括但不限于访问令牌、地址、前缀等,示例如下:
instances:
- host: example.com
token: 'YOUR_LONG_LIVED_TOKEN'
secure: true
远程实例配置
在远程实例上,尽管不需要上述完整的配置流程,但仍然需要在configuration.yaml
中启用组件声明,确保不会处理来自自身的事件,简单声明即可:
remote_homeassistant: {}
注意事项:
- 配置时务必替换
example.com
和YOUR_LONG_LIVED_TOKEN
为实际值。 - 访问令牌可通过远程Home Assistant的用户设置页面生成。
- 确保主实例与远程实例之间的网络可达,特别是在设置了安全连接(HTTPS/WSS)的情况下。
以上步骤完成后,重新启动Home Assistant实例,组件即被激活并开始工作。利用此组件,您可以无缝地跨不同Home Assistant实例管理设备和状态,增强您的智能家居体验。