Home Assistant Matter 和 Thread：边界路由器、IPv6、VLAN 和共享设备

Home Assistant 如何处理 Matter 和 Thread

在 Home Assistant OS 上添加Matter集成会安装执行 Matter 工作的官方 Matter Server App。Home Assistant 将 OS 称为推荐且唯一受支持的选项。自行在 Docker 中运行 Matter Server 不受支持，基于 Thread 的 Matter 设备需要 Home Assistant OS 10 或更新版本。

新设备通过手机上的 Companion App 添加，而不是通过浏览器。在 Android 上，从 Play 商店安装完整版 Companion App，并允许始终访问位置。在 iPhone 上，使用最新版 Companion App。

当 Home Assistant 发现边界路由器时，Thread集成会出现。它保存每个 Thread 网络的凭据，作用类似 Wi-Fi 密码，并允许你为新设备选择首选网络。

Thread 边界路由器

Home Assistant 可以使用其他生态系统的边界路由器，也可以自身充当边界路由器。

• 独立网络：各制造商的边界路由器通常形成各自的 Thread 网络，并拥有各自的凭据。设备不能在这些网络之间漫游。
• 手机和边界路由器：要从 Android 手机添加 Thread 设备，Home Assistant 列出 Nest Hub（第 2 代）或 Nest Wifi Pro；从 iPhone 添加则列出 HomePod mini 或 HomePod（第 2 代），或 Apple TV 4K。Home Assistant 自己的边界路由器适用于两者。
• Connect ZBT-1：已停产，但仍有更新。Home Assistant 推荐其 Zigbee 固件；Thread 可以使用，但仍在完善，并建议新买家选择 ZBT-2。
• 多协议（在一个无线电上运行 Zigbee 和 Thread）仍处于实验阶段，不建议使用。
• 放置：请使用 USB 延长线。USB 3 端口会产生干扰，可能影响 Zigbee 和 Thread。

与手机共享 Thread 凭据

1. Android：在 Companion App 中打开设置 › Companion App › 故障排除。

2. 轻点同步 Thread 凭据。

3. iPhone：打开设置 › 连接 › Thread。

4. 在首选网络框中轻点将凭据发送至手机。

对网络的要求

Home Assistant 在这方面提供了特别具体的说明。Matter 面向普通家庭网络设计，其文档提醒注意常见的“高级”设置。

• IPv6：IPv6 多播流量必须能够从网络自由到达 Home Assistant 主机。在设置 › 系统 › 网络中将 IPv6 设置为自动或静态。无需 IPv6 互联网连接或 DHCPv6 服务器。
• Thread 的 IPv6 路由：主机、路由器以及任何 Docker 或虚拟机管理程序层都必须能够路由或转发 IPv6。
• 多播：路由器或接入点中“优化”多播的设置可能破坏 Matter 发现。异常的 IGMP 侦听和多播过滤也会造成问题。
• 网状 Wi-Fi：部分网状系统会过滤多播，可能导致手机找不到边界路由器。请检查其多播、IGMP 侦听和 mDNS 设置。
• VLAN：将 Wi-Fi Matter 设备和 Thread 边界路由器放在与 Home Assistant 相同的 VLAN 中。尽量保持网络简单且扁平。
• 2.4 GHz：添加 Wi-Fi Matter 设备时，手机应与其连接同一个 2.4 GHz 网络。

Matter 及与其他生态系统共享设备

添加已由 Apple 家庭或 Google Home 控制的设备

1. 确保 Companion App 是最新版本。

2. 打开设置 › 连接 › Matter并选择添加设备。

3. 选择是，设备已在使用中。并选择控制器，例如 Google Home。

4. 按照步骤操作，然后为设备命名、选择区域并选择完成。

将 Home Assistant 设备共享给另一个控制器

1. 打开设置 › 连接 › Matter › 设备并选择设备。

2. 选择共享设备，然后再次选择共享设备。无需按设备上的按钮。

3. 在另一个 App 中扫描二维码或输入共享码。

4. 要检查，请打开设备的三点菜单并选择管理 Fabric。

要移除另一个控制器，请在管理 Fabric中将其删除。对于 Apple 家庭，还需从 iCloud 钥匙串中的 Apple Matter 配件列表移除该配件。

常见问题与 Home Assistant 的解决方法

• “你需要使用 Home Assistant Companion App”：只能从手机 App 添加设备，不能通过浏览器添加。
• Android 提示 Matter 不可用：等待最长 24 小时，让 Google Play 服务下载 Matter 模块。然后重新安装 Companion App 或 Google Home。
• 卡在“正在检查网络连接”：将手机放在边界路由器和设备附近。对于 Wi-Fi 设备，请使用 2.4 GHz。
• “此设备需要边界路由器”：设置一个边界路由器，或让 Home Assistant 充当边界路由器，并将其 Thread 凭据同步到手机。
• “目标节点未处理更新文件”：Apple 边界路由器不会转发 Matter 更新所需的 mDNS 数据包。添加非 Apple 边界路由器，或关闭 Apple 边界路由器至少 30 分钟后重试。
• 设备随机不可用或配网出错：检查上述网络规则，尤其是 VLAN、多播设置和扁平拓扑。
• 需要更多详细信息：从 Matter 集成或设备的三点菜单下载诊断信息。

常见问题

参考资料

• Home Assistant：Matter 集成
• Home Assistant：Thread 集成
• Home Assistant：OpenThread Border Router 集成
• Home Assistant：Connect ZBT-1
• Google Home 和 Nest 帮助：为 Matter 准备智能家居
• Apple 支持：配对和管理 Matter 配件

核查日期：2026 年 11 月 1 日。

更多设备指南