终极入门教程：Home-Assistant-Matter-Hub让你的智能家居支持Matter协议

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

Home-Assistant-Matter-Hub是一款强大的工具，能帮助你将Home Assistant智能家居系统无缝接入Matter协议，实现不同品牌智能设备的互联互通。通过本教程，你将快速掌握如何安装、配置和使用这个工具，让你的智能家居设备获得跨平台的兼容性和更强大的控制能力。

为什么选择Home-Assistant-Matter-Hub？

Matter协议作为智能家居领域的统一标准，正在改变我们控制和管理智能设备的方式。Home-Assistant-Matter-Hub作为连接Home Assistant与Matter协议的桥梁，具有以下优势：

• 跨平台兼容：让你的Home Assistant设备可以被Apple Home、Amazon Alexa、Google Home等主流智能助手发现和控制
• 简单配置：通过直观的Web界面轻松设置多个独立桥接器
• 灵活过滤：精确选择哪些设备通过Matter协议对外暴露
• 开源免费：基于开源技术构建，持续更新和改进

快速安装指南

Home-Assistant-Matter-Hub提供多种安装方式，你可以根据自己的环境选择最适合的方法：

Home Assistant OS用户（推荐）

1. 打开Home Assistant界面，进入设置 -> 加载项 -> 加载项商店
2. 点击右上角三个点，选择存储库
3. 添加存储库URL：https://github.com/t0bst4r/home-assistant-addons
4. 刷新商店，找到并安装"Home Assistant Matter Hub"加载项
5. 配置日志级别后点击"启动"

Docker用户

使用以下docker-compose配置：

services:
  matter-hub:
    image: ghcr.io/t0bst4r/home-assistant-matter-hub:latest
    restart: unless-stopped
    network_mode: host
    environment:
      - HAMH_HOME_ASSISTANT_URL=http://你的HomeAssistant地址:8123/
      - HAMH_HOME_ASSISTANT_ACCESS_TOKEN=你的长期访问令牌
      - HAMH_LOG_LEVEL=info
      - HAMH_HTTP_PORT=8482
    volumes:
      - $PWD/home-assistant-matter-hub:/data

然后运行docker compose up -d启动服务。

手动安装

通过npm全局安装：

npm install -g home-assistant-matter-hub

启动应用：

home-assistant-matter-hub start \
  --home-assistant-url="http://你的HomeAssistant地址:8123/" \
  --home-assistant-access-token="你的长期访问令牌" \
  --log-level=info \
  --http-port=8482

桥接器配置详解

安装完成后，通过Web界面（默认地址：http://你的服务器IP:8482）进行桥接器配置：

访问Web界面

• Home Assistant加载项用户：直接点击"打开Web UI"
• Docker或手动安装用户：在浏览器中访问http://服务器IP:8482

创建你的第一个桥接器

每个桥接器都是独立的Matter设备，可以配置不同的端口和设备过滤规则。基本配置包括：

{
  "name": "我的Matter桥接器",
  "port": 5540,
  "filter": {
    "include": [],
    "exclude": []
  }
}

设备过滤规则

通过过滤规则精确控制哪些设备通过Matter协议对外暴露：

• 包含规则：指定要包含的设备
• 排除规则：指定要排除的设备

规则类型包括：

• pattern：匹配实体ID的模式
• domain：按设备域过滤（如light、switch）
• platform：按集成平台过滤
• entity_category：按实体类别过滤
• label：按标签过滤
• area：按区域过滤

示例配置：

{
  "name": "客厅设备桥",
  "port": 5540,
  "filter": {
    "include": [
      {
        "type": "label",
        "value": "matter_expose"
      },
      {
        "type": "pattern",
        "value": "light.living_room_*"
      }
    ],
    "exclude": [
      {
        "type": "domain",
        "value": "fan"
      },
      {
        "type": "entity_category",
        "value": "diagnostic"
      }
    ]
  }
}

连接到智能助手

配置好桥接器后，就可以将其连接到各种智能助手了。

连接到Apple Home

1. 打开Apple Home应用，点击右上角"+"号，选择"添加配件"

2. 选择"更多选项"，然后在"家庭中心与桥接器"中找到你的Matter桥接器

3. 选择你的桥接器，进入详情页面

4. 点击"开启配对模式"，获取配对代码

5. 使用Apple Home应用扫描配对码或手动输入

连接到Amazon Alexa

1. 打开Alexa应用，进入"设备"标签，点击右上角"+"号，选择"添加设备"

2. 在设备类型中选择"Matter"

3. 选择"尝试使用数字代码"

4. 输入从桥接器获取的配对代码

5. 等待连接完成

高级配置选项

Home-Assistant-Matter-Hub提供了丰富的配置选项，可以通过命令行参数或环境变量进行设置：

• --log-level：日志级别（debug/info/warn/error）
• --storage-location：数据存储路径
• --http-port：Web界面端口
• --http-auth-username：Web界面用户名
• --http-auth-password：Web界面密码
• --mdns-network-interface：限制mDNS使用的网络接口

所有配置选项都可以通过环境变量设置，只需在选项名前添加HAMH_前缀，例如HAMH_LOG_LEVEL=debug。

故障排除

如果遇到连接问题，请检查以下几点：

1. IPv6支持：确保你的网络环境启用了IPv6
2. mDNS支持：确保网络中允许mDNS广播（特别是使用VLAN时）
3. 端口冲突：确保桥接器使用的端口没有被其他服务占用
4. Home Assistant连接：验证Home Assistant URL和访问令牌是否正确

详细的故障排除指南可以参考项目文档中的连接问题解决指南。

总结

通过Home-Assistant-Matter-Hub，你可以轻松地将Home Assistant中的智能设备接入Matter生态系统，实现跨平台的智能设备控制。无论是通过Home Assistant加载项、Docker还是手动安装，这个工具都能为你提供简单而强大的Matter协议支持。

立即开始使用Home-Assistant-Matter-Hub，体验智能家居互联互通的全新可能！

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