ESPHome 是一款用于 ESP8266 和 ESP32 芯片设备的开源系统,允许用户通过定义简单的 YAML 配置文件来创建物联网 (IoT) 设备应用,无需直接编写底层代码。它特别适合智能家居解决方案,可与 Home Assistant 集成,也可独立使用。本文将详细介绍如何在 Linux 系统局域网内部署 ESPHome 并结合内网穿透工具实现外网访问。
第一步,本地部署 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
安装内网穿透工具。
- 需配合客户端进行管理。下载并导入镜像:
wget https://dl.luyouxia.com:8443/v2/lyx-docker-x86_64.tar
docker load -i lyx-docker-x86_64.tar
- 使用该镜像启动容器。









