跳转到内容

强制门户

ESPHome 中的强制门户组件是当连接到配置的 WiFi 失败时的回退机制。

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

在此 Web 界面中,您可以手动覆盖设备的 WiFi 设置(请注意,这将被任何后续的串行上传覆盖,因此请确保同时更新您的 YAML 配置)。

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

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

# 示例配置项
wifi:
# ...
ap:
ssid: "客厅回退热点"
password: !secret wifi_ap_password
captive_portal:
  • compression (Optional, string): 用于嵌入 Web 资源的压缩算法。 选项为 gzipbr(Brotli)。Brotli 比 gzip 小约 24%,但某些浏览器 仅支持通过 HTTPS 连接的 Brotli。由于强制门户通过 HTTP 提供,建议使用 gzip 以获得最大兼容性。默认为 gzip