跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

本地部署 ESPHome 智能家居方案及外网访问配置

ESPHome 是用于 ESP8266 和 ESP32 设备的开源系统,可通过 YAML 配置创建物联网应用。介绍在 Linux 系统上部署 ESPHome Dashboard 的方法,并演示如何通过内网穿透技术将局域网服务映射到公网,实现外部远程访问。

w795471发布于 2026/4/12更新于 2026/9/7113 浏览
本地部署 ESPHome 智能家居方案及外网访问配置

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

第一步:本地部署 ESPHome

  1. 本教程使用 Linux Ubuntu 系统进行演示,首先输入以下命令更新软件包列表并安装必要的依赖项。
sudo apt-get update && sudo apt-get install -y python3-pip python3-dev git
  1. 安装虚拟环境 venv 模块。
sudo apt install -y python3-venv

创建一个虚拟环境(例如在 ~/venv_esphome)。

python3 -m venv ~/venv_esphome

激活虚拟环境。

source ~/venv_esphome/bin/activate
  1. 使用国内源加速下载安装 esphome。
pip install esphome -i https://pypi.tuna.tsinghua.edu.cn/simple

验证是否安装成功。

esphome --version
  1. 创建并进入一个空的 ESPHome 项目目录。
mkdir ~/esphome-dashboard
cd ~/esphome-dashboard

使用向导创建配置文件,按照提示完成。

esphome wizard your_device.yaml
  1. 在项目目录中运行以下命令启动 ESPHome Dashboard。
esphome dashboard .
  1. 打开浏览器访问地址 http://你的服务器 IP:6052,即可看到部署的 ESPHome 界面。

第二步:外网访问本地 ESPHome

为了从外部网络访问局域网内的服务,需要配置内网穿透工具。

  1. 确保已安装 Docker 环境。

  2. 拉取并运行内网穿透工具的容器镜像。请将 <penetration-image> 替换为实际使用的穿透服务镜像名称。

docker run --name lyx -it --restart=always --net=host -e code=<安装码> <penetration-image>
  1. 等待下载和安装过程,如果一切正常,终端会显示登录成功的 Token 信息。

  2. 若容器在前台运行,可按 Ctrl + C 退出,随后使用以下命令将其放入后台持续运行:

docker start lyx

注意:由于容器参数已添加 --restart=always,开机后会自动启动,无需手动干预。

  1. 在管理界面进行内网映射配置。选择对应的设备,点击【添加映射】。

  2. 选择【原生端口】模式,在内网地址填写服务器 IP 和 ESPHome 端口(如 6052),点击【创建】。

  3. 创建成功后,获取生成的公网地址。在外网设备上打开浏览器,输入该地址即可访问内网部署的 ESPHome 界面。

目录

  1. 第一步:本地部署 ESPHome
  2. 第二步:外网访问本地 ESPHome

更多推荐文章

查看全部
  • 前端 SSG 静态站点生成技术解析
  • Llama-3.2V-11B-COT 部署:Triton 推理服务封装与压测
  • FPGA 加速图像处理:核心算法解析
  • SenseVoice-Small ONNX 量化版部署与 Gradio 使用记录
  • Spring Cloud Gateway 微服务统一入口实践
  • C++ 继承机制详解:概念、访问控制与多继承处理
  • Java 动态规划实战:从递归优化到经典模型解析
  • Java 类加载及 new 对象的过程
  • QClaw 接入微信背后:AI 如何从聊天走向执行任务
  • OpenClaw Gateway 命令与交互指南
  • libwebkit2gtk-4.1-0 安装与依赖配置详解
  • Retinaface+CurricularFace 人脸识别服务 Kubernetes StatefulSet 部署实战
  • 基于 DeepFace 与 OpenCV 的实时情绪分析器实现
  • AI 智能体 Coze 知识库:从入门到实战
  • C++ 类与对象基础:封装、实例化与 this 指针详解
  • 通义万相 2.1 文生图模型特性与应用拓展实践
  • Java 大厂实习面试核心考点:数据库、中间件与基础原理
  • Visual Studio 2026 使用 C++ 模块入门指南
  • Qwen3-32B 多场景落地:医疗问诊预筛与药品说明解读系统
  • 2026 上半年主流 AIGC 长文本写作工具评测与选型指南

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online