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 服务是否正常运行
- 确认网络环境是否支持设备发现
- 验证防火墙设置是否阻止了相关端口
配对码无效？
- 确保配对码格式正确（11-21 位数字）
- 检查设备是否处于配对模式
- 重启 Matter Hub 服务后重试
总结
完成以上步骤后，Home Assistant 设备即可通过 Matter 协议连接到智能家居控制器，实现语音控制和远程管理。