--- title: "Home Assistant Matter 和 Thread：边界路由器、IPv6、VLAN 和共享设备实用指南" url: "https://kilobat.app/zh-hans/devices/home-assistant" description: "Home Assistant 与 Matter、Thread：IPv6、多播和 VLAN 的网络规则，包括 Connect ZBT-1 在内的边界路由器，以及如何与 Apple 和 Google 共享设备。" --- 智能家居 · 智能家居生态系统 # Home Assistant Matter 和 Thread：边界路由器、IPv6、VLAN 和共享设备 Home Assistant 是在你自己的硬件上运行的开源家庭自动化软件。它的 Matter 集成通过 Companion App 添加 Matter 设备，Thread 集成则跟踪家中的 Thread 网络。 运行平台 Home Assistant OS 是 Matter Server App 支持的安装方式；该 App 不支持 32 位平台 添加设备 仅限 Companion App：Android 8.1 或更新版本（建议 12），或 iOS 16 或更新版本 Thread 边界路由器 运行 OpenThread Border Router App 的 Home Assistant Yellow、Connect ZBT-1 或 ZBT-2，或者 Apple 或 Google 的边界路由器 网络 IPv6 多播必须能够到达 Home Assistant 主机；单一扁平网络为佳 **核查于 2026 年 11 月 1 日。** Home Assistant OS 的 Matter 和 Thread 集成及 Companion App，依据 home-assistant.io 2026 年的文档。 ## 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。 | 边界路由器 | 备注 | |---|---| | Home Assistant Yellow、Connect ZBT-1 或 Connect ZBT-2 | 配合 OpenThread Border Router App；Home Assistant 可以配置和控制它 | | Google Nest Hub（第 2 代）、Nest Hub Max、Nest Wifi Pro、Nest Wifi、Google TV Streamer | 由 Google Home 配置；可以使用，但不能管理 | | HomePod（第 2 代）、HomePod mini、Apple TV 4K（第 2 代）和第 3 代 Wi-Fi + 以太网版 | 由 Apple 家庭配置；可以使用，但不能管理 | | 其他设备，例如 Nanoleaf 或 Amazon 设备 | 可以使用，但不能管理 | ### 与手机共享 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 网络。 **Kilobat 可以帮助你。**`kilobat devices --bonjour` 列出 Mac 在网络上看到的 Bonjour（mDNS）服务类型。服务缺失可能有多种原因，包括多播过滤；这不能证明过滤已启用。此功能需要 macOS 本地网络权限。 ## 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 需要 IPv6 吗？** 是的，本地网络需要。IPv6 多播必须能够到达 Home Assistant 主机，但无需互联网服务商提供 IPv6，也无需 DHCPv6 服务器。 **Home Assistant 的 Matter 设备可以位于独立的 VLAN 中吗？** Home Assistant 不建议这样做：Wi-Fi Matter 设备和 Thread 边界路由器应与 Home Assistant 位于同一 VLAN。 **我可以将 HomePod 或 Nest Hub 用作 Home Assistant 的 Thread 边界路由器吗？** 可以。Home Assistant 可以使用 Apple 和 Google 的边界路由器，但只有它们各自的 App 可以配置它们。 ## 参考资料 - [Home Assistant：Matter 集成](https://www.home-assistant.io/integrations/matter/) - [Home Assistant：Thread 集成](https://www.home-assistant.io/integrations/thread/) - [Home Assistant：OpenThread Border Router 集成](https://www.home-assistant.io/integrations/otbr/) - [Home Assistant：Connect ZBT-1](https://www.home-assistant.io/connectzbt1/) - [Google Home 和 Nest 帮助：为 Matter 准备智能家居](https://support.google.com/googlehome/answer/12391458?hl=en-GB) - [Apple 支持：配对和管理 Matter 配件](https://support.apple.com/en-gb/102135) 核查日期：2026 年 11 月 1 日。 ## 从 Mac 查看家庭网络 Kilobat 是一款 Mac 菜单栏 App，附带供 AI 智能体使用的 CLI 和 MCP 服务器。它列出 Wi-Fi 上的设备并在新设备加入时通知你，记录路由器和互联网的健康历史，扫描附近信道，并显示 Mac 上哪个 App 正在使用网络。[阅读文档](https://kilobat.app/zh-hans/docs)。 [下载 Mac 版 ↓](https://kilobat.app/downloads/Kilobat-1.31.1.dmg?via=site) ``` brew install seifip/kilobat/kilobat ``` ## 更多设备指南 - [Matter](https://kilobat.app/zh-hans/devices/matter): Matter 是 Connectivity Standards Alliance 制定的开放智能家居标准。 - [Thread](https://kilobat.app/zh-hans/devices/thread): Thread 是一种供传感器、门锁和按钮等智能家居设备使用的低功耗无线网状网络。 - [Matter 设备无法配对](https://kilobat.app/zh-hans/devices/matter-wont-pair): Matter 配对可能因多种原因失败，包括手机连接错误网络、蓝牙关闭、设备未处于配对模式、没有 Thread 边界路由器，或网络阻止 IPv6 或多播。 - [Matter 设备无响应](https://kilobat.app/zh-hans/devices/matter-unresponsive): Matter 设备配对后又显示离线，可能是设备、中枢或网络存在问题。