ESPHome 是一款用于 ESP8266 和 ESP32 芯片设备的开源系统,它允许用户通过定义简单的 YAML 配置文件来创建复杂的物联网( IoT )设备应用,而无需直接编写底层代码,特别适合于智能家居解决方案,可以与 Home Assistant 完美集成,但也可以独立使用。本文将详细介绍如何在 Linux 系统局域网内部署 ESPHome 并结合路由侠实现外网访问局域网内部署的 ESPHome 。
第一步,本地部署 ESPHome
1,本教程使用 Linux Ubuntu 系统进行演示,首先输入以下命令更新软件包列表并安装一些必要的依赖项。
sudo apt-get update && sudo apt-get install -y python3-pip python3-dev git
2,安装虚拟环境 venv 模块。
sudo apt install -y python3-venv
创建一个虚拟环境(例如在 ~/venv_esphome )。
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,创建并进入一个空的 ESPHome 项目目录。
mkdir ~/esphome-dashboard cd ~/esphome-dashboard
使用向导创建配置文件,按照提示完成。
esphome wizard your_device.yaml
5,在项目目录中运行以下命令启动 ESPHome Dashboard 。
esphome dashboard .
6,打开浏览器访问地址 http://你的服务器 IP:6052 ,就能看到你部署的 ESPHome 界面了。

第二步,外网访问本地 ESPHome
安装路由侠内网穿透。
1,当前未提供网页管理,需要先在任意一台 Windows 机器安装路由侠 Windows 版本,用作跨机器管理。点此下载
2,在路由侠客户端主界面,进入' 设备管理 ',点击右下角的' 添加设备 ',此时可查看到对应的安装码,此安装码用于将设备添加到对应账号下,可选中后复制。












