Home Assistant Matter Hub 连接智能家居设备指南
Matter 协议打破了不同品牌设备之间的壁垒。通过 Home Assistant Matter Hub,可以将 Home Assistant 实例通过 Matter 协议发布出来,实现跨品牌设备的统一控制。
准备工作
在开始安装之前,确保系统已准备就绪:
- 安装 Node.js 和 npm
- 部署 Home Assistant 实例
- 准备智能家居控制器(如 iPhone、Alexa 设备或 Google Home 音箱)
快速安装
步骤 1:获取项目代码
打开终端,执行以下命令克隆项目:
git clone <repository_url>
cd home-assistant-matter-hub
步骤 2:安装项目依赖
在项目目录中运行:
npm install
该命令会自动下载并安装所有必要的依赖包。
步骤 3:配置运行环境
创建环境配置文件,设置服务端口:
echo "MATTER_HUB_PORT=8090" > .env
可根据需要修改端口号,确保不与系统中其他服务冲突。
步骤 4:启动服务
运行启动命令:
npm start
看到服务成功启动的提示信息后,Home Assistant Matter Hub 即已在后台运行。
Apple Home 连接
进入设备配对模式
在桥接器详情页面,找到'开启配对模式'按钮并点击,准备进入配对流程。
获取配对设置码
设备进入配对模式后,系统会生成一个唯一的设置码,格式为'0000-0000-0000'。建议立即复制保存。
Alexa 设备配置
添加新设备入口
打开 Alexa 应用,进入设备管理页面,点击底部的'添加设备'按钮。
选择 Matter 设备类型
在设备设置页面,找到 Matter 选项,选择'Matter'作为设备类型。
输入配对数字码
推荐使用数字码输入方式,输入之前复制的 11-21 位配对码,点击'下一步'完成连接。
Home Assistant 集成配置
为了让 Home Assistant 能够与 Matter Hub 通信,需要在 Home Assistant 配置文件中添加 Matter 集成:
matter:
discovery: true
保存配置文件后重启 Home Assistant 服务,系统会自动发现并连接 Matter Hub。
常见问题
设备无法被发现?
- 检查 Home Assistant Matter Hub 服务是否正常运行

