Matter Server

Matter Server 智能家居服务器 — 一键安装

与 Matter 设备交互,兼容 Home Assistant!

为什么用 Web.Casa 安装 Matter Server 智能家居服务器?

一键部署

无需手动编写 Docker Compose,Web.Casa 自动配置并启动。

自动 HTTPS

Caddy 自动签发和续期 SSL 证书,反向代理开箱即用。

统一管理

监控、备份、更新、日志——所有应用在一个面板中管理。

安装方式

先安装 Web.Casa,然后在应用商店中一键安装此应用。

应用信息

版本
8.1.0
作者
OpenHomeFoundation
默认端口
9997

Python Matter 服务器

本项目基于官方 Matter(原 CHIP)SDK实现了一个通过 WebSocket 运行的 Matter 控制器服务器,同时提供了服务器和客户端实现。

该项目的主要目标是为 Home Assistant 提供 Matter 支持,但其通用架构也使其适用于其他项目。

支持

有问题吗?

您可以通过以下几种方式获得解答:

如果您在使用 Home Assistant 与 Matter 时遇到问题,请在 Home Assistant Core 仓库提交问题报告。

如果您完全确定问题与 Matter 服务器组件相关,也可以在本仓库提交问题。

与基于 Wi-Fi/以太网的 Matter 设备通信的要求

请确保容器在主机网络上运行。主机网络接口需要与您用于调试的 Android/iPhone 设备处于同一网络。Matter 使用链路本地组播协议,该协议无法跨不同 LAN 或 VLAN 工作。

主机网络接口需要启用 IPv6 支持。

通过 Thread 边界路由器与 Thread 设备通信的要求

要使通过 Thread 边界路由器的通信正常工作(当边界路由器与 Matter 控制器服务器不在同一主机上运行时),需要正确配置 IPv6 路由。IPv6 路由主要通过 IPv6 邻居发现协议自动设置,特别是路由信息选项(RIO)。然而,IPv6 邻居发现 RIO 是否被处理以及是否正确处理,取决于系统使用的网络管理软件。在处理此路由信息选项时可能存在错误和注意事项。

通常,请确保内核选项 CONFIG_IPV6_ROUTER_PREF 已启用,并且 IPv6 转发已禁用(sysctl 变量 net.ipv6.conf.all.forwarding)。如果启用了 IPv6 转发,Linux 内核将不会执行可达性探测(RFC 4191),这可能导致在网络变更被检测到之前出现较长时间的中断(最长可达 30 分钟)。

常见问题

Matter Server 智能家居服务器 可以安装在 Web.Casa 上吗?

是的,Matter Server 智能家居服务器 是 Web.Casa 应用商店中的官方应用。你可以通过 Web.Casa 面板一键安装,无需手动编写 Docker Compose 或配置反向代理。

如何在 Web.Casa 上安装 Matter Server 智能家居服务器?

首先通过 curl -fsSL https://get.web.casa | bash 安装 Web.Casa,然后在面板的应用商店中搜索「Matter Server 智能家居服务器」,点击安装即可。Web.Casa 会自动配置 Docker 容器、分配端口并设置 Caddy 反向代理。

Matter Server 智能家居服务器 在 Web.Casa 上的默认端口是什么?

Matter Server 智能家居服务器 在 Web.Casa 上的默认端口为 9997。你可以通过 Web.Casa 的 Caddy 反向代理将其绑定到自定义域名,自动获取 HTTPS 证书。

Matter Server 智能家居服务器 安装后可以自动获取 HTTPS 吗?

是的。Web.Casa 基于 Caddy 构建,安装应用后只需绑定域名,Caddy 会自动通过 Let's Encrypt 签发和续期 SSL 证书,全程无需手动配置。

Matter Server 智能家居服务器 的数据如何备份?

Web.Casa 内置备份插件,支持将 Matter Server 智能家居服务器 的数据自动备份到本地、S3、WebDAV 或 SFTP。你可以设置定时快照和保留策略,确保数据安全。