ESPHome 是一款用于 ESP8266 和 ESP32 芯片设备的开源系统，它允许用户通过定义简单的 YAML 配置文件来创建复杂的物联网 (IoT) 设备应用，而无需直接编写底层代码。特别适合于智能家居解决方案，可以与 Home Assistant 完美集成，也可以独立使用。
第一步：本地部署 ESPHome
- 本教程使用 Linux Ubuntu 系统进行演示，首先输入以下命令更新软件包列表并安装必要的依赖项。
sudo apt-get update && sudo apt-get install -y python3-pip python3-dev git
- 安装虚拟环境 venv 模块。
sudo apt install -y python3-venv
创建一个虚拟环境（例如在 ~/venv_esphome）。
python3 -m venv ~/venv_esphome
激活虚拟环境。
source ~/venv_esphome/bin/activate
- 使用国内源加速下载安装 esphome。
pip install esphome -i https://pypi.tuna.tsinghua.edu.cn/simple
验证是否安装成功。
esphome --version
- 创建并进入一个空的 ESPHome 项目目录。
mkdir ~/esphome-dashboard
cd ~/esphome-dashboard
使用向导创建配置文件，按照提示完成。
esphome wizard your_device.yaml
- 在项目目录中运行以下命令启动 ESPHome Dashboard。
esphome dashboard .
- 打开浏览器访问地址 http://你的服务器 IP:6052，即可看到部署的 ESPHome 界面。
第二步：外网访问本地 ESPHome
为了从外部网络访问局域网内的服务，需要配置内网穿透工具。
-
确保已安装 Docker 环境。
-
拉取并运行内网穿透工具的容器镜像。请将
<penetration-image>替换为实际使用的穿透服务镜像名称。
docker run --name lyx -it --restart=always --net=host -e code=<安装码> <penetration-image>
-
等待下载和安装过程，如果一切正常，终端会显示登录成功的 Token 信息。
-
若容器在前台运行，可按 Ctrl + C 退出，随后使用以下命令将其放入后台持续运行：
docker start lyx
注意：由于容器参数已添加 --restart=always，开机后会自动启动，无需手动干预。
-
在管理界面进行内网映射配置。选择对应的设备，点击【添加映射】。
-
选择【原生端口】模式，在内网地址填写服务器 IP 和 ESPHome 端口（如 6052），点击【创建】。
-
创建成功后，获取生成的公网地址。在外网设备上打开浏览器，输入该地址即可访问内网部署的 ESPHome 界面。