远程Home-Assistant组件安装与使用指南

远程Home-Assistant组件安装与使用指南

remote_homeassistantLinks multiple home-assistant instances together项目地址:https://gitcode.com/gh_mirrors/re/remote_homeassistant

远程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实例管理设备和状态，增强您的智能家居体验。

remote_homeassistantLinks multiple home-assistant instances together项目地址:https://gitcode.com/gh_mirrors/re/remote_homeassistant