HA 掃不到裝置？八成是 mDNS 的問題

charles

「這個裝置明明在線上，HA 就是找不到它」

如果你遇過這個，先不要重設裝置，多半是 mDNS 被擋住了。



■ mDNS 是什麼

簡單說：讓裝置在區域網路裡「喊一聲」讓別人找到它的機制。
（Apple 那邊叫 Bonjour，Linux 叫 Avahi，都是同一件事。）

靠它的東西超多：

• HomeKit 配對
  
• ESPHome 裝置發現
  
• Chromecast / Google Cast
  
• Sonos
  
• AirPlay
  
• 網路印表機
  
• 很多 HA 整合的「自動發現」
  

■ 四個會擋住它的情況

1. 裝置和 HA 在不同網段

mDNS 廣播預設不跨網段。
你做了 VLAN 隔離，或 HA 在主網路、裝置在訪客網路，就一定掃不到。

解法：路由器開 mDNS Repeater / Reflector（不同品牌名字不一樣，
可能叫「Bonjour 轉發」「Avahi」「多播路由」）。

2. AP 隔離開著

同網段但裝置之間互相看不到。
找到「AP 隔離」「用戶端隔離」「Client Isolation」，關掉。

3. 用了訪客網路

訪客網路的本質就是隔離。
IoT 裝置不要接訪客網路（除非你已經設好 mDNS 轉發）。

4. Docker 網路模式不對

如果你的 HA 跑在 Docker 裡，一定要用 network_mode: host。

用預設的 bridge 模式的話，HA 在自己的虛擬網路裡，
收不到實體網路的廣播，自動發現全部失效。

這是 NAS 上跑 HA 最常見的問題。

■ 怎麼確認是不是 mDNS 問題

在跟 HA 同一台機器上（或同網段的電腦）執行：

1. # Linux / macOS
2. avahi-browse -a -t
3. # 或
4. dns-sd -B _services._dns-sd._udp

複製代碼

看得到裝置 → mDNS 正常，問題在別的地方
看不到 → 就是 mDNS 被擋了

■ 最後的辦法：手動指定 IP

很多整合在自動發現失敗時，允許你直接填 IP。

雖然少了自動發現的方便，但至少能用。
記得先幫那個裝置設定 DHCP 保留，不然 IP 換掉又要重來。

有人被 mDNS 卡過嗎？後來怎麼解的？