Linux 本地部署 ESPHome 智能家居并实现外网访问

ESPHome 本地部署与外网访问指南

ESPHome 是一款用于 ESP8266 和 ESP32 芯片设备的开源系统，允许用户通过定义简单的 YAML 配置文件来创建复杂的物联网 (IoT) 设备应用，而无需直接编写底层代码。它特别适合于智能家居解决方案，可以与 Home Assistant 完美集成，也可以独立使用。

第一步：本地部署 ESPHome

本教程以 Linux Ubuntu 系统为例。

1. 更新软件包列表并安装必要的依赖项。

sudo apt-get update && sudo apt-get install -y python3-pip python3-dev git

2. 安装虚拟环境 venv 模块并创建虚拟环境。

sudo apt install -y python3-venv
python3 -m venv ~/venv_esphome
source ~/venv_esphome/bin/activate

3. 使用国内源加速下载安装 esphome。

pip install esphome -i https://pypi.tuna.tsinghua.edu.cn/simple
esphome --version

4. 创建并进入项目目录，使用向导生成配置文件。

mkdir ~/esphome-dashboard
cd ~/esphome-dashboard
esphome wizard your_device.yaml

5. 在项目目录中启动 ESPHome Dashboard。

esphome dashboard .

6. 打开浏览器访问 http://你的服务器 IP:6052，即可看到 ESPHome 界面。

第二步：外网访问本地 ESPHome

1. 配置内网穿透服务

由于当前版本未提供网页管理，需配合客户端进行跨设备管理。

1. 在客户端主界面进入'设备管理'，点击'添加设备'查看安装码，复制该码用于后续配置。