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


