Home-Assistant-Matter-Hub 安装与配置完整指南

【免费下载链接】home-assistant-matter-hubPublish your Home-Assistant Instance using Matter.项目地址: https://gitcode.com/gh_mirrors/ho/home-assistant-matter-hub

项目介绍

Home-Assistant-Matter-Hub 是一个开源项目，它能够帮助用户将 Home Assistant 实例通过 Matter 协议发布出来。Matter 是一种智能家居连接标准，允许不同品牌和设备的智能家居系统之间相互通信。通过本项目，用户可以将 Home Assistant 中的实体轻松连接到支持 Matter 的控制器，如 Alexa、Apple Home 或 Google Home 等，无需进行端口映射等复杂操作。

技术架构

项目采用 TypeScript 作为主要开发语言，结合以下核心技术：

• Matter 协议- 智能家居互联标准
• Node.js 运行时- 高性能应用平台
• Home Assistant 集成- 智能家居自动化核心

环境准备

在开始安装之前，请确保您的系统满足以下要求：

• 已安装 Node.js 运行环境（包含 npm 包管理器）
• 已部署并运行的 Home Assistant 实例
• 支持 Matter 协议的智能家居控制器

安装步骤

1. 获取项目源码

打开终端，执行以下命令克隆项目：

git clone https://gitcode.com/gh_mirrors/ho/home-assistant-matter-hub.git cd home-assistant-matter-hub

2. 安装项目依赖

进入项目目录后，运行以下命令安装所需依赖：

npm install

3. 配置环境变量

创建.env文件并添加以下配置：

MATTER_HUB_PORT=8090

您可以根据实际需求修改端口号。

Home Assistant 配置

集成配置

编辑 Home Assistant 的配置文件configuration.yaml，添加以下内容：

matter: discovery: true

保存文件后，重启 Home Assistant 服务使配置生效。

设备连接指南

Apple Home 配置

打开 Apple Home 应用，进入设置菜单配置家庭环境。通过右上角的设置按钮可以访问家庭设置选项，包括编辑家庭视图、重新排序区域等功能。

配对码获取

在 Apple Home 中，当检测到 Matter 设备时，会显示配对码界面。您需要复制显示的配对码（格式为0000-0000-0000），用于在其他平台进行设备配对。

Alexa 设备添加

打开 Amazon Alexa 应用，进入设备页面，点击"Add Device"按钮开始添加新设备。

配对连接过程

在 Alexa 中输入配对码后，系统会显示连接状态。这个过程通常需要等待数秒到一分钟时间。

启动服务

完成所有配置后，运行以下命令启动 Home-Assistant-Matter-Hub：

npm start

验证配置

完成所有步骤后，请检查以下事项确保配置成功：

• Home Assistant 与 Matter Hub 连接正常
• 智能控制器能够发现并控制设备
• 跨平台设备互联功能可用

故障排除

如果在配置过程中遇到问题，请检查：

• 环境变量配置是否正确
• Home Assistant 配置文件语法是否正确
• 网络连接是否正常
• 端口是否被占用

现在您可以开始享受智能家居带来的便捷生活，通过 Matter 协议实现不同品牌设备的无缝协作。

【免费下载链接】home-assistant-matter-hubPublish your Home-Assistant Instance using Matter.项目地址: https://gitcode.com/gh_mirrors/ho/home-assistant-matter-hub