跳转到内容

mDNS 组件

mdns 组件使节点使用多播 DNS(mDNS)协议在本地网络上宣布自己。

Home Assistant 和 ESPHome 仪表板都使用 mDNS 来识别网络上所有 ESPHome 节点的 IP 地址。 如果 mDNS 被禁用,它们将不再能够自动找到您的设备。可能需要为所有节点使用静态 IP,并在 Home Assistant 插件中启用 ping 选项。

建议保持 mDNS 启用。

# 示例配置项
mdns:
disabled: false

可以添加额外的 mDNS 服务作为 esphome 节点公开的服务。

# 带有额外服务的示例配置项
mdns:
services:
- service: "_custom_service"
protocol: "_tcp"
port: 8080
txt:
txt_key_1: txt_value_1
  • disabled (Optional, boolean): 设置为 true 以禁用 mDNS 使用。默认为 false。

  • services (Optional, list): 要公开的额外服务列表。

    • service (Required, string): 额外服务的名称。
    • protocol (Required, string): 服务的协议(_udp 或 _tcp)。
    • port (Optional, templatable, int): 额外服务的端口号。
    • txt (Optional, mapping): 要添加到服务的额外文本记录。值为 可模板化