跳转到内容

Captive Portal

ESPHome 中的 captive portal 组件是在连接到配置的 WiFi 失败时的回退机制。

在 WiFi 连接尝试失败 1 分钟后,ESP 将启动一个 WiFi 热点(使用您配置中的凭据)

在这个网页界面中,您可以手动覆盖设备的 WiFi 设置(请注意,这会被任何后续的串口上传覆盖,因此请确保也更新您的 YAML 配置)。

此外,您可以上传一个新的固件文件。

当您连接到回退网络时,网页界面应该会自动打开(另请参阅登录网络通知)。如果这不起作用,您也可以在浏览器中手动导航到 http://192.168.4.1/。

# Example configuration entry
wifi:
# ...
ap:
ssid: "Livingroom Fallback Hotspot"
password: !secret wifi_ap_password
captive_portal:
  • compression (可选, string):用于嵌入式 Web 资源的压缩算法。 选项为 gzip 或 br(Brotli)。Brotli 比 gzip 大约小 ~24%,但某些浏览器只在 HTTPS 连接上支持 Brotli。由于 captive portal 是通过 HTTP 提供的,推荐使用 gzip 以获得最大兼容性。默认为 gzip。