跳转到内容

主机平台

host 平台允许 ESPHome 配置在台式计算机上编译和运行。这在 MacOS 和 Linux 上可以正常工作。在 Windows 上,可以使用 WSL(Windows Subsystem for Linux)创建一个可以运行 ESPHome 的 Linux 环境。

唯一需要的配置是可选地设置一个虚拟 MAC 地址,该地址将用于向 Home Assistant 标识配置(本机 MAC 地址不易获取)。

NOTE

HA 不会使用 mDNS 自动发现运行在 host 上的 ESPHome 实例,您需要使用主机计算机的 IP 地址显式添加它。如果 HA 在手动添加设备时无法建立连接,本地主机计算机的防火墙设置可能是原因。ESPHome API 端口(6053)必须允许通过防火墙。 有关详细信息,请参阅 API

许多组件,特别是与实际硬件接口的组件,在使用 host 时将不可用。不要配置 wifi —— 网络将自动使用主机计算机可用。

# 示例配置条目
host:
mac_address: "06:35:69:ab:f6:79"
  • mac_address (可选, MAC 地址): 与 HA 通信时使用的虚拟 MAC 地址。

esphome run yourfile.yaml 命令将编译并自动在 host 平台上运行构建文件。