把 Matter 裝置加進 Home Assistant：Matter Server 9.x 完整設定與 1.6 現況

charles · 發表於 2026-9-21 11:07:01

做完這一篇，你會有一台跑著 Matter Server 的 Home Assistant，
能把 Matter 裝置配對進來、看得到它的網路拓樸圖，
並且能把同一台裝置同時分享給 Apple 家庭或 Google Home 而不用重買。

先把現況講清楚，因為這一年變動很大

一、現行規格是 Matter 1.6，2026 年 6 月 17 日發布。

1.6 是所謂的 focused feature release，沒有新增任何裝置型別，
加的是 NFC 委任（把手機靠上去就能配對，不用找 QR code）、
Joint Fabric（多生態系共享控制）、恆溫器建議、環境感知（暫定規格）、
以及憑證撤銷清單改成可分塊更新。

攝影機是上一版 1.5（2025-11-20）加的，一起加的還有 Closures
（把窗簾、遮陽篷、大門、車庫門統一成一套模型）、土壤感測器、電價資料、TCP 傳輸。
很多文章把這兩版混在一起講，買東西的時候會看錯規格標示。

二、Apple 的「家庭」App 支援的 Matter 型別，不包含攝影機。

依 Apple 支援文件的清單，目前是：空調、橋接器、燈、門鎖、插座、開關、
恆溫器、窗簾遮陽、感測器。攝影機、電視、掃地機器人、大型家電都不在裡面。

這不是「還要再等等看」，是可以直接查的現況。
所以如果你買 Matter 攝影機的目的是進 Apple 家庭，現在買了用不到。

三、Matter 協定完全定義在區域網路上。

這點常被寫反。一台拿到 Matter 認證的裝置，保證可以被任何 Matter 控制器本地控制，
不需要網路、不需要原廠帳號。雲端只在三個地方回來：
遠端存取、規格以外的廠商專屬功能、以及韌體裡另一條平行的遙測。

所以拿原廠 App 去做斷網測試，一定會得到「果然還是繞雲端」的錯誤結論 ——
你測的是那支 App，不是 Matter。要測的話用 Home Assistant 配對，然後拔網路線。

四、進 Apple「家庭」App 已經不需要 HomeKit（MFi）認證。

走 CSA 的 Matter 認證就可以。舊文那套「HomeKit 裝置貴一倍、選擇少三倍」的論證，
前提已經不成立了。

五、Home Assistant 的 Matter Server 在 2026 年整個換掉了。

Matter Server 應用程式從 9.0.0 起改用 matter.js 重寫版，
舊的 Python Matter Server 已經移除。現行是 9.2.0（內含 matter-server 1.4.0），
從 9.1.0 起支援 Matter 1.6.0。

這件事對你的實際影響很大，看步驟 2 和最後一節。

步驟 1：先搞清楚你的裝置是 Wi-Fi Matter 還是 Thread Matter

這決定你需不需要額外的硬體，買之前就要看。

看盒子上的標示，Matter 標誌旁邊一定會有另一個：

Matter + Wi-Fi 標誌 —— 直接連你家的 Wi-Fi。不需要額外硬體
Matter + Thread 標誌 —— 需要家裡有一台 Thread 邊界路由器

Thread 是低功耗的網狀網路，電池裝置幾乎都走這個。
能當邊界路由器的常見東西：HomePod、HomePod mini、
Apple TV 4K 第三代的 Wi-Fi + 乙太網路版本、Google Nest Hub 第二代、
以及 Home Assistant 裝了 OpenThread Border Router 應用程式再插一支支援的 USB 棒。

家裡一台邊界路由器都沒有，就不要買 Thread 版本，它會停在配對那一步，
而且錯誤訊息只會說「找不到裝置」。

另外一定要確認的兩件事：

Matter 裝置大多只連 2.4GHz Wi-Fi。配對時手機也要連在 2.4GHz 那個網路上
手機要開藍牙。Matter 的配對是靠藍牙把 Wi-Fi 或 Thread 的憑證送進裝置的

步驟 2：安裝 Matter Server

路 A：Home Assistant OS（推薦，而且官方只有這條路是完整測試過的）

設定 → 裝置與服務 → 新增整合 → 搜尋 Matter
它會問你要不要安裝官方的 Matter Server 應用程式，按提交
等它裝完並啟動

你會看到什麼：左側選單會多出一個 Matter Server 面板（Matter 圖示）。
點進去是 Matter Server 自己的儀表板，上面會顯示伺服器版本與目前的節點數（一開始是 0）。

左側沒有出現那個面板，去「設定 → 應用程式 → Matter Server」看它是不是在執行中，
以及日誌有沒有紅字。

路 B：用容器自己跑（Docker / 非 HA OS）

官方的原話是：容器版本是「as-is、沒有官方支援」，
而且自架容器最容易出問題的正是 Thread 裝置的連線，因為它用的是主機網路，
整套 IPv6 多播行為由你的作業系統決定。知道這個前提之後再往下。

建一個目錄放 docker-compose.yml：

# /opt/matter-server/docker-compose.yml
services:
matter-server:
image: ghcr.io/matter-js/matterjs-server:stable
container_name: matterjs-server
restart: unless-stopped
network_mode: host
security_opt:
- apparmor=unconfined
volumes:
- /opt/matter-server/data:/data
- /run/dbus:/run/dbus:ro
environment:
- STORAGE_PATH=/data
- LOG_LEVEL=info

複製代碼

資料目錄的權限一定要先處理，新版容器是用非特權使用者跑的：

以下還有約 61% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入

		自動登入	找回密碼
密碼			立即註冊

把 Matter 裝置加進 Home Assistant：Matter Server 9.x 完整設定與 1.6 現況

延伸閱讀